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
4 changes: 2 additions & 2 deletions reference/docs-conceptual/how-to-use-docs.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
description: This article explains how to use the features of this site including search filtering and version selection.
ms.date: 01/28/2026
ms.date: 03/18/2026
ms.topic: how-to
title: How to use the PowerShell documentation
---
Expand Down Expand Up @@ -82,7 +82,7 @@ returns 1,096 articles from the entire Microsoft Learn site.

This site contains cmdlet reference for the following versions of PowerShell:

- PowerShell 7.6 (preview)
- PowerShell 7.6 (LTS)
- PowerShell 7.5
- PowerShell 7.4 (LTS)
- PowerShell 5.1
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
description: Details the policies governing support for PowerShell.
ms.date: 03/12/2026
ms.date: 03/18/2026
ms.topic: lifecycle
title: PowerShell Support Lifecycle
---
Expand All @@ -17,15 +17,16 @@ There are multiple versions of PowerShell 7 that can be installed.
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 v7.4.14.
The current LTS release is PowerShell v7.6.0. The previous LTS release, PowerShell v7.4.14, is
still supported until 10-Nov-2026.
- **Preview release** - A preview release is a version of PowerShell that's currently in
development. Preview releases can contain bug fixes, new features, and experiments. Preview
releases can contain bugs and might not be stable. For that reason, you shouldn't use them in
production environments. Preview versions aren't officially supported. They allow you to test out
new features and provide feedback. Your feedback is important and can influence the features that
get released.

The current Preview release is PowerShell v7.6.0-rc1.
There is no current Preview release.

PowerShell follows the [Microsoft Modern Lifecycle Policy][02]. The End of Support dates follow the
[.NET Support Policy][06] for the version of .NET that the release of PowerShell was built upon.
Expand Down Expand Up @@ -123,7 +124,7 @@ lists the end-of-support dates for the current versions of PowerShell:

| Version | Release Date | End-of-support | .NET Version |
| ------------------------ | :----------: | :------------: | --------------- |
| PowerShell 7.6 (preview) | Future date | 14-Nov-2028 | [.NET 10.0][19] |
| PowerShell 7.6 (preview) | 18-Mar-2028 | 14-Nov-2028 | [.NET 10.0][19] |
| PowerShell 7.5 | 23-Jan-2025 | 10-Nov-2026 | [.NET 9.0][14] |
| PowerShell 7.4 (LTS) | 16-Nov-2023 | 10-Nov-2026 | [.NET 8.0][13] |

