Update GateKeeper instructions

Author: sdwheeler

reference/docs-conceptual/install/Installing-PowerShell-on-macOS.md

@@ -1,6 +1,6 @@
 ---
 description: Information about installing PowerShell on macOS
-ms.date: 10/16/2025
+ms.date: 10/23/2025
 title: Installing PowerShell on macOS
 ---
 
@@ -120,7 +120,7 @@ brew upgrade powershell-lts
 > If you decide to use different methods, there are ways to correct the issue using the
 > [Homebrew link method][11].
 
-## Installation via Direct Download
+## Installation the package via Direct Download
 
 Starting with version 7.2, PowerShell supports the Apple M-series Arm-based processors. Download the
 install package from the [releases][09] page onto your Mac. The links to the current versions are:
@@ -139,41 +139,39 @@ There are two ways to install PowerShell using the Direct Download method.
 
 Install PowerShell using Finder:
 
-1. Open Finder
+1. Open **Finder**
 1. Locate the downloaded package
 1. Double-click the file
-1. Follow the prompts
 
-You might receive the following error message when installing the package:
+   You will receive the following error message when installing the package:
 
-> "powershell-7.5.4-osx-arm64.pkg" cannot be opened because Apple cannot check it for malicious
-> software.
+   > "powershell-7.5.4-osx-arm64.pkg" Not Opened
+   >
+   > Apple could not verify "powershell-7.5.4-osx-arm64.pkg" is free from malware that may harm
+   > your Mac or compromise your privacy.
 
-To work around this issue using Finder:
+1. Select the **Done** button to close the prompt.
 
-1. Locate the downloaded package in Finder
-1. Control-click (click while pressing the <kbd>Control (or Ctrl)</kbd> key on the package
-1. Select **Open** from the context menu
+This error message comes from the Gatekeeper feature of macOS. For more information, see
+[Safely open apps on your Mac - Apple Support](https://support.apple.com/102445).
 
-### Using Terminal
-
-Install PowerShell from the terminal. Change the filename to match the package you downloaded.
-
-```sh
-sudo installer -pkg ./Downloads/powershell-7.5.4-osx-arm64.pkg -target /
-```
+After you've tried to open the package, follow these steps:
 
-You might receive the following error message when installing the package:
+1. Open **System Settings**.
+1. Select **Privacy & Security** and scroll down to the **Security** section.
+1. Select the **Open Anyway** button to confirm your intent to install PowerShell.
+1. When the warning prompt reappears, select **Open Anyway**.
+1. Enter username and password to allow the installation to proceed.
 
-> "powershell-7.5.4-osx-arm64.pkg" cannot be opened because Apple cannot check it for malicious
-> software.
+### Using Terminal
 
-There are a few different ways to work around this issue from the command line:
+To install the PowerShell package from the command line, you must bypass the Gatekeeper checks. Use
+one of the following methods to install the package:
 
 - Run the `installer` command with the **allowUntrusted** flag:
 
   ```sh
-  `sudo installer -allowUntrusted -pkg ./Downloads/powershell-7.5.4-osx-arm64.pkg -target /`
+  sudo installer -allowUntrusted -pkg ./Downloads/powershell-7.5.4-osx-arm64.pkg -target /
   ```
 
 - Or install the package as you normally would after running one of the following commands: