如何在PowerShell中正确验证PSObject[]类型的函数参数？

问题根源 #

• 校验规则本身无拦截能力：PowerShell中所有类型的实例本质上都属于[PSObject]的子类，你编写的第一个判断条件$_ -is [PSObject]对任何输入都成立，因此整个校验逻辑永远返回真，完全起不到拦截作用。
• 参数类型转换优先级高于校验：PowerShell执行参数绑定时，会先尝试将输入值转换为你定义的参数类型，再执行校验规则。你最初定义[PSObject[]] $data时，[string[]]可以无感知隐式转换为[PSObject[]]（因为字符串本身也属于PSObject），转换完成后才会执行校验逻辑，自然无法拦截转换后的合法类型。
• 数组类型判断逻辑冗余：[string[]]本身就属于[System.Object[]]的子类，就算你去掉第一个判断条件，输入的字符串数组也会命中第三个判断条件，依然可以通过校验。

修复方案 #

根据你的使用场景，可以选择以下任意一种方案：

场景1：预期传入自定义PSCustomObject对象 #

如果你需要的参数是通过[PSCustomObject]@{}生成的带自定义属性的对象，直接修改参数类型为[PSCustomObject[]]即可，[string[]]无法隐式转换为该类型，输入不匹配时会直接抛出类型转换错误，无需额外校验：

[Parameter(Mandatory = $false, Position = 0, HelpMessage = "PsObject data.")]
[PSCustomObject[]]
$data

场景2：必须保留[PSObject[]]类型约束 #

如果业务需要保留[PSObject[]]的类型定义，建议在ValidateScript中校验每个元素是否包含你要调用的必填属性，避免后续访问不存在的属性时报错：

[Parameter(Mandatory = $false, Position = 0, HelpMessage = "PsObject data.")]
[ValidateScript({
    $inputItems = @($_)
    # 替换为你实际要调用的属性名
    $requiredProperties = @('Id', 'Name', 'CreateTime')
    foreach ($item in $inputItems) {
        $missedProps = $requiredProperties | Where-Object { -not $item.PSObject.Properties[$_] }
        if ($missedProps) {
            throw "输入对象缺少必填属性：$($missedProps -join '、')，当前对象值：$item"
        }
    }
    $true
})]
[PSObject[]]
$data

场景3：需要拦截所有系统基础类型 #

如果不允许传入字符串、数值、布尔值等系统基础类型，可以在校验中添加命名空间判断：

[Parameter(Mandatory = $false, Position = 0, HelpMessage = "PsObject data.")]
[ValidateScript({
    $inputItems = @($_)
    foreach ($item in $inputItems) {
        if ($item.GetType().Namespace -eq 'System') {
            throw "不允许传入系统基础类型：$($item.GetType().Name)，值为：$item"
        }
    }
    $true
})]
[PSObject[]]
$data

内容的提问来源于stack exchange，提问作者Alexey I. Kuzhel