Skip to content

Add instructions to install preview releases #2617

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Jun 26, 2018
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -25,6 +25,22 @@ Once the package is installed, run `pwsh` from a terminal.
[lai]: #linux-appimage
[tar]: #binary-archives

## Installing Preview Releases

When installing a PowerShell Core Preview release for Linux via a Package Repository,
the package name changes from `powershell` to `powershell-preview`.

Installing via direct download does not change, other than the file name.

Here is a table of the commands to install the stable and preview packages using the various package managers:

|Distrobution(s)|Stable Command | Preview Command |
|---------------|---------------|-----------------|
| Ubuntu, Debian |`sudo apt-get install -y powershell`| `sudo apt-get install -y powershell-preview`|
| CentOS, RedHat |`sudo yum install -y powershell` | `sudo yum install -y powershell-preview`|
| OpenSUSE |`sudo zypper install powershell` | `sudo zypper install powershell-preview`|
| Fedora |`sudo dnf install -y powershell` | `sudo dnf install -y powershell-preview`|

## Ubuntu 14.04

### Installation via Package Repository - Ubuntu 14.04
@@ -65,9 +81,10 @@ sudo dpkg -i powershell_6.0.2-1.ubuntu.14.04_amd64.deb
sudo apt-get install -f
```

> Please note that `dpkg -i` will fail with unmet dependencies;
> the next command, `apt-get install -f` resolves these
> and then finishes configuring the PowerShell package.
> [!NOTE]
> The `dpkg -i` command fails with unmet dependencies.
> The next command, `apt-get install -f` resolves these issues
> then finishes configuring the PowerShell package.

### Uninstallation - Ubuntu 14.04

@@ -115,9 +132,10 @@ sudo dpkg -i powershell_6.0.2-1.ubuntu.16.04_amd64.deb
sudo apt-get install -f
```

> Please note that `dpkg -i` will fail with unmet dependencies;
> the next command, `apt-get install -f` resolves these
> and then finishes configuring the PowerShell package.
> [!NOTE]
> The `dpkg -i` command fails with unmet dependencies.
> The next command, `apt-get install -f` resolves these issues
> then finishes configuring the PowerShell package.

### Uninstallation - Ubuntu 16.04

@@ -127,7 +145,8 @@ sudo apt-get remove powershell

## Ubuntu 17.10

> Note: Support for Ubuntu 18.04 was added after `6.1.0-preview.2`
> [!NOTE]
> Support for Ubuntu 17.04 was added after `6.1.0-preview.2`

### Installation via Package Repository - Ubuntu 17.10

@@ -167,9 +186,10 @@ sudo dpkg -i powershell_6.0.2-1.ubuntu.17.10_amd64.deb
sudo apt-get install -f
```

> Please note that `dpkg -i` will fail with unmet dependencies;
> the next command, `apt-get install -f` resolves these
> and then finishes configuring the PowerShell package.
> [!NOTE]
> The `dpkg -i` command fails with unmet dependencies.
> The next command, `apt-get install -f` resolves these issues
> then finishes configuring the PowerShell package.

### Uninstallation - Ubuntu 17.10

@@ -179,7 +199,8 @@ sudo apt-get remove powershell

## Ubuntu 18.04

> Note: Support for Ubuntu 18.04 was added after `6.1.0-preview.2`
> [!NOTE]
> Support for Ubuntu 18.04 was added after `6.1.0-preview.2`

### Installation via Package Repository - Ubuntu 18.04

@@ -219,9 +240,10 @@ sudo dpkg -i powershell_6.1.0-preview.3-1.ubuntu.18.04_amd64.deb
sudo apt-get install -f
```

> Please note that `dpkg -i` will fail with unmet dependencies;
> the next command, `apt-get install -f` resolves these
> and then finishes configuring the PowerShell package.
> [!NOTE]
> The `dpkg -i` command fails with unmet dependencies.
> The next command, `apt-get install -f` resolves these issues
> then finishes configuring the PowerShell package.

### Uninstallation - Ubuntu 17.10

@@ -274,9 +296,9 @@ sudo apt-get install -f
```

> [!NOTE]
> Please note that `dpkg -i` will fail with unmet dependencies.
> The next command, `apt-get install -f` resolves these
> and then finishes configuring the PowerShell package.
> The `dpkg -i` command fails with unmet dependencies.
> The next command, `apt-get install -f` resolves these issues
> then finishes configuring the PowerShell package.

### Uninstallation - Debian 8

@@ -328,10 +350,7 @@ sudo dpkg -i powershell_6.0.2-1.debian.9_amd64.deb
sudo apt-get install -f
```

> [!NOTE]
> Please note that `dpkg -i` will fail with unmet dependencies.
> The next command, `apt-get install -f` resolves these
> and then finishes configuring the PowerShell package.


### Uninstallation - Debian 9

@@ -498,7 +517,8 @@ sudo zypper remove powershell

## Fedora

> Please note, Fedora 28 is only supported in PowerShell Core 6.1 and newer.
> [!NOTE]
> Fedora 28 is only supported in PowerShell Core 6.1 and newer.

### Installation via Package Repository (preferred) - Fedora 27, Fedora 28

@@ -552,6 +572,9 @@ sudo dnf remove powershell

## Arch Linux

> [!NOTE]
> Arch support is experimental.

PowerShell is available from the [Arch Linux][] User Repository (AUR).

* It can be compiled with the [latest tagged release][arch-release]
@@ -569,6 +592,9 @@ For more information on installing packages from the AUR, see the [Arch Linux wi

## Linux AppImage

> [!NOTE]
> AppImage support is experimental

Using a recent Linux distribution,
download the AppImage `powershell-6.0.1-x86_64.AppImage`
from the [releases][] page onto the Linux machine.
@@ -589,6 +615,9 @@ This package is a single binary that works independently of the user's Linux di

## Kali

> [!NOTE]
> Kali support is experimental.

### Installation

```sh
@@ -625,6 +654,9 @@ sudo dpkg -r powershell_6.0.2-1.ubuntu.16.04_amd64.deb

## Raspbian

> [!NOTE]
> Raspbian support is experimental.

Currently, PowerShell is only supported on Raspbian Stretch.

Also CoreCLR (and thus PowerShell Core) will only work on Pi 2 and Pi 3 devices as other devices,