validatescript 是 powershell 中最灵活的参数验证方式，允许用任意脚本逻辑判断传入值是否合法，失败时自动抛出可读性良好的错误；它在参数绑定时执行，返回 $false 或抛出异常即中止命令，且 $_ 表示原始参数值，支持结合 $pscmdlet 和 $psboundparameters 实现上下文感知验证。
validatescript 是 powershell 中最灵活的参数验证方式，它允许你用任意脚本逻辑判断传入值是否合法，失败时自动抛出可读性良好的错误。
基本语法和触发时机
在函数参数声明中用 [ValidateScript({ ... })] 修饰参数，大括号内是返回布尔值的脚本块。PowerShell 在绑定参数（即调用函数、解析参数）时立即执行该脚本块，只要返回 $false 或抛出异常，整个命令就中止，不会进入函数体。
示例：
function Test-PathExists {
param(
[ValidateScript({ Test-Path $_ })]
[string]$Path
)
"路径有效：$Path"
}
调用 Test-PathExists -Path "C:\Windows" 成功；传入不存在路径则报错：Cannot validate argument on parameter 'Path'. The "Test-Path $_" validation script for the argument with value "X:\Missing" did not return a result of True.
访问当前参数值和上下文
脚本块中的 $_ 始终代表正在验证的那个参数的值（即传入的原始值），类型未强制转换前的值。你还可以使用 $PSCmdlet 获取调用上下文，比如判断是否在远程会话中验证：
- 用
$_.GetType().Name查看实际类型，避免隐式转换干扰判断 - 用
$PSCmdlet.ParameterSetName根据参数集启用不同验证逻辑 - 用
$PSCmdlet.ShouldProcess()在验证中做安全确认（较少见，需谨慎）
常见实用场景与写法
比起简单条件，ValidateScript 更适合复合判断：
-
非空且长度合规：
[ValidateScript({ $_ -and $_.Length -ge 3 -and $_.Length -le 20 })] -
必须是特定格式的字符串（如邮箱）：
[ValidateScript({ $_ -match '^[^\@]+@[\w\-]+\.[\w\-]+$' })] -
数值范围加倍数约束（如端口号且为偶数）：
[ValidateScript({ $_ -ge 1024 -and $_ -le 65535 -and $_ % 2 -eq 0 })] -
依赖其他参数的验证（需配合
$PSBoundParameters）：[ValidateScript({ if ($PSBoundParameters.ContainsKey('Mode') -and $PSBoundParameters.Mode -eq 'Secure') { $_ -match '^[a-z0-9]{8,}$' } else { $true } })]
注意事项和避坑点
ValidateScript 运行在参数绑定阶段，因此：
- 不能修改参数变量本身（
$_ = ...无效） - 不要在其中调用耗时操作（如网络请求、大文件读取），否则影响命令响应速度
- 错误信息默认较泛，可通过
throw主动抛出自定义消息，例如：throw "日志路径必须是绝对路径：'$_' 不符合要求" - 如果参数支持管道输入（
[Parameter(ValueFromPipeline)]），ValidateScript 对每个管道对象分别执行一次
