如何在PowerShell中正确使用System.Threading.Tasks.Parallel？

我来帮你解决这个问题——你遇到的“无法在运行空间外执行”错误，本质是PowerShell的运行空间（Runspace）机制在搞事情。System.Threading.Tasks.Parallel启动的线程默认不会关联PowerShell的运行上下文，而PowerShell的绝大多数操作（比如调用cmdlet、访问变量）都依赖当前运行空间，所以直接跑脚本块就会报错。

下面我给你拆解正确的实现方式，以及和*-Job cmdlets的区别：

核心问题：运行空间绑定 #

PowerShell的脚本块（ScriptBlock）不是普通的.NET委托，它的执行依赖于运行空间——包含了变量、模块、cmdlet等上下文的容器。Parallel.ForEach默认启动的线程没有绑定任何PowerShell运行空间，所以脚本块里的PowerShell操作会失败。

你不需要像*-Job那样创建独立的作业进程，但必须手动把脚本块和运行空间关联起来。

方法1：绑定到当前运行空间执行 #

最简单的方式是获取当前PowerShell的默认运行空间，然后在并行线程里通过Invoke方法在该运行空间内执行你的逻辑：

# 获取当前PowerShell的默认运行空间
$currentRunspace = [System.Management.Automation.Runspaces.Runspace]::DefaultRunspace

# 测试用的数据集
$testData = @("FileA.txt", "FileB.log", "FolderC", "FileD.csv")

# 使用Parallel.ForEach处理数据
[System.Threading.Tasks.Parallel]::ForEach(
    $testData,
    [Action[string]]{
        param($item)
        # 在当前运行空间内执行操作，确保PowerShell上下文可用
        $result = $currentRunspace.Invoke({
            param($inputItem)
            # 这里可以安全执行任何PowerShell操作
            Write-Host "Processing $inputItem on thread $([System.Threading.Thread]::CurrentThread.ManagedThreadId)"
            # 示例：检查项目是否存在
            Test-Path -Path $inputItem
        }, $item)
        
        # 处理返回结果
        if ($result -eq $true) {
            Write-Host "$item exists"
        }
    }
)

方法2：初始化线程级运行空间 #

如果需要在每个并行线程里复用PowerShell上下文（比如导入模块、设置全局变量），可以通过ParallelOptions的初始化逻辑来为每个线程创建绑定的运行空间：

# 配置并行选项，比如最大并行数
$parallelOpts = [System.Threading.Tasks.ParallelOptions]@{
    MaxDegreeOfParallelism = [System.Environment]::ProcessorCount
}

# 初始化每个线程的运行空间（比如导入模块）
$threadInit = {
    # 这里的代码会在每个并行线程启动时执行一次
    Import-Module PSScriptAnalyzer
    $global:ThreadId = [System.Threading.Thread]::CurrentThread.ManagedThreadId
}

$testData = @("Script1.ps1", "Script2.ps1", "Script3.ps1")

[System.Threading.Tasks.Parallel]::ForEach(
    $testData,
    $parallelOpts,
    [Action[string]]{
        param($scriptPath)
        # 线程已经初始化了运行空间，直接执行操作
        Write-Host "Analyzing $scriptPath on thread $global:ThreadId"
        Invoke-ScriptAnalyzer -Path $scriptPath
    }
)

和*-Job Cmdlets的区别 #

• *-Job是创建独立的后台进程/运行空间，开销更大，但隔离性强，适合长时间运行的任务。
• System.Threading.Tasks.Parallel是在当前进程的多线程中执行，开销小、速度快，但需要手动处理运行空间绑定和线程安全问题，适合CPU密集型的短任务。

注意事项 #

1. 线程安全：多个线程同时访问共享变量时，必须使用锁（比如[System.Threading.Monitor]::Enter($lockObject)）或者线程安全的集合（比如[System.Collections.Concurrent.ConcurrentBag]）。
2. 错误处理：Parallel.ForEach中的异常会被包装成AggregateException，需要用try/catch捕获并遍历内部异常：

   try {
       [System.Threading.Tasks.Parallel]::ForEach(...)
   }
   catch [System.AggregateException] {
       foreach ($ex in $_.InnerExceptions) {
           Write-Error "Parallel error: $($ex.Message)"
       }
   }
   

3. 避免全局状态修改：不要在并行操作中直接修改PowerShell的全局变量或配置，容易引发不可预测的问题。

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