81 lines
3.2 KiB
Markdown
81 lines
3.2 KiB
Markdown
PowerShell
|
|
==========
|
|
|
|
This repository is "Project Magrathea": Open PowerShell on GitHub, for
|
|
Linux, Windows (.NET Core and Full), and OS X. It is built using the
|
|
[.NET Command Line Interface][dotnet-cli] to support targetting every
|
|
flavor of PowerShell. It is a collaborative effort among many teams:
|
|
|
|
- Full PowerShell
|
|
- Core PowerShell
|
|
- Open Source Technology Center
|
|
- .NET Foundation
|
|
|
|
[dotnet-cli]: https://github.com/dotnet/cli
|
|
|
|
Build Status
|
|
------------
|
|
|
|
| Platform | `master` |
|
|
|--------------|----------|
|
|
| Ubuntu 14.04 | [![Build Status](https://travis-ci.com/PowerShell/PowerShell.svg?token=31YifM4jfyVpBmEGitCm&branch=master)](https://travis-ci.com/PowerShell/PowerShell) |
|
|
| OS X 10.11 | [![Build Status](https://travis-ci.com/PowerShell/PowerShell.svg?token=31YifM4jfyVpBmEGitCm&branch=master)](https://travis-ci.com/PowerShell/PowerShell) |
|
|
| Windows | [![Build status](https://ci.appveyor.com/api/projects/status/jtefab3hpngtyesp/branch/master?svg=true)](https://ci.appveyor.com/project/PowerShell/powershell/branch/master) |
|
|
|
|
Get PowerShell
|
|
--------------
|
|
|
|
| | Linux | Windows .NET Core | Windows .NET Full | OS X | PSRP |
|
|
|-----------------------|-------|-------------------|-------------------|------|------|
|
|
| Build from **Source** | [Instructions](docs/building/linux.md) | [Instructions](docs/building/windows-core.md) | [Instructions](docs/building/windows-full.md) | [Instructions](docs/building/osx.md) | [Instructions][psrp] |
|
|
| Get **Binaries** | [Releases][] | [Artifacts][] | [Artifacts][] | [Releases][] | TBD |
|
|
|
|
Building summary: `Start-PSBuild` from the module
|
|
`./build.psm1` (self-host on Linux / OS X)
|
|
|
|
See [Linux releases](docs/installation/linux.md) and
|
|
[Windows artifacts](docs/installation/windows.md) installation
|
|
instructions.
|
|
|
|
[releases]: https://github.com/PowerShell/PowerShell/releases
|
|
[artifacts]: https://ci.appveyor.com/project/PowerShell/powershell-linux/build/artifacts
|
|
[psrp]: https://github.com/PowerShell/psl-omi-provider
|
|
|
|
Team coordination
|
|
-----------------
|
|
|
|
- [PSCore Slack chat](https://pscore.slack.com/)
|
|
- [Waffle.io scrum board](https://waffle.io/PowerShell/PowerShell)
|
|
- [VSO items](https://aka.ms/openps)
|
|
- [PowerShell subsystem maintainers](https://aka.ms/psowners)
|
|
- [Automation Sharepoint](https://aka.ms/pscore)
|
|
- [Internal Open PowerShell Documents](https://github.com/PowerShell/Internal-PowerShellTeam-Tools/tree/master/OpenPowerShellDocs)
|
|
|
|
If you encounter any problems, see the [known issues](KNOWNISSUES.md),
|
|
search the [issues][], and if all else fails, open a new issue.
|
|
|
|
[issues]: https://github.com/PowerShell/PowerShell/issues
|
|
|
|
Obtain the source code
|
|
----------------------
|
|
|
|
### Setup Git
|
|
|
|
Install [Git][], the version control system.
|
|
|
|
See the [Contributing Guidelines](.github/CONTRIBUTING.md) for more Git
|
|
information, such as our installation instructions, contributing
|
|
rules, and Git best practices.
|
|
|
|
[Git]: https://git-scm.com/documentation
|
|
|
|
### Download source code
|
|
|
|
Clone this repository. It is a "superproject" and has a number of
|
|
other repositories embedded within it as submodules. *Please* see the
|
|
contributing guidelines and learn about submodules. To make things
|
|
easy, we can just clone recursively.
|
|
|
|
```sh
|
|
git clone --recursive https://github.com/PowerShell/PowerShell.git
|
|
```
|