Skip to content

Commit 96dcd4a

Browse files
authored
Add instructions for unintalling brew cask (#12861)
1 parent a46aad7 commit 96dcd4a

File tree

2 files changed

+15
-5
lines changed

2 files changed

+15
-5
lines changed

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

Lines changed: 15 additions & 4 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/12/2026
3+
ms.date: 03/18/2026
44
title: Alternate ways to install PowerShell
55
---
66
# Alternate ways to install PowerShell
@@ -16,6 +16,10 @@ from the PowerShell Community or the operating system vendor. For support option
1616
Homebrew is the preferred package manager for macOS. If the `brew` command isn't found, you need to
1717
install Homebrew following [their instructions][12].
1818

19+
> [!IMPORTANT]
20+
> The brew formula is maintained and supported by the Homebrew community. The brew formula builds
21+
> PowerShell from source code rather than installing a package built by Microsoft.
22+
1923
```bash
2024
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2125
```
@@ -26,9 +30,16 @@ Once `brew` is installed, install PowerShell using the following command:
2630
brew install powershell
2731
```
2832

29-
> [!IMPORTANT]
30-
> The brew formula is maintained and supported by the Homebrew community. The brew formula builds
31-
> PowerShell from source code rather than installing a package built by Microsoft.
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+
```
3243

3344
### Update PowerShell 7
3445

reference/docs-conceptual/toc.yml

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -213,7 +213,6 @@ items:
213213
- name: Glossary
214214
href: learn/glossary.md
215215
- name: What's New in PowerShell
216-
expanded: true
217216
items:
218217
- name: Overview
219218
href: whats-new/overview.yml

0 commit comments

Comments
 (0)