Merge pull request #11264 from MicrosoftDocs/main

7/12/2024 PM Publish

reference/5.1/Microsoft.PowerShell.Core/About/about_Automatic_Variables.md

@@ -1,7 +1,7 @@
 ---
 description: Describes variables that store state information for PowerShell. These variables are created and maintained by PowerShell.
 Locale: en-US
-ms.date: 07/01/2024
+ms.date: 07/12/2024
 no-loc: [Reset, Current, Background, Blink, Bold, Foreground, Formatting, Hidden, Italic, Reset, Reverse, Underline, PSEventArgs, PSEventSubscriber, PSEdition]
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_automatic_variables?view=powershell-5.1&WT.mc_id=ps-gethelp
 schema: 2.0.0

reference/5.1/Microsoft.PowerShell.Management/Checkpoint-Computer.md

@@ -2,7 +2,7 @@
 external help file: Microsoft.PowerShell.Commands.Management.dll-Help.xml
 Locale: en-US
 Module Name: Microsoft.PowerShell.Management
-ms.date: 06/09/2017
+ms.date: 07/12/2024
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.management/checkpoint-computer?view=powershell-5.1&WT.mc_id=ps-gethelp
 schema: 2.0.0
 title: Checkpoint-Computer
@@ -22,9 +22,9 @@ Checkpoint-Computer [-Description] <String> [[-RestorePointType] <String>] [<Com
 
 The `Checkpoint-Computer` cmdlet creates a system restore point on the local computer.
 
-System restore points and the `Checkpoint-Computer` cmdlet are supported only on client operating systems, such as Windows 8, Windows 7, Windows Vista, and Windows XP.
-
-Beginning in Windows 8, `Checkpoint-Computer` cannot create more than one checkpoint each day.
+System restore points and the `Checkpoint-Computer` cmdlet are supported only on client operating
+systems, such as Windows 10 or Windows 11. `Checkpoint-Computer` cannot create more than one
+checkpoint each day.
 
 ## EXAMPLES
 
@@ -34,23 +34,22 @@ Beginning in Windows 8, `Checkpoint-Computer` cannot create more than one checkp
 Checkpoint-Computer -Description "Install MyApp"
 ```
 
-This command creates a system restore point called Install MyApp.
-It uses the default APPLICATION_INSTALL restore point type.
+This command creates a system restore point called Install MyApp. It uses the default
+`APPLICATION_INSTALL` restore point type.
 
 ### Example 2: Create a system MODIFY_SETTINGS restore point
 
 ```powershell
 Checkpoint-Computer -Description "ChangeNetSettings" -RestorePointType MODIFY_SETTINGS
 ```
 
-This command creates a MODIFY_SETTINGS system restore point called "ChangeNetSettings".
+This command creates a `MODIFY_SETTINGS` system restore point called "ChangeNetSettings".
 
 ## PARAMETERS
 
 ### -Description
 
-Specifies a descriptive name for the restore point.
-This parameter is required.
+Specifies a descriptive name for the restore point. This parameter is required.
 
 ```yaml
 Type: System.String
@@ -66,16 +65,19 @@ Accept wildcard characters: False
 
 ### -RestorePointType
 
-Specifies the type of restore point.
-The default is APPLICATION_INSTALL.
+Specifies the type of restore point. The default is `APPLICATION_INSTALL`.
 
 The acceptable values for this parameter are:
 
-- APPLICATION_INSTALL
-- APPLICATION_UNINSTALL
-- DEVICE_DRIVER_INSTALL
-- MODIFY_SETTINGS
-- CANCELLED_OPERATION
+- `APPLICATION_INSTALL`
+- `APPLICATION_UNINSTALL`
+- `DEVICE_DRIVER_INSTALL`
+- `MODIFY_SETTINGS`
+- `CANCELLED_OPERATION`
+
+The cmdlet accepts `CANCELLED_OPERATION` but this type of restore point operation is no longer
+supported. For more information about these types, see the
+[Restore Point Description Text](/windows/win32/sr/restore-point-description-text) documentation.
 
 ```yaml
 Type: System.String
@@ -92,7 +94,10 @@ Accept wildcard characters: False
 
 ### CommonParameters
 
-This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](../Microsoft.PowerShell.Core/About/about_CommonParameters.md).
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
+-InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose,
+-WarningAction, and -WarningVariable. For more information, see
+[about_CommonParameters](../Microsoft.PowerShell.Core/About/about_CommonParameters.md).
 
 ## INPUTS
 
@@ -108,11 +113,14 @@ This cmdlet does not generate any output.
 
 ## NOTES
 
-- This cmdlet uses the **CreateRestorePoint** method of the **SystemRestore** class with a **BEGIN_SYSTEM_CHANGE** event.
-- Beginning in Windows 8, `Checkpoint-Computer` cannot create more than one system restore point each day. If you try to create a new restore point before the 24-hour period has elapsed, Windows PowerShell generates the following error:
+- This cmdlet uses the **CreateRestorePoint** method of the **SystemRestore** class with a
+  **BEGIN_SYSTEM_CHANGE** event.
+- Beginning in Windows 8, `Checkpoint-Computer` cannot create more than one system restore point
+  each day. If you try to create a new restore point before the 24-hour period has elapsed, Windows
+  PowerShell generates the following error:
 
-  `"A new system restore point cannot be created because one has already been created within the past 24 hours.
-  Please try again later."`
+  `"A new system restore point cannot be created because one has already been created within the
+  past 24 hours. Please try again later."`
 
 ## RELATED LINKS
 

reference/7.2/Microsoft.PowerShell.Core/About/about_Automatic_Variables.md

@@ -1,7 +1,7 @@
 ---
 description: Describes variables that store state information for PowerShell. These variables are created and maintained by PowerShell.
 Locale: en-US
-ms.date: 07/01/2024
+ms.date: 07/12/2024
 no-loc: [Reset, Current, Background, Blink, Bold, Foreground, Formatting, Hidden, Italic, Reset, Reverse, Underline, PSEventArgs, PSEventSubscriber, PSEdition]
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_automatic_variables?view=powershell-7.2&WT.mc_id=ps-gethelp
 schema: 2.0.0
@@ -281,23 +281,23 @@ echo Hello | pwsh -Command """$input World!"""
 
 ### $IsCoreCLR
 
-Contains `$True` if the current session is running on the .NET Core Runtime
-(CoreCLR). Otherwise contains `$False`.
+Contains `$true` if the current session is running on the .NET Core Runtime
+(CoreCLR). Otherwise contains `$false`.
 
 ### $IsLinux
 
-Contains `$True` if the current session is running on a Linux operating system.
-Otherwise contains `$False`.
+Contains `$true` if the current session is running on a Linux operating system.
+Otherwise contains `$false`.
 
 ### $IsMacOS
 
-Contains `$True` if the current session is running on a MacOS operating system.
-Otherwise contains `$False`.
+Contains `$true` if the current session is running on a MacOS operating system.
+Otherwise contains `$false`.
 
 ### $IsWindows
 
-Contains `$TRUE` if the current session is running on a Windows operating
-system. Otherwise contains `$FALSE`.
+Contains `$true` if the current session is running on a Windows operating
+system. Otherwise contains `$false`.
 
 ### $LASTEXITCODE
 

reference/7.4/Microsoft.PowerShell.Core/About/about_Automatic_Variables.md

@@ -1,7 +1,7 @@
 ---
 description: Describes variables that store state information for PowerShell. These variables are created and maintained by PowerShell.
 Locale: en-US
-ms.date: 07/01/2024
+ms.date: 07/12/2024
 no-loc: [Reset, Current, Background, Blink, Bold, Foreground, Formatting, Hidden, Italic, Reset, Reverse, Underline, PSEventArgs, PSEventSubscriber, PSEdition]
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_automatic_variables?view=powershell-7.4&WT.mc_id=ps-gethelp
 schema: 2.0.0
@@ -281,23 +281,23 @@ echo Hello | pwsh -Command """$input World!"""
 
 ### $IsCoreCLR
 
-Contains `$True` if the current session is running on the .NET Core Runtime
-(CoreCLR). Otherwise contains `$False`.
+Contains `$true` if the current session is running on the .NET Core Runtime
+(CoreCLR). Otherwise contains `$false`.
 
 ### $IsLinux
 
-Contains `$True` if the current session is running on a Linux operating system.
-Otherwise contains `$False`.
+Contains `$true` if the current session is running on a Linux operating system.
+Otherwise contains `$false`.
 
 ### $IsMacOS
 
-Contains `$True` if the current session is running on a MacOS operating system.
-Otherwise contains `$False`.
+Contains `$true` if the current session is running on a MacOS operating system.
+Otherwise contains `$false`.
 
 ### $IsWindows
 
-Contains `$TRUE` if the current session is running on a Windows operating
-system. Otherwise contains `$FALSE`.
+Contains `$true` if the current session is running on a Windows operating
+system. Otherwise contains `$false`.
 
 ### $LASTEXITCODE
 

reference/7.5/Microsoft.PowerShell.Core/About/about_Automatic_Variables.md

@@ -1,7 +1,7 @@
 ---
 description: Describes variables that store state information for PowerShell. These variables are created and maintained by PowerShell.
 Locale: en-US
-ms.date: 07/01/2024
+ms.date: 07/12/2024
 no-loc: [Reset, Current, Background, Blink, Bold, Foreground, Formatting, Hidden, Italic, Reset, Reverse, Underline, PSEventArgs, PSEventSubscriber, PSEdition]
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_automatic_variables?view=powershell-7.5&WT.mc_id=ps-gethelp
 schema: 2.0.0
@@ -281,23 +281,23 @@ echo Hello | pwsh -Command """$input World!"""
 
 ### $IsCoreCLR
 
-Contains `$True` if the current session is running on the .NET Core Runtime
-(CoreCLR). Otherwise contains `$False`.
+Contains `$true` if the current session is running on the .NET Core Runtime
+(CoreCLR). Otherwise contains `$false`.
 
 ### $IsLinux
 
-Contains `$True` if the current session is running on a Linux operating system.
-Otherwise contains `$False`.
+Contains `$true` if the current session is running on a Linux operating system.
+Otherwise contains `$false`.
 
 ### $IsMacOS
 
-Contains `$True` if the current session is running on a MacOS operating system.
-Otherwise contains `$False`.
+Contains `$true` if the current session is running on a MacOS operating system.
+Otherwise contains `$false`.
 
 ### $IsWindows
 
-Contains `$TRUE` if the current session is running on a Windows operating
-system. Otherwise contains `$FALSE`.
+Contains `$true` if the current session is running on a Windows operating
+system. Otherwise contains `$false`.
 
 ### $LASTEXITCODE
 

reference/docs-conceptual/install/install-ubuntu.md

@@ -1,6 +1,6 @@
 ---
 description: Information about installing PowerShell on Ubuntu
-ms.date: 06/19/2024
+ms.date: 07/12/2024
 title: Installing PowerShell on Ubuntu
 ---
 # Installing PowerShell on Ubuntu
@@ -115,7 +115,7 @@ sudo apt-get install -f
 rm powershell_7.4.3-1.deb_amd64.deb
 
 # Start PowerShell Preview
-pwsh-lts
+pwsh
 ```
 
 ## Uninstall PowerShell

reference/includes/alpine-support.md

@@ -1,17 +1,17 @@
 ---
 author: sdwheeler
 ms.author: sewhee
-ms.date: 06/04/2024
+ms.date: 07/12/2024
 ms.topic: include
 ---
 <!-- markdownlint-disable first-line-h1 -->
 Microsoft supports PowerShell until [PowerShell reaches end-of-support][lifecycle] or the version of
 [Alpine reaches end-of-life][eol-alpine].
 
-Alpine 3.17 - OS support ends on 2024-11-22
+Docker images containing PowerShell 7.2, PowerShell 7.4, and PowerShell 7.5-preview for x64 are
+available from the [Microsoft Artifact Registry][mcr] for the following versions of Alpine:
 
-- Docker images containing PowerShell 7.2, PowerShell 7.4, and PowerShell 7.5-preview for x64 are
-  available from the [Microsoft Artifact Registry][mcr]
+- Alpine 3.17 - OS support ends on 2024-11-22
 
 Docker images of PowerShell aren't available for Alpine 3.18 and 3.19 at this time.
 

reference/includes/debian-support.md

@@ -1,25 +1,24 @@
 ---
 author: sdwheeler
 ms.author: sewhee
-ms.date: 05/16/2024
+ms.date: 07/12/2024
 ms.topic: include
 ---
 <!-- markdownlint-disable first-line-h1 -->
 Microsoft supports PowerShell until [PowerShell reaches end-of-support][lifecycle] or the version of
 [Debian reaches end-of-life][eol-debian].
 
-Debian 11 (Bullseye) - OS support ends on 2024-07-31
+Docker images containing PowerShell 7.2, PowerShell 7.4, and PowerShell 7.5-preview for x64 are
+available from the [Microsoft Artifact Registry][mcr] for the following versions of Debian:
 
-- Docker images containing PowerShell 7.2, PowerShell 7.4, and PowerShell 7.5-preview for x64 are
-  available from the [Microsoft Artifact Registry][mcr]
-
-Debian 12 (Bookworm) - OS support ends on 2026-06-10
-
-- Docker images containing PowerShell 7.2, PowerShell 7.4, and PowerShell 7.5-preview for x64 are
-  available from the [Microsoft Artifact Registry][mcr]
+- Debian 12 (Bookworm) - OS support ends on 2026-06-10
+- Debian 11 (Bullseye) - OS support ends on 2024-07-31
 
 Preview versions of PowerShell are provided for testing and feedback only.
 
+Install package files (`.deb`) are also available from [https://packages.microsoft.com/][pcm].
+
 [lifecycle]: /powershell/scripting/install/powershell-support-lifecycle
 [eol-debian]: https://wiki.debian.org/DebianReleases
-[mcr]: https://mcr.microsoft.com/en-us/product/powershell/tags
+[mcr]: https://mcr.microsoft.com/product/powershell/tags
+[pcm]: https://packages.microsoft.com/

reference/includes/rhel-support.md

@@ -1,27 +1,26 @@
 ---
 author: sdwheeler
 ms.author: sewhee
-ms.date: 05/16/2024
+ms.date: 07/12/2024
 ms.topic: include
 ---
 <!-- markdownlint-disable first-line-h1 -->
 Microsoft supports PowerShell until [PowerShell reaches end-of-support][lifecycle] or the version of
 [RHEL reaches end-of-support][eol-rhel].
 
-RHEL 8 - OS support ends on 2029-05-31
+Docker images containing PowerShell 7.2, PowerShell 7.4, and PowerShell 7.5-preview for x64 are
+available from the [Microsoft Artifact Registry][mcr] for the following versions of RHEL:
 
-- Docker images containing PowerShell 7.2, PowerShell 7.4, and PowerShell 7.5-preview for x64 are
-  available from the [Microsoft Artifact Registry][mcr]
-
-RHEL 9 - OS support ends on 2032-05-31
-
-- Docker images containing PowerShell 7.2, PowerShell 7.4, and PowerShell 7.5-preview for x64 are
-  available from the [Microsoft Artifact Registry][mcr]
+- RHEL 8 - OS support ends on 2029-05-31
+- RHEL 9 - OS support ends on 2032-05-31
 
 PowerShell is tested on Red Hat Universal Base Images (UBI). For more information, see the
 [UBI information page][ubi].
 
+Install package files (`.rpm`) are also available from [https://packages.microsoft.com/][pcm].
+
 [lifecycle]: /powershell/scripting/install/powershell-support-lifecycle
 [eol-rhel]: https://access.redhat.com/support/policy/updates/errata/
 [ubi]: https://developers.redhat.com/products/rhel/ubi
-[mcr]: https://mcr.microsoft.com/en-us/product/powershell/tags
+[mcr]: https://mcr.microsoft.com/product/powershell/tags
+[pcm]: https://packages.microsoft.com/

reference/includes/ubuntu-support.md

@@ -1,27 +1,21 @@
 ---
 author: sdwheeler
 ms.author: sewhee
-ms.date: 06/04/2024
+ms.date: 07/12/2024
 ms.topic: include
 ---
 <!-- markdownlint-disable first-line-h1 -->
 Microsoft supports PowerShell until [PowerShell reaches end-of-support][lifecycle] or the version of
 [Ubuntu reaches end-of-support][eol-ubuntu].
 
-Ubuntu 20.04 (Focal Fossa) - OS support ends on 2025-04-02
+Docker images containing PowerShell 7.2, PowerShell 7.4, and PowerShell 7.5-preview for x64 and
+Arm32 are available from the [Microsoft Artifact Registry][mcr] for the following versions of
+Ubuntu:
 
-- Docker images containing PowerShell 7.2, PowerShell 7.4, and PowerShell 7.5-preview for x64 and
-  Arm32 are available from the [Microsoft Artifact Registry][mcr]
+- Ubuntu 22.04 (Jammy Jellyfish) - OS support ends on 2027-04-01
+- Ubuntu 20.04 (Focal Fossa) - OS support ends on 2025-04-02
 
-Ubuntu 22.04 (Jammy Jellyfish) - OS support ends on 2027-04-01
-
-- Docker images containing PowerShell 7.2, PowerShell 7.4, and PowerShell 7.5-preview for x64 and
-  Arm32 are available from the [Microsoft Artifact Registry][mcr]
-
-Ubuntu 24.04 (Noble Numbat) - OS support ends on 2029-04-25
-
-- Docker images containing PowerShell 7.2, PowerShell 7.4, and PowerShell 7.5-preview for x64 and
-  Arm32 are available from the [Microsoft Artifact Registry][mcr]
+Install package files (`.deb`) are also available from [https://packages.microsoft.com/][pcm].
 
 Ubuntu 23.10 (Mantic Minotaur) is an interim release. Microsoft doesn't support
 [interim releases][interim] of Ubuntu. For more information, see
@@ -31,4 +25,5 @@ Ubuntu 23.10 (Mantic Minotaur) is an interim release. Microsoft doesn't support
 [interim]: https://ubuntu.com/about/release-cycle
 [lifecycle]: /powershell/scripting/install/powershell-support-lifecycle
 [community]: /powershell/scripting/install/community-support
-[mcr]: https://mcr.microsoft.com/en-us/product/powershell/tags
+[mcr]: https://mcr.microsoft.com/product/powershell/tags
+[pcm]: https://packages.microsoft.com/