Skip to content

Auto Publish – main to live - 2026-05-21 22:00 UTC #13027

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.

Sign up for GitHub

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
learn-build-service-prod merged 1 commit into from
May 21, 2026
Merged

Auto Publish – main to live - 2026-05-21 22:00 UTC #13027

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
6 changes: 3 additions & 3 deletions reference/docs-conceptual/install/PowerShell-Support-Lifecycle.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
description: Details the policies governing support for PowerShell.
ms.date: 04/29/2026
ms.date: 05/20/2026
ms.topic: lifecycle
title: PowerShell Support Lifecycle
---
Expand All @@ -12,13 +12,13 @@ There are multiple versions of PowerShell 7 that can be installed.
releases can contain critical fixes, innovations, and new features. Microsoft supports a Stable
release for about six months after the next LTS release.

The current Stable release is PowerShell 7.5.6.
The current Stable release is PowerShell 7.5.7.

- **Long Term Servicing (LTS) release** - An LTS release of PowerShell is an LTS release of .NET.
Updates to an LTS release only contain critical security updates and servicing fixes that are
designed to minimize impact on existing workloads.

The current LTS release is PowerShell 7.6.1. The previous LTS release, PowerShell 7.4.15, is
The current LTS release is PowerShell 7.6.2. The previous LTS release, PowerShell 7.4.16, is
still supported until 10-Nov-2026.

- **Preview release** - A preview release is a version of PowerShell that's currently in
Expand Down
10 changes: 5 additions & 5 deletions reference/docs-conceptual/install/alternate-install-methods.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
description: Alternate ways to install PowerShell on non-Windows platforms.
ms.date: 04/21/2026
ms.date: 05/20/2026
title: Alternate ways to install PowerShell
---
# Alternate ways to install PowerShell
Expand Down Expand Up @@ -177,16 +177,16 @@ install the necessary dependencies for the target OS in separate steps.
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.6.1-linux-arm32.tar.gz`
- `powershell-7.6.1-linux-arm64.tar.gz`
- `powershell-7.6.1-linux-x64.tar.gz`
- `powershell-7.6.2-linux-arm32.tar.gz`
- `powershell-7.6.2-linux-arm64.tar.gz`
- `powershell-7.6.2-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.6.1/powershell-7.6.1-linux-x64.tar.gz
curl -L -o /tmp/powershell.tar.gz https://github.com/PowerShell/PowerShell/releases/download/v7.6.2/powershell-7.6.2-linux-x64.tar.gz

# Create the target folder where powershell will be placed
sudo mkdir -p /opt/microsoft/powershell/7
Expand Down
14 changes: 7 additions & 7 deletions reference/docs-conceptual/install/community-support.md
View file
Open in desktop
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: 04/21/2026
ms.date: 05/20/2026
title: Community support for PowerShell on Linux
---
# Community support for PowerShell on Linux
Expand Down Expand Up @@ -82,14 +82,14 @@ package from the [releases][09] page onto your Raspberry Pi computer. The links
versions are:

- PowerShell 7.6 - latest LTS release
- `https://github.com/PowerShell/PowerShell/releases/download/v7.6.1/powershell-7.6.1-linux-arm32.tar.gz`
- `https://github.com/PowerShell/PowerShell/releases/download/v7.6.1/powershell-7.6.1-linux-arm64.tar.gz`
- `https://github.com/PowerShell/PowerShell/releases/download/v7.6.2/powershell-7.6.2-linux-arm32.tar.gz`
- `https://github.com/PowerShell/PowerShell/releases/download/v7.6.2/powershell-7.6.2-linux-arm64.tar.gz`
- PowerShell 7.5 - latest stable release
- `https://github.com/PowerShell/PowerShell/releases/download/v7.5.6/powershell-7.5.6-linux-arm32.tar.gz`
- `https://github.com/PowerShell/PowerShell/releases/download/v7.5.6/powershell-7.5.6-linux-arm64.tar.gz`
- `https://github.com/PowerShell/PowerShell/releases/download/v7.5.7/powershell-7.5.7-linux-arm32.tar.gz`
- `https://github.com/PowerShell/PowerShell/releases/download/v7.5.7/powershell-7.5.7-linux-arm64.tar.gz`
- PowerShell 7.4 - previous LTS release
- `https://github.com/PowerShell/PowerShell/releases/download/v7.4.15/powershell-7.4.15-linux-arm32.tar.gz`
- `https://github.com/PowerShell/PowerShell/releases/download/v7.4.15/powershell-7.4.15-linux-arm64.tar.gz`
- `https://github.com/PowerShell/PowerShell/releases/download/v7.4.16/powershell-7.4.16-linux-arm32.tar.gz`
- `https://github.com/PowerShell/PowerShell/releases/download/v7.4.16/powershell-7.4.16-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: 5 additions & 5 deletions reference/docs-conceptual/install/install-alpine.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
description: How to install PowerShell on Alpine Linux
ms.date: 04/21/2026
ms.date: 05/20/2026
title: Install PowerShell 7 on Alpine Linux
---
# Install PowerShell 7 on Alpine Linux
Expand All @@ -19,9 +19,9 @@ with a previous version, reinstall the previous version using the [binary archiv
On Alpine Linux, PowerShell is installed from the `tar.gz` package downloaded from the
[releases][01] page. Select the URL of the package version you want to install.

- PowerShell 7.6 (LTS) - `https://github.com/PowerShell/PowerShell/releases/download/v7.6.1/powershell-7.6.1-linux-musl-x64.tar.gz`
- PowerShell 7.5 - `https://github.com/PowerShell/PowerShell/releases/download/v7.5.6/powershell-7.5.6-linux-musl-x64.tar.gz`
- PowerShell 7.4 (LTS) - `https://github.com/PowerShell/PowerShell/releases/download/v7.4.15/powershell-7.4.15-linux-musl-x64.tar.gz`
- PowerShell 7.6 (LTS) - `https://github.com/PowerShell/PowerShell/releases/download/v7.6.2/powershell-7.6.2-linux-musl-x64.tar.gz`
- PowerShell 7.5 - `https://github.com/PowerShell/PowerShell/releases/download/v7.5.7/powershell-7.5.7-linux-musl-x64.tar.gz`
- PowerShell 7.4 (LTS) - `https://github.com/PowerShell/PowerShell/releases/download/v7.4.16/powershell-7.4.16-linux-musl-x64.tar.gz`