Expand Down
6 changes: 3 additions & 3 deletions reference/docs-conceptual/install/install-alpine.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
description: How to install PowerShell on Alpine Linux
ms.date: 03/12/2026
ms.date: 03/18/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.0/powershell-7.6.0-linux-musl-x64.tar.gz`
- PowerShell 7.5 - `https://github.com/PowerShell/PowerShell/releases/download/v7.5.5/powershell-7.5.5-linux-musl-x64.tar.gz`
- PowerShell 7.4 (LTS) - `https://github.com/PowerShell/PowerShell/releases/download/v7.4.14/powershell-7.4.14-linux-musl-x64.tar.gz`
- PowerShell 7.6-preview - `https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-rc1/powershell-7.6.0-rc1-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.5.5/powershell-7.5.5-linux-musl-x64.tar.gz -o /tmp/powershell.tar.gz
curl -L https://github.com/PowerShell/PowerShell/releases/download/v7.6.0/powershell-7.6.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
12 changes: 6 additions & 6 deletions reference/docs-conceptual/install/install-debian.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
description: How to install PowerShell on Debian Linux
ms.date: 03/12/2026
ms.date: 03/18/2026
title: Install PowerShell 7 on Debian
---
# Install PowerShell 7 on Debian
Expand Down Expand Up @@ -71,12 +71,12 @@ pwsh
Download the universal package from the GitHub releases page. Choose the link for the version you
want to install.

- PowerShell 7.6 (LTS) universal package for supported versions of Debian
- `https://github.com/PowerShell/PowerShell/releases/download/v7.6.0/powershell_7.6.0-1.deb_amd64.deb`
- PowerShell 7.5 universal package for supported versions of Debian
- `https://github.com/PowerShell/PowerShell/releases/download/v7.5.5/powershell_7.5.5-1.deb_amd64.deb`
- PowerShell 7.4 (LTS) universal package for supported versions of Debian
- `https://github.com/PowerShell/PowerShell/releases/download/v7.4.14/powershell_7.4.14-1.deb_amd64.deb`
- PowerShell 7.6-preview universal package for supported versions of Debian
- `https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-rc1/powershell-preview_7.6.0-rc1-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 @@ -93,17 +93,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.5.5/powershell_7.5.5-1.deb_amd64.deb
wget https://github.com/PowerShell/PowerShell/releases/download/v7.6.0/powershell_7.6.0-1.deb_amd64.deb

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

# Start PowerShell
pwsh
Expand Down
30 changes: 15 additions & 15 deletions reference/docs-conceptual/install/install-powershell-on-macos.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
description: How to install PowerShell on macOS
ms.date: 03/12/2026
ms.date: 03/18/2026
title: Install PowerShell 7 on macOS
---

Expand All @@ -24,15 +24,15 @@ There are several ways to install PowerShell on macOS.
Download the install package from the [releases][04] page. Select the package version you want to
install.

- PowerShell 7.6 (LTS)
- Arm64 processors - [powershell-7.6.0-osx-arm64.pkg][13]
- x64 processors - [powershell-7.6.0-osx-x64.pkg][15]
- PowerShell 7.5
- Arm64 processors - [powershell-7.5.5-osx-arm64.pkg][09]
- x64 processors - [powershell-7.5.5-osx-x64.pkg][11]
- PowerShell 7.4 (LTS)
- Arm64 processors - [powershell-7.4.14-osx-arm64.pkg][05]
- x64 processors - [powershell-7.4.14-osx-x64.pkg][07]
- PowerShell 7.6-preview
- Arm64 processors - [powershell-7.6.0-rc.1-osx-arm64.pkg][13]
- x64 processors - [powershell-7.6.0-rc.1-osx-x64.pkg][15]

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

Expand Down Expand Up @@ -103,22 +103,22 @@ dependencies.
Download the install package from the [releases][04] page onto your Mac. Select the archive version
you want to install.

- PowerShell 7.4 (LTS)
- Arm64 processors - [powershell-7.4.14-osx-arm64.tar.gz][06]
- x64 processors - [powershell-7.4.14-osx-x64.tar.gz][08]
- PowerShell 7.6 (LTS)
- Arm64 processors - [powershell-7.6.0-osx-arm64.tar.gz][14]
- x64 processors - [powershell-7.6.0-osx-x64.tar.gz][16]
- PowerShell 7.5
- Arm64 processors - [powershell-7.5.5-osx-arm64.tar.gz][10]
- x64 processors - [powershell-7.5.5-osx-x64.tar.gz][12]
- PowerShell 7.6-preview
- Arm64 processors - [powershell-7.6.0-rc.1-osx-arm64.tar.gz][14]
- x64 processors - [powershell-7.6.0-rc.1-osx-x64.tar.gz][16]
- PowerShell 7.4 (LTS)
- Arm64 processors - [powershell-7.4.14-osx-arm64.tar.gz][06]
- x64 processors - [powershell-7.4.14-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.5.5/powershell-7.5.5-osx-arm64.tar.gz
curl -L -o /tmp/powershell.tar.gz https://github.com/PowerShell/PowerShell/releases/download/v7.6.0/powershell-7.6.0-osx-arm64.tar.gz

# Create the target folder where powershell is placed
sudo mkdir -p /usr/local/microsoft/powershell/7
Expand Down Expand Up @@ -190,10 +190,10 @@ can't support those methods. For more information, see [Alternate ways to instal
[10]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.5/powershell-7.5.5-osx-arm64.tar.gz
[11]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.5/powershell-7.5.5-osx-x64.pkg
[12]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.5/powershell-7.5.5-osx-x64.tar.gz
[13]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-rc.1/powershell-7.6.0-rc.1-osx-arm64.pkg
[14]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-rc.1/powershell-7.6.0-rc.1-osx-arm64.tar.gz
[15]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-rc.1/powershell-7.6.0-rc.1-osx-x64.pkg
[16]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-rc.1/powershell-7.6.0-rc.1-osx-x64.tar.gz
[13]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0/powershell-7.6.0-osx-arm64.pkg
[14]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0/powershell-7.6.0-osx-arm64.tar.gz
[15]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0/powershell-7.6.0-osx-x64.pkg
[16]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0/powershell-7.6.0-osx-x64.tar.gz
[17]: https://specifications.freedesktop.org/basedir/latest/
[18]: https://support.apple.com/102445
[19]: PowerShell-Support-Lifecycle.md
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: 03/12/2026
ms.date: 03/18/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.5.5-win-arm64.zip'
$zipfile = 'PowerShell-7.6.0-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.5.5-win-arm64.zip
Expand-Archive .\PowerShell-7.6.0-win-arm64.zip

# Set up remoting to PowerShell 7
Set-Location .\PowerShell-7.5.5-win-arm64
Set-Location .\PowerShell-7.6.0-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.5.5
Enter-PSSession -ComputerName $deviceIp -Credential Administrator -Configuration PowerShell.7.6.0
```

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.5.5-win-x64.zip'
$zipfile = 'PowerShell-7.6.0-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.5.5-win-x64.zip -DestinationPath 'C:\Program Files\PowerShell 7'
Expand-Archive -Path C:\PowerShell-7.6.0-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.5.5/PowerShell-7.5.5-win-x64.zip
[03]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0/PowerShell-7.6.0-win-x64.zip
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
description: How to install PowerShell on Windows
ms.date: 03/12/2026
ms.date: 03/18/2026
title: Install PowerShell 7 on Windows
---
# Install PowerShell 7 on Windows
Expand Down Expand Up @@ -48,10 +48,10 @@ winget search --id Microsoft.PowerShell
```

```Output
Name Id Version Source
---------------------------------------------------------------
PowerShell Microsoft.PowerShell 7.5.5.0 winget
PowerShell Preview Microsoft.PowerShell.Preview 7.6.0.6 winget
Name Id Version Source
-----------------------------------------------------------------
PowerShell Microsoft.PowerShell 7.6.0.0 winget
PowerShell Preview Microsoft.PowerShell.Preview 7.6.0.101 winget
```

Install PowerShell 7:
Expand All @@ -67,8 +67,7 @@ winget install --id Microsoft.PowerShell.Preview --source winget
```

