Skip to content

Commit 6ab3944

Browse files
TravisEz13Sean Wheeler
authored and
Sean Wheeler
committed
Add instructions to install preview releases (#2617)
* Add instructions to install preview releases * Address PR comments * Reformatting notes
1 parent dde1d1f commit 6ab3944

File tree

1 file changed

+54
-22
lines changed

1 file changed

+54
-22
lines changed

reference/docs-conceptual/setup/Installing-PowerShell-Core-on-Linux.md

Lines changed: 54 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,22 @@ Once the package is installed, run `pwsh` from a terminal.
2525
[lai]: #linux-appimage
2626
[tar]: #binary-archives
2727

28+
## Installing Preview Releases
29+
30+
When installing a PowerShell Core Preview release for Linux via a Package Repository,
31+
the package name changes from `powershell` to `powershell-preview`.
32+
33+
Installing via direct download does not change, other than the file name.
34+
35+
Here is a table of the commands to install the stable and preview packages using the various package managers:
36+
37+
|Distrobution(s)|Stable Command | Preview Command |
38+
|---------------|---------------|-----------------|
39+
| Ubuntu, Debian |`sudo apt-get install -y powershell`| `sudo apt-get install -y powershell-preview`|
40+
| CentOS, RedHat |`sudo yum install -y powershell` | `sudo yum install -y powershell-preview`|
41+
| OpenSUSE |`sudo zypper install powershell` | `sudo zypper install powershell-preview`|
42+
| Fedora |`sudo dnf install -y powershell` | `sudo dnf install -y powershell-preview`|
43+
2844
## Ubuntu 14.04
2945

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

68-
> Please note that `dpkg -i` will fail with unmet dependencies;
69-
> the next command, `apt-get install -f` resolves these
70-
> and then finishes configuring the PowerShell package.
84+
> [!NOTE]
85+
> The `dpkg -i` command fails with unmet dependencies.
86+
> The next command, `apt-get install -f` resolves these issues
87+
> then finishes configuring the PowerShell package.
7188
7289
### Uninstallation - Ubuntu 14.04
7390

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

118-
> Please note that `dpkg -i` will fail with unmet dependencies;
119-
> the next command, `apt-get install -f` resolves these
120-
> and then finishes configuring the PowerShell package.
135+
> [!NOTE]
136+
> The `dpkg -i` command fails with unmet dependencies.
137+
> The next command, `apt-get install -f` resolves these issues
138+
> then finishes configuring the PowerShell package.
121139
122140
### Uninstallation - Ubuntu 16.04
123141

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

128146
## Ubuntu 17.10
129147

130-
> Note: Support for Ubuntu 18.04 was added after `6.1.0-preview.2`
148+
> [!NOTE]
149+
> Support for Ubuntu 17.04 was added after `6.1.0-preview.2`
131150
132151
### Installation via Package Repository - Ubuntu 17.10
133152

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

170-
> Please note that `dpkg -i` will fail with unmet dependencies;
171-
> the next command, `apt-get install -f` resolves these
172-
> and then finishes configuring the PowerShell package.
189+
> [!NOTE]
190+
> The `dpkg -i` command fails with unmet dependencies.
191+
> The next command, `apt-get install -f` resolves these issues
192+
> then finishes configuring the PowerShell package.
173193
174194
### Uninstallation - Ubuntu 17.10
175195

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

180200
## Ubuntu 18.04
181201

182-
> Note: Support for Ubuntu 18.04 was added after `6.1.0-preview.2`
202+
> [!NOTE]
203+
> Support for Ubuntu 18.04 was added after `6.1.0-preview.2`
183204
184205
### Installation via Package Repository - Ubuntu 18.04
185206

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

222-
> Please note that `dpkg -i` will fail with unmet dependencies;
223-
> the next command, `apt-get install -f` resolves these
224-
> and then finishes configuring the PowerShell package.
243+
> [!NOTE]
244+
> The `dpkg -i` command fails with unmet dependencies.
245+
> The next command, `apt-get install -f` resolves these issues
246+
> then finishes configuring the PowerShell package.
225247
226248
### Uninstallation - Ubuntu 17.10
227249

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

276298
> [!NOTE]
277-
> Please note that `dpkg -i` will fail with unmet dependencies.
278-
> The next command, `apt-get install -f` resolves these
279-
> and then finishes configuring the PowerShell package.
299+
> The `dpkg -i` command fails with unmet dependencies.
300+
> The next command, `apt-get install -f` resolves these issues
301+
> then finishes configuring the PowerShell package.
280302
281303
### Uninstallation - Debian 8
282304

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

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

336355
### Uninstallation - Debian 9
337356

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

499518
## Fedora
500519

501-
> Please note, Fedora 28 is only supported in PowerShell Core 6.1 and newer.
520+
> [!NOTE]
521+
> Fedora 28 is only supported in PowerShell Core 6.1 and newer.
502522
503523
### Installation via Package Repository (preferred) - Fedora 27, Fedora 28
504524

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

553573
## Arch Linux
554574

575+
> [!NOTE]
576+
> Arch support is experimental.
577+
555578
PowerShell is available from the [Arch Linux][] User Repository (AUR).
556579

557580
* 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
569592

570593
## Linux AppImage
571594

595+
> [!NOTE]
596+
> AppImage support is experimental
597+
572598
Using a recent Linux distribution,
573599
download the AppImage `powershell-6.0.1-x86_64.AppImage`
574600
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
589615

590616
## Kali
591617

618+
> [!NOTE]
619+
> Kali support is experimental.
620+
592621
### Installation
593622

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

626655
## Raspbian
627656

657+
> [!NOTE]
658+
> Raspbian support is experimental.
659+
628660
Currently, PowerShell is only supported on Raspbian Stretch.
629661

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

0 commit comments

Comments
 (0)