Skip to content
Merged
Show file tree
Hide file tree
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
172 changes: 69 additions & 103 deletions reference/docs-conceptual/install/Installing-PowerShell-on-Windows.md

Large diffs are not rendered by default.

Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
description: Information about installing PowerShell on macOS
ms.date: 01/23/2025
ms.date: 01/27/2025
title: Installing PowerShell on macOS
---

Expand All @@ -16,6 +16,8 @@ check the list of [Supported versions][06] below.
> need to run PowerShell 7.4 side-by-side with a previous version, reinstall the previous version
> using the [binary archive][04] method.

[!INCLUDE [Latest version](../../includes/latest-install.md)]

## Install the latest stable release of PowerShell

There are several ways to install PowerShell on macOS. Choose one of the following methods:
Expand Down Expand Up @@ -119,21 +121,21 @@ are:
- PowerShell 7.4
- x64 processors - [powershell-7.4.7-osx-x64.pkg][20]
- Arm64 processors - [powershell-7.4.7-osx-arm64.pkg][18]
- PowerShell 7.5-rc.1
- PowerShell 7.5
- x64 processors - [powershell-7.5.0-osx-x64.pkg][24]
- Arm64 processors - [powershell-7.5.0-arm64.pkg][22]

You can double-click the file and follow the prompts, or install it from the terminal using the
following commands. Change the name of the file to match the file you downloaded.

```sh
sudo installer -pkg ./Downloads/powershell-7.4.7-osx-x64.pkg -target /
sudo installer -pkg ./Downloads/powershell-7.5.0-osx-x64.pkg -target /
```

If you are running on macOS Big Sur 11.5 or higher you may receive the following error message
when installing the package:

> "powershell-7.4.7-osx-x64.pkg" cannot be opened because Apple cannot check it for malicious
> "powershell-7.5.0-osx-x64.pkg" cannot be opened because Apple cannot check it for malicious
> software.

There are two ways to work around this issue:
Expand All @@ -146,7 +148,7 @@ Using the Finder

From the command line

1. Run `sudo xattr -rd com.apple.quarantine ./Downloads/powershell-7.4.7-osx-x64.pkg`. If you are using
1. Run `sudo xattr -rd com.apple.quarantine ./Downloads/powershell-7.5.0-osx-x64.pkg`. If you are using
PowerShell 7 or higher, you can use the `Unblock-File` cmdlet. Include the full path to the
`.pkg` file.
1. Install the package as you normally would.
Expand Down Expand Up @@ -197,7 +199,7 @@ match the version you want to install.

```sh
# Download the powershell '.tar.gz' archive
curl -L -o /tmp/powershell.tar.gz https://github.com/PowerShell/PowerShell/releases/download/v7.4.7/powershell-7.4.7-osx-x64.tar.gz
curl -L -o /tmp/powershell.tar.gz https://github.com/PowerShell/PowerShell/releases/download/v7.5.0/powershell-7.5.0-osx-x64.tar.gz

# Create the target folder where powershell is placed
sudo mkdir -p /usr/local/microsoft/powershell/7
Expand Down
7 changes: 5 additions & 2 deletions reference/docs-conceptual/install/community-support.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
description: PowerShell can run on Linux distributions that aren't officially supported by Microsoft.
ms.date: 01/23/2025
ms.date: 01/27/2025
title: Community support for PowerShell on Linux
---
# Community support for PowerShell on Linux
Expand Down Expand Up @@ -77,9 +77,12 @@ the following article provides information on how to install PowerShell on openS
Download the tar.gz package from the [releases][09] page onto your Raspberry Pi computer. The links
to the current versions are:

- PowerShell 7.4.7 - latest LTS release
- PowerShell 7.4 - latest LTS release
- `https://github.com/PowerShell/PowerShell/releases/download/v7.4.7/powershell-7.4.7-linux-arm32.tar.gz`
- `https://github.com/PowerShell/PowerShell/releases/download/v7.4.7/powershell-7.4.7-linux-arm64.tar.gz`
- PowerShell 7.5 - latest stable release
- `https://github.com/PowerShell/PowerShell/releases/download/v7.5.0/powershell-7.5.0-linux-arm32.tar.gz`
- `https://github.com/PowerShell/PowerShell/releases/download/v7.5.0/powershell-7.5.0-linux-arm64.tar.gz`

Use the following shell commands to download and install the package. This script detects whether
you're running a 32-bit or 64-bit OS and installs the latest stable version of PowerShell for that
Expand Down
10 changes: 6 additions & 4 deletions reference/docs-conceptual/install/install-alpine.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
description: Information about installing PowerShell on Alpine Linux
ms.date: 01/23/2025
ms.date: 01/27/2025
title: Installing PowerShell on Alpine Linux
---
# Installing PowerShell on Alpine Linux
Expand All @@ -15,13 +15,15 @@ check the list of [Supported versions][02] below.
> need to run PowerShell 7.4 side-by-side with a previous version, reinstall the previous version
> using the [binary archive][05] method.