Use the following shell commands to install PowerShell 7:

Expand All @@ -48,7 +48,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.6.1/powershell-7.6.1-linux-musl-x64.tar.gz -o /tmp/powershell.tar.gz
curl -L https://github.com/PowerShell/PowerShell/releases/download/v7.6.2/powershell-7.6.2-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
14 changes: 7 additions & 7 deletions reference/docs-conceptual/install/install-debian.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
description: How to install PowerShell on Debian Linux
ms.date: 04/21/2026
ms.date: 05/20/2026
title: Install PowerShell 7 on Debian
---
# Install PowerShell 7 on Debian
Expand Down Expand Up @@ -73,11 +73,11 @@ Download the universal package from the GitHub releases page. Choose the link fo
want to install.

- PowerShell 7.6 (LTS) universal package for supported versions of Debian
- `https://github.com/PowerShell/PowerShell/releases/download/v7.6.1/powershell_7.6.1-1.deb_amd64.deb`
- `https://github.com/PowerShell/PowerShell/releases/download/v7.6.2/powershell_7.6.2-1.deb_amd64.deb`
- PowerShell 7.5 universal package for supported versions of Debian
- `https://github.com/PowerShell/PowerShell/releases/download/v7.5.6/powershell_7.5.6-1.deb_amd64.deb`
- `https://github.com/PowerShell/PowerShell/releases/download/v7.5.7/powershell_7.5.7-1.deb_amd64.deb`
- PowerShell 7.4 (LTS) universal package for supported versions of Debian
- `https://github.com/PowerShell/PowerShell/releases/download/v7.4.15/powershell_7.4.15-1.deb_amd64.deb`
- `https://github.com/PowerShell/PowerShell/releases/download/v7.4.16/powershell_7.4.16-1.deb_amd64.deb`

The following shell script downloads and installs the current release of PowerShell. You can
change the URL to download the version of PowerShell that you want to install.
Expand All @@ -94,17 +94,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.6.1/powershell_7.6.1-1.deb_amd64.deb
wget https://github.com/PowerShell/PowerShell/releases/download/v7.6.2/powershell_7.6.2-1.deb_amd64.deb

###################################
# Install the PowerShell package
sudo dpkg -i powershell_7.6.1-1.deb_amd64.deb
sudo dpkg -i powershell_7.6.2-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.6.1-1.deb_amd64.deb
rm powershell_7.6.2-1.deb_amd64.deb

# Start PowerShell
pwsh
Expand Down
58 changes: 32 additions & 26 deletions reference/docs-conceptual/install/install-powershell-on-macos.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
description: How to install PowerShell on macOS
ms.date: 04/21/2026
ms.date: 05/20/2026
title: Install PowerShell 7 on macOS
---

Expand All @@ -26,17 +26,23 @@ Download the install package from the [releases][04] page. Select the package ve
install.

