diff --git a/reference/docs-conceptual/install/PowerShell-Support-Lifecycle.md b/reference/docs-conceptual/install/PowerShell-Support-Lifecycle.md index d6fd1b32484d..0427bb8e9dd9 100644 --- a/reference/docs-conceptual/install/PowerShell-Support-Lifecycle.md +++ b/reference/docs-conceptual/install/PowerShell-Support-Lifecycle.md @@ -1,32 +1,43 @@ --- description: Details the policies governing support for PowerShell. -ms.date: 10/22/2025 +ms.date: 03/06/2026 ms.topic: lifecycle title: PowerShell Support Lifecycle --- # PowerShell Support Lifecycle -> [!NOTE] -> This document is about support for PowerShell. Windows PowerShell (1.0 - 5.1) is a component of -> the Windows operating system. For more information, see -> [Product and Services Lifecycle Information][03]. +There are multiple versions of PowerShell 7 that can be installed. + +- **Stable release** - A stable release is a release that occurs between LTS releases. Stable + releases can contain critical fixes, innovations, and new features. Microsoft supports a Stable + release for about six months after the next LTS release. -PowerShell follows the [Microsoft Modern Lifecycle Policy][02]. Support dates follow the -[.NET Support Policy][06]. In this servicing approach, customers can choose Long Term Support (LTS) -releases or current releases. + The current Stable release is PowerShell v7.5.4. +- **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. -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 v7.4.13. +- **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. -A **current** release is a release that occurs between **LTS** releases. Current releases can -contain critical fixes, innovations, and new features. Microsoft supports a **current** release for -six months after the next **LTS** release. + The current Preview release is PowerShell v7.6.0-rc1. -Both **LTS** and **current** versions of PowerShell receive security updates and bug fixes. -Microsoft only supports the latest update version of a 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. +Both LTS and Stable releases of PowerShell receive security updates and bug fixes. Microsoft only +supports the latest update version of a release. + +> [!NOTE] +> This document is about support for PowerShell, not Windows PowerShell. Windows PowerShell is a +> component of the Windows operating system and is subject to the Windows support lifecycle. For +> more information, see [Product and Services Lifecycle Information][03]. -## Getting support +## Support options Microsoft provides support for PowerShell on a best-effort basis. Support for Windows PowerShell 5.1 is provided through Windows support channels. You can use the standard paid support channels to get diff --git a/reference/docs-conceptual/install/install-alpine.md b/reference/docs-conceptual/install/install-alpine.md index a4792cd12d33..e4ba3261c55b 100644 --- a/reference/docs-conceptual/install/install-alpine.md +++ b/reference/docs-conceptual/install/install-alpine.md @@ -1,31 +1,29 @@ --- description: How to install PowerShell on Alpine Linux -ms.date: 02/20/2026 -title: Install PowerShell on Alpine Linux +ms.date: 03/06/2026 +title: Install PowerShell 7 on Alpine Linux --- -# Install PowerShell on Alpine Linux +# Install PowerShell 7 on Alpine Linux -All packages are available on our GitHub [releases][03] page. After the package is installed, run -`pwsh` from a terminal. Run `pwsh-preview` if you installed a preview release. Before installing, -check the list of [Supported versions][02] below. +There are multiple package versions of PowerShell 7 that can be installed. This article focuses on +installing the latest stable release package. For more information about the package versions, see +the [PowerShell Support Lifecycle][04] article. Newer versions of PowerShell 7 replace existing previous versions of PowerShell 7. Preview versions of PowerShell can be installed side-by-side with other versions of PowerShell. Newer preview versions replace existing previous preview versions. If you need to run PowerShell 7.5 side-by-side -with a previous version, reinstall the previous version using the [binary archive][05] method. +with a previous version, reinstall the previous version using the [binary archive][03] method. -[!INCLUDE [Latest version](../../includes/latest-install.md)] +## Install PowerShell 7 -## Installation steps +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. -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 (LTS) - `https://github.com/PowerShell/PowerShell/releases/download/v7.4.13/powershell-7.4.13-linux-musl-x64.tar.gz` - PowerShell 7.5 - `https://github.com/PowerShell/PowerShell/releases/download/v7.5.4/powershell-7.5.4-linux-musl-x64.tar.gz` +- PowerShell 7.4 (LTS) - `https://github.com/PowerShell/PowerShell/releases/download/v7.4.13/powershell-7.4.13-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` -Then, in the terminal, execute the following shell commands to install PowerShell 7.4: +Use the following shell commands to install PowerShell 7: ```sh #!/bin/bash @@ -68,15 +66,14 @@ sudo ln -s /opt/microsoft/powershell/7/pwsh /usr/bin/pwsh pwsh ``` -## Uninstall PowerShell - -```sh -sudo rm -rf /usr/bin/pwsh /opt/microsoft/powershell -``` +## Start PowerShell 7 -## PowerShell paths +After the package is installed, run `pwsh` from a terminal. If you have installed a Preview package, +run `pwsh-preview`. -- `$PSHOME` is `/opt/microsoft/powershell/7/` +- The location of `$PSHOME` varies based on the package you installed. + - For Stable and LTS packages: `/opt/microsoft/powershell/7/` + - For Preview packages: `/opt/microsoft/powershell/7-preview/` - The profiles scripts are stored in the following locations: - AllUsersAllHosts - `$PSHOME/profile.ps1` - AllUsersCurrentHost - `$PSHOME/Microsoft.PowerShell_profile.ps1` @@ -91,20 +88,26 @@ sudo rm -rf /usr/bin/pwsh /opt/microsoft/powershell The profiles respect PowerShell's per-host configuration, so the default host-specific profiles exists at `Microsoft.PowerShell_profile.ps1` in the same locations. -PowerShell respects the [XDG Base Directory Specification][04] on Linux. +PowerShell respects the [XDG Base Directory Specification][02] on Linux. + +## Uninstall PowerShell 7 + +```sh +sudo rm -rf /usr/bin/pwsh /opt/microsoft/powershell +``` -## Supported versions +## Supported OS versions [!INCLUDE [Alpine support](../../includes/alpine-support.md)] -## Installation support +## Supported installation methods -Microsoft supports the installation methods in this document. There may be other methods of -installation available from other third-party sources. While those tools and methods may work, -Microsoft can't support those methods. +Microsoft supports the installation methods in this document. There may be other third-party methods +of installation available from other sources. While those tools and methods may work, Microsoft +can't support those methods. -[02]: #supported-versions -[03]: https://aka.ms/PowerShell-Release?tag=stable -[04]: https://specifications.freedesktop.org/basedir/latest/ -[05]: install-other-linux.md#binary-archives +[01]: https://github.com/PowerShell/PowerShell/releases +[02]: https://specifications.freedesktop.org/basedir/latest/ +[03]: install-other-linux.md#binary-archives +[04]: PowerShell-Support-Lifecycle.md diff --git a/reference/docs-conceptual/install/install-debian.md b/reference/docs-conceptual/install/install-debian.md index 24a007ca0769..b2f5820fb447 100644 --- a/reference/docs-conceptual/install/install-debian.md +++ b/reference/docs-conceptual/install/install-debian.md @@ -1,34 +1,36 @@ --- description: How to install PowerShell on Debian Linux -ms.date: 02/20/2026 -title: Install PowerShell on Debian +ms.date: 03/06/2026 +title: Install PowerShell 7 on Debian --- -# Install PowerShell on Debian +# Install PowerShell 7 on Debian -All packages are available on our GitHub [releases][02] page. Before installing, check the list of -[Supported versions][01] below. After the package is installed, run `pwsh` from a terminal. Run -`pwsh-lts` if you installed a preview release. +There are multiple package versions of PowerShell 7 that can be installed. This article focuses on +installing the latest stable release package. For more information about the package versions, see +the [PowerShell Support Lifecycle][05] article. Newer versions of PowerShell 7 replace existing previous versions of PowerShell 7. Preview versions of PowerShell can be installed side-by-side with other versions of PowerShell. Newer preview versions replace existing previous preview versions. If you need to run PowerShell 7.5 side-by-side -with a previous version, reinstall the previous version using the [binary archive][05] method. +with a previous version, reinstall the previous version using the [binary archive][04] method. -Debian uses APT (Advanced Package Tool) as a package manager. +## Choose an installation method -[!INCLUDE [Latest version](../../includes/latest-install.md)] +On Debian Linux, you can install PowerShell using the universal `.deb` package from the Microsoft +package repository or by downloading a file from the GitHub [releases][01] page. -## Installation on Debian 11 or 12 via the Package Repository +### Install PowerShell 7 from the Package Repository Microsoft builds and supports a variety of software products for Linux systems and makes them available via Linux packaging clients (apt, dnf, yum, etc). These Linux software packages are hosted -on the _Linux package repository for Microsoft products_, [https://packages.microsoft.com][03], also +on the _Linux package repository for Microsoft products_, [https://packages.microsoft.com][02], also known as _PMC_. Installing PowerShell from PMC is the preferred method of installation. > [!NOTE] -> This script only works for supported versions of Debian. +> This script only works for supported versions of Debian that have a package published to the +> Microsoft package repository. ```sh #!/bin/bash @@ -64,17 +66,15 @@ sudo apt-get install -y powershell pwsh ``` -## Installation via direct download +### Manually download and install PowerShell 7 -PowerShell 7.2 introduced a universal package that makes installation easier. Download the universal -package from the [releases][02] page onto your Debian machine. +Download the universal package from the GitHub releases page. Choose the link for the version you +want to install. -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.13/powershell_7.4.13-1.deb_amd64.deb` - PowerShell 7.5 universal package for supported versions of Debian - `https://github.com/PowerShell/PowerShell/releases/download/v7.5.4/powershell_7.5.4-1.deb_amd64.deb` +- PowerShell 7.4 (LTS) universal package for supported versions of Debian + - `https://github.com/PowerShell/PowerShell/releases/download/v7.4.13/powershell_7.4.13-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` @@ -109,15 +109,14 @@ rm powershell_7.5.4-1.deb_amd64.deb pwsh ``` -## Uninstall PowerShell +## Start PowerShell 7 -```sh -sudo apt-get remove powershell -``` +After the package is installed, run `pwsh` from a terminal. If you have installed a Preview package, +run `pwsh-preview`. -## PowerShell paths - -- `$PSHOME` is `/opt/microsoft/powershell/7/` +- The location of `$PSHOME` varies based on the package you installed. + - For Stable and LTS packages: `/opt/microsoft/powershell/7/` + - For Preview packages: `/opt/microsoft/powershell/7-preview/` - The profiles scripts are stored in the following locations: - AllUsersAllHosts - `$PSHOME/profile.ps1` - AllUsersCurrentHost - `$PSHOME/Microsoft.PowerShell_profile.ps1` @@ -129,21 +128,30 @@ sudo apt-get remove powershell - Default modules - `$PSHOME/Modules` - PSReadLine history is recorded in `~/.local/share/powershell/PSReadLine/ConsoleHost_history.txt` -PowerShell respects the [XDG Base Directory Specification][04] on Linux. +The profiles respect PowerShell's per-host configuration, so the default host-specific profiles +exists at `Microsoft.PowerShell_profile.ps1` in the same locations. + +PowerShell respects the [XDG Base Directory Specification][03] on Linux. + +## Uninstall PowerShell 7 + +```sh +sudo apt-get remove powershell +``` -## Supported versions +## Supported OS versions [!INCLUDE [Debian support](../../includes/debian-support.md)] -## Installation support +## Supported installation methods Microsoft supports the installation methods in this document. There may be other methods of installation available from other third-party sources. While those tools and methods may work, Microsoft can't support those methods. -[01]: #supported-versions -[02]: https://aka.ms/PowerShell-Release?tag=stable -[03]: https://packages.microsoft.com -[04]: https://specifications.freedesktop.org/basedir/latest/ -[05]: install-other-linux.md#binary-archives +[01]: https://github.com/PowerShell/PowerShell/releases +[02]: https://packages.microsoft.com +[03]: https://specifications.freedesktop.org/basedir/latest/ +[04]: install-other-linux.md#binary-archives +[05]: PowerShell-Support-Lifecycle.md diff --git a/reference/docs-conceptual/install/install-powershell-on-macos.md b/reference/docs-conceptual/install/install-powershell-on-macos.md index 2fc223d1a647..e7b2c83186fd 100644 --- a/reference/docs-conceptual/install/install-powershell-on-macos.md +++ b/reference/docs-conceptual/install/install-powershell-on-macos.md @@ -1,34 +1,29 @@ --- description: How to install PowerShell on macOS -ms.date: 02/20/2026 -title: Install PowerShell on macOS +ms.date: 03/06/2026 +title: Install PowerShell 7 on macOS --- -# Install PowerShell on macOS +# Install PowerShell 7 on macOS -PowerShell 7 or higher requires macOS 13 and higher. All packages are available on the GitHub -[releases][11] page for PowerShell. After the package is installed, run `pwsh` from a terminal. -Before installing, check the list of [Supported versions][08]. +There are multiple package versions of PowerShell 7 that can be installed. This article focuses on +installing the latest stable release package. For more information about the package versions, see +the [PowerShell Support Lifecycle][22] article. Newer versions of PowerShell 7 replace existing previous versions of PowerShell 7. Preview versions of PowerShell can be installed side-by-side with other versions of PowerShell. Newer preview -versions replace existing previous preview versions.If you need to run PowerShell 7.5 side-by-side -with a previous version, reinstall the previous version using the [binary archive][03] method. +versions replace existing previous preview versions. If you need to run PowerShell 7.5 side-by-side +with a previous version, reinstall the previous version using the binary archive method. -[!INCLUDE [Latest version](../../includes/latest-install.md)] +## Choose an installation method -## Install the latest stable release of PowerShell +There are several ways to install PowerShell on macOS. Homebrew is the preferred installation +method. -There are several ways to install PowerShell on macOS. Choose one of the following methods: +### Install PowerShell 7 using Homebrew -- Install using [Homebrew][06]. Homebrew is the preferred package manager for macOS. -- Install via [Direct Download][05]. -- Install as [a .NET Global tool][04]. -- Install from [binary archives][03]. - -## Install using Homebrew - -If the `brew` command isn't found, you need to install Homebrew following [their instructions][12]. +Homebrew is the preferred package manager for macOS. If the `brew` command isn't found, you need to +install Homebrew following [their instructions][04]. ```bash /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" @@ -42,101 +37,36 @@ The following command installs the latest stable release of PowerShell: brew install --cask powershell ``` -Verify the installation is working correctly: +If you want the LTS or Preview version of PowerShell, you can install it using Homebrew's tap +method. Select tap version you want to install: -```sh -pwsh -``` +- `powershell/tap/powershell-lts` +- `powershell/tap/powershell-preview` -When new versions of PowerShell are released, update Homebrew's formulae and upgrade PowerShell: - -```sh -brew update -brew upgrade powershell -``` - -> [!NOTE] -> You can call the previous commands from within a PowerShell (`pwsh`) session, but then you must -> restart the PowerShell session to complete the upgrade and refresh the values shown in -> `$PSVersionTable`. - -[brew]: https://brew.sh/ - -### Install the latest preview release of PowerShell - -The following command installs the latest preview release of PowerShell: +For example, use the following command to install the Preview release: ```sh brew install powershell/tap/powershell-preview ``` -Run the following command to start the preview version of PowerShell: - -```sh -pwsh-preview -``` - -When new preview versions of PowerShell are released, update Homebrew's formulae and upgrade to the -latest preview version of PowerShell: - -```sh -brew update -brew upgrade powershell-preview -``` - -> [!NOTE] -> You can call the previous commands from within a PowerShell (`pwsh`) session, but then you must -> restart the PowerShell session to complete the upgrade and refresh the values shown in -> `$PSVersionTable`. - -### Install the latest LTS release of PowerShell - -The following command installs the latest LTS release of PowerShell: - -```sh -brew install powershell/tap/powershell-lts -``` - -Verify your installation: - -```sh -pwsh-lts -``` - -When new LTS versions of PowerShell are released, run the following commands to update Homebrew's -formulae and upgrade to the latest LTS version of PowerShell: - -```sh -brew update -brew upgrade powershell-lts -``` - -> [!NOTE] -> When updating to a newer version of PowerShell, use the same method, cask or the tap, that you -> used to perform the initial install. If you use a different method, opening a new pwsh session -> continues to use the older version of PowerShell. -> -> If you decide to use different methods, there are ways to correct the issue using the -> [Homebrew link method][13]. - -## Install the package via Direct Download +### Manually download and install the package -Starting with version 7.2, PowerShell supports the Apple M-series Arm-based processors. Download the -install package from the [releases][11] page onto your Mac. The links to the current versions are: +Download the install package from the [releases][03] page. Select the package version you want to +install. -- PowerShell 7.4 (LTS) - - Arm64 processors - [powershell-7.4.13-osx-arm64.pkg][16] - - x64 processors - [powershell-7.4.13-osx-x64.pkg][18] - PowerShell 7.5 - - Arm64 processors - [powershell-7.5.4-arm64.pkg][20] - - x64 processors - [powershell-7.5.4-osx-x64.pkg][22] + - Arm64 processors - [powershell-7.5.4-arm64.pkg][12] + - x64 processors - [powershell-7.5.4-osx-x64.pkg][14] +- PowerShell 7.4 (LTS) + - Arm64 processors - [powershell-7.4.13-osx-arm64.pkg][08] + - x64 processors - [powershell-7.4.13-osx-x64.pkg][10] - PowerShell 7.6-preview - - Arm64 processors - [powershell-7.6.0-rc1-osx-arm64.pkg][24] - - x64 processors - [powershell-7.6.0-rc1-osx-x64.pkg][26] + - Arm64 processors - [powershell-7.6.0-rc1-osx-arm64.pkg][16] + - x64 processors - [powershell-7.6.0-rc1-osx-x64.pkg][18] -There are two ways to install PowerShell using the Direct Download method. +There are two ways to install PowerShell using the downloaded package. -### Using Finder +#### Install the package using Finder Install PowerShell using Finder: @@ -154,7 +84,7 @@ Install PowerShell using Finder: 1. Select the **Done** button to close the prompt. This error message comes from the Gatekeeper feature of macOS. For more information, see -[Safely open apps on your Mac - Apple Support][29]. +[Safely open apps on your Mac - Apple Support][21]. After you've tried to open the package, follow these steps: @@ -164,7 +94,7 @@ After you've tried to open the package, follow these steps: 1. When the warning prompt reappears, select **Open Anyway**. 1. Enter username and password to allow the installation to proceed. -### Using Terminal +#### Install the package from a command shell To install the PowerShell package from the command line, you must bypass the Gatekeeper checks. Use one of the following methods to install the package: @@ -181,10 +111,10 @@ one of the following methods to install the package: - Use the `Unblock-File` cmdlet if you're using PowerShell. Include the full path to the `.pkg` file. -## Install as a .NET Global tool +### Install as a .NET Global tool -If you already have the [.NET Core SDK][01] installed, it's easy to install PowerShell as a -[.NET Global tool][02]. +If you already have the [.NET Core SDK][01] installed, you can use the [.NET Global tool][02] to +install PowerShell 7. ```sh dotnet tool install --global PowerShell @@ -194,33 +124,24 @@ The dotnet tool installer adds `~/.dotnet/tools` to your `PATH` environment vari currently running shell doesn't have the updated `PATH`. Start PowerShell from a new shell by typing `pwsh`. -## Binary archives +### Install PowerShell 7 from a binary archive PowerShell binary `tar.gz` archives are provided for the macOS platform to enable advanced deployment scenarios. When you install using this method, you must also manually install any dependencies. -> [!NOTE] -> You can use this method to install any version of PowerShell including the latest: -> -> - Stable release: [https://aka.ms/powershell-release?tag=stable][11] -> - LTS release: [https://aka.ms/powershell-release?tag=lts][09] -> - Preview release: [https://aka.ms/powershell-release?tag=preview][10] - -### Install binary archives on macOS - -Download the install package from the [releases][11] page onto your Mac. The links to the current -versions are: +Download the install package from the [releases][03] page onto your Mac. Select the archive version +you want to install. - PowerShell 7.4 (LTS) - - Arm64 processors - [powershell-7.4.13-osx-arm64.tar.gz][17] - - x64 processors - [powershell-7.4.13-osx-x64.tar.gz][19] + - Arm64 processors - [powershell-7.4.13-osx-arm64.tar.gz][09] + - x64 processors - [powershell-7.4.13-osx-x64.tar.gz][11] - PowerShell 7.5 - - Arm64 processors - [powershell-7.5.4-osx-arm64.tar.gz][21] - - x64 processors - [powershell-7.5.4-osx-x64.tar.gz][23] + - Arm64 processors - [powershell-7.5.4-osx-arm64.tar.gz][13] + - x64 processors - [powershell-7.5.4-osx-x64.tar.gz][15] - PowerShell 7.6-preview - - Arm64 processors - [powershell-7.6.0-rc1-osx-arm64.tar.gz][25] - - x64 processors - [powershell-7.6.0-rc1-osx-x64.tar.gz][27] + - Arm64 processors - [powershell-7.6.0-rc1-osx-arm64.tar.gz][17] + - x64 processors - [powershell-7.6.0-rc1-osx-x64.tar.gz][19] Use the following commands to install PowerShell from the binary archive. Change the download URL to match the version you want to install. @@ -242,7 +163,44 @@ sudo chmod +x /usr/local/microsoft/powershell/7/pwsh sudo ln -s /usr/local/microsoft/powershell/7/pwsh /usr/local/bin/pwsh ``` -## Uninstalling PowerShell +## Start PowerShell 7 + +After the package is installed, run `pwsh` from a terminal. If you have installed a Preview package, +run `pwsh-preview`. + +- The location of `$PSHOME` varies based on the package you installed. + - For Stable and LTS packages: `/usr/local/microsoft/powershell/7/` + - For Preview packages: `/usr/local/microsoft/powershell/7-preview/` + - The macOS install package creates a symbolic link, `/usr/local/bin/pwsh` that points to `pwsh` + in the `$PSHOME` location. +- User profiles are read from `~/.config/powershell/profile.ps1` +- Default profiles are read from `$PSHOME/profile.ps1` +- User modules are read from `~/.local/share/powershell/Modules` +- Shared modules are read from `/usr/local/share/powershell/Modules` +- Default modules are read from `$PSHOME/Modules` +- PSReadLine history is recorded to `~/.local/share/powershell/PSReadLine/ConsoleHost_history.txt` + +PowerShell respects the [XDG Base Directory Specification][20] on macOS. + +## Update PowerShell 7 + +Run the following commands to update the installed version of PowerShell to the latest release. + +```sh + +brew update +brew upgrade powershell +``` + +> [!NOTE] +> When updating to a newer version of PowerShell, use the same method, cask or the tap, that you +> used to perform the initial install. If you use a different method, opening a new pwsh session +> continues to use the older version of PowerShell. +> +> If you decide to use different methods, there are ways to correct the issue using the +> [Homebrew link method][05]. + +## Uninstall PowerShell 7 If you installed PowerShell with Homebrew, use the following command to uninstall: @@ -250,75 +208,51 @@ If you installed PowerShell with Homebrew, use the following command to uninstal brew uninstall --cask powershell ``` -If you installed PowerShell via direct download, PowerShell must be removed manually: +If you manually installed PowerShell 7, you must manually remove it. The following command removes +the symbolic link and PowerShell files. ```sh sudo rm -rf /usr/local/bin/pwsh /usr/local/microsoft/powershell ``` -To remove the extra PowerShell paths, refer to the [paths][07] section in this document and remove -the paths using `sudo rm`. - -> [!NOTE] -> This process isn't necessary if you installed with Homebrew. - -## Paths - -- `$PSHOME` is `/usr/local/microsoft/powershell/7` - - The macOS install package creates a symbolic link, `/usr/local/bin/pwsh` that points to `pwsh` - in the `$PSHOME` location. -- User profiles are read from `~/.config/powershell/profile.ps1` -- Default profiles are read from `$PSHOME/profile.ps1` -- User modules are read from `~/.local/share/powershell/Modules` -- Shared modules are read from `/usr/local/share/powershell/Modules` -- Default modules are read from `$PSHOME/Modules` -- PSReadLine history is recorded to `~/.local/share/powershell/PSReadLine/ConsoleHost_history.txt` - -PowerShell respects the [XDG Base Directory Specification][28] on macOS. +Use `sudo rm` to remove any other remaining PowerShell files and folders. -## Supported versions +## Supported versions of macOS [!INCLUDE [macOS support](../../includes/macos-support.md)] -## Installation support +## Supported installation methods -Microsoft supports the installation methods in this document. There might be other methods of -installation available from other sources. While those tools and methods might work, Microsoft can't -support those methods. +Microsoft supports the installation methods in this document. There may be other third-party methods +of installation available from other sources. While those tools and methods may work, Microsoft +can't support those methods. ## Additional resources -- [Homebrew Web][12] -- [Homebrew GitHub Repository][14] -- [Homebrew-Cask][15] +- [Homebrew Web][04] +- [Homebrew GitHub Repository][06] +- [Homebrew-Cask][07] [01]: /dotnet/core/sdk [02]: /dotnet/core/tools/global-tools -[03]: #binary-archives -[04]: #install-as-a-net-global-tool -[05]: #install-the-package-via-direct-download -[06]: #install-using-homebrew -[07]: #paths -[08]: #supported-versions -[09]: https://aka.ms/powershell-release?tag=lts -[10]: https://aka.ms/powershell-release?tag=preview -[11]: https://aka.ms/powershell-release?tag=stable -[12]: https://brew.sh/ -[13]: https://docs.brew.sh/Manpage#link-ln-options-formula -[14]: https://github.com/Homebrew -[15]: https://github.com/Homebrew/homebrew-cask -[16]: https://github.com/PowerShell/PowerShell/releases/download/v7.4.13/powershell-7.4.13-osx-arm64.pkg -[17]: https://github.com/PowerShell/PowerShell/releases/download/v7.4.13/powershell-7.4.13-osx-arm64.tar.gz -[18]: https://github.com/PowerShell/PowerShell/releases/download/v7.4.13/powershell-7.4.13-osx-x64.pkg -[19]: https://github.com/PowerShell/PowerShell/releases/download/v7.4.13/powershell-7.4.13-osx-x64.tar.gz -[20]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.4/powershell-7.5.4-osx-arm64.pkg -[21]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.4/powershell-7.5.4-osx-arm64.tar.gz -[22]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.4/powershell-7.5.4-osx-x64.pkg -[23]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.4/powershell-7.5.4-osx-x64.tar.gz -[24]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-rc1/powershell-7.6.0-rc1-osx-arm64.pkg -[25]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-rc1/powershell-7.6.0-rc1-osx-arm64.tar.gz -[26]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-rc1/powershell-7.6.0-rc1-osx-x64.pkg -[27]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-rc1/powershell-7.6.0-rc1-osx-x64.tar.gz -[28]: https://specifications.freedesktop.org/basedir/latest/ -[29]: https://support.apple.com/102445 +[03]: https://aka.ms/powershell-release?tag=stable +[04]: https://brew.sh/ +[05]: https://docs.brew.sh/Manpage#link-ln-options-formula +[06]: https://github.com/Homebrew +[07]: https://github.com/Homebrew/homebrew-cask +[08]: https://github.com/PowerShell/PowerShell/releases/download/v7.4.13/powershell-7.4.13-osx-arm64.pkg +[09]: https://github.com/PowerShell/PowerShell/releases/download/v7.4.13/powershell-7.4.13-osx-arm64.tar.gz +[10]: https://github.com/PowerShell/PowerShell/releases/download/v7.4.13/powershell-7.4.13-osx-x64.pkg +[11]: https://github.com/PowerShell/PowerShell/releases/download/v7.4.13/powershell-7.4.13-osx-x64.tar.gz +[12]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.4/powershell-7.5.4-osx-arm64.pkg +[13]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.4/powershell-7.5.4-osx-arm64.tar.gz +[14]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.4/powershell-7.5.4-osx-x64.pkg +[15]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.4/powershell-7.5.4-osx-x64.tar.gz +[16]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-rc1/powershell-7.6.0-rc1-osx-arm64.pkg +[17]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-rc1/powershell-7.6.0-rc1-osx-arm64.tar.gz +[18]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-rc1/powershell-7.6.0-rc1-osx-x64.pkg +[19]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-rc1/powershell-7.6.0-rc1-osx-x64.tar.gz +[20]: https://specifications.freedesktop.org/basedir/latest/ +[21]: https://support.apple.com/102445 +[22]: PowerShell-Support-Lifecycle.md diff --git a/reference/docs-conceptual/install/install-powershell-on-windows-iot-nano.md b/reference/docs-conceptual/install/install-powershell-on-windows-iot-nano.md index a91e77af3506..9a66308315ac 100644 --- a/reference/docs-conceptual/install/install-powershell-on-windows-iot-nano.md +++ b/reference/docs-conceptual/install/install-powershell-on-windows-iot-nano.md @@ -1,11 +1,11 @@ --- description: How to install PowerShell on Windows IoT and Nano Server. -ms.date: 12/15/2025 -title: Install PowerShell on Windows IoT and Nano Server +ms.date: 03/06/2026 +title: Install PowerShell 7 on Windows IoT and Nano Server --- -# Install PowerShell on Windows IoT and Nano Server +# Install PowerShell 7 on Windows IoT and Nano Server -This article describes how to install PowerShell on Windows IoT and Nano Server. +This article describes how to install PowerShell 7 on Windows IoT and Nano Server. ## Deploy on Windows 11 IoT @@ -104,7 +104,7 @@ Expand-Archive -Path C:\PowerShell-7.5.4-win-x64.zip -DestinationPath 'C:\Progra You can check the version that you are using by running `winver.exe`. -## Installation support +## Supported installation methods Microsoft supports the installation methods in this document. There may be other third-party methods of installation available from other sources. While those tools and methods may work, Microsoft diff --git a/reference/docs-conceptual/install/install-powershell-on-windows.md b/reference/docs-conceptual/install/install-powershell-on-windows.md index 1b5d4137de25..903f7b4e8b8c 100644 --- a/reference/docs-conceptual/install/install-powershell-on-windows.md +++ b/reference/docs-conceptual/install/install-powershell-on-windows.md @@ -1,46 +1,45 @@ --- description: How to install PowerShell on Windows -ms.date: 02/20/2026 -title: Install PowerShell on Windows +ms.date: 03/06/2026 +title: Install PowerShell 7 on Windows --- -# Install PowerShell on Windows +# Install PowerShell 7 on Windows + +PowerShell 7 doesn't replace Windows PowerShell 5.1. It installs to a new directory and runs +side-by-side with Windows PowerShell 5.1. There are some Windows PowerShell modules that can be run +using the PowerShell 7 Windows Compatibility feature. Other modules require that you run them in +Windows PowerShell 5.1. For more information, see [PowerShell 7 module compatibility][01]. + +There are multiple package versions of PowerShell 7 that can be installed. This article focuses on +installing the latest stable release package. For more information about the package versions, see +the [PowerShell Support Lifecycle][26] article. + +## Choose an installation method There are multiple ways to install PowerShell in Windows. Each install method is designed to support different scenarios and workflows. Choose the method that best suits your needs. -- [WinGet][10] - Recommended way to install PowerShell on Windows clients -- [MSI package][08] - Best choice for Windows Servers and enterprise deployment scenarios -- [ZIP package][11] - Easiest way to _side load_ or install multiple versions +- [WinGet][11] - Recommended way to install PowerShell on Windows clients +- [MSI package][09] - Best choice for Windows Servers and enterprise deployment scenarios +- [ZIP package][12] - Easiest way to _side load_ or install multiple versions - Use this method for Windows Nano Server, Windows IoT, and Arm-based systems -- [.NET Global tool][07] - A good choice for .NET developers that install and use other global tools -- [Microsoft Store package][09] - An easy way to install for casual users of PowerShell but has +- [.NET Global tool][08] - A good choice for .NET developers that install and use other global tools +- [Microsoft Store package][10] - An easy way to install for casual users of PowerShell but has limitations -PowerShell 7 installs to a new directory and runs side-by-side with Windows PowerShell 5.1. Newer -versions of PowerShell 7 replace existing previous versions of PowerShell 7. Preview versions of -PowerShell can be installed side-by-side with other versions of PowerShell. Newer preview versions -replace existing previous preview versions. - -PowerShell 7 supports updates through Microsoft Update. When you enable this feature, you'll get -the latest PowerShell 7 updates in your traditional Microsoft Update (MU) management flow, whether -that's with Windows Update for Business, WSUS, Microsoft Endpoint Configuration Manager, or the -interactive MU dialog in **Settings**. +### Install PowerShell using WinGet (recommended) -For more information, see the [PowerShell Microsoft Update FAQ][23]. - -## Install PowerShell using WinGet (recommended) - -WinGet, the Windows Package Manager, is a command-line tool enables users to +WinGet, the Windows Package Manager, is a command-line tool that enables you to discover, install, upgrade, remove, and configure applications on Windows client computers. This tool is the client interface to the Windows Package Manager service. The `winget` command-line tool -is bundled with Windows 11 and modern versions of Windows 10 by default as the **App Installer**. +is included in Windows 11 and Windows Server 2025 as part of the **App Installer**. > [!NOTE] -> See the [winget documentation][06] for a list of system requirements and install instructions. +> See the [winget documentation][07] for a list of system requirements and install instructions. > `winget` isn't available on Windows Server 2022 or earlier versions. Windows Server 2025 includes > `winget` for **Windows Server with Desktop Experience** only. -The following commands can be used to install PowerShell using the published `winget` packages: +Use the following `winget` commands to install PowerShell: Search for the latest version of PowerShell @@ -55,12 +54,14 @@ PowerShell Microsoft.PowerShell 7.5.4.0 winget PowerShell Preview Microsoft.PowerShell.Preview 7.6.0.6 winget ``` -Install PowerShell or PowerShell Preview using the `--id` parameter +Install PowerShell 7: ```powershell winget install --id Microsoft.PowerShell --source winget ``` +If you want to install PowerShell 7 Preview, use the following command: + ```powershell winget install --id Microsoft.PowerShell.Preview --source winget ``` @@ -69,36 +70,25 @@ winget install --id Microsoft.PowerShell.Preview --source winget > 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. -## Install the MSI package +### Install the MSI package To install PowerShell on Windows, use the following links to download the install package from GitHub. Latest stable release: -- [PowerShell-7.5.4-win-x64.msi][14] -- [PowerShell-7.5.4-win-x86.msi][16] -- [PowerShell-7.5.4-win-arm64.msi][12] +- [PowerShell-7.5.4-win-x64.msi][15] +- [PowerShell-7.5.4-win-x86.msi][17] +- [PowerShell-7.5.4-win-arm64.msi][13] Latest Preview release: -- [PowerShell-7.6.0-rc1-win-x64.msi][19] -- [PowerShell-7.6.0-rc1-win-x86.msi][20] -- [PowerShell-7.6.0-rc1-win-arm64.msi][18] +- [PowerShell-7.6.0-rc1-win-x64.msi][20] +- [PowerShell-7.6.0-rc1-win-x86.msi][21] +- [PowerShell-7.6.0-rc1-win-arm64.msi][19] Once downloaded, double-click the installer file and follow the prompts. -The installer creates a shortcut in the Windows Start Menu. - -- By default the package is installed to `$Env:ProgramFiles\PowerShell\7` - - The install location is added to your `$Env:PATH` environment variable -- Preview releases of PowerShell 7 install to `$Env:ProgramFiles\PowerShell\7-preview` -- You can launch PowerShell via the Start Menu or `$Env:ProgramFiles\PowerShell\7\pwsh.exe` - -> [!NOTE] -> To run PowerShell 7.5 side-by-side with other versions of PowerShell 7, use the [ZIP install][11] -> method to install the other version to a different folder. - ### Install the MSI package from the command line MSI packages can be installed from the command line allowing administrators to deploy packages @@ -141,30 +131,32 @@ The following example shows how to silently install PowerShell with all the inst msiexec.exe /package PowerShell-7.5.4-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][04]. +For a full list of command-line options for `Msiexec.exe`, see [Command line options][05]. -## Install from the ZIP package +### Install from the ZIP package PowerShell binary ZIP archives are provided to enable advanced deployment scenarios. -Download one of the following ZIP archives from the [current release][21] page. +Download one of the following ZIP archives from the [current release][22] page. -- [PowerShell-7.5.4-win-x64.zip][15] -- [PowerShell-7.5.4-win-x86.zip][17] -- [PowerShell-7.5.4-win-arm64.zip][13] +- [PowerShell-7.5.4-win-x64.zip][16] +- [PowerShell-7.5.4-win-x86.zip][18] +- [PowerShell-7.5.4-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 installing the MSI packages, installing the ZIP archive doesn't check for prerequisites. For -remoting over WSMan to work properly, ensure that you've met the [prerequisites][03]. +remoting over WSMan to work properly, ensure that you've met the [prerequisites][04]. Use this method to install the ARM-based version of PowerShell on computers like the Microsoft -Surface Pro X. For best results, install PowerShell to the to `$Env:ProgramFiles\PowerShell\7` -folder. +Surface Pro X. For best results, install PowerShell to the `$Env:ProgramFiles\PowerShell\7` folder. +If you are installing an additional version of PowerShell 7 side-by-side with an existing version of +PowerShell 7, install the additional version to a different folder. You must manually add a shortcut +to the Start Menu and add the location to the PATH environment variable. -## Install as a .NET Global tool +### Install as a .NET Global tool -If you already have the [.NET Core SDK][01] installed, you can install PowerShell -as a [.NET Global tool][02]. +If you already have the [.NET Core SDK][02] installed, you can install PowerShell +as a [.NET Global tool][03]. ``` dotnet tool install --global PowerShell @@ -174,10 +166,10 @@ The dotnet tool installer adds `$HOME\.dotnet\tools` to your `$Env:PATH` environ However, the currently running shell doesn't have the updated `$Env:PATH`. You can start PowerShell from a new shell by typing `pwsh`. -## Install from the Microsoft Store +### Install from the Microsoft Store PowerShell can be installed from the Microsoft Store. You can find the -PowerShell release in the [Microsoft Store][22] site or in the Store application in Windows. +PowerShell release in the [Microsoft Store][23] site or in the Store application in Windows. Benefits of the Microsoft Store package: @@ -185,26 +177,28 @@ Benefits of the Microsoft Store package: - Integrates with other software distribution mechanisms like Intune and Configuration Manager - Can install on Windows systems using x86, x64, or Arm64 processors -### Known limitations +#### Limitations of a Store-based installation -By default, Windows Store packages run in an application sandbox that virtualizes access to some -filesystem and registry locations. Changes to virtualized file and registry locations don't persist -outside of the application sandbox. +Store-based installations are installed for a single user. There is no option to install it for all +users. By default, Microsoft Store packages run in an application sandbox that virtualizes access to +some filesystem and registry locations. Changes to virtualized file and registry locations don't +persist outside of the application sandbox. -This sandbox blocks all changes to the application's root folder. Any system-level configuration -settings stored in `$PSHOME` can't be modified. This includes the WSMAN configuration. This prevents -remote sessions from connecting to Store-based installs of PowerShell. User-level configurations and -SSH remoting are supported. +Store-based installations don't support PowerShell remoting. The application sandbox blocks all +changes to the application's root folder. Any system-level configuration settings stored in +`$PSHOME` can't be modified. This includes the WSMAN configuration. This prevents remote sessions +from connecting to Store-based installs of PowerShell. User-level configurations and SSH remoting +for outbound connections are supported. -The following commands need write to `$PSHOME`. These commands aren't supported in a Microsoft Store -instance of PowerShell. +The following commands aren't supported in a Microsoft Store instance of PowerShell. These commands +need write access to `$PSHOME`. - `Register-PSSessionConfiguration` - `Update-Help -Scope AllUsers` - `Enable-ExperimentalFeature -Scope AllUsers` - `Set-ExecutionPolicy -Scope LocalMachine` -For more information, see [Understanding how packaged desktop apps run on Windows][05]. +For more information, see [Understanding how packaged desktop apps run on Windows][06]. Beginning in PowerShell 7.2, the PowerShell package is now exempt from file and registry virtualization. Changes to virtualized file and registry locations now persist outside of the @@ -213,19 +207,57 @@ application sandbox. However, changes to the application's root folder are still > [!IMPORTANT] > You must be running on Windows build 1903 or higher for this exemption to work. -## Upgrade an existing installation +## Start PowerShell 7 + +After installing PowerShell 7, you can start it by running the `pwsh` command or open it from the +Start Menu. The installer creates shortcut entries in the Windows Start Menu. + +By default, the installer installs the package in `$Env:ProgramFiles\PowerShell\7`. Preview releases +of PowerShell 7 install to `$Env:ProgramFiles\PowerShell\7-preview`. The installed location is added +to your `$Env:PATH` environment variable. + +> [!NOTE] +> To run PowerShell 7.5 side-by-side with other versions of PowerShell 7, use the [ZIP install][12] +> method to install the other version to a different folder. When you install using the ZIP method, +> you must manually add a shortcut to the Start Menu and add the location to the PATH environment +> variable. + +The following screenshot shows multiple versions of PowerShell in the Start Menu. Select the item +labeled **PowerShell 7**. + +![PowerShell in the Start Menu.][24] + +The selected entry is for PowerShell 7. Preview versions of PowerShell 7 install side-by-side with +stable versions. Select the item labeled **PowerShell 7-preview** to start the preview version. + +The first and last entries shown are for Windows PowerShell 5.1, which are installed by default on +Windows. If you choose **Windows PowerShell ISE**, that starts the Windows PowerShell Integrated +Scripting Environment (ISE), which is a different application that only works with Windows +PowerShell 5.1. + +## Upgrade PowerShell 7 + +PowerShell 7 supports updates through Microsoft Update. When you enable this feature, you'll get +the latest PowerShell 7 updates in your traditional Microsoft Update (MU) management flow, whether +that's with Windows Update for Business, WSUS, Microsoft Endpoint Configuration Manager, or the +interactive MU dialog in **Settings**. For more information, see the +[PowerShell Microsoft Update FAQ][25]. + +If you want to upgrade to the latest version of PowerShell 7 before it's available through Microsoft +Update, you should use the same install method you used when you first installed PowerShell. Newer +versions of PowerShell 7 replace existing previous versions of PowerShell 7. Preview versions of +PowerShell can be installed side-by-side with non-preview versions of PowerShell. Newer preview +versions replace existing previous preview versions. -For best results when upgrading, you should use the same install method you used when you first -installed PowerShell. If you aren't sure how PowerShell was installed, you can check the value of -the `$PSHOME` variable, which always points to the directory containing PowerShell that the current -session is running. +If you aren't sure how PowerShell was installed, you can check the value of the `$PSHOME` variable, +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][07]. +- 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][08] or with [WinGet][10] on a computer with an X86 or x64 processor. + [MSI package][09] or with [WinGet][11] on a computer with an X86 or x64 processor. - If the value starts with `$Env:ProgramFiles\WindowsApps\`, PowerShell was installed as a - [Microsoft Store package][09] or with [WinGet][10] on computer with an ARM processor. -- If the value is anything else, it's likely that PowerShell was installed as a [ZIP package][11]. + [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]. If you installed via the MSI package, that information also appears in the **Programs and Features** Control Panel. @@ -270,7 +302,7 @@ The process of uninstalling PowerShell 7 depends on the installation method you You can check the version that you are using by running `winver.exe`. -## Installation support +## Supported installation methods Microsoft supports the installation methods in this document. There may be other third-party methods of installation available from other sources. While those tools and methods may work, Microsoft @@ -279,26 +311,29 @@ can't support those methods. [!INCLUDE [Latest version](../../includes/latest-install.md)] -[01]: /dotnet/core/sdk -[02]: /dotnet/core/tools/global-tools -[03]: /powershell/module/microsoft.powershell.core/about/about_remote_requirements -[04]: /windows/desktop/Msi/command-line-options -[05]: /windows/msix/desktop/desktop-to-uwp-behind-the-scenes -[06]: /windows/package-manager/winget -[07]: #dotnet -[08]: #msi -[09]: #msstore -[10]: #winget -[11]: #zip -[12]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.4/PowerShell-7.5.4-win-arm64.msi -[13]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.4/PowerShell-7.5.4-win-arm64.zip -[14]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.4/PowerShell-7.5.4-win-x64.msi -[15]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.4/PowerShell-7.5.4-win-x64.zip -[16]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.4/PowerShell-7.5.4-win-x86.msi -[17]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.4/PowerShell-7.5.4-win-x86.zip -[18]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-rc1/PowerShell-7.6.0-rc1-win-arm64.msi -[19]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-rc1/PowerShell-7.6.0-rc1-win-x64.msi -[20]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-rc1/PowerShell-7.6.0-rc1-win-x86.msi -[21]: https://github.com/PowerShell/PowerShell/releases/latest -[22]: https://www.microsoft.com/store/apps/9MZ1SNWT0N5D -[23]: microsoft-update-faq.yml +[01]: ../whats-new/module-compatibility.md +[02]: /dotnet/core/sdk +[03]: /dotnet/core/tools/global-tools +[04]: /powershell/module/microsoft.powershell.core/about/about_remote_requirements +[05]: /windows/desktop/Msi/command-line-options +[06]: /windows/msix/desktop/desktop-to-uwp-behind-the-scenes +[07]: /windows/package-manager/winget +[08]: #dotnet +[09]: #msi +[10]: #msstore +[11]: #winget +[12]: #zip +[13]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.4/PowerShell-7.5.4-win-arm64.msi +[14]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.4/PowerShell-7.5.4-win-arm64.zip +[15]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.4/PowerShell-7.5.4-win-x64.msi +[16]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.4/PowerShell-7.5.4-win-x64.zip +[17]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.4/PowerShell-7.5.4-win-x86.msi +[18]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.4/PowerShell-7.5.4-win-x86.zip +[19]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-rc1/PowerShell-7.6.0-rc1-win-arm64.msi +[20]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-rc1/PowerShell-7.6.0-rc1-win-x64.msi +[21]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-rc1/PowerShell-7.6.0-rc1-win-x86.msi +[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 +[25]: microsoft-update-faq.yml +[26]: PowerShell-Support-Lifecycle.md diff --git a/reference/docs-conceptual/install/install-powershell.yml b/reference/docs-conceptual/install/install-powershell.yml index 154938c3d2a8..7572b2c5dcb7 100644 --- a/reference/docs-conceptual/install/install-powershell.yml +++ b/reference/docs-conceptual/install/install-powershell.yml @@ -7,7 +7,7 @@ metadata: title: Install PowerShell on Windows, Linux, and macOS description: Learn how to install PowerShell on Windows, Linux, and macOS. ms.topic: landing-page - ms.date: 11/19/2025 + ms.date: 03/06/2026 # linkListType: architecture | concept | deploy | download | get-started | how-to-guide | learn | overview | quickstart | reference | sample | tutorial | video | whats-new @@ -33,7 +33,7 @@ landingContent: - text: Install on macOS url: install-powershell-on-macos.md - text: Supported macOS releases - url: install-powershell-on-macos.md#supported-versions + url: install-powershell-on-macos.md#supported-versions-of-macos # Card - title: Linux diff --git a/reference/docs-conceptual/install/install-rhel.md b/reference/docs-conceptual/install/install-rhel.md index a77a5a32c157..b868a6177687 100644 --- a/reference/docs-conceptual/install/install-rhel.md +++ b/reference/docs-conceptual/install/install-rhel.md @@ -1,34 +1,35 @@ --- description: Information about installing PowerShell on Red Hat Enterprise Linux (RHEL) -ms.date: 02/20/2026 -title: Installing PowerShell on Red Hat Enterprise Linux (RHEL) +ms.date: 03/06/2026 +title: Install PowerShell 7 on Red Hat Enterprise Linux (RHEL) --- -# Installing PowerShell on Red Hat Enterprise Linux (RHEL) +# Install PowerShell 7 on Red Hat Enterprise Linux (RHEL) -All packages are available on our GitHub [releases][02] page. Before installing, check the list of -[Supported versions][01] below. After the package is installed, run `pwsh` from a terminal. Run -`pwsh-preview` if you installed a preview release. +There are multiple package versions of PowerShell 7 that can be installed. This article focuses on +installing the latest stable release package. For more information about the package versions, see +the [PowerShell Support Lifecycle][03] article. Newer versions of PowerShell 7 replace existing previous versions of PowerShell 7. Preview versions of PowerShell can be installed side-by-side with other versions of PowerShell. Newer preview -versions replace existing previous preview versions. If you need to run PowerShell 7.5 side-by-side -with a previous version, reinstall the previous version using the [binary archive][05] method. +versions replace existing previous preview versions. -RHEL 7 uses `yum` and RHEL 8 and higher uses the `dnf` package manager. +## Choose an installation method -[!INCLUDE [Latest version](../../includes/latest-install.md)] +On RHEL, you can install PowerShell using the universal `.rpm` package from the Microsoft +package repository or by downloading file from the GitHub release page. -## Installation via the Package Repository +### Install PowerShell 7 from the Package Repository Microsoft builds and supports a variety of software products for Linux systems and makes them available via Linux packaging clients (apt, dnf, yum, etc). These Linux software packages are hosted -on the _Linux package repository for Microsoft products_, [https://packages.microsoft.com][03], also +on the _Linux package repository for Microsoft products_, [https://packages.microsoft.com][01], also known as _PMC_. Installing PowerShell from PMC is the preferred method of installation. > [!NOTE] -> This script only works for supported versions of RHEL that are published to PMC. +> This script only works for supported versions of RHEL that have a package published to the +> Microsoft package repository. ```sh #!/bin/bash @@ -37,11 +38,10 @@ Installing PowerShell from PMC is the preferred method of installation. # Get version of RHEL source /etc/os-release -if [ ${VERSION_ID%.*} -lt 8 ] -then majorver=7 -elif [ ${VERSION_ID%.*} -lt 9 ] +if [ ${VERSION_ID%.*} -ge 8 ] then majorver=8 -else majorver=9 +elif [ ${VERSION_ID%.*} -ge 9 ] +then majorver=9 fi # Download the Microsoft RedHat repository package @@ -59,47 +59,33 @@ sudo dnf update sudo dnf install powershell -y ``` -## Installation via direct download +### Manually download and install PowerShell 7 -PowerShell 7.2 introduced a universal package that makes installation easier. Download the universal -package from the [releases][02] page onto your RHEL machine. Use this method to install PowerShell -on systems running RHEL 10. +Download the universal package from the GitHub releases page. Select the URL of the package version +you want to install. -The link to the current version is: - -- PowerShell 7.4.13 universal package for supported versions of RHEL - - `https://github.com/PowerShell/PowerShell/releases/download/v7.4.13/powershell-7.4.13-1.rh.x86_64.rpm` -- PowerShell 7.5.4 universal package for supported versions of RHEL +- PowerShell 7.5 universal package - `https://github.com/PowerShell/PowerShell/releases/download/v7.5.4/powershell-7.5.4-1.rh.x86_64.rpm` -- PowerShell 7.6-preview universal package for supported versions of RHEL +- PowerShell 7.4 (LTS) universal package + - `https://github.com/PowerShell/PowerShell/releases/download/v7.4.13/powershell-7.4.13-1.rh.x86_64.rpm` +- PowerShell 7.6-preview universal package - `https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-rc1/powershell-preview-7.6.0-rc1-1.rh.x86_64.rpm` -The following shell script downloads and installs the current preview release of PowerShell. You can -change the URL to download the version of PowerShell that you want to install. - -On RHEL 8 or 9: +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. ```sh sudo dnf install https://github.com/PowerShell/PowerShell/releases/download/v7.5.4/powershell-7.5.4-1.rh.x86_64.rpm ``` -## Uninstall PowerShell - -On RHEL 8 or 9: - -```sh -sudo dnf remove powershell -``` +## Start PowerShell 7 -## Support for Arm processors +After the package is installed, run `pwsh` from a terminal. If you have installed a Preview package, +run `pwsh-preview`. -PowerShell 7.2 and newer supports running on RHEL using a 64-bit Arm processor. Use the binary -archive installation method of installing PowerShell that's described in -[Alternate ways to install PowerShell on Linux][05]. - -## PowerShell paths - -- `$PSHOME` is `/opt/microsoft/powershell/7/` +- The location of `$PSHOME` varies based on the package you installed. + - For Stable and LTS packages: `/opt/microsoft/powershell/7/` + - For Preview packages: `/opt/microsoft/powershell/7-preview/` - The profiles scripts are stored in the following locations: - AllUsersAllHosts - `$PSHOME/profile.ps1` - AllUsersCurrentHost - `$PSHOME/Microsoft.PowerShell_profile.ps1` @@ -111,21 +97,28 @@ archive installation method of installing PowerShell that's described in - Default modules - `$PSHOME/Modules` - PSReadLine history is recorded in `~/.local/share/powershell/PSReadLine/ConsoleHost_history.txt` -PowerShell respects the [XDG Base Directory Specification][04] on Linux. +The profiles respect PowerShell's per-host configuration, so the default host-specific profiles +exists at `Microsoft.PowerShell_profile.ps1` in the same locations. + +PowerShell respects the [XDG Base Directory Specification][02] on Linux. + +## Uninstall PowerShell 7 + +```sh +sudo dnf remove powershell +``` -## Supported versions +## Supported versions of RHEL [!INCLUDE [RHEL support](../../includes/rhel-support.md)] -## Installation support +## Supported installation methods -Microsoft supports the installation methods in this document. There may be other methods of -installation available from other third-party sources. While those tools and methods may work, -Microsoft can't support those methods. +Microsoft supports the installation methods in this document. There may be other third-party methods +of installation available from other sources. While those tools and methods may work, Microsoft +can't support those methods. -[01]: #supported-versions -[02]: https://aka.ms/PowerShell-Release?tag=stable -[03]: https://packages.microsoft.com -[04]: https://specifications.freedesktop.org/basedir/latest/ -[05]: install-other-linux.md#binary-archives +[01]: https://packages.microsoft.com +[02]: https://specifications.freedesktop.org/basedir/latest/ +[03]: PowerShell-Support-Lifecycle.md diff --git a/reference/docs-conceptual/install/install-ubuntu.md b/reference/docs-conceptual/install/install-ubuntu.md index 4512a7ba84e4..d7201444ac3f 100644 --- a/reference/docs-conceptual/install/install-ubuntu.md +++ b/reference/docs-conceptual/install/install-ubuntu.md @@ -1,34 +1,36 @@ --- description: Information about installing PowerShell on Ubuntu -ms.date: 02/20/2026 -title: Installing PowerShell on Ubuntu +ms.date: 03/06/2026 +title: Install PowerShell 7 on Ubuntu --- -# Installing PowerShell on Ubuntu +# Install PowerShell 7 on Ubuntu -All packages are available on our GitHub [releases][05] page. Before installing, -check the list of [Supported versions][04] below. After the package is installed, run -`pwsh` from a terminal. Run `pwsh-lts` if you installed a preview release. +There are multiple package versions of PowerShell 7 that can be installed. This article focuses on +installing the latest stable release package. For more information about the package versions, see +the [PowerShell Support Lifecycle][07] article. Newer versions of PowerShell 7 replace existing previous versions of PowerShell 7. Preview versions of PowerShell can be installed side-by-side with other versions of PowerShell. Newer preview versions replace existing previous preview versions. If you need to run PowerShell 7.5 side-by-side -with a previous version, reinstall the previous version using the [binary archive][08] method. +with a previous version, reinstall the previous version using the [binary archive][06] method. -Ubuntu uses APT (Advanced Package Tool) as a package manager. +## Choose an installation method -[!INCLUDE [Latest version](../../includes/latest-install.md)] +On Ubuntu Linux, you can install PowerShell using the universal `.deb` package from the Microsoft +package repository or by downloading a file from the [stable release][03] page. -## Installation via Package Repository the Package Repository +### Install PowerShell 7 from the Package Repository Microsoft builds and supports a variety of software products for Linux systems and makes them available via Linux packaging clients (apt, dnf, yum, etc). These Linux software packages are hosted -on the _Linux package repository for Microsoft products_, [https://packages.microsoft.com][06], also +on the _Linux package repository for Microsoft products_, [https://packages.microsoft.com][04], also known as _PMC_. Installing PowerShell from PMC is the preferred method of installation. > [!NOTE] -> This script only works for supported versions of Ubuntu. +> This script only works for supported versions of Ubuntu that have a package published to the +> Microsoft package repository. ```sh #!/bin/bash @@ -76,18 +78,16 @@ pwsh > repositories to favor one over the other. For instructions on how to set the priorities, see > [My Linux distribution provides .NET packages, and I want to use them][01]. -## Installation via direct download +### Manually download and install PowerShell 7 -PowerShell 7.2 introduced a universal package that makes installation easier. Download the universal -package from the [releases][05] page onto your Ubuntu machine. +Download the universal package from the GitHub releases page. Select the URL of the package version +you want to install. -The link to the current version is: - -- PowerShell 7.4 (LTS) universal package for supported versions of Ubuntu +- PowerShell 7.4 (LTS) universal package - `https://github.com/PowerShell/PowerShell/releases/download/v7.4.13/powershell_7.4.13-1.deb_amd64.deb` -- PowerShell 7.5 universal package for supported versions of Ubuntu +- PowerShell 7.5 universal package - `https://github.com/PowerShell/PowerShell/releases/download/v7.5.4/powershell_7.5.4-1.deb_amd64.deb` -- PowerShell 7.6-preview universal package for supported versions of Ubuntu +- PowerShell 7.6-preview universal - `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 preview release of PowerShell. You can @@ -116,26 +116,16 @@ sudo apt-get install -f # Delete the downloaded package file rm powershell_7.5.4-1.deb_amd64.deb - -# Start PowerShell Preview -pwsh ``` -## Uninstall PowerShell - -```sh -sudo apt-get remove powershell -``` - -## Support for Arm processors - -PowerShell 7.2 and newer supports running on Ubuntu using 32-bit Arm processors. Use the binary -archive installation method of installing PowerShell that's described in -[Alternate ways to install PowerShell on Linux][03]. +## Start PowerShell 7 -## PowerShell paths +After the package is installed, run `pwsh` from a terminal. If you have installed a Preview package, +run `pwsh-preview`. -- `$PSHOME` is `/opt/microsoft/powershell/7/` +- The location of `$PSHOME` varies based on the package you installed. + - For Stable and LTS packages: `/opt/microsoft/powershell/7/` + - For Preview packages: `/opt/microsoft/powershell/7-preview/` - The profiles scripts are stored in the following locations: - AllUsersAllHosts - `$PSHOME/profile.ps1` - AllUsersCurrentHost - `$PSHOME/Microsoft.PowerShell_profile.ps1` @@ -147,25 +137,38 @@ archive installation method of installing PowerShell that's described in - Default modules - `$PSHOME/Modules` - PSReadLine history is recorded in `~/.local/share/powershell/PSReadLine/ConsoleHost_history.txt` -PowerShell respects the [XDG Base Directory Specification][07] on Linux. +The profiles respect PowerShell's per-host configuration, so the default host-specific profiles +exists at `Microsoft.PowerShell_profile.ps1` in the same locations. + +PowerShell respects the [XDG Base Directory Specification][05] on Linux. + +## Uninstall PowerShell + +```sh +sudo apt-get remove powershell +``` + +## Support for Arm processors + +PowerShell 7.2 and newer supports running on Ubuntu using 32-bit Arm processors. Use the binary +archive installation method of installing PowerShell that's described in +[Alternate ways to install PowerShell on Linux][06]. ## Supported versions [!INCLUDE [Ubuntu support](../../includes/ubuntu-support.md)] -## Installation support +## Supported installation methods Microsoft supports the installation methods in this document. There may be other methods of installation available from other third-party sources. While those tools and methods may work, Microsoft can't support those methods. - [01]: /dotnet/core/install/linux-package-mixup?pivots=os-linux-ubuntu#my-linux-distribution-provides-net-packages-and-i-want-to-use-them [02]: /dotnet/core/install/linux-package-mixup?pivots=os-linux-ubuntu#whats-going-on -[03]: /powershell/scripting/install/install-other-linux -[04]: #supported-versions -[05]: https://aka.ms/PowerShell-Release?tag=stable -[06]: https://packages.microsoft.com -[07]: https://specifications.freedesktop.org/basedir/latest/ -[08]: install-other-linux.md#binary-archives +[03]: https://aka.ms/PowerShell-Release?tag=stable +[04]: https://packages.microsoft.com +[05]: https://specifications.freedesktop.org/basedir/latest/ +[06]: install-other-linux.md#binary-archives +[07]: PowerShell-Support-Lifecycle.md diff --git a/reference/docs-conceptual/install/media/install-powershell-on-windows/powershell-start-menu.png b/reference/docs-conceptual/install/media/install-powershell-on-windows/powershell-start-menu.png new file mode 100644 index 000000000000..19576865f7ad Binary files /dev/null and b/reference/docs-conceptual/install/media/install-powershell-on-windows/powershell-start-menu.png differ diff --git a/reference/docs-conceptual/toc.yml b/reference/docs-conceptual/toc.yml index 87b6e21ae2e7..d2ab761b7e97 100644 --- a/reference/docs-conceptual/toc.yml +++ b/reference/docs-conceptual/toc.yml @@ -14,13 +14,13 @@ items: href: powershell-commands.md - name: Discover PowerShell href: discover-powershell.md - - name: Install + - name: Install PowerShell 7 items: - name: Overview href: install/install-powershell.yml - - name: Install PowerShell on Windows + - name: Install PowerShell 7 on Windows href: install/install-powershell-on-windows.md - - name: Install PowerShell on Linux + - name: Install PowerShell 7 on Linux items: - name: Overview href: install/install-powershell-on-linux.md @@ -36,13 +36,13 @@ items: href: install/community-support.md - name: Alternate ways to install on Linux href: install/install-other-linux.md - - name: Install PowerShell on macOS + - name: Install PowerShell 7 on macOS href: install/install-powershell-on-macos.md - name: Install PowerShell on Windows IoT and Nano Server href: install/install-powershell-on-windows-iot-nano.md - - name: Install PowerShell on Arm + - name: Install PowerShell 7 on Arm href: install/powershell-on-arm.md - - name: Using PowerShell in Docker + - name: Using PowerShell 7 in Docker href: install/PowerShell-in-Docker.md - name: Microsoft Update FAQ for PowerShell href: install/microsoft-update-faq.yml diff --git a/reference/docs-conceptual/windows-powershell/update-notification-message.yml b/reference/docs-conceptual/windows-powershell/update-notification-message.yml index 3f55d3dfbba4..f6f2ae638c25 100644 --- a/reference/docs-conceptual/windows-powershell/update-notification-message.yml +++ b/reference/docs-conceptual/windows-powershell/update-notification-message.yml @@ -2,7 +2,7 @@ metadata: description: >- This article explains the intent of the update notification message in Windows PowerShell. - ms.date: 02/12/2026 + ms.date: 03/06/2026 ms.topic: faq title: Windows PowerShell update message FAQ @@ -24,45 +24,48 @@ sections: Windows PowerShell displays this message at startup to make you aware that there is a newer version of PowerShell available. - - question: I opened the URL but it didn't install an update. + - question: I opened the URL but it didn't install an update. How do I install PowerShell 7? answer: | - The `aka.ms` link takes you to this page. If you want to install the latest version of - PowerShell, follow the instructions in - [**Install PowerShell on Windows**](../install/install-powershell-on-windows.md). + The `aka.ms` link shown in the Windows PowerShell console takes you to this page. To + install the latest version of PowerShell 7, follow the instructions in the + [**Install PowerShell on Windows**](../install/install-powershell-on-windows.md) article. - question: But I installed PowerShell 7, why am I still seeing this message? answer: | - **You always get the message when you run Windows PowerShell 5.1.** + Because you ran Windows PowerShell instead of PowerShell 7. PowerShell 7 and Windows + PowerShell 5.1 are separate products. PowerShell 7 doesn't replace Windows PowerShell 5.1. + PowerShell 7 installs side-by-side. You can run either version. - PowerShell 7 and Windows PowerShell 5.1 are separate products. PowerShell 7 doesn't - replace Windows PowerShell 5.1. PowerShell 7 installs side-by-side. You can run either - version. - - - question: Can I disable the message? - answer: No. There is no way to disable the message. - - - question: How does Windows PowerShell 5.1 get updated? + - question: How do I run PowerShell 7? answer: | - Windows PowerShell 5.1 is a built-in component of Windows. It's important to understand - that Windows PowerShell 5.1 is no longer being developed. Microsoft only publishes - security updates for Windows PowerShell 5.1. All updates are managed through standard - Windows update channels. - - - question: My install of Windows is up-to-date. Why am I still getting this message? - answer: | - **This message appears every time you start Windows PowerShell 5.1.** - - It doesn't mean that Windows PowerShell 5.1 is not up-to-date. **It means that you didn't - run PowerShell 7.** + For instructions, see the _Start PowerShell 7_ section of the + [Install PowerShell on Windows](../install/install-powershell-on-windows.md#start-powershell-7) + article. - question: Why would I want to install PowerShell 7? answer: | - Windows PowerShell 5.1 is no longer being developed. PowerShell 7 is actively developed - and supported. PowerShell 7 is faster, more secure, and is available for Windows, Linux - and macOS. For more information, see - [Differences between Windows PowerShell 5.1 and PowerShell 7](../whats-new/differences-from-windows-powershell.md). + PowerShell 7 is faster, more secure, and is available for Windows, Linux and macOS. + PowerShell 7 is actively developed and supported. Windows PowerShell 5.1 is no longer + being developed. For more information, see the + [Differences between Windows PowerShell 5.1 and PowerShell 7](../whats-new/differences-from-windows-powershell.md) + article. - question: Do I need to install PowerShell 7? answer: | No, you don't need to install PowerShell 7 unless you have a specific requirement for the features it provides. + + - question: My install of Windows is up-to-date. Why am I still getting this message? + answer: | + This message appears every time you start Windows PowerShell 5.1. It doesn't mean that + Windows PowerShell 5.1 is not up-to-date. + + - question: How does Windows PowerShell 5.1 get updated? + answer: | + Microsoft only publishes security updates for Windows PowerShell 5.1. It's important to + understand that Windows PowerShell 5.1 is no longer being developed. Windows PowerShell + 5.1 is a built-in component of Windows. All updates are managed through standard Windows + update channels. + + - question: Can I disable the message? + answer: No. There is no way to disable the message. diff --git a/reference/includes/alpine-support.md b/reference/includes/alpine-support.md index 40efc432bd1e..c73bdcf5065c 100644 --- a/reference/includes/alpine-support.md +++ b/reference/includes/alpine-support.md @@ -1,17 +1,24 @@ --- author: sdwheeler ms.author: sewhee -ms.date: 07/03/2025 +ms.date: 03/06/2026 ms.topic: include --- Microsoft supports PowerShell until [PowerShell reaches end-of-support][lifecycle] or the version of [Alpine reaches end-of-life][eol-alpine]. +Support for these versions of Alpine ends on the following dates: + +- Alpine 3.23 - 2027-11-01 +- Alpine 3.22 - 2027-05-01 +- Alpine 3.21 - 2026-11-01 +- Alpine 3.20 - 2026-04-01 + The Docker images for the .NET SDK contain the latest versions of PowerShell. These images are available from the [Microsoft Artifact Registry][mcr]. -These images are built from official operating system (OS) images provide by the OS distributor. +These images are built from official operating system (OS) images provided by the OS distributor. These images may not have the latest security updates. Microsoft recommends that you update the OS packages to the latest version to ensure the latest security updates are applied. diff --git a/reference/includes/debian-support.md b/reference/includes/debian-support.md index a953dde6a3d7..0c86dd366172 100644 --- a/reference/includes/debian-support.md +++ b/reference/includes/debian-support.md @@ -1,13 +1,18 @@ --- author: sdwheeler ms.author: sewhee -ms.date: 07/03/2025 +ms.date: 03/06/2026 ms.topic: include --- Microsoft supports PowerShell until [PowerShell reaches end-of-support][lifecycle] or the version of [Debian reaches end-of-life][eol-debian]. +Support for these versions of Debian ends on the following dates: + +- Debian 13 - 2028-08-09 +- Debian 12 - 2026-06-10 + Install package files (`.deb`) are also available from [https://packages.microsoft.com/][pcm]. The Docker images for the .NET SDK contain the latest versions of PowerShell. These images are diff --git a/reference/includes/macos-support.md b/reference/includes/macos-support.md index b560addd6e89..47cbf4be4826 100644 --- a/reference/includes/macos-support.md +++ b/reference/includes/macos-support.md @@ -8,6 +8,8 @@ ms.topic: include Microsoft supports PowerShell until [PowerShell reaches end-of-support][lifecycle] or the version of macOS reaches end-of-support. +The following versions of macOS are supported: + - macOS 26 (Tahoe) x64 and Arm64 - macOS 15 (Sequoia) x64 and Arm64 - macOS 14 (Sonoma) x64 and Arm64 diff --git a/reference/includes/rhel-support.md b/reference/includes/rhel-support.md index fa21794accc6..acce3eaf497f 100644 --- a/reference/includes/rhel-support.md +++ b/reference/includes/rhel-support.md @@ -1,18 +1,20 @@ --- author: sdwheeler ms.author: sewhee -ms.date: 07/03/2025 +ms.date: 03/06/2026 ms.topic: include --- Microsoft supports PowerShell until [PowerShell reaches end-of-support][lifecycle] or the version of [RHEL reaches end-of-support][eol-rhel]. -Install package files (`.rpm`) are also available from [https://packages.microsoft.com/][pcm]. +Support for these versions of RHEL ends on the following dates: + +- RHEL 10 - 2035-05-31 +- RHEL 9 - 2032-05-31 +- RHEL 8 - 2029-05-31 -- RHEL 10 - OS support ends on 2035-05-31 -- RHEL 9 - OS support ends on 2032-05-31 -- RHEL 8 - OS support ends on 2029-05-31 +Install package files (`.rpm`) are also available from [https://packages.microsoft.com/][pcm]. PowerShell is tested on Red Hat Universal Base Images (UBI). For more information, see the [UBI information page][ubi]. diff --git a/reference/includes/ubuntu-support.md b/reference/includes/ubuntu-support.md index 19a9ecaf3c28..310175461610 100644 --- a/reference/includes/ubuntu-support.md +++ b/reference/includes/ubuntu-support.md @@ -1,13 +1,18 @@ --- author: sdwheeler ms.author: sewhee -ms.date: 09/16/2025 +ms.date: 03/06/2026 ms.topic: include --- Microsoft supports PowerShell until [PowerShell reaches end-of-support][lifecycle] or the version of [Ubuntu reaches end-of-support][eol-ubuntu]. +Support for these versions of Ubuntu ends on the following dates: + +- Ubuntu 24.04 - 2029-05-31 +- Ubuntu 22.04 - 2027-04-01 + Install package files (`.deb`) are also available from [https://packages.microsoft.com/][pcm]. The Docker images for the .NET SDK contain the latest versions of PowerShell. You can download these @@ -21,7 +26,7 @@ These images are provided for testing purposes. If you need a Docker image for a workload, you should build and maintain your own. > [!NOTE] -> Ubuntu 25.04 (Plucky Puffin) is an interim release. Microsoft doesn't support +> Ubuntu 25.10 (Questing Quokka) is an interim release. Microsoft doesn't test or support > [interim releases][interim] of Ubuntu. For more information, see > [Community supported distributions][community]. diff --git a/reference/includes/windows-support.md b/reference/includes/windows-support.md index a9429f7e1eaf..2bd11fe5d7e8 100644 --- a/reference/includes/windows-support.md +++ b/reference/includes/windows-support.md @@ -1,7 +1,7 @@ --- author: sdwheeler ms.author: sewhee -ms.date: 07/03/2025 +ms.date: 03/06/2026 ms.topic: include ---