如何在PowerShell模块的RunspacePool中带参数调用ps1脚本

问题1：无法向 PS1 文件传递参数修复 #

错误原因 #

• 你的foo.ps1定义了LogMsg、FilePath两个必填参数，但调用时仅传入了1个FilePath参数，参数不匹配导致脚本执行被拦截
• AddScript调用外部ps1文件时需要添加调用运算符&，否则内容会被当作普通字符串处理

修正后的调用代码 #

$MaxRunspaces = 5
$RunspacePool = [runspacefactory]::CreateRunspacePool(1, $MaxRunspaces)
$RunspacePool.Open()
$Jobs = New-Object System.Collections.ArrayList
$Filenames = @("log1.log", "log2.log", "log3.log")
# 替换为你实际要传入日志内容的变量
$baseLogMsg = "这是测试写入的日志内容"

foreach ($File in $Filenames) {
    Write-Host "Creating runspace for $File"
    $PowerShell = [powershell]::Create()
    $PowerShell.RunspacePool = $RunspacePool
    # 用Join-Path拼接路径更稳定，避免手动拼接的斜杠错误
    $FilePath = Join-Path "C:\Users\user\Documents\log\" $File
    # 修正ps1调用写法，明确指定参数名传参，避免位置传参错误
    $PowerShell.AddScript("& 'C:\Users\user\Documents\foo.ps1'")
    $PowerShell.AddParameter('LogMsg', $baseLogMsg)
    $PowerShell.AddParameter('FilePath', $FilePath) | Out-Null
    
    $JobObj = New-Object -TypeName PSObject -Property @{
        Runspace = $PowerShell.BeginInvoke()
        PowerShell = $PowerShell  
    }
    $Jobs.Add($JobObj) | Out-Null
}

问题2：获取 PS1 内输出信息的方法 #

Write-Host的输出默认写入PowerShell的信息流（6号流），需要显式收集流返回结果；推荐优先将Write-Host替换为Write-Output，输出会直接进入标准输出流，收集逻辑更简单。
添加以下代码等待任务完成并收集所有输出：

foreach ($job in $Jobs) {
    # 等待异步任务执行完成，获取标准输出流内容（对应Write-Output的输出）
    $stdOutput = $job.PowerShell.EndInvoke($job.Runspace)
    $stdOutput | ForEach-Object { Write-Host "脚本输出：$_" }
    # 收集信息流内容（对应Write-Host的输出）
    $job.PowerShell.Streams.Information | ForEach-Object { Write-Host "脚本Write-Host输出：$($_.Message)" }
    # 异常捕获（可选）
    $job.PowerShell.Streams.Error | ForEach-Object { Write-Error "脚本执行错误：$_" }
    # 释放资源
    $job.PowerShell.Dispose()
}
# 关闭并释放RunspacePool资源
$RunspacePool.Close()
$RunspacePool.Dispose()

替代异步实现方案 #

如果不想手动维护RunspacePool，可以根据场景选择以下方案：

• Start-Job：PowerShell原生后台作业，语法简单，适合并发量较低的场景，缺点是每个作业启动独立进程，资源开销高于RunspacePool
• ForEach-Object -Parallel：PowerShell 7+内置并行执行能力，语法极简，自动管理线程池，参数传递方便，示例代码如下：

$Filenames = @("log1.log", "log2.log", "log3.log")
$baseLogMsg = "测试日志内容"
$Filenames | ForEach-Object -Parallel {
    $filePath = Join-Path "C:\Users\user\Documents\log\" $_
    & "C:\Users\user\Documents\foo.ps1" -LogMsg $using:baseLogMsg -FilePath $filePath
} -ThrottleLimit 5

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