The Wayback Machine - https://web.archive.org/web/20190322175455/https://github.com/PowerShell/PowerShell
Skip to content
Please note that GitHub no longer supports Internet Explorer.

We recommend upgrading to the latest Microsoft Edge, Google Chrome, or Firefox.

Learn more

/PowerShell

PowerShell for every system!
powershell windows macos linux command-line shell netcore
  1. C# 87.5%
  2. PowerShell 11.6%
  3. Roff 0.6%
  4. Shell 0.1%
  5. Dockerfile 0.1%
  6. HTML 0.1%
Branch: master
Find File
Clone or download

Clone with HTTPS

Use Git or checkout with SVN using the web URL.

Open in Desktop Download ZIP

Launching GitHub Desktop...

If nothing happens, download GitHub Desktop and try again.

Launching GitHub Desktop...

If nothing happens, download GitHub Desktop and try again.

Launching Xcode...

If nothing happens, download Xcode and try again.

Launching Visual Studio...

If nothing happens, download the GitHub extension for Visual Studio and try again.

@SteveL-MSFT @TravisEz13
SteveL-MSFT and TravisEz13 Update to new format for PoshChan settings and allow all users access… 
… to reminders (#9198)


PoshChan has been updated to use a new settings format so that authorized users are per action vs being global. 

## PR Context

Since reminders don't incur much of a resource hit for PoshChan, there's no reason not to allow everyone to use it.  See https://github.com/SteveL-MSFT/PoshChan-Bot for use instructions.
Latest commit c94f8c0 Mar 22, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Update link to Contributing guide to new PowerShell-Doc repo (#9090) Mar 12, 2019
.poshchan Update to new format for PoshChan settings and allow all users access… Mar 22, 2019
.vscode Fix duplicate recommendation of Azure DevOps extension for VS Code (#… Mar 3, 2019
.vsts-ci Disable Homebrew analytics in macOS VSTS builds (#9130) Mar 16, 2019
assets Build(deps): Bump PowerShellGet from 2.1.0 to 2.1.2 in /src/Modules (#… Mar 15, 2019
demos Fix broken python method (#8821) Feb 5, 2019
docker Delete Docker manifest creation script (#9076) Mar 11, 2019
docs Fix Enter-PSHostProcess tests flakiness (#9007) Mar 11, 2019
src Refactor ReadConsole P/Invoke in ConsoleHost (#9165) Mar 22, 2019
test Add tests for command globbing (#9180) Mar 21, 2019
tools Performance improvements for release build (#9179) Mar 21, 2019
.editorconfig Remove 'en-us' from docs.microsoft.com URL (#8628) Jan 11, 2019
.gitattributes Add VSTS CI for Windows (#7536) Aug 18, 2018
.gitignore [feature] Add -CustomPipeName to `pwsh` and `Enter-PSHostProcess` (#8889 Feb 22, 2019
.markdownlint.json Update CHANGELOG.md for 'v6.0.0-beta.1' release (#3736) May 9, 2017
.spelling Merged PR 7283: RC.1 change log Feb 28, 2019
CHANGELOG.md Merged PR 7298: Update Change log Mar 4, 2019
CODE_OF_CONDUCT.md Promote https (#8160) Nov 1, 2018
LICENSE.txt Use standard MIT license Jan 10, 2019
PowerShell.Common.props Port DotNet fixes from 6.1.3 (#8914) Feb 19, 2019
PowerShell.sln Update path of test\xUnit\xUnit.tests.csproj in PowerShell.sln (#8730) Jan 24, 2019
README.md README.md (#9045) Mar 11, 2019
Settings.StyleCop Disable some StyleCop rules (#6986) Jun 5, 2018
ThirdPartyNotices.txt Use https in URLs where available (#8622) Jan 24, 2019
build.psm1 Translate Skipped the test results into something Azure DevOps does N… Mar 20, 2019
codecov.yml Make OpenCover merge and upload more reliable/usable (#3078) Feb 1, 2017
global.json Port DotNet fixes from 6.1.3 (#8914) Feb 19, 2019
nuget.config Restore modules from the NuGet package cache by using dotnet restore (#… Feb 27, 2018
stylecop.json Add Settings.StyleCop file (#6930) Jun 4, 2018

README.md

logo PowerShell

Welcome to the PowerShell GitHub Community! PowerShell Core is a cross-platform (Windows, Linux, and macOS) automation and configuration tool/framework that works well with your existing tools and is optimized for dealing with structured data (e.g. JSON, CSV, XML, etc.), REST APIs, and object models. It includes a command-line shell, an associated scripting language and a framework for processing cmdlets.

Windows PowerShell vs. PowerShell Core

Although this repository started as a fork of the Windows PowerShell code base, changes made in this repository do not make their way back to Windows PowerShell 5.1 automatically. This also means that issues tracked here are only for PowerShell Core 6. Windows PowerShell specific issues should be opened on UserVoice.

New to PowerShell?

If you are new to PowerShell and would like to learn more, we recommend reviewing the getting started documentation.

Get PowerShell

You can download and install a PowerShell package for any of the following platforms.

Supported Platform Downloads (stable) Downloads (preview) How to Install
Windows (x64) .msi .msi Instructions
Windows (x86) .msi .msi Instructions
Ubuntu 18.04 .deb .deb Instructions
Ubuntu 16.04 .deb .deb Instructions
Ubuntu 14.04 .deb .deb Instructions
Debian 9 .deb .deb Instructions
CentOS 7 .rpm .rpm Instructions
Red Hat Enterprise Linux 7 .rpm .rpm Instructions
openSUSE 42.3 .rpm .rpm Instructions
Fedora 27, Fedora 28 .rpm .rpm Instructions
macOS 10.12+ .pkg .pkg Instructions
Docker Instructions

You can download and install a PowerShell package for any of the following platforms, which are supported by the community.

Platform Downloads (stable) Downloads (preview) How to Install
Arch Linux Instructions
Kali Linux .deb .deb Instructions
Many Linux distributions Snapcraft Snapcraft

You can also download the PowerShell binary archives for Windows, macOS and Linux.

Platform Downloads (stable) Downloads (preview) How to Install
Windows 32-bit/64-bit 32-bit/64-bit Instructions
macOS 64-bit 64-bit Instructions
Linux 64-bit 64-bit Instructions
Windows (arm) Experimental 32-bit/64-bit 32-bit/64-bit Instructions
Raspbian (Stretch) Experimental .tgz 32-bit/64-bit Instructions

To install a specific version, visit releases.

Community Dashboard

Dashboard with visualizations for community contributions and project status using PowerShell, Azure, and PowerBI.

For more information on how and why we built this dashboard, check out this blog post.

Chat Room

Want to chat with other members of the PowerShell community?

We have a Gitter Room which you can join below.

Join the chat at https://gitter.im/PowerShell/PowerShell

There is also the community driven PowerShell Slack Team which you can sign up for at Slack.

Add-ons and libraries

Awesome PowerShell has a great curated list of add-ons and resources.

Building the Repository

Linux Windows macOS
Instructions Instructions Instructions

If you have any problems building, please consult the developer FAQ.

Build status of nightly builds

Azure CI (Windows) Azure CI (Linux) Azure CI (macOS) Code Coverage Status CodeFactor Grade
windows-nightly-image linux-nightly-image macOS-nightly-image cc-image cf-image

Downloading the Source Code

You can just clone the repository:

git clone https://github.com/PowerShell/PowerShell.git

See working with the PowerShell repository for more information.

Developing and Contributing

Please see the Contribution Guide for how to develop and contribute. If you are developing .NET Core C# applications targeting PowerShell Core, please check out our FAQ to learn more about the PowerShell SDK NuGet package.

Also, make sure to check out our PowerShell-RFC repository for request-for-comments (RFC) documents to submit and give comments on proposed and future designs.

Support

For support, please see the Support Section.

Legal and Licensing

PowerShell is licensed under the MIT license.

Windows Docker Files and Images

License: By requesting and using the Container OS Image for Windows containers, you acknowledge, understand, and consent to the Supplemental License Terms available on Docker Hub:

Telemetry

By default, PowerShell collects the OS description and the version of PowerShell (equivalent to $PSVersionTable.OS and $PSVersionTable.GitCommitId) using Application Insights. To opt-out of sending telemetry, create an environment variable called POWERSHELL_TELEMETRY_OPTOUT set to a value of 1 before starting PowerShell from the installed location. The telemetry we collect fall under the Microsoft Privacy Statement.

Governance

Governance policy for PowerShell project is described here.

Code of Conduct

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.

You can’t perform that action at this time.