Merge pull request #12573 from MicrosoftDocs/main

Auto Publish – main to live - 2025-12-09 23:00 UTC

Author: learn-build-service-prod[bot]

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: 09/29/2025
+ms.date: 12/09/2025
 no-loc: [Debug, Verbose, Confirm]
 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
@@ -37,18 +37,18 @@ For more information, see [about_Preference_Variables][03].
 The following list displays the common parameters. Their aliases are listed in
 parentheses.
 
-- `Debug` (db)
-- `ErrorAction` (ea)
-- `ErrorVariable` (ev)
-- `InformationAction` (infa)
-- `InformationVariable` (iv)
-- `OutVariable` (ov)
-- `OutBuffer` (ob)
-- `PipelineVariable` (pv)
-- `ProgressAction` (proga)
-- `Verbose` (vb)
-- `WarningAction` (wa)
-- `WarningVariable` (wv)
+- `Debug` (`db`)
+- `ErrorAction` (`ea`)
+- `ErrorVariable` (`ev`)
+- `InformationAction` (`infa`)
+- `InformationVariable` (`iv`)
+- `OutVariable` (`ov`)
+- `OutBuffer` (`ob`)
+- `PipelineVariable` (`pv`)
+- `ProgressAction` (`proga`)
+- `Verbose` (`vb`)
+- `WarningAction` (`wa`)
+- `WarningVariable` (`wv`)
 
 The **Action** parameters are `ActionPreference` type values.
 `ActionPreference` is an enumeration with the following values:
@@ -827,11 +827,12 @@ Mode                LastWriteTime     Length Name
 
 ## See also
 
+<!-- Using backtick on cmdlet names to avoid localization -->
 - [about_Preference_Variables][03]
-- [Write-Debug][11]
-- [Write-Error][12]
-- [Write-Verbose][13]
-- [Write-Warning][14]
+- [`Write-Debug`][11]
+- [`Write-Error`][12]
+- [`Write-Verbose`][13]
+- [`Write-Warning`][14]
 
 <!-- link references -->
 [02]: about_Automatic_Variables.md

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

@@ -1,7 +1,7 @@
 ---
 description: Explains the availability and purpose of output streams in PowerShell.
 Locale: en-US
-ms.date: 01/22/2023
+ms.date: 12/09/2025
 no-loc: [Success, Error, Warning, Verbose, Debug, Information, Progress]
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_output_streams?view=powershell-5.1&WT.mc_id=ps-gethelp
 schema: 2.0.0
@@ -102,16 +102,17 @@ support redirection.
 
 ## See also
 
+<!-- Using backtick on cmdlet names to avoid localization -->
 - [about_CommonParameters][02]
 - [about_Redirection][03]
-- [Write-Debug][04]
-- [Write-Error][05]
-- [Write-Host][06]
-- [Write-Information][07]
-- [Write-Output][08]
-- [Write-Progress][09]
-- [Write-Verbose][10]
-- [Write-Warning][11]
+- [`Write-Debug`][04]
+- [`Write-Error`][05]
+- [`Write-Host`][06]
+- [`Write-Information`][07]
+- [`Write-Output`][08]
+- [`Write-Progress`][09]
+- [`Write-Verbose`][10]
+- [`Write-Warning`][11]
 
 <!-- link references -->
 [01]: about_Automatic_Variables.md

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

@@ -1,7 +1,7 @@
 ---
 description: Describes the features of PowerShell that use ANSI escape sequences and the terminal hosts that support them.
 Locale: en-US
-ms.date: 08/27/2024
+ms.date: 12/09/2025
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_ansi_terminals?view=powershell-7.4&WT.mc_id=ps-gethelp
 schema: 2.0.0
 title: about_ANSI_Terminals
@@ -183,8 +183,23 @@ The following members control how or when ANSI formatting is used:
   - **SymbolicLink** - Built-in member to specify color for symbolic links
   - **Executable** - Built-in member to specify color for executables.
   - **Extension** - Use this member to define colors for different file