[!INCLUDE [Latest version](../../includes/latest-install.md)]

## Installation steps

Installation on Alpine is based on downloading tar.gz package from the [releases][03] page. The URL
to the package depends on the version of PowerShell you want to install.

- PowerShell 7.4.7 - `https://github.com/PowerShell/PowerShell/releases/download/v7.4.7/powershell-7.4.7-linux-musl-x64.tar.gz`
- PowerShell 7.5.0 - `https://github.com/PowerShell/PowerShell/releases/download/7.5.0/powershell-7.5.0-linux-musl-x64.tar.gz`
- PowerShell 7.4 - `https://github.com/PowerShell/PowerShell/releases/download/v7.4.7/powershell-7.4.7-linux-musl-x64.tar.gz`
- PowerShell 7.5 - `https://github.com/PowerShell/PowerShell/releases/download/7.5.0/powershell-7.5.0-linux-musl-x64.tar.gz`

Then, in the terminal, execute the following shell commands to install PowerShell 7.4:

Expand All @@ -47,7 +49,7 @@ apk -X https://dl-cdn.alpinelinux.org/alpine/edge/main add --no-cache \
openssh-client \

# Download the powershell '.tar.gz' archive
curl -L https://github.com/PowerShell/PowerShell/releases/download/v7.4.7/powershell-7.4.7-linux-musl-x64.tar.gz -o /tmp/powershell.tar.gz
curl -L https://github.com/PowerShell/PowerShell/releases/download/v7.5.0/powershell-7.5.0-linux-musl-x64.tar.gz -o /tmp/powershell.tar.gz

# Create the target folder where powershell will be placed
sudo mkdir -p /opt/microsoft/powershell/7
Expand Down
10 changes: 6 additions & 4 deletions reference/docs-conceptual/install/install-debian.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,8 @@ All packages are available on our GitHub [releases][02] page. Before installing,

Debian uses APT (Advanced Package Tool) as a package manager.

[!INCLUDE [Latest version](../../includes/latest-install.md)]

## Installation on Debian 11 or 12 via the Package Repository

Microsoft builds and supports a variety of software products for Linux systems and makes them
Expand Down Expand Up @@ -71,7 +73,7 @@ The link to the current version is:

- PowerShell 7.4 (LTS) universal package for supported versions of Debian
- `https://github.com/PowerShell/PowerShell/releases/download/v7.4.7/powershell_7.4.7-1.deb_amd64.deb`
- PowerShell 7.5-preview universal package for supported versions of Debian
- PowerShell 7.5 universal package for supported versions of Debian
- `https://github.com/PowerShell/PowerShell/releases/download/7.5.0/powershell-preview_7.5.0-1.deb_amd64.deb`

The following shell script downloads and installs the current release of PowerShell. You can
Expand All @@ -88,17 +90,17 @@ sudo apt-get update
sudo apt-get install -y wget

# Download the PowerShell package file
wget https://github.com/PowerShell/PowerShell/releases/download/v7.4.7/powershell_7.4.7-1.deb_amd64.deb
wget https://github.com/PowerShell/PowerShell/releases/download/v7.5.0/powershell_7.5.0-1.deb_amd64.deb

###################################
# Install the PowerShell package
sudo dpkg -i powershell_7.4.7-1.deb_amd64.deb
sudo dpkg -i powershell_7.5.0-1.deb_amd64.deb

# Resolve missing dependencies and finish the install (if necessary)
sudo apt-get install -f

# Delete the downloaded package file
rm powershell_7.4.7-1.deb_amd64.deb
rm powershell_7.5.0-1.deb_amd64.deb

# Start PowerShell
pwsh
Expand Down
10 changes: 5 additions & 5 deletions reference/docs-conceptual/install/install-other-linux.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
description: Information about installing PowerShell on various Linux distributions
ms.date: 01/23/2025
ms.date: 01/27/2025
title: Alternate ways to install PowerShell on Linux
---
# Alternate ways to install PowerShell on Linux
Expand Down Expand Up @@ -132,16 +132,16 @@ archive.
The following example shows the steps for installing the x64 binary archive. You must choose the
correct binary archive that matches the processor type for your platform.

- `powershell-7.4.7-linux-arm32.tar.gz`
- `powershell-7.4.7-linux-arm64.tar.gz`
- `powershell-7.4.7-linux-x64.tar.gz`
- `powershell-7.5.0-linux-arm32.tar.gz`
- `powershell-7.5.0-linux-arm64.tar.gz`
- `powershell-7.5.0-linux-x64.tar.gz`

