PowerShell如何使用从模块导入的enum作为脚本参数？

PowerShell 运行脚本时，会先执行解析阶段的类型检查，此时会优先校验param块中所有参数的类型约束，而using module属于运行时执行的导入指令，会在解析阶段完成后才执行。也就是说你脚本开头的using module SampleModule，实际是在参数类型检查完成后才运行的，自然解析阶段找不到还没导入的[SampleEnum]类型。
提前在会话中手动执行using module时，枚举类型已经被加载到全局会话的类型缓存中，解析脚本时就能直接找到类型，所以不会报错。
另外Import-Module仅能导入模块公开的函数、变量、别名等运行时成员，不会导入枚举、自定义类这类类型，所以无法解决该问题。

下面是三种常用的可行方案，可以根据你的场景选择：

方案1：参数验证逻辑动态校验类型 #

去掉参数的强类型约束，改用ValidateScript在参数绑定阶段完成校验，此时using module已经执行完成，类型已经导入：

using module SampleModule
param(
    [ValidateScript({
        $validValues = [Enum]::GetNames([SampleEnum])
        if ($_ -in $validValues -or $_ -is [SampleEnum]) {
            return $true
        }
        throw "参数 MyEnum 仅支持以下有效值：$($validValues -join ', ')"
    })]
    $MyEnum
)

# 运行时强转为枚举类型即可正常使用
$MyEnum = [SampleEnum]$MyEnum
$MyEnum

该方案改动最小，不需要调整现有脚本结构，适合参数不多的简单场景。

方案2：拆分入口脚本与业务脚本 #

新增一个入口脚本负责提前导入模块，再调用原有业务脚本，原有脚本不需要做任何修改：

1. 新建Start-Sample.ps1入口脚本：

using module SampleModule
# 直接调用原有业务脚本，透传所有输入参数
& "$PSScriptRoot\Sample.ps1" @args

2. 原有Sample.ps1保留你之前的代码不变，运行时直接执行Start-Sample.ps1即可。
   该方案完全保留原有脚本的强类型约束，不需要修改业务代码，适合复杂脚本场景。

方案3：使用动态参数声明枚举参数 #

动态参数会在参数绑定阶段才生成，此时模块已经导入，可以正常识别枚举类型，不需要拆分脚本也能保留强类型特性：

using module SampleModule
param()

# 动态参数块，运行时生成参数定义
dynamicparam {
    $paramDict = [System.Management.Automation.RuntimeDefinedParameterDictionary]::new()
    $paramAttr = [System.Management.Automation.ParameterAttribute]@{
        Mandatory = $false # 按需设置是否必填等参数属性
    }
    $attrCollection = [System.Collections.ObjectModel.Collection[System.Attribute]]::new()
    $attrCollection.Add($paramAttr)
    
    $enumParam = [System.Management.Automation.RuntimeDefinedParameter]::new(
        "MyEnum", [SampleEnum], $attrCollection
    )
    $paramDict.Add("MyEnum", $enumParam)
    return $paramDict
}

process {
    # 从绑定参数中获取枚举值
    $MyEnum = $PSBoundParameters["MyEnum"]
    $MyEnum
}

该方案不需要拆分脚本，同时保留了强类型参数的自动补全、类型校验特性，适合不想多维护一个入口脚本的场景。

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