Merge pull request #12585 from MicrosoftDocs/main

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

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

.gitignore

@@ -4,17 +4,17 @@ _themes/
 .openpublishing.build.mdproj
 .openpublishing.buildcore.ps1
 .optemp/
+.vale/
 *.orig
 **/.ignore/**
+**/settings.json
 dependentPackages/
 log/
 maml/
 obj/
 packages.config
 packages/
+StaleContentReport.*.csv
 Tools/NuGet/
 updatablehelp/
 xhtml/
-**/settings.json
-StaleContentReport.*.csv
-.vale/

.vscode/extensions.json

@@ -5,10 +5,13 @@
     "Acrolinx.vscode-sidebar",
     "docsmsft.docs-authoring-pack",
     "marvhen.reflow-markdown",
+    "chrischinchilla.vale-vscode",
     "ms-vscode.powershell",
+    "nhoizey.gremlins",
     "shuworks.vscode-table-formatter",
+    "bierner.markdown-yaml-preamble",
     "streetsidesoftware.code-spell-checker",
-    "wmaurer.change-case",
-    "yzane.markdown-pdf"
+    "usernamehw.errorlens",
+    "wmaurer.change-case"
   ]
 }

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

@@ -1,14 +1,15 @@
 ---
 description: Provides information about how PowerShell background jobs run a command or expression in the background without interacting with the current session.
 Locale: en-US
-ms.date: 01/07/2025
+ms.date: 12/15/2025
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_jobs?view=powershell-5.1&WT.mc_id=ps-gethelp
 schema: 2.0.0
 title: about_Jobs
 ---
 # about_Jobs
 
 ## Short description
+
 Provides information about how PowerShell background jobs run a command or
 expression in the background without interacting with the current session.
 
@@ -239,12 +240,12 @@ Id Name  PSJobTypeName State    HasMoreData Location  Command
 In this case, the **State** property reveals that Job 2 is still running. If
 you were to use the `Receive-Job` cmdlet to get the job results now, the
 results would be incomplete. You can use the `Receive-Job` cmdlet repeatedly to
-get all of the results. Use the **State** property to determine when the job is
+get all the results. Use the **State** property to determine when the job is
 complete.
 
-You can also use the **Wait** parameter of the `Receive-Job` cmdlet. When you
-use this parameter, the cmdlet doesn't return the command prompt until the job
-is completed and all results are available.
+You can also the `Receive-Job -Wait` command. When you use this parameter, the
+cmdlet doesn't return the command prompt until the job is completed and all
+results are available.
 
 You can also use the `Wait-Job` cmdlet to wait for any or all of the results of
 the job. `Wait-Job` lets you wait for one or more specific job or for all jobs.

reference/5.1/Microsoft.PowerShell.Core/Get-Help.md

@@ -2,7 +2,7 @@
 external help file: System.Management.Automation.dll-Help.xml
 Locale: en-US
 Module Name: Microsoft.PowerShell.Core
-ms.date: 06/21/2023
+ms.date: 12/15/2025
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/get-help?view=powershell-5.1&WT.mc_id=ps-gethelp
 schema: 2.0.0
 title: Get-Help
