Merge pull request #11081 from MicrosoftDocs/main

5/7/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: 01/19/2024
+ms.date: 05/07/2024
 no-loc: [Reset, Current, Background, Blink, Bold, Foreground, Formatting, Hidden, Italic, Reset, Reverse, Underline]
 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
@@ -551,10 +551,10 @@ available for use in module manifest files, whereas `$PSVersionTable` isn't.
 Contains the full path of the installation directory for PowerShell, typically,
 `$env:windir\System32\PowerShell\v1.0` in Windows systems. You can use this
 variable in the paths of PowerShell files. For example, the following command
-searches the conceptual Help topics for the word **variable**:
+searches the conceptual Help topics for the word **Help**:
 
 ```powershell
-Select-String -Pattern Variable -Path $pshome\*.txt
+Select-String -Pattern Help -Path $PSHOME\en-US\*.txt
 ```
 
 ### $PSItem

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

@@ -1,7 +1,7 @@
 ---
 description: Describes the operators that are supported by PowerShell.
 Locale: en-US
-ms.date: 02/26/2024
+ms.date: 05/07/2024
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_operators?view=powershell-5.1&WT.mc_id=ps-gethelp
 schema: 2.0.0
 title: about Operators
@@ -262,9 +262,13 @@ table. For more information, see [about_Hash_Tables][09].
 ### Call operator `&`
 
 Runs a command, script, or script block. The call operator, also known as the
-"invocation operator", lets you run commands that are stored in variables and
+_invocation operator_, lets you run commands that are stored in variables and
 represented by strings or script blocks. The call operator executes in a child
-scope. For more about scopes, see [about_Scopes][19].
+scope. For more about scopes, see [about_Scopes][19]. You can use this to build
+strings containing the command, parameters, and arguments you need, and then
+invoke the string as if it were a command. The strings that you create must
+follow the same parsing rules as a command that you type at the command line.
+For more information, see [about_Parsing][08].
 
 This example stores a command in a string and executes it using the call
 operator.
@@ -603,6 +607,7 @@ properties and methods of an object, use the Static parameter of the
 [05]: about_Arithmetic_Operators.md
 [06]: about_Assignment_Operators.md
 [07]: about_Comparison_Operators.md
+[08]: about_Parsing.md
 [09]: about_Hash_Tables.md
 [12]: about_Join.md
 [13]: about_logical_operators.md

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: 01/19/2024
+ms.date: 05/07/2024
 no-loc: [Reset, Current, Background, Blink, Bold, Foreground, Formatting, Hidden, Italic, Reset, Reverse, Underline]
 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
@@ -585,12 +585,12 @@ available for use in module manifest files, whereas `$PSVersionTable` isn't.
 ### $PSHOME
 
 Contains the full path of the installation directory for PowerShell, typically,
-`$env:windir\System32\PowerShell\v1.0` in Windows systems. You can use this
-variable in the paths of PowerShell files. For example, the following command
-searches the conceptual Help topics for the word **variable**:
+`C:\Program Files\PowerShell\7` in Windows systems. You can use this variable
+in the paths of PowerShell files. For example, the following command searches
+the conceptual Help topics for the word **Help**:
 
 ```powershell
-Select-String -Pattern Variable -Path $pshome\*.txt
+Select-String -Pattern Help -Path $PSHOME\en-US\*.txt
 ```
 
 ### $PSItem

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

@@ -1,7 +1,7 @@
 ---
 description: Describes the operators that are supported by PowerShell.
 Locale: en-US
-ms.date: 02/26/2024
+ms.date: 05/07/2024
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_operators?view=powershell-7.2&WT.mc_id=ps-gethelp
 schema: 2.0.0
 title: about Operators
@@ -239,9 +239,13 @@ table. For more information, see [about_Hash_Tables][09].
 ### Call operator `&`
 
 Runs a command, script, or script block. The call operator, also known as the
-"invocation operator", lets you run commands that are stored in variables and
+_invocation operator_, lets you run commands that are stored in variables and
 represented by strings or script blocks. The call operator executes in a child