-    extensions. The **Extension** member pre-includes extensions for archive
-    and PowerShell files.
+    extensions. The **Extension** member predefines colors for archive and
+    PowerShell file extensions.
+
+    The following example shows how to change the colors for various `FileInfo`
+    settings and specific file extensions. The colors are chosen to work well
+    on a light terminal background.
+
+    ```powershell
+    $PSStyle.FileInfo.Directory = $PSStyle.Background.FromRgb(0x2f6aff) +
+        $PSStyle.Foreground.BrightWhite
+    $PSStyle.FileInfo.SymbolicLink = $PSStyle.Foreground.Cyan
+    $PSStyle.FileInfo.Executable = $PSStyle.Foreground.BrightMagenta
+    $PSStyle.FileInfo.Extension['.ps1'] = $PSStyle.Foreground.Cyan
+    $PSStyle.FileInfo.Extension['.ps1xml'] = $PSStyle.Foreground.Cyan
+    $PSStyle.FileInfo.Extension['.psd1'] = $PSStyle.Foreground.Cyan
+    $PSStyle.FileInfo.Extension['.psm1'] = $PSStyle.Foreground.Cyan
+    ```
 
 ## Cmdlets that generate ANSI output
 

reference/7.4/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: 09/29/2025
+ms.date: 12/09/2025
 no-loc: [Debug, Verbose, Confirm]
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_commonparameters?view=powershell-7.4&WT.mc_id=ps-gethelp
 schema: 2.0.0
@@ -37,18 +37,18 @@ For more information, see [about_Preference_Variables][03].
 The following list displays the common parameters. Their aliases are listed in
 parentheses.
 
-- `Debug` (db)
-- `ErrorAction` (ea)
-- `ErrorVariable` (ev)
-- `InformationAction` (infa)
-- `InformationVariable` (iv)
-- `OutVariable` (ov)
-- `OutBuffer` (ob)
-- `PipelineVariable` (pv)
-- `ProgressAction` (proga)
-- `Verbose` (vb)
-- `WarningAction` (wa)
-- `WarningVariable` (wv)
+- `Debug` (`db`)
+- `ErrorAction` (`ea`)
+- `ErrorVariable` (`ev`)
+- `InformationAction` (`infa`)
+- `InformationVariable` (`iv`)
+- `OutVariable` (`ov`)
+- `OutBuffer` (`ob`)
+- `PipelineVariable` (`pv`)
+- `ProgressAction` (`proga`)
+- `Verbose` (`vb`)
+- `WarningAction` (`wa`)
+- `WarningVariable` (`wv`)
 
 The **Action** parameters are `ActionPreference` type values.
 `ActionPreference` is an enumeration with the following values:
@@ -815,11 +815,12 @@ Mode                LastWriteTime     Length Name
 
 ## See also
 
+<!-- Using backtick on cmdlet names to avoid localization -->
 - [about_Preference_Variables][03]
-- [Write-Debug][11]
-- [Write-Error][12]
-- [Write-Verbose][13]
-- [Write-Warning][14]
+- [`Write-Debug`][11]
+- [`Write-Error`][12]
+- [`Write-Verbose`][13]
+- [`Write-Warning`][14]
 
 <!-- link references -->
 [02]: about_Automatic_Variables.md

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

@@ -1,7 +1,7 @@
 ---
 description: Explains the availability and purpose of output streams in PowerShell.
 Locale: en-US
-ms.date: 01/22/2023
+ms.date: 12/09/2025
 no-loc: [Success, Error, Warning, Verbose, Debug, Information, Progress]
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_output_streams?view=powershell-7.4&WT.mc_id=ps-gethelp
 schema: 2.0.0
@@ -102,16 +102,17 @@ support redirection.
 
 ## See also
 
+<!-- Using backtick on cmdlet names to avoid localization -->
 - [about_CommonParameters][02]
 - [about_Redirection][03]
