Skip to content

Commit 27c9333

Browse files
authored
Move uninstall steps to top for brew (#12900)
1 parent 00b992b commit 27c9333

File tree

1 file changed

+15
-19
lines changed

1 file changed

+15
-19
lines changed

reference/docs-conceptual/install/alternate-install-methods.md

Lines changed: 15 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
description: Alternate ways to install PowerShell on non-Windows platforms.
3-
ms.date: 03/18/2026
3+
ms.date: 03/30/2026
44
title: Alternate ways to install PowerShell
55
---
66
# Alternate ways to install PowerShell
@@ -13,34 +13,30 @@ from the PowerShell Community or the operating system vendor. For support option
1313

1414
## Install on macOS using Homebrew
1515

16-
Homebrew is the preferred package manager for macOS. If the `brew` command isn't found, you need to
17-
install Homebrew following [their instructions][12].
16+
Homebrew is a popular package manager for macOS. To install Homebrew, follow the instructions on the
17+
[Homebrew website][12].
1818

1919
> [!IMPORTANT]
2020
> The brew formula is maintained and supported by the Homebrew community. The brew formula builds
2121
> PowerShell from source code rather than installing a package built by Microsoft.
22+
>
23+
> If you previously installed PowerShell using the Homebrew cask, you must first uninstall the cask
24+
> before you can successfully install using the Homebrew formula. Use the following commands to
25+
> uninstall the cask:
26+
>
27+
> ```sh
28+
> # Uninstall the PowerShell cask instance
29+
> brew uninstall --cask powershell
30+
> # Uninstall the PowerShell Preview cask instance
31+
> brew uninstall --cask powershell-preview
32+
> ```
2233
23-
```bash
24-
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
25-
```
26-
27-
Once `brew` is installed, install PowerShell using the following command:
34+
Run the following command to install PowerShell using the Homebrew formula:
2835
2936
```sh
3037
brew install powershell
3138
```
3239
33-
If you previously installed PowerShell using the Homebrew cask, you must first uninstall the cask
34-
before you can successfully install using the Homebrew formula. Use the following commands to
35-
uninstall the cask:
36-
37-
```sh
38-
# Uninstall the PowerShell cask instance
39-
brew uninstall --cask powershell
40-
# Uninstall the PowerShell Preview cask instance
41-
brew uninstall --cask powershell-preview
42-
```
43-
4440
### Update PowerShell 7
4541

4642
Run the following commands to update the installed version of PowerShell to the latest release.

0 commit comments

Comments
 (0)