- PowerShell 7.6 (LTS)
- Arm64 processors - [powershell-7.6.1-osx-arm64.pkg][13]
- x64 processors - [powershell-7.6.1-osx-x64.pkg][15]
- Arm64 processors - [powershell-7.6.2-osx-arm64.pkg][13]
- x64 processors - [powershell-7.6.2-osx-x64.pkg][15]
- PowerShell 7.5
- Arm64 processors - [powershell-7.5.6-osx-arm64.pkg][09]
- x64 processors - [powershell-7.5.6-osx-x64.pkg][11]
- Arm64 processors - [powershell-7.5.7-osx-arm64.pkg][09]
- x64 processors - [powershell-7.5.7-osx-x64.pkg][11]
- PowerShell 7.4 (LTS)
- Arm64 processors - [powershell-7.4.15-osx-arm64.pkg][05]
- x64 processors - [powershell-7.4.15-osx-x64.pkg][07]
- Arm64 processors - [powershell-7.4.16-osx-arm64.pkg][05]
- x64 processors - [powershell-7.4.16-osx-x64.pkg][07]

There are two ways to install PowerShell using the downloaded package.

Beginning with the May 2026 releases of PowerShell, the macOS PKG package is notarized and signed by
Microsoft. To install the package, download the PKG file and open it.

For previous versions of PowerShell, use the following instructions to bypass the Gatekeeper checks
and install the package.

#### Install the package using Finder

Install PowerShell using Finder:
Expand Down Expand Up @@ -105,21 +111,21 @@ Download the install package from the [releases][04] page onto your Mac. Select
you want to install.

- PowerShell 7.6 (LTS)
- Arm64 processors - [powershell-7.6.1-osx-arm64.tar.gz][14]
- x64 processors - [powershell-7.6.1-osx-x64.tar.gz][16]
- Arm64 processors - [powershell-7.6.2-osx-arm64.tar.gz][14]
- x64 processors - [powershell-7.6.2-osx-x64.tar.gz][16]
- PowerShell 7.5
- Arm64 processors - [powershell-7.5.6-osx-arm64.tar.gz][10]
- x64 processors - [powershell-7.5.6-osx-x64.tar.gz][12]
- Arm64 processors - [powershell-7.5.7-osx-arm64.tar.gz][10]
- x64 processors - [powershell-7.5.7-osx-x64.tar.gz][12]
- PowerShell 7.4 (LTS)
- Arm64 processors - [powershell-7.4.15-osx-arm64.tar.gz][06]
- x64 processors - [powershell-7.4.15-osx-x64.tar.gz][08]
- Arm64 processors - [powershell-7.4.16-osx-arm64.tar.gz][06]
- x64 processors - [powershell-7.4.16-osx-x64.tar.gz][08]

Use the following commands to install PowerShell from the binary archive. Change the download URL to
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.6.1/powershell-7.6.1-osx-arm64.tar.gz
curl -L -o /tmp/powershell.tar.gz https://github.com/PowerShell/PowerShell/releases/download/v7.6.2/powershell-7.6.2-osx-arm64.tar.gz