-scope. For more about scopes, see [about_Scopes][19].
+scope. For more about scopes, see [about_Scopes][19]. You can use this to build
+strings containing the command, parameters, and arguments you need, and then
+invoke the string as if it were a command. The strings that you create must
+follow the same parsing rules as a command that you type at the command line.
+For more information, see [about_Parsing][08].
 
 This example stores a command in a string and executes it using the call
 operator.
@@ -851,6 +855,7 @@ ${a}?[0]
 [05]: about_Arithmetic_Operators.md
 [06]: about_Assignment_Operators.md
 [07]: about_Comparison_Operators.md
+[08]: about_Parsing.md
 [09]: about_Hash_Tables.md
 [10]: about_If.md
 [11]: about_Jobs.md

reference/7.3/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: 01/19/2024
+ms.date: 05/07/2024
 no-loc: [Reset, Current, Background, Blink, Bold, Foreground, Formatting, Hidden, Italic, Reset, Reverse, Underline]
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_automatic_variables?view=powershell-7.3&WT.mc_id=ps-gethelp
 schema: 2.0.0
@@ -585,12 +585,12 @@ available for use in module manifest files, whereas `$PSVersionTable` isn't.
 ### $PSHOME
 
 Contains the full path of the installation directory for PowerShell, typically,
-`$env:windir\System32\PowerShell\v1.0` in Windows systems. You can use this
-variable in the paths of PowerShell files. For example, the following command
-searches the conceptual Help topics for the word **variable**:
+`C:\Program Files\PowerShell\7` in Windows systems. You can use this variable
+in the paths of PowerShell files. For example, the following command searches
+the conceptual Help topics for the word **Help**:
 
 ```powershell
-Select-String -Pattern Variable -Path $pshome\*.txt
+Select-String -Pattern Help -Path $PSHOME\en-US\*.txt
 ```
 
 ### $PSItem

reference/7.3/Microsoft.PowerShell.Core/About/about_Operators.md

@@ -1,7 +1,7 @@
 ---
 description: Describes the operators that are supported by PowerShell.
 Locale: en-US
-ms.date: 02/26/2024
+ms.date: 05/07/2024
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_operators?view=powershell-7.3&WT.mc_id=ps-gethelp
 schema: 2.0.0
 title: about Operators
@@ -239,9 +239,13 @@ table. For more information, see [about_Hash_Tables][09].
 ### Call operator `&`
 
 Runs a command, script, or script block. The call operator, also known as the
-"invocation operator", lets you run commands that are stored in variables and
+_invocation operator_, lets you run commands that are stored in variables and
 represented by strings or script blocks. The call operator executes in a child
-scope. For more about scopes, see [about_Scopes][19].
+scope. For more about scopes, see [about_Scopes][19]. You can use this to build
+strings containing the command, parameters, and arguments you need, and then
+invoke the string as if it were a command. The strings that you create must
+follow the same parsing rules as a command that you type at the command line.
+For more information, see [about_Parsing][08].
 
 This example stores a command in a string and executes it using the call
 operator.
@@ -851,6 +855,7 @@ ${a}?[0]
 [05]: about_Arithmetic_Operators.md
 [06]: about_Assignment_Operators.md
 [07]: about_Comparison_Operators.md
+[08]: about_Parsing.md
 [09]: about_Hash_Tables.md
 [10]: about_If.md
 [11]: about_Jobs.md

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: 01/19/2024
+ms.date: 05/07/2024
 no-loc: [Reset, Current, Background, Blink, Bold, Foreground, Formatting, Hidden, Italic, Reset, Reverse, Underline]
 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
@@ -585,12 +585,12 @@ available for use in module manifest files, whereas `$PSVersionTable` isn't.
 ### $PSHOME
 
 Contains the full path of the installation directory for PowerShell, typically,
-`$env:windir\System32\PowerShell\v1.0` in Windows systems. You can use this
-variable in the paths of PowerShell files. For example, the following command
-searches the conceptual Help topics for the word **variable**:
+`C:\Program Files\PowerShell\7` in Windows systems. You can use this variable
+in the paths of PowerShell files. For example, the following command searches
+the conceptual Help topics for the word **Help**:
 
 ```powershell
-Select-String -Pattern Variable -Path $pshome\*.txt
+Select-String -Pattern Help -Path $PSHOME\en-US\*.txt
 ```
 
 ### $PSItem

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