Use the following shell commands to download and install PowerShell from the `tar.gz` binary
archive. Change the URL to match the version of PowerShell you want to install.

```sh
# Download the powershell '.tar.gz' archive
curl -L -o /tmp/powershell.tar.gz https://github.com/PowerShell/PowerShell/releases/download/v7.4.7/powershell-7.4.7-linux-x64.tar.gz
curl -L -o /tmp/powershell.tar.gz https://github.com/PowerShell/PowerShell/releases/download/v7.5.0/powershell-7.5.0-linux-x64.tar.gz

# Create the target folder where powershell will be placed
sudo mkdir -p /opt/microsoft/powershell/7
Expand Down
4 changes: 3 additions & 1 deletion reference/docs-conceptual/install/install-rhel.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,8 @@ All packages are available on our GitHub [releases][02] page. Before installing,

RHEL 7 uses `yum` and RHEL 8 and higher uses the `dnf` package manager.

[!INCLUDE [Latest version](../../includes/latest-install.md)]

## Installation via the Package Repository

Microsoft builds and supports a variety of software products for Linux systems and makes them
Expand Down Expand Up @@ -75,7 +77,7 @@ change the URL to download the version of PowerShell that you want to install.
On RHEL 8 or 9:

```sh
sudo dnf install https://github.com/PowerShell/PowerShell/releases/download/v7.4.7/powershell-7.4.7-1.rh.x86_64.rpm
sudo dnf install https://github.com/PowerShell/PowerShell/releases/download/v7.5.0/powershell-7.5.0-1.rh.x86_64.rpm
```

## Uninstall PowerShell
Expand Down
12 changes: 7 additions & 5 deletions reference/docs-conceptual/install/install-ubuntu.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
description: Information about installing PowerShell on Ubuntu
ms.date: 01/23/2025
ms.date: 01/27/2025
title: Installing PowerShell on Ubuntu
---
# Installing PowerShell on Ubuntu
Expand All @@ -17,6 +17,8 @@ check the list of [Supported versions][04] below. After the package is installed

Ubuntu uses APT (Advanced Package Tool) as a package manager.

[!INCLUDE [Latest version](../../includes/latest-install.md)]

## Installation via Package Repository the Package Repository

Microsoft builds and supports a variety of software products for Linux systems and makes them
Expand Down Expand Up @@ -83,7 +85,7 @@ The link to the current version is:

- PowerShell 7.4 (LTS) universal package for supported versions of Ubuntu
- `https://github.com/PowerShell/PowerShell/releases/download/v7.4.7/powershell_7.4.7-1.deb_amd64.deb`
- PowerShell 7.5.0 universal package for supported versions of Ubuntu
- PowerShell 7.5 universal package for supported versions of Ubuntu
- `https://github.com/PowerShell/PowerShell/releases/download/7.5.0/powershell-preview_7.5.0-1.deb_amd64.deb`

The following shell script downloads and installs the current preview release of PowerShell. You can
Expand All @@ -100,17 +102,17 @@ sudo apt-get update
sudo apt-get install -y wget

# Download the PowerShell package file
wget https://github.com/PowerShell/PowerShell/releases/download/v7.4.7/powershell_7.4.7-1.deb_amd64.deb
wget https://github.com/PowerShell/PowerShell/releases/download/v7.5.0/powershell_7.5.0-1.deb_amd64.deb

###################################
# Install the PowerShell package
sudo dpkg -i powershell_7.4.7-1.deb_amd64.deb
sudo dpkg -i powershell_7.5.0-1.deb_amd64.deb

# Resolve missing dependencies and finish the install (if necessary)
sudo apt-get install -f

# Delete the downloaded package file
rm powershell_7.4.7-1.deb_amd64.deb
rm powershell_7.5.0-1.deb_amd64.deb

# Start PowerShell Preview
pwsh
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
description: Remoting in PowerShell using WSMan
ms.date: 10/03/2023
ms.date: 01/27/2025
title: Using WS-Management (WSMan) Remoting in PowerShell
---
# Using WS-Management (WSMan) Remoting in PowerShell
Expand All @@ -10,54 +10,66 @@ title: Using WS-Management (WSMan) Remoting in PowerShell
To enable PowerShell remoting run the `Enable-PSRemoting` cmdlet in an elevated PowerShell session.
Running `Enable-PSRemoting` configures a remoting endpoint for the specific installation version
that you are running the cmdlet in. For example, when you run `Enable-PSRemoting` while running
PowerShell 7.3, PowerShell creates a remoting endpoint runs PowerShell 7.3. If you run
PowerShell 7.4, PowerShell creates a remoting endpoint runs PowerShell 7.4. If you run
`Enable-PSRemoting` while running PowerShell 7-preview, PowerShell creates a remoting endpoint that
runs PowerShell 7-preview. You can create multiple remoting endpoints for different versions of that
run side-by-side.