@@ -255,10 +255,9 @@ Export-Clixml
 Import-Clixml
 ```
 
-`Get-Help` uses the **Full** parameter to get help information for `Add-Member`. The
-**MamlCommandHelpInfo** object is sent down the pipeline. `Out-String` uses the **Stream** parameter
-to convert the object into a string. `Select-String` uses the **Pattern** parameter to search the
-string for **Clixml**.
+`Get-Help` uses the **Full** parameter to get help information for `Add-Member` and returns a
+**MamlCommandHelpInfo**. `Out-String` uses the **Stream** parameter to convert the object into a
+string. `Select-String` uses the **Pattern** parameter to search the string for **Clixml**.
 
 ### Example 10: Display a list of articles that include a word
 
@@ -655,6 +654,13 @@ can also use it to update the help files so that the help on your computer is ne
 You can also read the help articles about the commands that come with PowerShell online starting at
 [Getting Started with Windows PowerShell](/powershell/scripting/getting-started/getting-started-with-windows-powershell).
 
+You can use `Get-Help` to search for help articles by keyword or wildcard pattern. `Get-Help`
+displays a list of the matching articles. If the search term matches an approved verb, `Get-Help`
+displays a list of commands that use that verb. It doesn't include other help articles that include
+the matching search term. If the search term doesn't match an approved verb, `Get-Help` displays
+a list of articles that include that text in their contents. For more information about approved
+verbs, see [Get-Verb](xref:Microsoft.PowerShell.Utility.Get-Verb).
+
 `Get-Help` displays help in the locale set for the Windows operating system or in the fallback
 language for that locale. If you don't have help files for the primary or fallback locale,
 `Get-Help` behaves as if there are no help files on the computer. To get help for a different

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

@@ -1,14 +1,15 @@
 ---
 description: Provides information about how PowerShell background jobs run a command or expression in the background without interacting with the current session.
 Locale: en-US
-ms.date: 01/07/2025
+ms.date: 12/15/2025
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_jobs?view=powershell-7.4&WT.mc_id=ps-gethelp
 schema: 2.0.0
 title: about_Jobs
 ---
 # about_Jobs
 
 ## Short description
+
 Provides information about how PowerShell background jobs run a command or
 expression in the background without interacting with the current session.
 
@@ -250,12 +251,12 @@ Id Name  PSJobTypeName State    HasMoreData Location  Command
 In this case, the **State** property reveals that Job 2 is still running. If
 you were to use the `Receive-Job` cmdlet to get the job results now, the
 results would be incomplete. You can use the `Receive-Job` cmdlet repeatedly to
-get all of the results. Use the **State** property to determine when the job is
+get all the results. Use the **State** property to determine when the job is
 complete.
 
-You can also use the **Wait** parameter of the `Receive-Job` cmdlet. When you
-use this parameter, the cmdlet doesn't return the command prompt until the job
-is completed and all results are available.
+You can also the `Receive-Job -Wait` command. When you use this parameter, the
+cmdlet doesn't return the command prompt until the job is completed and all
+results are available.
 
 You can also use the `Wait-Job` cmdlet to wait for any or all of the results of
 the job. `Wait-Job` lets you wait for one or more specific job or for all jobs.

reference/7.4/Microsoft.PowerShell.Core/Get-Help.md

@@ -2,7 +2,7 @@
 external help file: System.Management.Automation.dll-Help.xml
 Locale: en-US
 Module Name: Microsoft.PowerShell.Core
-ms.date: 01/10/2024
+ms.date: 12/15/2025
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/get-help?view=powershell-7.4&WT.mc_id=ps-gethelp
 schema: 2.0.0
 title: Get-Help
@@ -100,8 +100,8 @@ fallback locale, it looks for help articles in English, **en-US**, before it ret
 message or displaying autogenerated help.
 
 For information about the symbols that `Get-Help` displays in the command syntax diagram, see
-[about_Command_Syntax](./About/about_Command_Syntax.md). For information about parameter attributes,
-such as **Required** and **Position**, see [about_Parameters](./About/about_Parameters.md).
+[about_Command_Syntax](About/about_Command_Syntax.md). For information about parameter attributes,
+such as **Required** and **Position**, see [about_Parameters](About/about_Parameters.md).
 
 > [!NOTE]
 > In PowerShell 3.0 and PowerShell 4.0, `Get-Help` can't find **About** articles in modules unless
@@ -118,10 +118,10 @@ immediately to the left of a parameter, the function jumps to that parameter's d
 full help topic. When you hit <kbd>Q</kbd> to exit the help view, you are returned to the command
 line at the same cursor position so you can continue typing the command.
 
-When you use the key combination <kbd>Alt</kbd>+<kbd>h</kbd>, the **PSReadLine** `ShowParameterHelp` function
-displays help information for the parameter immediately to the left of the cursor. The help text is
-displayed below the command line. This allows you to see the description of the parameter and
-continue typing your command.
+When you use the key combination <kbd>Alt</kbd>+<kbd>h</kbd>, the **PSReadLine** `ShowParameterHelp`
+function displays help information for the parameter immediately to the left of the cursor. The help
+text is displayed below the command line. This allows you to see the description of the parameter
+and continue typing your command.
 
 For more information, see [Using dynamic help](/powershell/scripting/learn/shell/dynamic-help).
 
@@ -255,10 +255,9 @@ Export-Clixml
 Import-Clixml
 ```
 
