114 lines
4.4 KiB
Markdown
114 lines
4.4 KiB
Markdown
![logo][] PowerShell
|
|
====================
|
|
|
|
Welcome to the PowerShell GitHub Commmunity! PowerShell is an automation and configuration management platform.
|
|
It consists of a cross-platform (Windows, Linux and OS X) command-line shell and associated scripting language.
|
|
|
|
[logo]: assets/Powershell_64.png
|
|
|
|
New to PowerShell?
|
|
------------------
|
|
|
|
If you are new to PowerShell and would like to learn more, we recommend reviewing the [getting started][] documentation.
|
|
|
|
[getting started]: docs/learning-powershell
|
|
|
|
Get PowerShell
|
|
--------------
|
|
|
|
You can download and install a PowerShell package for any of the following platforms.
|
|
|
|
| Platform | Releases | How to Install |
|
|
|--------------|--------------------|--------------------------------|
|
|
| Windows | [.msi][rl-windows] | [Instructions][in-windows] |
|
|
| Ubuntu 14.04 | [.deb][rl-ubuntu] | [Instructions][in-ubuntu] |
|
|
| CentOS 7 | [.rpm][rl-centos] | [Instructions][in-centos] |
|
|
| OS X 10.11 | [.pkg][rl-osx] | [Instructions][in-osx] |
|
|
|
|
[rl-windows]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.7/PowerShell_6.0.0.7.msi
|
|
[rl-ubuntu]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.7/powershell_6.0.0-alpha.7-1_amd64.deb
|
|
[rl-centos]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.7/powershell-6.0.0_alpha.7-1.x86_64.rpm
|
|
[rl-osx]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.7/powershell-6.0.0-alpha.7.pkg
|
|
|
|
[installation]: docs/installation
|
|
[in-windows]: docs/installation/windows.md#msi
|
|
[in-ubuntu]: docs/installation/linux.md#ubuntu-1404
|
|
[in-centos]: docs/installation/linux.md#centos-7
|
|
[in-osx]: docs/installation/linux.md#os-x-1011
|
|
|
|
To install a specific version, visit [releases](https://github.com/PowerShell/PowerShell/releases).
|
|
|
|
Building the Repository
|
|
-----------------------
|
|
|
|
| Linux | Windows | OS X |
|
|
|--------------------------|----------------------------|------------------------|
|
|
| [Instructions][bd-linux] | [Instructions][bd-windows] | [Instructions][bd-osx] |
|
|
|
|
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] |
|
|
|
|
[bd-linux]: docs/building/linux.md
|
|
[bd-windows]: docs/building/windows-core.md
|
|
[bd-osx]: docs/building/osx.md
|
|
|
|
[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
|
|
|
|
Downloading the Source Code
|
|
---------------------------
|
|
|
|
The PowerShell repository has a number of other repositories embedded as submodules.
|
|
|
|
To make things easy, we can just clone recursively:
|
|
|
|
```sh
|
|
git clone --recursive https://github.com/PowerShell/PowerShell.git
|
|
```
|
|
|
|
If you already cloned but forgot to use `--recursive`, you can update submodules manually:
|
|
|
|
```sh
|
|
git submodule update --init
|
|
```
|
|
|
|
See [working with the PowerShell repository](docs/git) for more information.
|
|
|
|
Developing and Contributing
|
|
--------------------------
|
|
|
|
Please see the [Contribution Guide][] for how to develop and contribute.
|
|
|
|
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.
|
|
|
|
[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
|
|
|
|
Legal and Licensing
|
|
-------------------
|
|
|
|
PowerShell is licensed under the [MIT license][].
|
|
|
|
[MIT license]: LICENSE.txt
|
|
|
|
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]: http://opensource.microsoft.com/codeofconduct/
|
|
[conduct-FAQ]: http://opensource.microsoft.com/codeofconduct/faq/
|
|
[conduct-email]: mailto:opencode@microsoft.com
|