From 63176e66812119fc4d4d1a455290dceeecbdf234 Mon Sep 17 00:00:00 2001 From: Theano Petersen Date: Wed, 18 Mar 2026 06:30:38 -0700 Subject: [PATCH 1/3] BULK Fix broken links (#12857) This PR contains fixes to broken links. For work item request details see [558724](https://dev.azure.com/msft-skilling/Content/_workitems/edit/558724) --- .../install/install-powershell-on-windows.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/reference/docs-conceptual/install/install-powershell-on-windows.md b/reference/docs-conceptual/install/install-powershell-on-windows.md index 482829bf215..1cf58c2a669 100644 --- a/reference/docs-conceptual/install/install-powershell-on-windows.md +++ b/reference/docs-conceptual/install/install-powershell-on-windows.md @@ -83,9 +83,9 @@ Latest stable release: Latest Preview release: -- [PowerShell-7.6.0-rc1-win-x64.msi][20] -- [PowerShell-7.6.0-rc1-win-x86.msi][21] -- [PowerShell-7.6.0-rc1-win-arm64.msi][19] +- [PowerShell-7.6.0-rc.1-win-x64.msi][20] +- [PowerShell-7.6.0-rc.1-win-x86.msi][21] +- [PowerShell-7.6.0-rc.1-win-arm64.msi][19] Once downloaded, double-click the installer file and follow the prompts. @@ -329,9 +329,9 @@ can't support those methods. [16]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.5/PowerShell-7.5.5-win-x64.zip [17]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.5/PowerShell-7.5.5-win-x86.msi [18]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.5/PowerShell-7.5.5-win-x86.zip -[19]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-rc1/PowerShell-7.6.0-rc1-win-arm64.msi -[20]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-rc1/PowerShell-7.6.0-rc1-win-x64.msi -[21]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-rc1/PowerShell-7.6.0-rc1-win-x86.msi +[19]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-rc.1/PowerShell-7.6.0-rc.1-win-arm64.msi +[20]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-rc.1/PowerShell-7.6.0-rc.1-win-x64.msi +[21]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-rc.1/PowerShell-7.6.0-rc.1-win-x86.msi [22]: https://github.com/PowerShell/PowerShell/releases/latest [23]: https://www.microsoft.com/store/apps/9MZ1SNWT0N5D [24]: media/install-powershell-on-windows/powershell-start-menu.png From a46aad77b5823a32d884f5865853ab51be84bb59 Mon Sep 17 00:00:00 2001 From: Sean Wheeler Date: Wed, 18 Mar 2026 10:54:41 -0500 Subject: [PATCH 2/3] Update release notes for PSReadLine 2.4.5 (#12860) --- .../5.1/PSReadLine/About/about_PSReadLine.md | 41 ++++++++++++++++--- .../7.4/PSReadLine/About/about_PSReadLine.md | 10 +---- .../7.5/PSReadLine/About/about_PSReadLine.md | 10 +---- .../7.6/PSReadLine/About/about_PSReadLine.md | 9 +--- 4 files changed, 40 insertions(+), 30 deletions(-) diff --git a/reference/5.1/PSReadLine/About/about_PSReadLine.md b/reference/5.1/PSReadLine/About/about_PSReadLine.md index ede36a40c0c..ac79d771ca5 100644 --- a/reference/5.1/PSReadLine/About/about_PSReadLine.md +++ b/reference/5.1/PSReadLine/About/about_PSReadLine.md @@ -1,23 +1,24 @@ --- description: PSReadLine provides an improved command-line editing experience in the PowerShell console. Locale: en-US -ms.date: 08/18/2025 +ms.date: 03/18/2026 online version: https://learn.microsoft.com/powershell/module/psreadline/about/about_psreadline?view=powershell-5.1&WT.mc_id=ps-gethelp schema: 2.0.0 title: about_PSReadLine --- # about_PSReadLine -## SHORT DESCRIPTION +## Short description PSReadLine provides an improved command-line editing experience in the PowerShell console. -## LONG DESCRIPTION +## Long description There have been many updates to PSReadLine since the version that ships in Windows PowerShell 5.1. +- v2.4.5 first shipped in PowerShell 7.6.0-rc.1 - v2.3.6 first shipped in PowerShell 7.4.7 and 7.5.0 - v2.3.5 first shipped in PowerShell 7.4.2 and 7.5.0-preview.3 - v2.3.4 first shipped in PowerShell 7.4.0-rc.1 @@ -45,6 +46,9 @@ PowerShell console. It provides: - Bash style completion (optional in Cmd mode, default in Emacs mode) - Emacs yank/kill-ring - PowerShell token based "word" movement and deletion +- Predictive IntelliSense +- Dynamic display of Help in the console without losing your place on the + command line PSReadLine requires PowerShell 5.1, or newer. PSReadLine works with the default Windows console host, Windows Terminal, and Visual Studio Code. It doesn't work @@ -57,7 +61,32 @@ in a supported version of PowerShell run the following command. Install-Module -Name PSReadLine -AllowClobber -Force ``` -## CUSTOM KEY BINDINGS +## Predictive IntelliSense + +Predictive IntelliSense is an addition to the concept of tab completion that +assists the user in successfully completing commands. It enables users to +discover, edit, and execute full commands based on matching predictions from the +user's history and additional domain specific plugins. + +### Enable Predictive IntelliSense + +Predictive IntelliSense is disabled by default. To enable predictions, just run +the following command: + +```powershell +Set-PSReadLineOption -PredictionSource History +``` + +The **PredictionSource** parameter can also accept plugins for domain specific +and custom requirements. + +To disable Predictive IntelliSense, just run: + +```powershell +Set-PSReadLineOption -PredictionSource None +``` + +## Custom key bindings PSReadLine supports custom key bindings using the `Set-PSReadLineKeyHandler` cmdlet. Most custom key bindings call one of the [bindable functions][02], for @@ -119,7 +148,7 @@ is installed in the **PSReadLine** module folder. Most key bindings use some helper functions for editing the command line. Those APIs are documented in [about_PSReadLine_Functions][02]. -## NOTES +## Notes ### Command History @@ -225,7 +254,7 @@ $Env:PGPASS = gcloud auth print-access-token Feel free to submit a pull request or submit feedback on the GitHub page. -## SEE ALSO +## See also - PSReadLine is heavily influenced by the GNU [readline][04] library. diff --git a/reference/7.4/PSReadLine/About/about_PSReadLine.md b/reference/7.4/PSReadLine/About/about_PSReadLine.md index b7ec9560ac2..acf41e13eba 100644 --- a/reference/7.4/PSReadLine/About/about_PSReadLine.md +++ b/reference/7.4/PSReadLine/About/about_PSReadLine.md @@ -1,7 +1,7 @@ --- description: PSReadLine provides an improved command-line editing experience in the PowerShell console. Locale: en-US -ms.date: 08/18/2025 +ms.date: 03/18/2026 online version: https://learn.microsoft.com/powershell/module/psreadline/about/about_psreadline?view=powershell-7.4&WT.mc_id=ps-gethelp schema: 2.0.0 title: about_PSReadLine @@ -18,6 +18,7 @@ PowerShell console. There have been many updates to PSReadLine since the version that ships in Windows PowerShell 5.1. +- v2.4.5 first shipped in PowerShell 7.6.0-rc.1 - v2.3.6 first shipped in PowerShell 7.4.7 and 7.5.0 - v2.3.5 first shipped in PowerShell 7.4.2 and 7.5.0-preview.3 - v2.3.4 first shipped in PowerShell 7.4.0-rc.1 @@ -60,13 +61,6 @@ in a supported version of PowerShell run the following command. Install-Module -Name PSReadLine -AllowClobber -Force ``` -> [!NOTE] -> Beginning with PowerShell 7.0, PowerShell skips autoloading PSReadLine on -> Windows if a screen reader program is detected. Currently, PSReadLine doesn't -> work well with the screen readers. The default rendering and formatting of -> PowerShell 7.0 on Windows works properly. You can manually load the module if -> necessary. - ## Predictive IntelliSense Predictive IntelliSense is an addition to the concept of tab completion that diff --git a/reference/7.5/PSReadLine/About/about_PSReadLine.md b/reference/7.5/PSReadLine/About/about_PSReadLine.md index 9dcca385911..380586988cc 100644 --- a/reference/7.5/PSReadLine/About/about_PSReadLine.md +++ b/reference/7.5/PSReadLine/About/about_PSReadLine.md @@ -1,7 +1,7 @@ --- description: PSReadLine provides an improved command-line editing experience in the PowerShell console. Locale: en-US -ms.date: 08/18/2025 +ms.date: 03/18/2026 online version: https://learn.microsoft.com/powershell/module/psreadline/about/about_psreadline?view=powershell-7.5&WT.mc_id=ps-gethelp schema: 2.0.0 title: about_PSReadLine @@ -18,6 +18,7 @@ PowerShell console. There have been many updates to PSReadLine since the version that ships in Windows PowerShell 5.1. +- v2.4.5 first shipped in PowerShell 7.6.0-rc.1 - v2.3.6 first shipped in PowerShell 7.4.7 and 7.5.0 - v2.3.5 first shipped in PowerShell 7.4.2 and 7.5.0-preview.3 - v2.3.4 first shipped in PowerShell 7.4.0-rc.1 @@ -60,13 +61,6 @@ in a supported version of PowerShell run the following command. Install-Module -Name PSReadLine -AllowClobber -Force ``` -> [!NOTE] -> Beginning with PowerShell 7.0, PowerShell skips autoloading PSReadLine on -> Windows if a screen reader program is detected. Currently, PSReadLine doesn't -> work well with the screen readers. The default rendering and formatting of -> PowerShell 7.0 on Windows works properly. You can manually load the module if -> necessary. - ## Predictive IntelliSense Predictive IntelliSense is an addition to the concept of tab completion that diff --git a/reference/7.6/PSReadLine/About/about_PSReadLine.md b/reference/7.6/PSReadLine/About/about_PSReadLine.md index be142ff2bc3..4631b6bcff1 100644 --- a/reference/7.6/PSReadLine/About/about_PSReadLine.md +++ b/reference/7.6/PSReadLine/About/about_PSReadLine.md @@ -1,7 +1,7 @@ --- description: PSReadLine provides an improved command-line editing experience in the PowerShell console. Locale: en-US -ms.date: 02/20/2026 +ms.date: 03/18/2026 online version: https://learn.microsoft.com/powershell/module/psreadline/about/about_psreadline?view=powershell-7.6&WT.mc_id=ps-gethelp schema: 2.0.0 title: about_PSReadLine @@ -61,13 +61,6 @@ in a supported version of PowerShell run the following command. Install-Module -Name PSReadLine -AllowClobber -Force ``` -> [!NOTE] -> Beginning with PowerShell 7.0, PowerShell skips autoloading PSReadLine on -> Windows if a screen reader program is detected. Currently, PSReadLine doesn't -> work well with the screen readers. The default rendering and formatting of -> PowerShell 7.0 on Windows works properly. You can manually load the module if -> necessary. - ## Predictive IntelliSense Predictive IntelliSense is an addition to the concept of tab completion that From 96dcd4ac07859248dc574c01bb21153694dba0ab Mon Sep 17 00:00:00 2001 From: Sean Wheeler Date: Wed, 18 Mar 2026 13:07:50 -0500 Subject: [PATCH 3/3] Add instructions for unintalling brew cask (#12861) --- .../install/alternate-install-methods.md | 19 +++++++++++++++---- reference/docs-conceptual/toc.yml | 1 - 2 files changed, 15 insertions(+), 5 deletions(-) diff --git a/reference/docs-conceptual/install/alternate-install-methods.md b/reference/docs-conceptual/install/alternate-install-methods.md index 1ddd34e2a60..61129cc4169 100644 --- a/reference/docs-conceptual/install/alternate-install-methods.md +++ b/reference/docs-conceptual/install/alternate-install-methods.md @@ -1,6 +1,6 @@ --- description: Alternate ways to install PowerShell on non-Windows platforms. -ms.date: 03/12/2026 +ms.date: 03/18/2026 title: Alternate ways to install PowerShell --- # Alternate ways to install PowerShell @@ -16,6 +16,10 @@ from the PowerShell Community or the operating system vendor. For support option Homebrew is the preferred package manager for macOS. If the `brew` command isn't found, you need to install Homebrew following [their instructions][12]. +> [!IMPORTANT] +> The brew formula is maintained and supported by the Homebrew community. The brew formula builds +> PowerShell from source code rather than installing a package built by Microsoft. + ```bash /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" ``` @@ -26,9 +30,16 @@ Once `brew` is installed, install PowerShell using the following command: brew install powershell ``` -> [!IMPORTANT] -> The brew formula is maintained and supported by the Homebrew community. The brew formula builds -> PowerShell from source code rather than installing a package built by Microsoft. +If you previously installed PowerShell using the Homebrew cask, you must first uninstall the cask +before you can successfully install using the Homebrew formula. Use the following commands to +uninstall the cask: + +```sh +# Uninstall the PowerShell cask instance +brew uninstall --cask powershell +# Uninstall the PowerShell Preview cask instance +brew uninstall --cask powershell-preview +``` ### Update PowerShell 7 diff --git a/reference/docs-conceptual/toc.yml b/reference/docs-conceptual/toc.yml index 7ec2e05d4e7..b59cdb698b8 100644 --- a/reference/docs-conceptual/toc.yml +++ b/reference/docs-conceptual/toc.yml @@ -213,7 +213,6 @@ items: - name: Glossary href: learn/glossary.md - name: What's New in PowerShell - expanded: true items: - name: Overview href: whats-new/overview.yml