2024-02-09 00:41:07 +08:00
|
|
|
# ![Sudo for Windows icon](./img/Windows/AppList.targetsize-24.png) Sudo for Windows
|
|
|
|
|
2024-02-10 01:22:23 +08:00
|
|
|
Welcome to the repository for [Sudo for Windows][sudo-for-windows] 🥪. Sudo
|
2024-02-09 03:24:03 +08:00
|
|
|
for Windows allows users to run elevated commands directly from unelevated
|
2024-02-09 00:41:07 +08:00
|
|
|
terminal windows.
|
|
|
|
|
2024-02-09 03:24:03 +08:00
|
|
|
Sudo is available for Windows 11 builds 26045 and later. If you're on an Insiders
|
2024-02-09 00:41:07 +08:00
|
|
|
build with sudo, you can enable it in the Windows Settings app, on the
|
|
|
|
"Developer Features" page.
|
|
|
|
|
|
|
|
Here you can report issues and file feature requests. We're in the process of
|
|
|
|
open-sourcing the code, so stay tuned for more updates.
|
|
|
|
|
|
|
|
## Relationship to `sudo` on Linux
|
|
|
|
|
2024-02-10 01:17:49 +08:00
|
|
|
Obviously, everything about permissions and the command line experience is
|
2024-02-09 00:41:07 +08:00
|
|
|
different between Windows and Linux. This project is not a fork of the Linux
|
|
|
|
`sudo` project, nor is it a port of the Linux `sudo` project. Instead, Sudo for
|
|
|
|
Windows is a Windows-specific implementation of the `sudo` concept.
|
|
|
|
|
|
|
|
As the two are entirely different applications, you'll find that certain
|
|
|
|
elements of the Linux `sudo` experience are not present in Sudo for Windows, and
|
|
|
|
vice versa. Scripts and documentation that are written for Linux `sudo` may not
|
|
|
|
be able to be used directly with Sudo for Windows without some modification.
|
|
|
|
|
|
|
|
## Documentation
|
|
|
|
|
|
|
|
All project documentation is located at
|
2024-02-10 01:22:23 +08:00
|
|
|
[aka.ms/sudo-docs][sudo-docs]. If you would like to contribute to
|
2024-02-09 00:41:07 +08:00
|
|
|
the documentation, please submit a pull request on the [Sudo for Windows
|
2024-02-10 01:22:23 +08:00
|
|
|
Documentation repo][documentation-repo].
|
2024-02-09 00:41:07 +08:00
|
|
|
|
|
|
|
## Contributing
|
|
|
|
|
|
|
|
We're still working on open-sourcing Sudo for Windows. Stay tuned for more updates.
|
|
|
|
|
|
|
|
### `sudo.ps1`
|
|
|
|
|
|
|
|
In the meantime, you can contribute to the [`sudo.ps1`] script. This script is
|
|
|
|
meant to be a helper wrapper around `sudo.exe` that provides a more
|
|
|
|
user-friendly experience for using sudo from PowerShell. This script is located
|
|
|
|
in the `scripts/` directory.
|
|
|
|
|
|
|
|
## Communicating with the Team
|
|
|
|
|
|
|
|
The easiest way to communicate with the team is via GitHub issues.
|
|
|
|
|
|
|
|
Please file new issues, feature requests and suggestions, but **DO search for
|
|
|
|
similar open/closed preexisting issues before creating a new issue.**
|
|
|
|
|
|
|
|
If you would like to ask a question that you feel doesn't warrant an issue
|
2024-02-10 01:22:23 +08:00
|
|
|
(yet), try a [discussion thread][discussions]. Those are especially helpful for question &
|
2024-02-09 00:41:07 +08:00
|
|
|
answer threads. Otherwise, you can reach out to us via your social media
|
|
|
|
platform of choice:
|
|
|
|
|
|
|
|
* Mike Griese, Senior Developer: [@zadjii@mastodon.social](https://mastodon.social/@zadjii)
|
|
|
|
* Jordi Adoumie, Product Manager: [@joadoumie](https://twitter.com/joadoumie)
|
|
|
|
* Dustin Howett, Engineering Lead: [@dhowett@mas.to](https://mas.to/@DHowett)
|
|
|
|
* Clint Rutkas, Lead Product Manager: [@crutkas](https://twitter.com/clintrutkas)
|
|
|
|
|
|
|
|
## Code of Conduct
|
|
|
|
|
|
|
|
This project has adopted the [Microsoft Open Source Code of
|
|
|
|
Conduct][conduct-code]. For more information see the [Code of Conduct
|
|
|
|
FAQ][conduct-FAQ] or contact [opencode@microsoft.com][conduct-email] with any
|
|
|
|
additional questions or comments.
|
|
|
|
|
|
|
|
[conduct-code]: https://opensource.microsoft.com/codeofconduct/
|
|
|
|
[conduct-FAQ]: https://opensource.microsoft.com/codeofconduct/faq/
|
|
|
|
[conduct-email]: mailto:opencode@microsoft.com
|
|
|
|
[`sudo.ps1`]: ./scripts/sudo.ps1
|
2024-02-10 01:22:23 +08:00
|
|
|
[discussions]: https://github.com/microsoft/sudo/discussions
|
|
|
|
[sudo-for-windows]: https://aka.ms/sudo
|
|
|
|
[sudo-docs]: https://aka.ms/sudo-docs
|
|
|
|
[documentation-repo]: https://github.com/MicrosoftDocs/windows-dev-docs/tree/docs/hub/sudo
|