PowerShell 7 or higher requires macOS 13 and higher. All packages are available on the GitHub releases page for PowerShell. After the package is installed, run pwsh
from a terminal. Before installing, check the list of Supported versions.
Note
PowerShell 7.4 is an in-place upgrade that removes previous versions of PowerShell 7. You can install preview versions of PowerShell side-by-side with other versions of PowerShell. If you need to run PowerShell 7.4 side-by-side with a previous version, reinstall the previous version using the binary archive method.
Install the latest stable release of PowerShellThere are several ways to install PowerShell on macOS. Choose one of the following methods:
If the brew
command isn't found, you need to install Homebrew following their instructions.
/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:
brew install --cask powershell
Verify the installation is working correctly:
pwsh
When new versions of PowerShell are released, update Homebrew's formulae and upgrade PowerShell:
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
.
The following command installs the latest preview release of PowerShell:
brew install powershell/tap/powershell-preview
Run the following command to start the preview version of PowerShell:
pwsh-preview
When new preview versions of PowerShell are released, update Homebrew's formulae and upgrade to the latest preview version of PowerShell:
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
.
The following command installs the latest LTS release of PowerShell:
brew install powershell/tap/powershell-lts
Verify your installation:
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:
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.
Installation via Direct DownloadStarting with version 7.2, PowerShell supports the Apple M-series Arm-based processors. Download the install package from the releases page onto your Mac. The links to the current versions are:
PowerShell 7.5
PowerShell 7.4
There are two ways to install PowerShell using the Direct Download method.
Using FinderInstall PowerShell using Finder:
You might receive the following error message when installing the package:
"powershell-7.5.2-osx-arm64.pkg" cannot be opened because Apple cannot check it for malicious software.
To work around this issue using Finder:
Install PowerShell from the terminal. Change the filename to match the package you downloaded.
sudo installer -pkg ./Downloads/powershell-7.5.2-osx-arm64.pkg -target /
You might receive the following error message when installing the package:
"powershell-7.5.2-osx-arm64.pkg" cannot be opened because Apple cannot check it for malicious software.
There are a few different ways to work around this issue from the command line:
Run the installer
command with the allowUntrusted flag:
`sudo installer -allowUntrusted -pkg ./Downloads/powershell-7.5.2-osx-arm64.pkg -target /`
Or install the package as you normally would after running one of the following commands:
sudo xattr -rd com.apple.quarantine ./Downloads/powershell-7.5.2-osx-arm64.pkg
.Unblock-File
cmdlet if you're using PowerShell. Include the full path to the .pkg
file.If you already have the .NET Core SDK installed, it's easy to install PowerShell as a .NET Global tool.
dotnet tool install --global PowerShell
The dotnet tool installer adds ~/.dotnet/tools
to your PATH
environment variable. However, the currently running shell doesn't have the updated PATH
. Start PowerShell from a new shell by typing pwsh
.
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.
Download the install package from the releases page onto your Mac. The links to the current versions are:
PowerShell 7.5-preview
PowerShell 7.4 (LTS)
Use the following commands to install PowerShell from the binary archive. Change the download URL to match the version you want to install.
# Download the powershell '.tar.gz' archive
curl -L -o /tmp/powershell.tar.gz https://github.com/PowerShell/PowerShell/releases/download/v7.5.2/powershell-7.5.2-osx-arm64.tar.gz
# Create the target folder where powershell is placed
sudo mkdir -p /usr/local/microsoft/powershell/7
# Expand powershell to the target folder
sudo tar zxf /tmp/powershell.tar.gz -C /usr/local/microsoft/powershell/7
# Set execute permissions
sudo chmod +x /usr/local/microsoft/powershell/7/pwsh
# Create the symbolic link that points to pwsh
sudo ln -s /usr/local/microsoft/powershell/7/pwsh /usr/local/bin/pwsh
Uninstalling PowerShell
If you installed PowerShell with Homebrew, use the following command to uninstall:
brew uninstall --cask powershell
If you installed PowerShell via direct download, PowerShell must be removed manually:
sudo rm -rf /usr/local/bin/pwsh /usr/local/microsoft/powershell
To remove the extra PowerShell paths, refer to the paths 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
/usr/local/bin/pwsh
that points to pwsh
in the $PSHOME
location.~/.config/powershell/profile.ps1
$PSHOME/profile.ps1
~/.local/share/powershell/Modules
/usr/local/share/powershell/Modules
$PSHOME/Modules
~/.local/share/powershell/PSReadLine/ConsoleHost_history.txt
PowerShell respects the XDG Base Directory Specification on macOS.
Supported versionsMicrosoft supports PowerShell until PowerShell reaches end-of-support or the version of macOS reaches end-of-support.
Apple determines the support lifecycle of macOS. For more information, see the following:
Installation supportMicrosoft 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.
Additional resourcesRetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4