-`Get-Help` uses the **Full** parameter to get help information for `Add-Member`. The
-**MamlCommandHelpInfo** object is sent down the pipeline. `Out-String` uses the **Stream** parameter
-to convert the object into a string. `Select-String` uses the **Pattern** parameter to search the
-string for **Clixml**.
+`Get-Help` uses the **Full** parameter to get help information for `Add-Member` and returns a
+**MamlCommandHelpInfo**. `Out-String` uses the **Stream** parameter to convert the object into a
+string. `Select-String` uses the **Pattern** parameter to search the string for **Clixml**.
 
 ### Example 10: Display a list of articles that include a word
 
@@ -329,7 +328,7 @@ SYNOPSIS
 ### Example 12: Display help for a script
 
 This example gets help for the `MyScript.ps1 script`. For information about how to write help for
-your functions and scripts, see [about_Comment_Based_Help](./About/about_Comment_Based_Help.md).
+your functions and scripts, see [about_Comment_Based_Help](About/about_Comment_Based_Help.md).
 
 ```powershell
 Get-Help -Name C:\PS-Test\MyScript.ps1
@@ -505,7 +504,7 @@ for cmdlet, function, workflow, and script help articles. You can't use the **On
 with `Get-Help` in a remote session.
 
 For information about supporting this feature in help articles that you write, see
-[about_Comment_Based_Help](./About/about_Comment_Based_Help.md), and
+[about_Comment_Based_Help](About/about_Comment_Based_Help.md), and
 [Supporting Online Help](/powershell/scripting/developer/module/supporting-online-help), and
 [Writing Help for PowerShell Cmdlets](/powershell/scripting/developer/help/writing-help-for-windows-powershell-cmdlets).
 
@@ -554,7 +553,7 @@ To see the custom cmdlet help for a provider path, go to the provider path locat
 the provider path. You can also find custom cmdlet help online in the provider help section of the
 help articles.
 
-For more information about PowerShell providers, see [about_Providers](./About/about_Providers.md).
+For more information about PowerShell providers, see [about_Providers](About/about_Providers.md).
 
 > [!NOTE]
 > The provider for the path specified must have a PowerShell provider help file installed. If no
@@ -655,6 +654,13 @@ can also use it to update the help files so that the help on your computer is ne
 You can also read the help articles about the commands that come with PowerShell online starting at
 [Getting Started with Windows PowerShell](/powershell/scripting/getting-started/getting-started-with-windows-powershell).
 
+You can use `Get-Help` to search for help articles by keyword or wildcard pattern. `Get-Help`
+displays a list of the matching articles. If the search term matches an approved verb, `Get-Help`
+displays a list of commands that use that verb. It doesn't include other help articles that include
+the matching search term. If the search term doesn't match an approved verb, `Get-Help` displays
+a list of articles that include that text in their contents. For more information about approved
+verbs, see [Get-Verb](xref:Microsoft.PowerShell.Utility.Get-Verb).
+
 `Get-Help` displays help in the locale set for the Windows operating system or in the fallback
 language for that locale. If you don't have help files for the primary or fallback locale,
 `Get-Help` behaves as if there are no help files on the computer. To get help for a different
@@ -691,7 +697,7 @@ following fields:
 
 [about_Command_Syntax](About/about_Command_Syntax.md)
 
-[about_Comment_Based_Help](./About/about_Comment_Based_Help.md)
+[about_Comment_Based_Help](About/about_Comment_Based_Help.md)
 
 [Get-Command](Get-Command.md)
 

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

@@ -1,14 +1,15 @@
 ---
 description: Provides information about how PowerShell background jobs run a command or expression in the background without interacting with the current session.
 Locale: en-US
-ms.date: 01/07/2025
+ms.date: 12/15/2025
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_jobs?view=powershell-7.5&WT.mc_id=ps-gethelp
 schema: 2.0.0
 title: about_Jobs
 ---
 # about_Jobs
 
 ## Short description
+
 Provides information about how PowerShell background jobs run a command or
 expression in the background without interacting with the current session.
 
@@ -250,12 +251,12 @@ Id Name  PSJobTypeName State    HasMoreData Location  Command
 In this case, the **State** property reveals that Job 2 is still running. If
 you were to use the `Receive-Job` cmdlet to get the job results now, the
 results would be incomplete. You can use the `Receive-Job` cmdlet repeatedly to
-get all of the results. Use the **State** property to determine when the job is
+get all the results. Use the **State** property to determine when the job is
 complete.
 
-You can also use the **Wait** parameter of the `Receive-Job` cmdlet. When you
-use this parameter, the cmdlet doesn't return the command prompt until the job
-is completed and all results are available.
+You can also the `Receive-Job -Wait` command. When you use this parameter, the
+cmdlet doesn't return the command prompt until the job is completed and all
+results are available.
 
 You can also use the `Wait-Job` cmdlet to wait for any or all of the results of
 the job. `Wait-Job` lets you wait for one or more specific job or for all jobs.

reference/7.5/Microsoft.PowerShell.Core/Get-Help.md

@@ -2,7 +2,7 @@
 external help file: System.Management.Automation.dll-Help.xml
 Locale: en-US
 Module Name: Microsoft.PowerShell.Core
-ms.date: 01/10/2024
+ms.date: 12/15/2025
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/get-help?view=powershell-7.5&WT.mc_id=ps-gethelp
 schema: 2.0.0
 title: Get-Help
@@ -255,10 +255,9 @@ Export-Clixml
 Import-Clixml
 ```
 
