PowerShell中ForEach-Object -Parallel无法识别自定义Process-File函数问题

核心原因 #

ForEach-Object -Parallel 是PowerShell 7及以上版本引入的并行执行特性，它的每一个并行执行的脚本块都运行在**独立的运行空间（Runspace）**中，默认不会继承父作用域中自定义的函数、别名等配置，需要显式传递才能使用。

两个函数识别情况不同的原因 #

• Process-Directory 是在普通非并行的 ForEach-Object 脚本块中调用的，这个脚本块和主脚本运行在同一个运行空间，主作用域预先定义的函数可以直接被识别，因此调用正常。
• Process-File 是在 ForEach-Object -Parallel 的并行脚本块中调用的，独立运行空间没有加载你在主脚本中定义的Process-File函数，因此抛出找不到命令的错误。

常用的解决方法有3种：

• 显式将父作用域的函数传入并行块，在块内重新定义

Get-Childitem $DirObject | ForEach-Object -Parallel {
    # 导入父作用域的Process-File函数到当前并行运行空间
    ${function:Process-File} = $using:function:Process-File
    Process-File -FileObject $_
}

• 将自定义函数保存为单独的.ps1脚本文件，在并行块内显式点源加载

Get-Childitem $DirObject | ForEach-Object -Parallel {
    # 替换为你的函数脚本实际路径
    . C:\scripts\Process-File.ps1
    Process-File -FileObject $_
}

• 如果有多个自定义函数需要复用，可以将函数封装为PowerShell模块，在并行块内导入模块后使用。

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