From d8f653a431fc6eaedf3712f6721aa00ec4403300 Mon Sep 17 00:00:00 2001 From: Sean Wheeler Date: Wed, 11 Mar 2026 16:08:32 -0500 Subject: [PATCH 1/3] Update macOS install docs and move Brew to alternate doc --- redir/.openpublishing.redirection.json | 5 + ...-linux.md => alternate-install-methods.md} | 123 +++++++++++----- .../install/install-powershell-on-linux.md | 28 ++-- .../install/install-powershell-on-macos.md | 135 +++++------------- reference/docs-conceptual/toc.yml | 2 +- 5 files changed, 144 insertions(+), 149 deletions(-) rename reference/docs-conceptual/install/{install-other-linux.md => alternate-install-methods.md} (59%) diff --git a/redir/.openpublishing.redirection.json b/redir/.openpublishing.redirection.json index c1a1a161abae..78f537d265e9 100644 --- a/redir/.openpublishing.redirection.json +++ b/redir/.openpublishing.redirection.json @@ -1,5 +1,10 @@ { "redirections": [ + { + "redirect_document_id": false, + "redirect_url": "/reference/docs-conceptual/install/alternate-install-methods", + "source_path": "../reference/docs-conceptual/install/install-other-linux.md" + }, { "redirect_document_id": false, "redirect_url": "/powershell/scripting/security/app-control/how-to-use-app-control", diff --git a/reference/docs-conceptual/install/install-other-linux.md b/reference/docs-conceptual/install/alternate-install-methods.md similarity index 59% rename from reference/docs-conceptual/install/install-other-linux.md rename to reference/docs-conceptual/install/alternate-install-methods.md index 6631e3527228..16e2b1b59ff9 100644 --- a/reference/docs-conceptual/install/install-other-linux.md +++ b/reference/docs-conceptual/install/alternate-install-methods.md @@ -1,39 +1,76 @@ --- -description: Information about installing PowerShell on various Linux distributions -ms.date: 02/17/2026 -title: Alternate ways to install PowerShell on Linux +description: Alternate ways to install PowerShell on non-Windows platforms. +ms.date: 03/11/2026 +title: Alternate ways to install PowerShell --- -# Alternate ways to install PowerShell on Linux +# Alternate ways to install PowerShell -All packages are available on our GitHub [releases][14] page. After the package is installed, run -`pwsh` from a terminal. Run `pwsh-preview` if you installed a preview release. +There are other ways to install PowerShell on non-Windows platforms. -There are three other ways to install PowerShell on a Linux distribution: +These methods may work but aren't officially supported by Microsoft. You may be able to get support +from the PowerShell Community or the operating system vendor. For support options, see +[Community Support][08]. -- Install using a [Snap Package][11] -- Install using the [binary archives][09] -- Install as a [.NET Global tool][10] +## Install on macOS using Homebrew -## Snap Package +Homebrew is the preferred package manager for macOS. If the `brew` command isn't found, you need to +install Homebrew following [their instructions][12]. -Snaps are application packages that are easy to install, secure, cross‐platform and dependency‐free. -Snaps are discoverable and installable from the Snap Store. Snap packages are supported the same as -the distribution you're running the package on. +```bash +/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" +``` + +Once `brew` is installed, install PowerShell using the following command: + +```sh +brew install powershell +``` + +### Update PowerShell 7 + +Run the following commands to update the installed version of PowerShell to the latest release. + +```sh +brew update +brew upgrade powershell +``` + +### Uninstall PowerShell 7 + +If you installed PowerShell with Homebrew, use the following command to uninstall: + +```sh +brew uninstall powershell +``` + +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 +``` + +Use `sudo rm` to remove any other remaining PowerShell files and folders. + +## Install on Linux using a Snap package + +Snaps are application packages that are easy to install if your platform supports Snap. You can find +and install Snap packages from the Snap Store. Snap packages build PowerShell from source code +rather than installing a package built by Microsoft. > [!IMPORTANT] -> The Snap Store contains PowerShell snap packages for many Linux distributions that are not -> officially supported by Microsoft. For support, see the list of available [Community Support][08] -> options. +> The Snap Store contains PowerShell snap packages for many Linux distributions that aren't +> officially supported by Microsoft. ### Getting snapd The snap daemon, known as `snapd`, is the background service that manages and maintains your snaps. It needs to be running before a snap can be installed. For instructions on how to install `snapd`, -see the [Snapcraft documentation][16]. +see the [Snapcraft documentation][14]. ### Installation via Snap -There are two PowerShell for Linux is published to the [Snap store][17]: `powershell` and +There are two PowerShell for Linux is published to the [Snap store][15]: `powershell` and `powershell-preview`. Use the following command to install the latest stable version of PowerShell: @@ -78,7 +115,7 @@ pwsh-preview After installation, Snap will automatically upgrade. You can trigger an upgrade using `sudo snap refresh powershell` or `sudo snap refresh powershell-preview`. -### Uninstallation +### Uninstall using Snap ```sh sudo snap remove powershell @@ -90,7 +127,7 @@ or sudo snap remove powershell-preview ``` -## Binary Archives +## Install from binary archives PowerShell binary `tar.gz` archives are provided for Linux platforms to enable advanced deployment scenarios. @@ -98,19 +135,19 @@ scenarios. > [!NOTE] > You can use this method to install any version of PowerShell including the latest: > -> - Stable release: [https://aka.ms/powershell-release?tag=stable][14] -> - LTS release: [https://aka.ms/powershell-release?tag=lts][12] -> - Preview release: [https://aka.ms/powershell-release?tag=preview][13] +> - 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] ### Dependencies -PowerShell builds portable binaries for all Linux distributions. But, .NET Core runtime requires -different dependencies on different distributions, and PowerShell does too. +PowerShell builds portable binaries for all supported Linux distributions. But, PowerShell and the +.NET runtime require different dependencies on different distributions. It's possible that when you install PowerShell, specific dependencies may not be installed, such as when manually installing from the binary archives. The following list details Linux distributions that are supported by Microsoft and have dependencies you may need to install. Check the -distribution page for more information: +Linux distribution page for more information: - [Alpine][01] - [Debian][02] @@ -119,11 +156,7 @@ distribution page for more information: - [Ubuntu][05] To deploy PowerShell binaries on Linux distributions that aren't officially supported, you need to -install the necessary dependencies for the target OS in separate steps. For example, our -[Amazon Linux dockerfile][15] installs dependencies first, and then extracts the Linux `tar.gz` -archive. - -### Installation using a binary archive file +install the necessary dependencies for the target OS in separate steps. > [!IMPORTANT] > This method can be used to install PowerShell on any version of Linux, including distributions @@ -173,9 +206,12 @@ dotnet tool install --global PowerShell ``` The dotnet tool installer adds `~/.dotnet/tools` to your `PATH` environment variable. However, the -currently running shell does not have the updated `PATH`. You should be able to start PowerShell +currently running shell doesn't have the updated `PATH`. You should be able to start PowerShell from a new shell by typing `pwsh`. +The .NET team publishes Docker images containing the .NET SDK with PowerShell already installed. You +can find those images on the [Microsoft Container Registry][13]. + [01]: /dotnet/core/install/linux-alpine#dependencies [02]: /dotnet/core/install/linux-debian#dependencies @@ -185,12 +221,25 @@ from a new shell by typing `pwsh`. [06]: /dotnet/core/sdk [07]: /dotnet/core/tools/global-tools [08]: /powershell/scripting/community/community-support -[09]: #binary-archives -[10]: #install-as-a-net-global-tool -[11]: #snap-package [12]: https://aka.ms/powershell-release?tag=lts [13]: https://aka.ms/powershell-release?tag=preview [14]: https://aka.ms/PowerShell-Release?tag=stable -[15]: https://github.com/PowerShell/PowerShell-Docker/blob/master/release/unstable/amazonlinux/docker/Dockerfile [16]: https://snapcraft.io/docs/tutorials/install-the-daemon/ [17]: https://snapcraft.io/store +[15]: https://mcr.microsoft.com/en-us/artifact/mar/dotnet/sdk/ + +[01]: /dotnet/core/install/linux-alpine#dependencies +[02]: /dotnet/core/install/linux-debian#dependencies +[03]: /dotnet/core/install/linux-rhel#dependencies +[04]: /dotnet/core/install/linux-sles#dependencies +[05]: /dotnet/core/install/linux-ubuntu#dependencies +[06]: /dotnet/core/sdk +[07]: /dotnet/core/tools/global-tools +[08]: /powershell/scripting/community/community-support +[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://mcr.microsoft.com/en-us/artifact/mar/dotnet/sdk/ +[14]: https://snapcraft.io/docs/tutorials/install-the-daemon/ +[15]: https://snapcraft.io/store diff --git a/reference/docs-conceptual/install/install-powershell-on-linux.md b/reference/docs-conceptual/install/install-powershell-on-linux.md index 36fa01179655..34b66d97f470 100644 --- a/reference/docs-conceptual/install/install-powershell-on-linux.md +++ b/reference/docs-conceptual/install/install-powershell-on-linux.md @@ -11,7 +11,7 @@ PowerShell. PowerShell can be installed on some distributions of Linux that aren Microsoft. In those cases, you may find support from the community for PowerShell on those platforms. -For more information, see the [PowerShell Support Lifecycle][05] documentation. +For more information, see the [PowerShell Support Lifecycle][01] documentation. This article lists the supported Linux distributions and package managers. All PowerShell releases remain supported until either the version of PowerShell or the version of the Linux distribution @@ -23,7 +23,7 @@ For the best compatibility, choose a long-term release (LTS) version. [!INCLUDE [Alpine support](../../includes/alpine-support.md)] -For more information, see [Install PowerShell on Alpine][13]. +For more information, see [Install PowerShell on Alpine][03]. ## Debian @@ -31,7 +31,7 @@ Debian uses APT (Advanced Package Tool) as a package manager. [!INCLUDE [Debian support](../../includes/debian-support.md)] -For more information, see [Install PowerShell on Debian][14]. +For more information, see [Install PowerShell on Debian][04]. ## Red Hat Enterprise Linux (RHEL) @@ -39,7 +39,7 @@ RHEL 7 uses yum and RHEL 8 uses the dnf package manager. [!INCLUDE [RHEL support](../../includes/rhel-support.md)] -For more information, see [Install PowerShell on RHEL][17]. +For more information, see [Install PowerShell on RHEL][06]. ## Ubuntu @@ -47,7 +47,7 @@ Ubuntu uses APT (Advanced Package Tool) as a package manager. [!INCLUDE [Ubuntu support](../../includes/ubuntu-support.md)] -For more information, see [Install PowerShell on Ubuntu][18]. +For more information, see [Install PowerShell on Ubuntu][07]. ## Community supported distributions @@ -61,20 +61,20 @@ To be supported by Microsoft, the Linux distribution must meet the following cri - The version of the distribution isn't an interim release or equivalent. - The PowerShell team has tested the version of the distribution. -For more information, see [Community support for PowerShell on Linux][06]. +For more information, see [Community support for PowerShell on Linux][02]. ## Alternate installation methods There are three other ways to install PowerShell on Linux, including Linux distributions that aren't officially supported. You can try to install PowerShell using the PowerShell Snap Package. You can also try deploying PowerShell binaries directly using the Linux `tar.gz` package. For more -information, see [Alternate ways to install PowerShell on Linux][15]. +information, see [Alternate ways to install PowerShell on Linux][05]. -[05]: ../PowerShell-Support-Lifecycle.md -[06]: community-support.md -[13]: install-alpine.md -[14]: install-debian.md -[15]: install-other-linux.md -[17]: install-rhel.md -[18]: install-ubuntu.md +[01]: ../PowerShell-Support-Lifecycle.md +[02]: community-support.md +[03]: install-alpine.md +[04]: install-debian.md +[05]: install-other-linux.md +[06]: install-rhel.md +[07]: install-ubuntu.md diff --git a/reference/docs-conceptual/install/install-powershell-on-macos.md b/reference/docs-conceptual/install/install-powershell-on-macos.md index e7b2c83186fd..37b69646db54 100644 --- a/reference/docs-conceptual/install/install-powershell-on-macos.md +++ b/reference/docs-conceptual/install/install-powershell-on-macos.md @@ -1,6 +1,6 @@ --- description: How to install PowerShell on macOS -ms.date: 03/06/2026 +ms.date: 03/11/2026 title: Install PowerShell 7 on macOS --- @@ -8,7 +8,7 @@ title: Install PowerShell 7 on macOS 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. +the [PowerShell Support Lifecycle][19] 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 @@ -17,52 +17,22 @@ with a previous version, reinstall the previous version using the binary archive ## Choose an installation method -There are several ways to install PowerShell on macOS. Homebrew is the preferred installation -method. - -### Install PowerShell 7 using Homebrew - -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)" -``` - -Once `brew` is installed, install PowerShell. - -The following command installs the latest stable release of PowerShell: - -```sh -brew install --cask powershell -``` - -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: - -- `powershell/tap/powershell-lts` -- `powershell/tap/powershell-preview` - -For example, use the following command to install the Preview release: - -```sh -brew install powershell/tap/powershell-preview -``` +There are several ways to install PowerShell on macOS. ### Manually download and install the package -Download the install package from the [releases][03] page. Select the package version you want to +Download the install package from the [releases][04] page. Select the package version you want to install. - PowerShell 7.5 - - Arm64 processors - [powershell-7.5.4-arm64.pkg][12] - - x64 processors - [powershell-7.5.4-osx-x64.pkg][14] + - Arm64 processors - [powershell-7.5.4-arm64.pkg][09] + - x64 processors - [powershell-7.5.4-osx-x64.pkg][11] - PowerShell 7.4 (LTS) - - Arm64 processors - [powershell-7.4.13-osx-arm64.pkg][08] - - x64 processors - [powershell-7.4.13-osx-x64.pkg][10] + - Arm64 processors - [powershell-7.4.13-osx-arm64.pkg][05] + - x64 processors - [powershell-7.4.13-osx-x64.pkg][07] - PowerShell 7.6-preview - - Arm64 processors - [powershell-7.6.0-rc1-osx-arm64.pkg][16] - - x64 processors - [powershell-7.6.0-rc1-osx-x64.pkg][18] + - Arm64 processors - [powershell-7.6.0-rc1-osx-arm64.pkg][13] + - x64 processors - [powershell-7.6.0-rc1-osx-x64.pkg][15] There are two ways to install PowerShell using the downloaded package. @@ -84,7 +54,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][21]. +[Safely open apps on your Mac - Apple Support][18]. After you've tried to open the package, follow these steps: @@ -130,18 +100,18 @@ PowerShell binary `tar.gz` archives are provided for the macOS platform to enabl deployment scenarios. When you install using this method, you must also manually install any dependencies. -Download the install package from the [releases][03] page onto your Mac. Select the archive version +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.13-osx-arm64.tar.gz][09] - - x64 processors - [powershell-7.4.13-osx-x64.tar.gz][11] + - Arm64 processors - [powershell-7.4.13-osx-arm64.tar.gz][06] + - x64 processors - [powershell-7.4.13-osx-x64.tar.gz][08] - PowerShell 7.5 - - Arm64 processors - [powershell-7.5.4-osx-arm64.tar.gz][13] - - x64 processors - [powershell-7.5.4-osx-x64.tar.gz][15] + - Arm64 processors - [powershell-7.5.4-osx-arm64.tar.gz][10] + - x64 processors - [powershell-7.5.4-osx-x64.tar.gz][12] - PowerShell 7.6-preview - - Arm64 processors - [powershell-7.6.0-rc1-osx-arm64.tar.gz][17] - - x64 processors - [powershell-7.6.0-rc1-osx-x64.tar.gz][19] + - Arm64 processors - [powershell-7.6.0-rc1-osx-arm64.tar.gz][14] + - x64 processors - [powershell-7.6.0-rc1-osx-x64.tar.gz][16] Use the following commands to install PowerShell from the binary archive. Change the download URL to match the version you want to install. @@ -180,34 +150,14 @@ run `pwsh-preview`. - 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. +PowerShell respects the [XDG Base Directory Specification][17] 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]. +To update PowerShell, download the new version of the package or binary archive and install it. ## Uninstall PowerShell 7 -If you installed PowerShell with Homebrew, use the following command to uninstall: - -```sh -brew uninstall --cask powershell -``` - If you manually installed PowerShell 7, you must manually remove it. The following command removes the symbolic link and PowerShell files. @@ -225,34 +175,25 @@ Use `sudo rm` to remove any other remaining PowerShell files and folders. 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][04] -- [Homebrew GitHub Repository][06] -- [Homebrew-Cask][07] +can't support those methods. For more information, see [Alternate ways to install PowerShell][03]. [01]: /dotnet/core/sdk [02]: /dotnet/core/tools/global-tools -[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 +[03]: alternate-install-methods.md +[04]: https://aka.ms/powershell-release?tag=stable +[05]: https://github.com/PowerShell/PowerShell/releases/download/v7.4.13/powershell-7.4.13-osx-arm64.pkg +[06]: https://github.com/PowerShell/PowerShell/releases/download/v7.4.13/powershell-7.4.13-osx-arm64.tar.gz +[07]: https://github.com/PowerShell/PowerShell/releases/download/v7.4.13/powershell-7.4.13-osx-x64.pkg +[08]: https://github.com/PowerShell/PowerShell/releases/download/v7.4.13/powershell-7.4.13-osx-x64.tar.gz +[09]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.4/powershell-7.5.4-osx-arm64.pkg +[10]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.4/powershell-7.5.4-osx-arm64.tar.gz +[11]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.4/powershell-7.5.4-osx-x64.pkg +[12]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.4/powershell-7.5.4-osx-x64.tar.gz +[13]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-rc1/powershell-7.6.0-rc1-osx-arm64.pkg +[14]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-rc1/powershell-7.6.0-rc1-osx-arm64.tar.gz +[15]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-rc1/powershell-7.6.0-rc1-osx-x64.pkg +[16]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-rc1/powershell-7.6.0-rc1-osx-x64.tar.gz +[17]: https://specifications.freedesktop.org/basedir/latest/ +[18]: https://support.apple.com/102445 +[19]: PowerShell-Support-Lifecycle.md diff --git a/reference/docs-conceptual/toc.yml b/reference/docs-conceptual/toc.yml index d2ab761b7e97..1ed90c7c29ff 100644 --- a/reference/docs-conceptual/toc.yml +++ b/reference/docs-conceptual/toc.yml @@ -35,7 +35,7 @@ items: - name: Community support for Linux href: install/community-support.md - name: Alternate ways to install on Linux - href: install/install-other-linux.md + href: install/alternate-install-methods.md - name: Install PowerShell 7 on macOS href: install/install-powershell-on-macos.md - name: Install PowerShell on Windows IoT and Nano Server From c87b88eaf17e76b7e6a003785aaa288aacd3ba82 Mon Sep 17 00:00:00 2001 From: Sean Wheeler Date: Wed, 11 Mar 2026 16:14:54 -0500 Subject: [PATCH 2/3] Fix links and add source build notes --- .../install/alternate-install-methods.md | 26 +++++++------------ 1 file changed, 9 insertions(+), 17 deletions(-) diff --git a/reference/docs-conceptual/install/alternate-install-methods.md b/reference/docs-conceptual/install/alternate-install-methods.md index 16e2b1b59ff9..e8a98003f438 100644 --- a/reference/docs-conceptual/install/alternate-install-methods.md +++ b/reference/docs-conceptual/install/alternate-install-methods.md @@ -26,6 +26,10 @@ Once `brew` is installed, install PowerShell using the following command: brew install powershell ``` +> [!NOTE] +> The brew formula builds PowerShell from source code rather than installing a package built by +> Microsoft. + ### Update PowerShell 7 Run the following commands to update the installed version of PowerShell to the latest release. @@ -55,8 +59,7 @@ Use `sudo rm` to remove any other remaining PowerShell files and folders. ## Install on Linux using a Snap package Snaps are application packages that are easy to install if your platform supports Snap. You can find -and install Snap packages from the Snap Store. Snap packages build PowerShell from source code -rather than installing a package built by Microsoft. +and install Snap packages from the Snap Store. > [!IMPORTANT] > The Snap Store contains PowerShell snap packages for many Linux distributions that aren't @@ -115,6 +118,10 @@ pwsh-preview After installation, Snap will automatically upgrade. You can trigger an upgrade using `sudo snap refresh powershell` or `sudo snap refresh powershell-preview`. +> [!NOTE] +> Snap packages build PowerShell from source code rather than installing a package built by +> Microsoft. + ### Uninstall using Snap ```sh @@ -221,21 +228,6 @@ can find those images on the [Microsoft Container Registry][13]. [06]: /dotnet/core/sdk [07]: /dotnet/core/tools/global-tools [08]: /powershell/scripting/community/community-support -[12]: https://aka.ms/powershell-release?tag=lts -[13]: https://aka.ms/powershell-release?tag=preview -[14]: https://aka.ms/PowerShell-Release?tag=stable -[16]: https://snapcraft.io/docs/tutorials/install-the-daemon/ -[17]: https://snapcraft.io/store -[15]: https://mcr.microsoft.com/en-us/artifact/mar/dotnet/sdk/ - -[01]: /dotnet/core/install/linux-alpine#dependencies -[02]: /dotnet/core/install/linux-debian#dependencies -[03]: /dotnet/core/install/linux-rhel#dependencies -[04]: /dotnet/core/install/linux-sles#dependencies -[05]: /dotnet/core/install/linux-ubuntu#dependencies -[06]: /dotnet/core/sdk -[07]: /dotnet/core/tools/global-tools -[08]: /powershell/scripting/community/community-support [09]: https://aka.ms/powershell-release?tag=lts [10]: https://aka.ms/powershell-release?tag=preview [11]: https://aka.ms/PowerShell-Release?tag=stable From 9dbbdd00d7373e57170ae4ede08bd0c27895a712 Mon Sep 17 00:00:00 2001 From: Sean Wheeler Date: Wed, 11 Mar 2026 16:19:56 -0500 Subject: [PATCH 3/3] Apply suggestions from code review Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- redir/.openpublishing.redirection.json | 2 +- .../docs-conceptual/install/install-powershell-on-linux.md | 2 +- .../docs-conceptual/install/install-powershell-on-macos.md | 2 +- reference/docs-conceptual/toc.yml | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/redir/.openpublishing.redirection.json b/redir/.openpublishing.redirection.json index 78f537d265e9..d65a1278b43e 100644 --- a/redir/.openpublishing.redirection.json +++ b/redir/.openpublishing.redirection.json @@ -2,7 +2,7 @@ "redirections": [ { "redirect_document_id": false, - "redirect_url": "/reference/docs-conceptual/install/alternate-install-methods", + "redirect_url": "/powershell/scripting/install/alternate-install-methods", "source_path": "../reference/docs-conceptual/install/install-other-linux.md" }, { diff --git a/reference/docs-conceptual/install/install-powershell-on-linux.md b/reference/docs-conceptual/install/install-powershell-on-linux.md index 34b66d97f470..f4c24c6348c0 100644 --- a/reference/docs-conceptual/install/install-powershell-on-linux.md +++ b/reference/docs-conceptual/install/install-powershell-on-linux.md @@ -75,6 +75,6 @@ information, see [Alternate ways to install PowerShell on Linux][05]. [02]: community-support.md [03]: install-alpine.md [04]: install-debian.md -[05]: install-other-linux.md +[05]: install/alternate-install-methods.md [06]: install-rhel.md [07]: install-ubuntu.md diff --git a/reference/docs-conceptual/install/install-powershell-on-macos.md b/reference/docs-conceptual/install/install-powershell-on-macos.md index 37b69646db54..609072f49fd8 100644 --- a/reference/docs-conceptual/install/install-powershell-on-macos.md +++ b/reference/docs-conceptual/install/install-powershell-on-macos.md @@ -25,7 +25,7 @@ Download the install package from the [releases][04] page. Select the package ve install. - PowerShell 7.5 - - Arm64 processors - [powershell-7.5.4-arm64.pkg][09] + - Arm64 processors - [powershell-7.5.4-osx-arm64.pkg][09] - x64 processors - [powershell-7.5.4-osx-x64.pkg][11] - PowerShell 7.4 (LTS) - Arm64 processors - [powershell-7.4.13-osx-arm64.pkg][05] diff --git a/reference/docs-conceptual/toc.yml b/reference/docs-conceptual/toc.yml index 1ed90c7c29ff..b2ecb2f0674b 100644 --- a/reference/docs-conceptual/toc.yml +++ b/reference/docs-conceptual/toc.yml @@ -34,7 +34,7 @@ items: href: install/install-ubuntu.md - name: Community support for Linux href: install/community-support.md - - name: Alternate ways to install on Linux + - name: Alternate ways to install PowerShell href: install/alternate-install-methods.md - name: Install PowerShell 7 on macOS href: install/install-powershell-on-macos.md