11---
22description : Information about installing PowerShell on macOS
3- ms.date : 06/18 /2025
3+ ms.date : 06/19 /2025
44title : Installing PowerShell on macOS
55---
66
@@ -22,10 +22,13 @@ Before installing, check the list of [Supported versions][06].
2222
2323There are several ways to install PowerShell on macOS. Choose one of the following methods:
2424
25- - Install using [ Homebrew] [ 10 ] . Homebrew is the preferred package manager for macOS.
26- - Install via [ Direct Download] [ 04 ]
25+ - Install using [ Homebrew] [ 27 ] . Homebrew is the preferred package manager for macOS.
26+ - Install via [ Direct Download] [ 04 ] .
27+ - Install as [ a .NET Global tool] [ 28 ] .
2728- Install from [ binary archives] [ 03 ] .
2829
30+ ## Install using Homebrew
31+
2932If the ` brew ` command isn't found, you need to install Homebrew following [ their instructions] [ 10 ] .
3033
3134``` bash
@@ -60,7 +63,7 @@ brew upgrade powershell
6063
6164[ brew ] : https://brew.sh/
6265
63- ## Install the latest preview release of PowerShell
66+ ### Install the latest preview release of PowerShell
6467
6568The following command installs the latest preview release of PowerShell:
6669
@@ -87,7 +90,7 @@ brew upgrade powershell-preview
8790> restart the PowerShell session to complete the upgrade and refresh the values shown in
8891> ` $PSVersionTable ` .
8992
90- ## Install the latest LTS release of PowerShell
93+ ### Install the latest LTS release of PowerShell
9194
9295The following command installs the latest LTS release of PowerShell:
9396
@@ -192,7 +195,7 @@ The dotnet tool installer adds `~/.dotnet/tools` to your `PATH` environment vari
192195currently running shell doesn't have the updated ` PATH ` . Start PowerShell from a new shell by typing
193196` pwsh ` .
194197
195- ## Binary Archives
198+ ## Binary archives
196199
197200PowerShell binary ` tar.gz ` archives are provided for the macOS platform to enable advanced
198201deployment scenarios. When you install using this method, you must also manually install any
@@ -282,7 +285,7 @@ Microsoft supports the installation methods in this document. There might be oth
282285installation available from other sources. While those tools and methods might work, Microsoft can't
283286support those methods.
284287
285- ## Additional Resources
288+ ## Additional resources
286289
287290- [ Homebrew Web] [ 10 ]
288291- [ Homebrew GitHub Repository] [ 12 ]
@@ -311,3 +314,5 @@ support those methods.
311314[ 24 ] : https://github.com/PowerShell/PowerShell/releases/download/v7.5.1/powershell-7.5.1-osx-x64.pkg
312315[ 25 ] : https://github.com/PowerShell/PowerShell/releases/download/v7.5.1/powershell-7.5.1-osx-x64.tar.gz
313316[ 26 ] : https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html
317+ [ 27 ] : #install-using-homebrew
318+ [ 28 ] : #install-as-a-net-global-tool
0 commit comments