-- [Write-Debug][04]
-- [Write-Error][05]
-- [Write-Host][06]
-- [Write-Information][07]
-- [Write-Output][08]
-- [Write-Progress][09]
-- [Write-Verbose][10]
-- [Write-Warning][11]
+- [`Write-Debug`][04]
+- [`Write-Error`][05]
+- [`Write-Host`][06]
+- [`Write-Information`][07]
+- [`Write-Output`][08]
+- [`Write-Progress`][09]
+- [`Write-Verbose`][10]
+- [`Write-Warning`][11]
 
 <!-- link references -->
 [01]: about_Automatic_Variables.md

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

@@ -1,7 +1,7 @@
 ---
 description: Describes the features of PowerShell that use ANSI escape sequences and the terminal hosts that support them.
 Locale: en-US
-ms.date: 08/27/2024
+ms.date: 12/09/2025
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_ansi_terminals?view=powershell-7.5&WT.mc_id=ps-gethelp
 schema: 2.0.0
 title: about_ANSI_Terminals
@@ -183,8 +183,23 @@ The following members control how or when ANSI formatting is used:
   - **SymbolicLink** - Built-in member to specify color for symbolic links
   - **Executable** - Built-in member to specify color for executables.
   - **Extension** - Use this member to define colors for different file
-    extensions. The **Extension** member pre-includes extensions for archive
-    and PowerShell files.
+    extensions. The **Extension** member predefines colors for archive and
+    PowerShell file extensions.
+
+    The following example shows how to change the colors for various `FileInfo`
+    settings and specific file extensions. The colors are chosen to work well
+    on a light terminal background.
+
+    ```powershell
+    $PSStyle.FileInfo.Directory = $PSStyle.Background.FromRgb(0x2f6aff) +
+        $PSStyle.Foreground.BrightWhite
+    $PSStyle.FileInfo.SymbolicLink = $PSStyle.Foreground.Cyan
+    $PSStyle.FileInfo.Executable = $PSStyle.Foreground.BrightMagenta
+    $PSStyle.FileInfo.Extension['.ps1'] = $PSStyle.Foreground.Cyan
+    $PSStyle.FileInfo.Extension['.ps1xml'] = $PSStyle.Foreground.Cyan
+    $PSStyle.FileInfo.Extension['.psd1'] = $PSStyle.Foreground.Cyan
+    $PSStyle.FileInfo.Extension['.psm1'] = $PSStyle.Foreground.Cyan
+    ```
 
 ## Cmdlets that generate ANSI output
 

reference/7.5/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: 09/29/2025
+ms.date: 12/09/2025
 no-loc: [Debug, Verbose, Confirm]
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_commonparameters?view=powershell-7.5&WT.mc_id=ps-gethelp
 schema: 2.0.0
@@ -37,18 +37,18 @@ For more information, see [about_Preference_Variables][03].
 The following list displays the common parameters. Their aliases are listed in
 parentheses.
 
-- `Debug` (db)
-- `ErrorAction` (ea)
-- `ErrorVariable` (ev)
-- `InformationAction` (infa)
-- `InformationVariable` (iv)
-- `OutVariable` (ov)
-- `OutBuffer` (ob)
-- `PipelineVariable` (pv)
-- `ProgressAction` (proga)
-- `Verbose` (vb)
-- `WarningAction` (wa)
-- `WarningVariable` (wv)
+- `Debug` (`db`)
+- `ErrorAction` (`ea`)
+- `ErrorVariable` (`ev`)
+- `InformationAction` (`infa`)
+- `InformationVariable` (`iv`)
+- `OutVariable` (`ov`)
+- `OutBuffer` (`ob`)
+- `PipelineVariable` (`pv`)
+- `ProgressAction` (`proga`)
+- `Verbose` (`vb`)
+- `WarningAction` (`wa`)
+- `WarningVariable` (`wv`)
 
 The **Action** parameters are `ActionPreference` type values.
 `ActionPreference` is an enumeration with the following values:
@@ -815,11 +815,12 @@ Mode                LastWriteTime     Length Name
 
 ## See also
 
+<!-- Using backtick on cmdlet names to avoid localization -->
 - [about_Preference_Variables][03]
-- [Write-Debug][11]
-- [Write-Error][12]
-- [Write-Verbose][13]
-- [Write-Warning][14]
+- [`Write-Debug`][11]
+- [`Write-Error`][12]
+- [`Write-Verbose`][13]
+- [`Write-Warning`][14]
 
 <!-- link references -->
 [02]: about_Automatic_Variables.md

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

@@ -1,7 +1,7 @@
 ---
 description: Explains the availability and purpose of output streams in PowerShell.
 Locale: en-US
-ms.date: 01/22/2023
+ms.date: 12/09/2025
 no-loc: [Success, Error, Warning, Verbose, Debug, Information, Progress]
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_output_streams?view=powershell-7.5&WT.mc_id=ps-gethelp
 schema: 2.0.0
@@ -102,16 +102,17 @@ support redirection.
 
 ## See also
 
+<!-- Using backtick on cmdlet names to avoid localization -->
 - [about_CommonParameters][02]
 - [about_Redirection][03]
-- [Write-Debug][04]
-- [Write-Error][05]
-- [Write-Host][06]
-- [Write-Information][07]
-- [Write-Output][08]
-- [Write-Progress][09]
-- [Write-Verbose][10]
-- [Write-Warning][11]
+- [`Write-Debug`][04]
+- [`Write-Error`][05]
+- [`Write-Host`][06]
+- [`Write-Information`][07]
+- [`Write-Output`][08]
+- [`Write-Progress`][09]
+- [`Write-Verbose`][10]
+- [`Write-Warning`][11]
 
 <!-- link references -->
 [01]: about_Automatic_Variables.md

reference/7.6/Microsoft.PowerShell.Core/About/about_ANSI_Terminals.md

@@ -1,7 +1,7 @@
 ---
 description: Describes the features of PowerShell that use ANSI escape sequences and the terminal hosts that support them.
 Locale: en-US
-ms.date: 08/27/2024
+ms.date: 12/09/2025
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_ansi_terminals?view=powershell-7.6&WT.mc_id=ps-gethelp
 schema: 2.0.0
 title: about_ANSI_Terminals
@@ -183,8 +183,23 @@ The following members control how or when ANSI formatting is used:
   - **SymbolicLink** - Built-in member to specify color for symbolic links
   - **Executable** - Built-in member to specify color for executables.
   - **Extension** - Use this member to define colors for different file
-    extensions. The **Extension** member pre-includes extensions for archive
-    and PowerShell files.
+    extensions. The **Extension** member predefines colors for archive and
+    PowerShell file extensions.
+
+    The following example shows how to change the colors for various `FileInfo`
+    settings and specific file extensions. The colors are chosen to work well
+    on a light terminal background.
+
+    ```powershell
+    $PSStyle.FileInfo.Directory = $PSStyle.Background.FromRgb(0x2f6aff) +
+        $PSStyle.Foreground.BrightWhite
+    $PSStyle.FileInfo.SymbolicLink = $PSStyle.Foreground.Cyan
+    $PSStyle.FileInfo.Executable = $PSStyle.Foreground.BrightMagenta
+    $PSStyle.FileInfo.Extension['.ps1'] = $PSStyle.Foreground.Cyan
+    $PSStyle.FileInfo.Extension['.ps1xml'] = $PSStyle.Foreground.Cyan
+    $PSStyle.FileInfo.Extension['.psd1'] = $PSStyle.Foreground.Cyan
+    $PSStyle.FileInfo.Extension['.psm1'] = $PSStyle.Foreground.Cyan
+    ```
 
 ## Cmdlets that generate ANSI output