Running `Enable-PSRemoting` creates two endpoints for that version.

- One has a simple name corresponding to the PowerShell major version. that hosts the session. For
example, **PowerShell.7.3**.
- The other configuration name contains the full version number. For example, **PowerShell.7.3.7**.
example, **PowerShell.7.4**.
- The other configuration name contains the full version number. For example, **PowerShell.7.4.7**.

You can connect to the latest version of PowerShell 7 host version using the simple name,
**PowerShell.7.3**. You can connect to a specific version of PowerShell using the longer,
**PowerShell.7.4**. You can connect to a specific version of PowerShell using the longer,
version-specific name.

Use the **ConfigurationName** parameter with the `New-PSSession` and `Enter-PSSession` cmdlets to
connect to a named configuration.

## Remoting to older versions of Windows

The following prerequisites must be met to enable PowerShell remoting over WSMan on older versions
of Windows.

- Install the Windows Management Framework (WMF) 5.1 (as necessary). For more information about WMF,
see [WMF Overview][01].
- Install the [Universal C Runtime][03] on Windows versions predating Windows 10. It's available via
direct download or Windows Update. Fully patched systems already have this package installed.

## WSMan remoting isn't supported on non-Windows platforms

Since the release of PowerShell 6, support for remoting over WS-Management (WSMan) on non-Windows
platforms has only been available to a limited set of Linux distributions. All versions of those
distributions that supported WSMan are no longer supported by the Linux vendors that created them.

On non-Windows, WSMan relied on the [Open Management Infrastructure (OMI)][01] project, which no
On non-Windows, WSMan relied on the [Open Management Infrastructure (OMI)][02] project, which no
longer supports PowerShell remoting. The OMI WSMan client is dependent on **OpenSSL 1.0**. Most
Linux distributions have moved to **OpenSSL 2.0**, which isn't backward-compatible. At this time,
there is no supported distribution that has the dependencies needed for the OMI WSMan client to
work.

The outdated libraries and supporting code have been removed for non-Windows platforms. WSMan-based
remoting is still supported between Windows systems. Remoting over SSH is supported for all
platforms. For more information, see [PowerShell remoting over SSH][03].
platforms. For more information, see [PowerShell remoting over SSH][05].

> [!NOTE]
> Users may be able to get WSMan remoting to work using the [PSWSMan][02] module. This module isn't
> Users may be able to get WSMan remoting to work using the [PSWSMan][04] module. This module isn't
> supported or maintained by Microsoft.

## Further reading

- [Enable-PSRemoting][04]
- [Enter-PSSession][05]
- [New-PSSession][06]
- [Enable-PSRemoting][06]
- [Enter-PSSession][07]
- [New-PSSession][08]

<!-- link references -->
[01]: https://github.com/Microsoft/omi
[02]: https://www.powershellgallery.com/packages/PSWSMan
[03]: SSH-Remoting-in-PowerShell.md
[04]: xref:Microsoft.PowerShell.Core.Enable-PSRemoting
[05]: xref:Microsoft.PowerShell.Core.Enter-PSSession
[06]: xref:Microsoft.PowerShell.Core.New-PSSession
[01]: ../../windows-powershell/wmf-overview.md
[02]: https://github.com/Microsoft/omi
[03]: https://www.microsoft.com/download/details.aspx?id=50410
[04]: https://www.powershellgallery.com/packages/PSWSMan
[05]: SSH-Remoting-in-PowerShell.md
[06]: xref:Microsoft.PowerShell.Core.Enable-PSRemoting
[07]: xref:Microsoft.PowerShell.Core.Enter-PSSession
[08]: xref:Microsoft.PowerShell.Core.New-PSSession
24 changes: 24 additions & 0 deletions reference/includes/latest-install.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
---
author: sdwheeler
ms.author: sewhee
ms.date: 01/27/2025
ms.topic: include
---
<!-- markdownlint-disable first-line-h1 -->
> [!NOTE]
> The installation commands in this article are for the latest stable release of PowerShell. To
> install a different version of PowerShell, adjust the command to match the version you need. The
> following links direct you to the release page for each version in the PowerShell repository on
> GitHub.
>
> - v7.5.0 - Stable release: [https://aka.ms/powershell-release?tag=stable][03]
> - v7.4.7 - LTS release: [https://aka.ms/powershell-release?tag=lts][01]
> - v7.6.0-preview.2 - Preview release: [https://aka.ms/powershell-release?tag=preview][02]
>
> Download links for every package are found in the **Assets** section of the Release page. The
> **Assets** section may be collapsed, so you may need to click to expand it.

<!-- link references -->
[01]: https://aka.ms/powershell-release?tag=lts
[02]: https://aka.ms/powershell-release?tag=preview
[03]: https://aka.ms/powershell-release?tag=stable