2016-07-27 23:47:03 +02:00
![logo][] PowerShell
====================
2015-07-02 00:06:29 +02:00
2016-08-17 19:29:14 +02:00
Welcome to the PowerShell GitHub Commmunity!
PowerShell is a cross-platform (Windows, Linux and OS X) 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.
2016-07-27 23:47:03 +02:00
[logo]: assets/Powershell_64.png
2016-03-31 00:13:29 +02:00
2016-06-24 20:18:01 +02:00
New to PowerShell?
------------------
2016-03-31 00:13:29 +02:00
2016-07-27 23:47:03 +02:00
If you are new to PowerShell and would like to learn more, we recommend reviewing the [getting started][] documentation.
2016-01-22 20:36:23 +01:00
2016-07-27 23:47:03 +02:00
[getting started]: docs/learning-powershell
2016-03-30 21:06:57 +02:00
2016-03-31 00:13:29 +02:00
Get PowerShell
--------------
2016-07-27 23:47:03 +02:00
You can download and install a PowerShell package for any of the following platforms.
2016-08-18 00:41:53 +02:00
| Platform | Downloads | How to Install |
|------------------------------|----------------------|-----------------------------|
| Windows 10 / Server 2016 | [.msi][rl-windows10] | [Instructions][in-windows] |
| Windows 8.1 / Server 2012 R2 | [.msi][rl-windows81] | [Instructions][in-windows] |
| Ubuntu 16.04 | [.deb][rl-ubuntu16] | [Instructions][in-ubuntu16] |
| Ubuntu 14.04 | [.deb][rl-ubuntu14] | [Instructions][in-ubuntu14] |
| CentOS 7 | [.rpm][rl-centos] | [Instructions][in-centos] |
| OS X 10.11 | [.pkg][rl-osx] | [Instructions][in-osx] |
2016-08-16 04:02:27 +02:00
[rl-windows10]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.9/PowerShell_6.0.0.9-alpha.9-win10-x64.msi
[rl-windows81]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.9/PowerShell_6.0.0.9-alpha.9-win81-x64.msi
2016-08-16 23:15:05 +02:00
[rl-ubuntu16]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.9/powershell_6.0.0-alpha.9-1ubuntu1.16.04.1_amd64.deb
[rl-ubuntu14]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.9/powershell_6.0.0-alpha.9-1ubuntu1.14.04.1_amd64.deb
[rl-centos]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.9/powershell-6.0.0_alpha.9-1.el7.centos.x86_64.rpm
2016-08-17 22:57:37 +02:00
[rl-osx]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.9/powershell-6.0.0-alpha.9.pkg
2016-07-27 23:47:03 +02:00
[installation]: docs/installation
[in-windows]: docs/installation/windows.md#msi
2016-08-12 01:55:04 +02:00
[in-ubuntu14]: docs/installation/linux.md#ubuntu-1404
[in-ubuntu16]: docs/installation/linux.md#ubuntu-1604
2016-07-27 23:47:03 +02:00
[in-centos]: docs/installation/linux.md#centos-7
[in-osx]: docs/installation/linux.md#os-x-1011
2016-06-24 20:18:01 +02:00
2016-08-05 23:10:42 +02:00
To install a specific version, visit [releases ](https://github.com/PowerShell/PowerShell/releases ).
2016-07-14 00:59:08 +02:00
2016-07-27 23:47:03 +02:00
Building the Repository
-----------------------
| Linux | Windows | OS X |
|--------------------------|----------------------------|------------------------|
| [Instructions][bd-linux] | [Instructions][bd-windows] | [Instructions][bd-osx] |
2016-07-28 21:45:31 +02:00
If you have any problems building, please consult the developer [FAQ][].
### Build status of master branches
| AppVeyor (Windows) | Travis CI (Linux / OS X) |
|--------------------------|--------------------------|
| [![av-image][]][av-site] | [![tv-image][]][tv-site] |
2016-07-27 23:47:03 +02:00
[bd-linux]: docs/building/linux.md
[bd-windows]: docs/building/windows-core.md
[bd-osx]: docs/building/osx.md
2016-01-21 21:25:48 +01:00
2016-07-28 21:45:31 +02:00
[FAQ]: docs/FAQ.md
[tv-image]: https://travis-ci.com/PowerShell/PowerShell.svg?token=31YifM4jfyVpBmEGitCm& branch=master
[tv-site]: https://travis-ci.com/PowerShell/PowerShell/branches
[av-image]: https://ci.appveyor.com/api/projects/status/jtefab3hpngtyesp/branch/master?svg=true
[av-site]: https://ci.appveyor.com/project/PowerShell/powershell/branch/master
2016-07-21 02:09:41 +02:00
Downloading the Source Code
2016-07-27 23:47:03 +02:00
---------------------------
2016-07-21 02:09:41 +02:00
The PowerShell repository has a number of other repositories embedded as submodules.
2016-07-27 23:47:03 +02:00
2016-08-11 07:52:53 +02:00
To make things easy, you can just clone recursively:
2016-07-21 02:09:41 +02:00
```sh
git clone --recursive https://github.com/PowerShell/PowerShell.git
```
2016-07-21 02:23:06 +02:00
If you already cloned but forgot to use `--recursive` , you can update submodules manually:
2016-07-27 23:47:03 +02:00
2016-07-21 02:23:06 +02:00
```sh
2016-07-27 23:47:03 +02:00
git submodule update --init
2016-07-21 02:23:06 +02:00
```
2016-07-27 23:47:03 +02:00
2016-07-27 23:51:18 +02:00
See [working with the PowerShell repository ](docs/git ) for more information.
2016-07-27 23:47:03 +02:00
2016-07-20 00:18:10 +02:00
Developing and Contributing
--------------------------
2016-07-20 20:18:28 +02:00
2016-07-27 23:47:03 +02:00
Please see the [Contribution Guide][] for how to develop and contribute.
2016-04-13 01:16:17 +02:00
2016-07-27 23:47:03 +02:00
If you have any problems, please consult the [known issues][], developer [FAQ][], and [GitHub issues][].
If you do not see your problem captured, please file a [new issue][] and follow the provided template.
2016-06-23 17:21:07 +02:00
2016-07-27 23:47:03 +02:00
[Contribution Guide]: .github/CONTRIBUTING.md
[known issues]: docs/KNOWNISSUES.md
[GitHub issues]: https://github.com/PowerShell/PowerShell/issues
[new issue]:https://github.com/PowerShell/PowerShell/issues/new
2016-06-24 19:47:46 +02:00
2016-07-29 23:10:26 +02:00
Legal and Licensing
-------------------
PowerShell is licensed under the [MIT license][].
[MIT license]: LICENSE.txt
2016-08-12 22:27:04 +02:00
Governance
-------------------
Governance policy for PowerShell project is described [here][].
[here]: https://github.com/PowerShell/PowerShell/blob/master/docs/community/governance.md
2016-06-24 19:47:46 +02:00
Code of Conduct
---------------
2016-07-21 02:09:41 +02:00
This project has adopted the [Microsoft Open Source Code of Conduct][conduct-code].
2016-07-27 23:47:03 +02:00
For more information see the [Code of Conduct FAQ][conduct-FAQ] or contact [opencode@microsoft.com][conduct-email] with any additional questions or comments.
2016-06-24 19:47:46 +02:00
[conduct-code]: http://opensource.microsoft.com/codeofconduct/
2016-07-20 00:18:55 +02:00
[conduct-FAQ]: http://opensource.microsoft.com/codeofconduct/faq/
2016-07-27 23:47:03 +02:00
[conduct-email]: mailto:opencode@microsoft.com