Update ForEach-Object -Parallel example 17

In PS v7.2, ForEach-Object -Parallel was updated to support variable
access in nested script block scenarios.

Example 17 in the docs currently reflects the erroneous behavior
exhibited in v7.1 and prior. This change updates the example to
reflect the fixed behavior in v7.2.

See PS issue #11817 for more information.

Author: surfingoldelephant

reference/7.4/Microsoft.PowerShell.Core/ForEach-Object.md

@@ -455,7 +455,7 @@ Output: 5
 > [PipelineVariable](About/about_CommonParameters.md) common parameter variables are _not_
 > supported in `ForEach-Object -Parallel` scenarios even with the `Using:` scope modifier.
 
-### Example 17: Passing variables in nested parallel script ScriptBlockSet
+### Example 17: Passing variables in nested parallel scriptblocks
 
 You can create a variable outside a `ForEach-Object -Parallel` scoped scriptblock and use
 it inside the scriptblock with the `Using:` scope modifier.
@@ -472,9 +472,10 @@ TestA
 TestA
 ```
 
+Beginning in PowerShell 7.2, you can create a variable inside a `ForEach-Object -Parallel` scoped
+scriptblock and use it inside a nested scriptblock.
+
 ```powershell
-# You CANNOT create a variable inside a scoped scriptblock
-# to be used in a nested foreach parallel scriptblock.
 $test1 = 'TestA'
 1..2 | ForEach-Object -Parallel {
     $Using:test1
@@ -486,14 +487,17 @@ $test1 = 'TestA'
 ```
 
 ```Output
-Line |
-   2 |  1..2 | ForEach-Object -Parallel {
-     |         ~~~~~~~~~~~~~~~~~~~~~~~~~~
-     | The value of the using variable '$Using:test2' can't be retrieved because it has
-     | not been set in the local session.
+TestA
+TestA
+TestB
+TestB
+TestB
+TestB
 ```
 
-The nested scriptblock can't access the `$test2` variable and an error is thrown.
+> [!NOTE]
+> In versions prior to PowerShell 7.2, the nested scriptblock can't access the `$test2` variable and
+> an error is thrown.
 
 ### Example 18: Creating multiple jobs that run scripts in parallel
 

reference/7.5/Microsoft.PowerShell.Core/ForEach-Object.md

@@ -455,7 +455,7 @@ Output: 5
 > [PipelineVariable](About/about_CommonParameters.md) common parameter variables are _not_
 > supported in `ForEach-Object -Parallel` scenarios even with the `Using:` scope modifier.
 
-### Example 17: Passing variables in nested parallel script ScriptBlockSet
+### Example 17: Passing variables in nested parallel scriptblocks
 
 You can create a variable outside a `ForEach-Object -Parallel` scoped scriptblock and use
 it inside the scriptblock with the `Using:` scope modifier.
@@ -472,9 +472,10 @@ TestA
 TestA
 ```
 
+Beginning in PowerShell 7.2, you can create a variable inside a `ForEach-Object -Parallel` scoped
+scriptblock and use it inside a nested scriptblock.
+
 ```powershell
-# You CANNOT create a variable inside a scoped scriptblock
-# to be used in a nested foreach parallel scriptblock.
 $test1 = 'TestA'
 1..2 | ForEach-Object -Parallel {
     $Using:test1
@@ -486,14 +487,17 @@ $test1 = 'TestA'
 ```
 
 ```Output
-Line |
-   2 |  1..2 | ForEach-Object -Parallel {
-     |         ~~~~~~~~~~~~~~~~~~~~~~~~~~
-     | The value of the using variable '$Using:test2' can't be retrieved because it has
-     | not been set in the local session.
+TestA
+TestA
+TestB
+TestB
+TestB
+TestB
 ```
 
-The nested scriptblock can't access the `$test2` variable and an error is thrown.
+> [!NOTE]
+> In versions prior to PowerShell 7.2, the nested scriptblock can't access the `$test2` variable and
+> an error is thrown.
 
 ### Example 18: Creating multiple jobs that run scripts in parallel
 

reference/7.6/Microsoft.PowerShell.Core/ForEach-Object.md

@@ -455,7 +455,7 @@ Output: 5
 > [PipelineVariable](About/about_CommonParameters.md) common parameter variables are _not_
 > supported in `ForEach-Object -Parallel` scenarios even with the `Using:` scope modifier.
 
-### Example 17: Passing variables in nested parallel script ScriptBlockSet
+### Example 17: Passing variables in nested parallel scriptblocks
 
 You can create a variable outside a `ForEach-Object -Parallel` scoped scriptblock and use
 it inside the scriptblock with the `Using:` scope modifier.
@@ -472,9 +472,10 @@ TestA
 TestA
 ```
 
+Beginning in PowerShell 7.2, you can create a variable inside a `ForEach-Object -Parallel` scoped
+scriptblock and use it inside a nested scriptblock.
+
 ```powershell
-# You CANNOT create a variable inside a scoped scriptblock
-# to be used in a nested foreach parallel scriptblock.
 $test1 = 'TestA'
 1..2 | ForEach-Object -Parallel {
     $Using:test1
@@ -486,14 +487,17 @@ $test1 = 'TestA'
 ```
 
 ```Output
-Line |
-   2 |  1..2 | ForEach-Object -Parallel {
-     |         ~~~~~~~~~~~~~~~~~~~~~~~~~~
-     | The value of the using variable '$Using:test2' can't be retrieved because it has
-     | not been set in the local session.
+TestA
+TestA
+TestB
+TestB
+TestB
+TestB
 ```
 
-The nested scriptblock can't access the `$test2` variable and an error is thrown.
+> [!NOTE]
+> In versions prior to PowerShell 7.2, the nested scriptblock can't access the `$test2` variable and
+> an error is thrown.
 
 ### Example 18: Creating multiple jobs that run scripts in parallel