PowerShell中实现ForEach循环并行执行的问题求助

问题场景 #

我有一段可正常运行的PowerShell串行代码，用于批量调用REST接口获取设备状态：

$ids = 1..9 
$status  = [PSCustomObject[]]::new(10)
foreach ($id in $ids)
{ 
   $uriStr      = "http://192.168." + [String]$id + ".51/status"
   $uri         = [System.Uri] $uriStr
   $status[$id] = try {Invoke-RestMethod -Uri $uri -TimeOut 30}catch{}
}
$status

尝试将循环改为并行执行时遇到多个问题：

• 直接使用foreach -parallel参数，提示“The foreach '-parallel' parameter is reserved for future use”；
• 尝试Workflow，提示“Workflow is not supported in PowerShell 6+”；
• 使用ForEach-Object -Parallel时，未加:using提示无法识别$status变量，加:using后出现“Unable to index into an object of type "System.Management.Automation.ScriptBlock"”错误。

正确实现方案 #

PowerShell 7+推荐使用ForEach-Object -Parallel实现并行，但不能直接在并行块中修改外部数组——因为并行脚本块运行在独立空间，:using引用的变量为只读，且多线程同时操作数组会引发冲突。正确思路是让每个并行任务返回包含设备ID和状态的对象，最后统一整理到目标数组中。

并行代码实现 #

$ids = 1..9 
# 初始化状态数组，长度保持和原代码一致
$status = [PSCustomObject[]]::new(10)

# 并行执行REST调用，返回关联ID的结果对象
$parallelResults = $ids | ForEach-Object -Parallel {
    $currentId = $_
    $uri = [System.Uri]"http://192.168.$currentId.51/status"
    # 保留原有的异常处理逻辑
    $currentStatus = try {
        Invoke-RestMethod -Uri $uri -TimeoutSec 30
    } catch {
        $null
    }
    # 返回包含ID和状态的自定义对象
    [PSCustomObject]@{
        DeviceId = $currentId
        Status   = $currentStatus
    }
}

# 将并行结果映射到状态数组
foreach ($result in $parallelResults) {
    $status[$result.DeviceId] = $result.Status
}

$status

核心要点说明 #

• 禁止直接修改外部变量：并行块中不要尝试修改:using引用的外部数组，而是通过返回结果的方式，在串行环境中统一处理，避免线程安全问题。
• 变量传递方式：通过管道传递$ids，并行块中用$_获取当前设备ID，无需额外引用；若需使用其他外部变量，才用:using:前缀（如:using:$globalConfig）。
• 并行度控制：可通过-ThrottleLimit参数限制同时运行的任务数（例如ForEach-Object -Parallel -ThrottleLimit 6），避免过度占用网络资源或给目标设备造成压力。
• 错误处理兼容：保留原有的try/catch逻辑，确保异常场景下的返回值和串行代码一致。

内容的提问来源于stack exchange，提问作者Net Dawg