# run\_as\_task
**run_as_task** is a Python package that allows scripts to escalate their privileges to Administrator (Local Service) on Windows, without requiring UAC approval. This project is a port of AHK [RunAsTask](https://www.autohotkey.com/boards/viewtopic.php?f=83&t=119710).
## Installation
```powershell
PS > pip install run_as_task
```
## Usage
Here is a basic example of how to use `run_as_task` to run the Windows Registry Editor (`regedit`) with escalated privileges:
```python
# regedit.py
from run_as_task import run_as_task
import subprocess
run_as_task()
subprocess.Popen(['regedit'], creationflags=subprocess.CREATE_NO_WINDOW)
```
### Important Notes
1. **First Run Setup**: When you run the script for the first time, `run_as_task` will register the script as a Windows Scheduled Task to allow for escalated execution. This initial setup will prompt you for UAC (User Account Control) permissions.
2. **Subsequent Runs**: After the initial setup, running the script again will not prompt for UAC. Instead, it will trigger the scheduled task to run with escalated privileges.
To execute the script, use the following command in PowerShell:
```powershell
PS > pythonw regedit.py
```
## License
This project is licensed under the MIT License. See the LICENSE file for details.
## Contact
For any questions or support, please reach out to me via [GitHub Issues](https://github.com/th-yoo/run_as_task/issues).
Raw data
{
"_id": null,
"home_page": "https://github.com/th-yoo/run_as_task",
"name": "run_as_task",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.9",
"maintainer_email": null,
"keywords": "admin, windows, elevation, privileges, task scheduler",
"author": "th yoo",
"author_email": "taihyungyoo@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/d7/18/cd0054a119a92043c30d5a090f8753e0dabf89ab9e43c34a6b9476c462c3/run_as_task-0.1.2.tar.gz",
"platform": null,
"description": "# run\\_as\\_task\n**run_as_task** is a Python package that allows scripts to escalate their privileges to Administrator (Local Service) on Windows, without requiring UAC approval. This project is a port of AHK [RunAsTask](https://www.autohotkey.com/boards/viewtopic.php?f=83&t=119710).\n\n## Installation\n```powershell\nPS > pip install run_as_task\n```\n\n## Usage\nHere is a basic example of how to use `run_as_task` to run the Windows Registry Editor (`regedit`) with escalated privileges:\n\n```python\n# regedit.py\nfrom run_as_task import run_as_task\nimport subprocess\n\nrun_as_task()\nsubprocess.Popen(['regedit'], creationflags=subprocess.CREATE_NO_WINDOW)\n```\n\n### Important Notes\n1. **First Run Setup**: When you run the script for the first time, `run_as_task` will register the script as a Windows Scheduled Task to allow for escalated execution. This initial setup will prompt you for UAC (User Account Control) permissions.\n\n2. **Subsequent Runs**: After the initial setup, running the script again will not prompt for UAC. Instead, it will trigger the scheduled task to run with escalated privileges.\n\nTo execute the script, use the following command in PowerShell:\n```powershell\nPS > pythonw regedit.py\n```\n\n## License\nThis project is licensed under the MIT License. See the LICENSE file for details.\n\n## Contact\nFor any questions or support, please reach out to me via [GitHub Issues](https://github.com/th-yoo/run_as_task/issues).\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "`run_as_task` is a Python package that allows scripts to escalate their privileges to Administrator (Local Service) without requiring UAC approval.",
"version": "0.1.2",
"project_urls": {
"Homepage": "https://github.com/th-yoo/run_as_task"
},
"split_keywords": [
"admin",
" windows",
" elevation",
" privileges",
" task scheduler"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "eaacdb9b952574c3cacde7eb7e933efe08447d1566d2e801c93b2b5b2c5faf9d",
"md5": "8448d1c1d126f96d7255415c62b2449b",
"sha256": "0a0e567f8df4248331d73994885845c78f68057b7b449fa2b1e17b3f82716abc"
},
"downloads": -1,
"filename": "run_as_task-0.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8448d1c1d126f96d7255415c62b2449b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.9",
"size": 5200,
"upload_time": "2024-09-03T13:14:55",
"upload_time_iso_8601": "2024-09-03T13:14:55.105753Z",
"url": "https://files.pythonhosted.org/packages/ea/ac/db9b952574c3cacde7eb7e933efe08447d1566d2e801c93b2b5b2c5faf9d/run_as_task-0.1.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d718cd0054a119a92043c30d5a090f8753e0dabf89ab9e43c34a6b9476c462c3",
"md5": "08eb9cbf435d97cf31bf0095d53c9498",
"sha256": "f578d0f8a9853005c1f55c7c50a139ba1e4a8ff6b07fca9f8582c15174466032"
},
"downloads": -1,
"filename": "run_as_task-0.1.2.tar.gz",
"has_sig": false,
"md5_digest": "08eb9cbf435d97cf31bf0095d53c9498",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.9",
"size": 4571,
"upload_time": "2024-09-03T13:14:55",
"upload_time_iso_8601": "2024-09-03T13:14:55.961800Z",
"url": "https://files.pythonhosted.org/packages/d7/18/cd0054a119a92043c30d5a090f8753e0dabf89ab9e43c34a6b9476c462c3/run_as_task-0.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-03 13:14:55",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "th-yoo",
"github_project": "run_as_task",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "run_as_task"
}
JSON