-`Get-Help` uses the **Full** parameter to get help information for `Add-Member`. The
-**MamlCommandHelpInfo** object is sent down the pipeline. `Out-String` uses the **Stream** parameter
-to convert the object into a string. `Select-String` uses the **Pattern** parameter to search the
-string for **Clixml**.
+`Get-Help` uses the **Full** parameter to get help information for `Add-Member` and returns a
+**MamlCommandHelpInfo**. `Out-String` uses the **Stream** parameter to convert the object into a
+string. `Select-String` uses the **Pattern** parameter to search the string for **Clixml**.
 
 ### Example 10: Display a list of articles that include a word
 
@@ -655,6 +654,13 @@ can also use it to update the help files so that the help on your computer is ne
 You can also read the help articles about the commands that come with PowerShell online starting at
 [Getting Started with Windows PowerShell](/powershell/scripting/getting-started/getting-started-with-windows-powershell).
 
+You can use `Get-Help` to search for help articles by keyword or wildcard pattern. `Get-Help`
+displays a list of the matching articles. If the search term matches an approved verb, `Get-Help`
+displays a list of commands that use that verb. It doesn't include other help articles that include
+the matching search term. If the search term doesn't match an approved verb, `Get-Help` displays
+a list of articles that include that text in their contents. For more information about approved
+verbs, see [Get-Verb](xref:Microsoft.PowerShell.Utility.Get-Verb).
+
 `Get-Help` displays help in the locale set for the Windows operating system or in the fallback
 language for that locale. If you don't have help files for the primary or fallback locale,
 `Get-Help` behaves as if there are no help files on the computer. To get help for a different

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

@@ -1,14 +1,15 @@
 ---
 description: Provides information about how PowerShell background jobs run a command or expression in the background without interacting with the current session.
 Locale: en-US
-ms.date: 01/07/2025
+ms.date: 12/15/2025
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_jobs?view=powershell-7.6&WT.mc_id=ps-gethelp
 schema: 2.0.0
 title: about_Jobs
 ---
 # about_Jobs
 
 ## Short description
+
 Provides information about how PowerShell background jobs run a command or
 expression in the background without interacting with the current session.
 
@@ -250,12 +251,12 @@ Id Name  PSJobTypeName State    HasMoreData Location  Command
 In this case, the **State** property reveals that Job 2 is still running. If
 you were to use the `Receive-Job` cmdlet to get the job results now, the
 results would be incomplete. You can use the `Receive-Job` cmdlet repeatedly to
-get all of the results. Use the **State** property to determine when the job is
+get all the results. Use the **State** property to determine when the job is
 complete.
 
-You can also use the **Wait** parameter of the `Receive-Job` cmdlet. When you
-use this parameter, the cmdlet doesn't return the command prompt until the job
-is completed and all results are available.
+You can also the `Receive-Job -Wait` command. When you use this parameter, the
+cmdlet doesn't return the command prompt until the job is completed and all
+results are available.
 
 You can also use the `Wait-Job` cmdlet to wait for any or all of the results of
 the job. `Wait-Job` lets you wait for one or more specific job or for all jobs.