如何在PowerShell并行循环中导入模块类以支持函数类型签名？

问题核心在于ForEach-Object -Parallel启动的每个并行会话都是独立运行环境，原会话中定义的自定义类不会自动同步到并行会话里。当你在并行块中导入带类型签名的函数时，函数找不到对应的类定义，就会触发报错。

下面提供两种可行的解决方法：

方法一：传递类定义字符串到并行块，重新定义类 #

把原会话中的类定义转为字符串，通过$using:传递到并行块，再用Invoke-Expression在并行会话中重新创建类，之后再导入函数即可正常使用类型签名。

示例代码：

# 定义自定义类
class VMInfo {
    [Microsoft.Azure.Commands.Compute.Models.PSVirtualMachine]$VM
    [string]$SubscriptionId
    [string]$SubscriptionName
}

class ConfigType {
    [string]$Setting1
}

# 带类型签名的处理函数
function processVM([VMInfo]$VMInfo, [ConfigType]$Config) {
    Write-Host "处理VM: $($VMInfo.SubscriptionName) - $($VMInfo.VM.Name)"
    # 这里添加实际业务逻辑
}

# 获取类和函数的定义字符串
$vmInfoClassDef = ([VMInfo].Definition)
$configTypeClassDef = ([ConfigType].Definition)
$funcDef = ${function:processVM}.ToString()

# 模拟待处理的VMInfo对象集合
$items = @(
    [VMInfo]@{
        VM = [Microsoft.Azure.Commands.Compute.Models.PSVirtualMachine]@{ Name = "VM-001" }
        SubscriptionId = "sub-123"
        SubscriptionName = "生产订阅"
    },
    [VMInfo]@{
        VM = [Microsoft.Azure.Commands.Compute.Models.PSVirtualMachine]@{ Name = "VM-002" }
        SubscriptionId = "sub-456"
        SubscriptionName = "测试订阅"
    }
)

$Config = [ConfigType]@{ Setting1 = "DefaultConfig" }

# 并行处理逻辑
$items | ForEach-Object -Parallel {
    $vmInfo = $_
    $config = $using:Config
    
    # 先在并行会话中重新定义类
    Invoke-Expression $using:vmInfoClassDef
    Invoke-Expression $using:configTypeClassDef
    
    # 导入处理函数
    ${function:processVM} = $using:funcDef
    
    # 调用带类型签名的函数
    processVM $vmInfo $config
}

方法二：将类和函数打包到模块，在并行块中导入模块 #

如果有多个自定义类，把所有类和相关函数打包成PowerShell模块（.psm1文件）会更便于管理，只需在并行块中导入模块即可自动获取所有类和函数定义。

第一步：创建模块文件 VMProcessingModule.psm1 #

# VMProcessingModule.psm1
class VMInfo {
    [Microsoft.Azure.Commands.Compute.Models.PSVirtualMachine]$VM
    [string]$SubscriptionId
    [string]$SubscriptionName
}

class ConfigType {
    [string]$Setting1
}

function processVM([VMInfo]$VMInfo, [ConfigType]$Config) {
    Write-Host "处理VM: $($VMInfo.SubscriptionName) - $($VMInfo.VM.Name)"
}

第二步：主脚本中调用并行处理 #

# 获取模块的绝对路径（避免并行会话路径问题）
$modulePath = (Resolve-Path .\VMProcessingModule.psm1).Path

$items = @(
    [VMInfo]@{
        VM = [Microsoft.Azure.Commands.Compute.Models.PSVirtualMachine]@{ Name = "VM-001" }
        SubscriptionId = "sub-123"
        SubscriptionName = "生产订阅"
    }
)

$Config = [ConfigType]@{ Setting1 = "DefaultConfig" }

# 并行处理
$items | ForEach-Object -Parallel {
    $vmInfo = $_
    $config = $using:Config
    $modulePath = $using:modulePath
    
    # 导入模块（-Force确保重载最新版本）
    Import-Module $modulePath -Force
    
    # 直接调用带类型签名的函数
    processVM $vmInfo $config
}

注意事项 #

1. 如果类依赖第三方类型（比如示例中的PSVirtualMachine），需要在并行块中提前导入对应的模块（比如Import-Module Az.Compute），确保类型能被识别。
2. 并行会话的环境是完全独立的，任何需要的依赖都要显式导入，不要依赖原会话的模块或定义。
3. 模块方式更适合类数量多、函数逻辑复杂的场景，后续维护更方便。

内容的提问来源于stack exchange，提问作者Ryu S.