# Create the target folder where powershell is placed
sudo mkdir -p /usr/local/microsoft/powershell/7
Expand Down Expand Up @@ -183,18 +189,18 @@ can't support those methods. For more information, see [Alternate ways to instal
[02]: /dotnet/core/tools/global-tools
[03]: alternate-install-methods.md#install-on-macos-using-homebrew
[04]: https://aka.ms/powershell-release?tag=stable
[05]: https://github.com/PowerShell/PowerShell/releases/download/v7.4.15/powershell-7.4.15-osx-arm64.pkg
[06]: https://github.com/PowerShell/PowerShell/releases/download/v7.4.15/powershell-7.4.15-osx-arm64.tar.gz
[07]: https://github.com/PowerShell/PowerShell/releases/download/v7.4.15/powershell-7.4.15-osx-x64.pkg
[08]: https://github.com/PowerShell/PowerShell/releases/download/v7.4.15/powershell-7.4.15-osx-x64.tar.gz
[09]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.6/powershell-7.5.6-osx-arm64.pkg
[10]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.6/powershell-7.5.6-osx-arm64.tar.gz
[11]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.6/powershell-7.5.6-osx-x64.pkg
[12]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.6/powershell-7.5.6-osx-x64.tar.gz
[13]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.1/powershell-7.6.1-osx-arm64.pkg
[14]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.1/powershell-7.6.1-osx-arm64.tar.gz
[15]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.1/powershell-7.6.1-osx-x64.pkg
[16]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.1/powershell-7.6.1-osx-x64.tar.gz
[05]: https://github.com/PowerShell/PowerShell/releases/download/v7.4.16/powershell-7.4.16-osx-arm64.pkg
[06]: https://github.com/PowerShell/PowerShell/releases/download/v7.4.16/powershell-7.4.16-osx-arm64.tar.gz
[07]: https://github.com/PowerShell/PowerShell/releases/download/v7.4.16/powershell-7.4.16-osx-x64.pkg
[08]: https://github.com/PowerShell/PowerShell/releases/download/v7.4.16/powershell-7.4.16-osx-x64.tar.gz
[09]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.7/powershell-7.5.7-osx-arm64.pkg
[10]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.7/powershell-7.5.7-osx-arm64.tar.gz
[11]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.7/powershell-7.5.7-osx-x64.pkg
[12]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.7/powershell-7.5.7-osx-x64.tar.gz
[13]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.2/powershell-7.6.2-osx-arm64.pkg
[14]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.2/powershell-7.6.2-osx-arm64.tar.gz
[15]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.2/powershell-7.6.2-osx-x64.pkg
[16]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.2/powershell-7.6.2-osx-x64.tar.gz
[17]: https://specifications.freedesktop.org/basedir/latest/
[18]: https://support.apple.com/102445
[19]: PowerShell-Support-Lifecycle.md
16 changes: 8 additions & 8 deletions reference/docs-conceptual/install/install-powershell-on-windows-iot-nano.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
description: How to install PowerShell on Windows IoT and Nano Server.
ms.date: 04/21/2026
ms.date: 05/20/2026
title: Install PowerShell 7 on Windows IoT and Nano Server
---
# Install PowerShell 7 on Windows IoT and Nano Server
Expand All @@ -14,7 +14,7 @@ Windows 11 IoT Enterprise comes with Windows PowerShell, which is used to deploy
```powershell
# Replace the placeholder information for the following variables:
$deviceip = '<device ip address>'
$zipfile = 'PowerShell-7.6.1-win-arm64.zip'
$zipfile = 'PowerShell-7.6.2-win-arm64.zip'
$downloadfolder = 'U:\Users\Administrator\Downloads'
# The download location is local to the device.
# There should be enough space for the zip file and the unzipped contents.
Expand All @@ -28,10 +28,10 @@ Copy-Item $zipfile -Destination $downloadfolder -ToSession $S
#Connect to the device and expand the archive
Enter-PSSession $S
Set-Location U:\Users\Administrator\Downloads
Expand-Archive .\PowerShell-7.6.1-win-arm64.zip
Expand-Archive .\PowerShell-7.6.2-win-arm64.zip

# Set up remoting to PowerShell 7
Set-Location .\PowerShell-7.6.1-win-arm64
Set-Location .\PowerShell-7.6.2-win-arm64
# Be sure to use the -PowerShellHome parameter otherwise it tries to create a new
# endpoint with Windows PowerShell 5.1
.\Install-PowerShellRemoting.ps1 -PowerShellHome .
Expand All @@ -43,7 +43,7 @@ PowerShell has to restart WinRM. Now you can connect to PowerShell 7 endpoint on
```powershell

# Be sure to use the -Configuration parameter. If you omit it, you connect to Windows PowerShell 5.1
Enter-PSSession -ComputerName $deviceIp -Credential Administrator -Configuration PowerShell.7.6.1
Enter-PSSession -ComputerName $deviceIp -Credential Administrator -Configuration PowerShell.7.6.2
```

Windows 11 IoT Core adds Windows PowerShell when you include _IOT_POWERSHELL_ feature. Use Windows
Expand Down Expand Up @@ -87,15 +87,15 @@ Deploy PowerShell to Nano Server using the following steps.
# Replace the placeholder information for the following variables:
$ipaddr = '<Nano Server IP address>'
$credential = Get-Credential # <An Administrator account on the system>
$zipfile = 'PowerShell-7.6.1-win-x64.zip'
$zipfile = 'PowerShell-7.6.2-win-x64.zip'
# Connect to the built-in instance of Windows PowerShell
$session = New-PSSession -ComputerName $ipaddr -Credential $credential
# Copy the file to the Nano Server instance
Copy-Item $zipfile C:\ -ToSession $session
# Enter the interactive remote session
Enter-PSSession $session
# Extract the ZIP file
Expand-Archive -Path C:\PowerShell-7.6.1-win-x64.zip -DestinationPath 'C:\Program Files\PowerShell 7'
Expand-Archive -Path C:\PowerShell-7.6.2-win-x64.zip -DestinationPath 'C:\Program Files\PowerShell 7'
```

## Supported versions of Windows
Expand All @@ -115,4 +115,4 @@ can't support those methods.
<!-- link references -->
[01]: /windows-server/get-started/deploy-nano-server
[02]: https://github.com/ms-iot/iot-adk-addonkit/blob/master/Tools/IoTCoreImaging/Docs/Import-PSCoreRelease.md#Import-PSCoreRelease
[03]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.1/PowerShell-7.6.1-win-x64.zip
[03]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.2/PowerShell-7.6.2-win-x64.zip
Loading
Loading