> [!NOTE]
> On Windows systems using X86 or X64 processor, `winget` installs the MSI package. On systems using
> the Arm64 processor, `winget` installs the Microsoft Store (MSIX) package.
> On systems using the Arm64 processor, `winget` installs the Microsoft Store (MSIX) package.

### Install the MSI package

Expand All @@ -77,15 +76,15 @@ package from GitHub.

Latest stable release:

- [PowerShell-7.5.5-win-x64.msi][15]
- [PowerShell-7.5.5-win-x86.msi][17]
- [PowerShell-7.5.5-win-arm64.msi][13]
- [PowerShell-7.6.0-win-x64.msi][15]
- [PowerShell-7.6.0-win-arm64.msi][13]

<!-- Update the links below to the latest preview release when available.
Latest Preview release:

- [PowerShell-7.6.0-rc.1-win-x64.msi][20]
- [PowerShell-7.6.0-rc.1-win-x86.msi][21]
- [PowerShell-7.6.0-rc.1-win-arm64.msi][19]
-->

Once downloaded, double-click the installer file and follow the prompts.

Expand Down Expand Up @@ -128,7 +127,7 @@ installation options:
The following example shows how to silently install PowerShell with all the install options enabled.

```powershell
msiexec.exe /package PowerShell-7.5.5-win-x64.msi /quiet ADD_EXPLORER_CONTEXT_MENU_OPENPOWERSHELL=1 ADD_FILE_CONTEXT_MENU_RUNPOWERSHELL=1 ENABLE_PSREMOTING=1 REGISTER_MANIFEST=1 USE_MU=1 ENABLE_MU=1 ADD_PATH=1
msiexec.exe /package PowerShell-7.6.0-win-x64.msi /quiet ADD_EXPLORER_CONTEXT_MENU_OPENPOWERSHELL=1 ADD_FILE_CONTEXT_MENU_RUNPOWERSHELL=1 ENABLE_PSREMOTING=1 REGISTER_MANIFEST=1 USE_MU=1 ENABLE_MU=1 ADD_PATH=1
```