@@ -1,7 +1,7 @@
 ---
 description: Describes the operators that are supported by PowerShell.
 Locale: en-US
-ms.date: 02/26/2024
+ms.date: 05/07/2024
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_operators?view=powershell-7.4&WT.mc_id=ps-gethelp
 schema: 2.0.0
 title: about Operators
@@ -239,9 +239,13 @@ table. For more information, see [about_Hash_Tables][09].
 ### Call operator `&`
 
 Runs a command, script, or script block. The call operator, also known as the
-"invocation operator", lets you run commands that are stored in variables and
+_invocation operator_, lets you run commands that are stored in variables and
 represented by strings or script blocks. The call operator executes in a child
-scope. For more about scopes, see [about_Scopes][19].
+scope. For more about scopes, see [about_Scopes][19]. You can use this to build
+strings containing the command, parameters, and arguments you need, and then
+invoke the string as if it were a command. The strings that you create must
+follow the same parsing rules as a command that you type at the command line.
+For more information, see [about_Parsing][08].
 
 This example stores a command in a string and executes it using the call
 operator.
@@ -851,6 +855,7 @@ ${a}?[0]
 [05]: about_Arithmetic_Operators.md
 [06]: about_Assignment_Operators.md
 [07]: about_Comparison_Operators.md
+[08]: about_Parsing.md
 [09]: about_Hash_Tables.md
 [10]: about_If.md
 [11]: about_Jobs.md

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: 01/19/2024
+ms.date: 05/07/2024
 no-loc: [Reset, Current, Background, Blink, Bold, Foreground, Formatting, Hidden, Italic, Reset, Reverse, Underline]
 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
@@ -585,12 +585,12 @@ available for use in module manifest files, whereas `$PSVersionTable` isn't.
 ### $PSHOME
 
 Contains the full path of the installation directory for PowerShell, typically,
-`$env:windir\System32\PowerShell\v1.0` in Windows systems. You can use this
-variable in the paths of PowerShell files. For example, the following command
-searches the conceptual Help topics for the word **variable**:
+`C:\Program Files\PowerShell\7` in Windows systems. You can use this variable
+in the paths of PowerShell files. For example, the following command searches
+the conceptual Help topics for the word **Help**:
 
 ```powershell
-Select-String -Pattern Variable -Path $pshome\*.txt
+Select-String -Pattern Help -Path $PSHOME\en-US\*.txt
 ```
 
 ### $PSItem

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

@@ -1,7 +1,7 @@
 ---
 description: Describes the operators that are supported by PowerShell.
 Locale: en-US
-ms.date: 02/26/2024
+ms.date: 05/07/2024
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_operators?view=powershell-7.5&WT.mc_id=ps-gethelp
 schema: 2.0.0
 title: about Operators
@@ -239,9 +239,13 @@ table. For more information, see [about_Hash_Tables][09].
 ### Call operator `&`
 
 Runs a command, script, or script block. The call operator, also known as the
-"invocation operator", lets you run commands that are stored in variables and
+_invocation operator_, lets you run commands that are stored in variables and
 represented by strings or script blocks. The call operator executes in a child
-scope. For more about scopes, see [about_Scopes][19].
+scope. For more about scopes, see [about_Scopes][19]. You can use this to build
+strings containing the command, parameters, and arguments you need, and then
+invoke the string as if it were a command. The strings that you create must
+follow the same parsing rules as a command that you type at the command line.
+For more information, see [about_Parsing][08].
 
 This example stores a command in a string and executes it using the call
 operator.
@@ -851,6 +855,7 @@ ${a}?[0]
 [05]: about_Arithmetic_Operators.md
 [06]: about_Assignment_Operators.md
 [07]: about_Comparison_Operators.md
+[08]: about_Parsing.md
 [09]: about_Hash_Tables.md
 [10]: about_If.md
 [11]: about_Jobs.md