Merge branch 'main' into doc/new-guid-uuid-v7

Author: SufficientDaikon

redir/.openpublishing.redirection.json

@@ -177,12 +177,17 @@
     },
     {
       "redirect_document_id": false,
-      "redirect_url": "/powershell/scripting/install/install-powershell-on-linux",
+      "redirect_url": "/powershell/scripting/install/linux-overview",
+      "source_path": "../reference/docs-conceptual/install/install-powershell-on-linux.md"
+    },
+    {
+      "redirect_document_id": false,
+      "redirect_url": "/powershell/scripting/install/linux-overview",
       "source_path": "../reference/docs-conceptual/install/Installing-PowerShell-Core-on-Linux.md"
     },
     {
       "redirect_document_id": false,
-      "redirect_url": "/powershell/scripting/install/install-powershell-on-linux",
+      "redirect_url": "/powershell/scripting/install/linux-overview",
       "source_path": "../reference/docs-conceptual/install/Installing-PowerShell-on-Linux.md"
     },
     {

reference/5.1/CimCmdlets/New-CimSession.md

@@ -331,8 +331,8 @@ By default, the `New-CimSession` cmdlet establishes a connection with a remote W
 endpoint for two reasons: to verify that the remote server is listening on the port number that is
 specified using the **Port** parameter, and to verify the specified account credentials. The
 verification is accomplished using a standard WS-Identity operation. You can add the
-**SkipTestConnection** switch parameter if the remote WS-Management endpoint cannot use WS-Identify,
-or to reduce some data transmission time.
+**SkipTestConnection** `[switch]` parameter if the remote WS-Management endpoint cannot use
+WS-Identify, or to reduce some data transmission time.
 
 ```yaml
 Type: System.Management.Automation.SwitchParameter

reference/5.1/Microsoft.PowerShell.Archive/Expand-Archive.md

@@ -2,7 +2,7 @@
 external help file: Microsoft.PowerShell.Archive-help.xml
 Locale: en-US
 Module Name: Microsoft.PowerShell.Archive
-ms.date: 10/06/2023
+ms.date: 04/01/2026
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.archive/expand-archive?view=powershell-5.1&WT.mc_id=ps-gethelp
 schema: 2.0.0
 title: Expand-Archive
@@ -11,7 +11,7 @@ title: Expand-Archive
 # Expand-Archive
 
 ## SYNOPSIS
-Extracts files from a specified archive (zipped) file.
+Extracts files from a specified ZIP archive file.
 
 ## SYNTAX
 
@@ -35,6 +35,13 @@ The `Expand-Archive` cmdlet extracts files from a specified zipped archive file
 destination folder. An archive file allows multiple files to be packaged, and optionally compressed,
 into a single zipped file for easier distribution and storage.
 
+This cmdlet only works with zip archives, which typically have the file extension `.zip`.
+
+The `Expand-Archive` cmdlet uses the **System.IO.Compression.ZipArchive** API to compress files.
+The API limits the maximum file size to 2GB. The .NET API works with files that conform to the
+official ZIP file format specification by PKWARE Inc. For more information, see
+[System.IO.Compression.ZipArchive](xref:System.IO.Compression.ZipArchive).
+
 ## EXAMPLES
 
 ### Example 1: Extract the contents of an archive

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: 02/10/2026
+ms.date: 04/02/2026
 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
@@ -160,8 +160,8 @@ use this automatic variable to determine the file to update.
 Contains an array of error objects that represent the most recent errors. The
 most recent error is the first error object in the array `$Error[0]`.
 
-To prevent an error from being added to the `$Error` array, use the
-**ErrorAction** common parameter with a value of **Ignore**. For more
+To prevent a non-terminating error from being added to the `$Error` array, use
+the **ErrorAction** common parameter with a value of **Ignore**. For more
 information, see [about_CommonParameters][53].
 
 ### `$Event`

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

@@ -198,19 +198,18 @@ The syntax diagrams use the following symbols:
 - Parameters with no values
 
   Some parameters don't accept input, so they don't have a parameter value.
-  Parameters without values are _switch parameters_. Switch parameters are used
-  like boolean values. They default to `$false`. When you use a switch
-  parameter, the value is set to `$true`.
+  Parameters without values are _`[switch]` parameters_. `[switch]` parameters
+  are used like boolean values. They default to `$false`. When you use a
+  `[switch]` parameter, the value is set to `$true`.
 
-  For example, the **ListImported** parameter of `Get-Command` is a switch
-  parameter. When you use the **ListImported** parameter, the cmdlet return
+  For example, the **ListImported** parameter of `Get-Command` is a `[switch]`
+  parameter. When you use the **ListImported** parameter, the cmdlet returns
   only commands that were imported from modules in the current session.
 
   ```Syntax
   Get-Command [-ListImported]
   ```
 
-<!-- So what are these `[    ]`? - square brackets, duh! -->
 - Brackets `[  ]` around parameters indicate optional items. A parameter and
   its value can be optional. For example, the **CommandType** parameter of
   `Get-Command` and its value are enclosed in brackets because they're both

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

@@ -1,7 +1,7 @@
 ---
 description: Describes the parameters that can be used with any cmdlet.
 Locale: en-US
-ms.date: 01/18/2026
+ms.date: 04/02/2026
 no-loc: [Confirm, Debug, ErrorAction, ErrorVariable, InformationAction, InformationVariable, OutBuffer, OutVariable, PipelineVariable, ProgressAction, Verbose, WarningAction, WarningVariable, WhatIf]
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_commonparameters?view=powershell-5.1&WT.mc_id=ps-gethelp
 schema: 2.0.0
@@ -109,14 +109,13 @@ the display of debugging messages when `$DebugPreference` isn't
 ### -ErrorAction
 
 Determines how the cmdlet responds to a non-terminating error from the command.
-This parameter works only when the command generates a non-terminating error,
-such as those from the `Write-Error` cmdlet.
+This parameter overrides the value of the `$ErrorActionPreference` variable for
+non-terminating errors generated by the command or the `Write-Error` cmdlet.
 
 ```yaml
 Type: ActionPreference
 Aliases: ea
-Accepted values: Suspend, Ignore, Inquire, Continue, Stop, SilentlyContinue
-
+Accepted values: Break, Suspend, Ignore, Inquire, Continue, Stop, SilentlyContinue
 Required: False
 Position: Named
 Default value: Depends on preference variable
@@ -129,9 +128,12 @@ variable for the current command. Because the default value of the
 `$ErrorActionPreference` variable is `Continue`, error messages are displayed
 and execution continues unless you use the `ErrorAction` parameter.
 
-The `ErrorAction` parameter has no effect on terminating errors (such as
-missing data, parameters that aren't valid, or insufficient permissions) that
-prevent a command from completing successfully.
+The `-ErrorAction` parameter doesn't prevent statement-terminating errors
+(such as missing data, parameters that aren't valid, or insufficient
+permissions) from stopping the current statement. However, when set to `Stop`,
+it escalates non-terminating errors to script-terminating errors, making them
+catchable by `try/catch`. For more information about error categories, see
+[about_Error_Handling][15].
 
 - `-ErrorAction:Break` Enters the debugger when an error occurs or an exception
   is raised.
@@ -829,6 +831,7 @@ Mode                LastWriteTime     Length Name
 
 <!-- Using backtick on cmdlet names to avoid localization -->
 - [about_Preference_Variables][03]
+- [about_Error_Handling][15]
 - [`Write-Debug`][11]
 - [`Write-Error`][12]
 - [`Write-Verbose`][13]
@@ -844,4 +847,5 @@ Mode                LastWriteTime     Length Name
 [12]: xref:Microsoft.PowerShell.Utility.Write-Error
 [13]: xref:Microsoft.PowerShell.Utility.Write-Verbose
 [14]: xref:Microsoft.PowerShell.Utility.Write-Warning
+[15]: about_Error_Handling.md