For a full list of command-line options for `Msiexec.exe`, see [Command line options][05].
Expand All @@ -138,9 +137,8 @@ For a full list of command-line options for `Msiexec.exe`, see [Command line opt
<a id="zip"></a>PowerShell binary ZIP archives are provided to enable advanced deployment scenarios.
Download one of the following ZIP archives from the [current release][22] page.

- [PowerShell-7.5.5-win-x64.zip][16]
- [PowerShell-7.5.5-win-x86.zip][18]
- [PowerShell-7.5.5-win-arm64.zip][14]
- [PowerShell-7.6.0-win-x64.zip][16]
- [PowerShell-7.6.0-win-arm64.zip][14]

Depending on how you download the file you may need to unblock the file using the `Unblock-File`
cmdlet. Unzip the contents to the location of your choice and run `pwsh.exe` from there. Unlike
Expand Down Expand Up @@ -175,7 +173,7 @@ Benefits of the Microsoft Store package:

- Automatic updates built right into Windows
- Integrates with other software distribution mechanisms like Intune and Configuration Manager
- Can install on Windows systems using x86, x64, or Arm64 processors
- Can install on Windows systems using x64 or Arm64 processors

#### Limitations of a Store-based installation

Expand Down Expand Up @@ -253,8 +251,8 @@ If you aren't sure how PowerShell was installed, you can check the value of the
which always points to the directory containing PowerShell that the current session is running.

- If the value is `$HOME\.dotnet\tools`, PowerShell was installed with the [.NET Global tool][08].
- If the value is `$Env:ProgramFiles\PowerShell\7`, PowerShell was installed as an
[MSI package][09] or with [WinGet][11] on a computer with an X86 or x64 processor.
- If the value is `$Env:ProgramFiles\PowerShell\7`, PowerShell was installed as an [MSI package][09]
or with [WinGet][11] on a computer with an x64 processor.
- If the value starts with `$Env:ProgramFiles\WindowsApps\`, PowerShell was installed as a
[Microsoft Store package][10] or with [WinGet][11] on computer with an ARM processor.
- If the value is anything else, it's likely that PowerShell was installed as a [ZIP package][12].
Expand Down Expand Up @@ -323,15 +321,10 @@ can't support those methods.
[10]: #msstore
[11]: #winget
[12]: #zip
[13]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.5/PowerShell-7.5.5-win-arm64.msi
[14]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.5/PowerShell-7.5.5-win-arm64.zip
[15]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.5/PowerShell-7.5.5-win-x64.msi
[16]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.5/PowerShell-7.5.5-win-x64.zip
[17]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.5/PowerShell-7.5.5-win-x86.msi
[18]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.5/PowerShell-7.5.5-win-x86.zip
[19]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-rc.1/PowerShell-7.6.0-rc.1-win-arm64.msi
[20]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-rc.1/PowerShell-7.6.0-rc.1-win-x64.msi
[21]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-rc.1/PowerShell-7.6.0-rc.1-win-x86.msi
[13]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0/PowerShell-7.6.0-win-arm64.msi
[14]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0/PowerShell-7.6.0-win-arm64.zip
[15]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0/PowerShell-7.6.0-win-x64.msi
[16]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0/PowerShell-7.6.0-win-x64.zip
[22]: https://github.com/PowerShell/PowerShell/releases/latest
[23]: https://www.microsoft.com/store/apps/9MZ1SNWT0N5D
[24]: media/install-powershell-on-windows/powershell-start-menu.png
Expand Down
Loading