Skip to content

Latest commit

 

History

History
510 lines (351 loc) · 15.7 KB

linux.md

File metadata and controls

510 lines (351 loc) · 15.7 KB

Package installation instructions

Supports Ubuntu 14.04, Ubuntu 16.04, Debian 8, CentOS 7, Red Hat Enterprise Linux (RHEL) 7, Arch Linux, many Linux distributions (AppImage), and macOS 10.12. All packages are available on our GitHub releases page.

All of these steps can be done automatically by the download.sh script. You should never run a script without reading it first!

Please read the download script first, and then if you want to run it, use:

bash <(curl -fsSL https://raw.githubusercontent.com/PowerShell/PowerShell/master/tools/download.sh)

Once the package is installed, run powershell from a terminal.

Ubuntu 14.04

Installation via Package Repository - Ubuntu 14.04

PowerShell Core, for Linux, is published to package repositories for easy installation (and updates). This is the preferred method.

# Import the public repository GPG keys
curl https://packages.microsoft.com/keys/microsoft.asc | sudo apt-key add -

# Register the Microsoft Ubuntu repository
curl https://packages.microsoft.com/config/ubuntu/14.04/prod.list | sudo tee /etc/apt/sources.list.d/microsoft.list

# Update apt-get
sudo apt-get update

# Install PowerShell
sudo apt-get install -y powershell

# Start PowerShell
powershell

After registering the Microsoft repository once as superuser, from then on, you just need to use sudo apt-get upgrade powershell to update it.

Installation via Direct Download

Using Ubuntu 14.04, download the Debian package powershell_6.0.0-beta.7-1ubuntu1.14.04.1_amd64.deb from the releases page onto the Ubuntu machine.

Then execute the following in the terminal:

sudo dpkg -i powershell_6.0.0-beta.7-1ubuntu1.14.04.1_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.

Uninstallation - Ubuntu 14.04

sudo apt-get remove powershell

Ubuntu 16.04

Installation via Package Repository - Ubuntu 16.04

PowerShell Core, for Linux, is published to package repositories for easy installation (and updates). This is the preferred method.

# Import the public repository GPG keys
curl https://packages.microsoft.com/keys/microsoft.asc | sudo apt-key add -

# Register the Microsoft Ubuntu repository
curl https://packages.microsoft.com/config/ubuntu/16.04/prod.list | sudo tee /etc/apt/sources.list.d/microsoft.list

# Update apt-get
sudo apt-get update

# Install PowerShell
sudo apt-get install -y powershell

# Start PowerShell
powershell

After registering the Microsoft repository once as superuser, from then on, you just need to use sudo apt-get upgrade powershell to update it.

Installation via Direct Download - Ubuntu 16.04

Using Ubuntu 16.04, download the Debian package powershell_6.0.0-beta.7-1ubuntu1.16.04.1_amd64.deb from the releases page onto the Ubuntu machine.

Then execute the following in the terminal:

sudo dpkg -i powershell_6.0.0-beta.7-1ubuntu1.16.04.1_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.

Uninstallation - Ubuntu 16.04

sudo apt-get remove powershell

Debian 8

Installation via Package Repository - Debian 8

PowerShell Core, for Linux, is published to package repositories for easy installation (and updates). This is the preferred method. Note that these instructions are the same as for Ubuntu 14.04 as we have validated the same package works on Debian 8.

# Import the public repository GPG keys
curl https://packages.microsoft.com/keys/microsoft.asc | sudo apt-key add -

# Register the Microsoft repository
curl https://packages.microsoft.com/config/ubuntu/14.04/prod.list | sudo tee /etc/apt/sources.list.d/microsoft.list

# Update apt-get
sudo apt-get update

# Install PowerShell
sudo apt-get install -y powershell

# Start PowerShell
powershell

After registering the Microsoft repository once as superuser, from then on, you just need to use sudo apt-get upgrade powershell to update it.

Installation via Direct Download - Debian 8

Download the Debian package powershell_6.0.0-beta.7-1ubuntu1.14.04.1_amd64.deb from the releases page onto the Debian machine.

Then execute the following in the terminal:

sudo dpkg -i powershell_6.0.0-beta.7-1ubuntu1.14.04.1_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.

Uninstallation - Debian 8

sudo apt-get remove powershell

CentOS 7

This package also works on Oracle Linux 7.

Installation via Package Repository (preferred) - CentOS 7

PowerShell Core for Linux is published to official Microsoft repositories for easy installation (and updates).

# Register the Microsoft RedHat repository
curl https://packages.microsoft.com/config/rhel/7/prod.repo | sudo tee /etc/yum.repos.d/microsoft.repo

# Install PowerShell
sudo yum install -y powershell

# Start PowerShell
powershell

After registering the Microsoft repository once as superuser, you just need to use sudo yum update powershell to update PowerShell.

Installation via Direct Download - CentOS 7

Using CentOS 7, download the RPM package powershell-6.0.0_beta.7-1.el7.x86_64.rpm from the releases page onto the CentOS machine.

Then execute the following in the terminal:

sudo yum install ./powershell-6.0.0_beta.7-1.el7.x86_64.rpm

You can also install the RPM without the intermediate step of downloading it:

sudo yum install https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-beta.7/powershell-6.0.0_beta.7-1.el7.x86_64.rpm

Uninstallation - CentOS 7

sudo yum remove powershell

Red Hat Enterprise Linux (RHEL) 7

Installation via Package Repository (preferred) - Red Hat Enterprise Linux (RHEL) 7

PowerShell Core for Linux is published to official Microsoft repositories for easy installation (and updates).

# Register the Microsoft RedHat repository
curl https://packages.microsoft.com/config/rhel/7/prod.repo | sudo tee /etc/yum.repos.d/microsoft.repo

# Install PowerShell
sudo yum install -y powershell

# Start PowerShell
powershell

After registering the Microsoft repository once as superuser, you just need to use sudo yum update powershell to update PowerShell.

Installation via Direct Download - Red Hat Enterprise Linux (RHEL) 7

Download the RPM package powershell-6.0.0_beta.7-1.el7.x86_64.rpm from the releases page onto the Red Hat Enterprise Linux machine.

Then execute the following in the terminal:

sudo yum install ./powershell-6.0.0_beta.7-1.el7.x86_64.rpm

You can also install the RPM without the intermediate step of downloading it:

sudo yum install https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-beta.7/powershell-6.0.0_beta.7-1.el7.x86_64.rpm

Uninstallation - Red Hat Enterprise Linux (RHEL) 7

sudo yum remove powershell

OpenSUSE 42.1

Installation instruction for OpenSUSE 42.1.

Installation via Direct Download - OpenSUSE 42.1

Using OpenSUSE 42.1, download the RPM package powershell-6.0.0_beta.6-1.suse.42.1.x86_64.rpm from the releases page onto the OpenSUSE machine.

Then execute the following in the terminal:

sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
sudo zypper install ./powershell-6.0.0_beta.6-1.suse.42.1.x86_64.rpm

You can also install the RPM without the intermediate step of downloading it:

sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
sudo zypper install https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-beta.6/powershell-6.0.0_beta.6-1.suse.42.1.x86_64.rpm

Uninstallation - OpenSUSE 42.1

sudo zypper remove powershell

Arch Linux

PowerShell is available from the Arch Linux User Repository (AUR) as a release or the latest development build.

Packages in the AUR are community maintained - there is no official support.

For more information on installing packages from the AUR, see the Arch Linux wiki.

Linux AppImage

Using a recent Linux distribution, download the AppImage PowerShell-6.0.0-beta.7-x86_64.AppImage from the releases page onto the Linux machine.

Then execute the following in the terminal:

chmod a+x PowerShell-6.0.0-beta.7-x86_64.AppImage
./PowerShell-6.0.0-beta.7-x86_64.AppImage

The AppImage lets you run PowerShell without installing it. It is a portable application that bundles PowerShell and its dependencies (including .NET Core's system dependencies) into one cohesive package. This package works independently of the user's Linux distribution, and is a single binary.

macOS 10.12

Installation via Homebrew (preferred) - macOS 10.12

Homebrew is the missing package manager for macOS. If the brew command is not found, you need to install Homebrew following their instructions.

Once you've installed Homebrew, installing PowerShell is easy. First, install Homebrew-Cask, so you can install more packages:

brew tap caskroom/cask

Now, you can install PowerShell:

brew cask install powershell

When new versions of PowerShell are released, simply update Homebrew's formulae and upgrade PowerShell:

brew update
brew cask reinstall powershell

Note: because of this issue in Cask, you currently have to do a reinstall to upgrade.

Installation via Direct Download - macOS 10.12

Using macOS 10.12, download the PKG package powershell-6.0.0-beta.7-osx.10.12-x64.pkg from the releases page onto the macOS machine.

Either double-click the file and follow the prompts, or install it from the terminal:

sudo installer -pkg powershell-6.0.0-beta.7-osx.10.12-x64.pkg -target /

Uninstallation - macOS 10.12

If you installed PowerShell with Homebrew, uninstallation is easy:

brew cask uninstall powershell

If you installed PowerShell via direct download, PowerShell must be removed manually:

sudo rm -rf /usr/local/bin/powershell /usr/local/microsoft/powershell

To uninstall the additional PowerShell paths (such as the user profile path) please see the paths section below in this document and remove the desired the paths with sudo rm. (Note: this is not necessary if you installed with Homebrew.)

OpenSSL on macOS

On macOS, .NET Core requires Homebrew's OpenSSL because the "OpenSSL" system libraries on macOS are not OpenSSL, as Apple deprecated OpenSSL in favor of their own libraries. This requirement is not a hard requirement for all of PowerShell. However, most networking functions (such as Invoke-WebRequest) do require OpenSSL to work properly.

The PowerShell formula for Homebrew includes this OpenSSL as a dependency, so you if you installed via Homebrew, you shouldn't run into these problems.

If you installed via direct download (or through some means other than Homebrew), the easiest fix for these issues is to install Homebrew's OpenSSL:

brew install openssl
brew install curl --with-openssl

Please ignore .NET Core's installation instructions to manually link the OpenSSL libraries. This is not required for PowerShell as we patch .NET Core's cryptography libraries to find Homebrew's OpenSSL in its installed location. Again, do not run brew link --force nor ln -s for OpenSSL, regardless of other instructions.

Homebrew previously allowed OpenSSL libraries to be linked to the system library location; however, this created major security holes and is no longer allowed. Because .NET Core's 1.0.0 release libraries still look in the prior system location for OpenSSL, they will fail to work unless the libraries are manually placed there (security risk), or their libraries are patched (which we do). To patch .NET Core's cryptography libraries, we use install_name_tool:

find ~/.nuget -name System.Security.Cryptography.Native.dylib | xargs sudo install_name_tool -add_rpath /usr/local/opt/openssl/lib
find ~/.nuget -name System.Net.Http.Native.dylib | xargs sudo install_name_tool -change /usr/lib/libcurl.4.dylib /usr/local/opt/curl/lib/libcurl.4.dylib

This updates .NET Core's library to look in Homebrew's OpenSSL installation location instead of the system library location. The PowerShell macOS package come with the necessary libraries patched, and the build script patches the libraries on-the-fly when building from source. You can run this command manually if you're having trouble with .NET Core's cryptography libraries.

Kali

Installation

# Install prerequisites
apt-get install libunwind8 libicu55
wget http://security.debian.org/debian-security/pool/updates/main/o/openssl/libssl1.0.0_1.0.1t-1+deb8u6_amd64.deb
dpkg -i libssl1.0.0_1.0.1t-1+deb8u6_amd64.deb

# Install PowerShell
dpkg -i powershell_6.0.0-beta.7-1ubuntu1.16.04.1_amd64.deb

# Start PowerShell
powershell

Run PowerShell in latest Kali (Kali GNU/Linux Rolling) without installing it

# Grab the latest App Image
wget https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-beta.7/PowerShell-6.0.0-beta.7-x86_64.AppImage

# Make executable
chmod a+x PowerShell-6.0.0-beta.7-x86_64.AppImage

# Start PowerShell
./PowerShell-6.0.0-beta.7-x86_64.AppImage

Uninstallation - Kali

dpkg -r powershell_6.0.0-beta.7-1ubuntu1.16.04.1_amd64

Paths

  • $PSHOME is /opt/microsoft/powershell/6.0.0-beta.7/
  • User profiles will be read from ~/.config/powershell/profile.ps1
  • Default profiles will be read from $PSHOME/profile.ps1
  • User modules will be read from ~/.local/share/powershell/Modules
  • Shared modules will be read from /usr/local/share/powershell/Modules
  • Default modules will be read from $PSHOME/Modules
  • PSReadline history will be recorded to ~/.local/share/powershell/PSReadLine/ConsoleHost_history.txt

The profiles respect PowerShell's per-host configuration, so the default host-specific profiles exists at Microsoft.PowerShell_profile.ps1 in the same locations.

On Linux and macOS, the XDG Base Directory Specification is respected.

Note that because macOS is a derivation of BSD, instead of /opt, the prefix used is /usr/local. Thus, $PSHOME is /usr/local/microsoft/powershell/6.0.0-beta.7/, and the symlink is placed at /usr/local/bin/powershell.