ValidatePattern 是 PowerShell 参数验证属性，用于通过正则表达式约束参数值，在绑定阶段自动校验并报错；需注意锚点、转义、引号及可与其他验证属性叠加使用。
validatepattern 是 powershell 参数验证属性之一，用于在函数或脚本块中对参数值施加正则表达式约束。它会在参数绑定阶段（调用时）自动检查输入是否匹配指定的正则模式，不匹配则直接报错并中断执行。
基本语法与用法
在 param() 块中为参数添加 [ValidatePattern("正则表达式")] 属性即可：
function Test-Email {
param(
[ValidatePattern('^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+.[a-zA-Z]{2,}$')]
[string]$Email
)
Write-Host "邮箱有效：$Email"
}
调用 Test-Email -Email "user@example.com" 会成功；而 Test-Email -Email "invalid@@" 则立即抛出错误，提示“无法验证参数 Email 的参数值”。
注意正则锚点和转义
PowerShell 的 ValidatePattern 默认对整个字符串进行匹配（类似 ^...$），但显式写出锚点更安全、意图更清晰：
直播间话术巡检-windows
下载
直播话术巡检系统(Windows版) — 实时语音转写、关键词检测、场景自动切换、告警推送、大屏可视化。支持 Windows VB-Cable 虚拟声卡音频采集，阿里云 ASR 实时识别。一键启动脚本，自动安装环境。
- 省略 ^ 和 $ 可能导致部分匹配（例如 "abc123" 匹配 "d+"，即使开头有字母）
- 正则中的反斜杠需双写（如 "\d+" 表示匹配数字），因为字符串字面量本身会解析一次转义
- 若正则含引号，建议用单引号包裹整个模式，避免与 PowerShell 字符串引号冲突
结合其他验证属性使用
ValidatePattern 可与其他验证属性叠加，顺序不影响逻辑，但所有条件都必须满足：
param(
[ValidateNotNullOrEmpty()]
[ValidatePattern('^d{4}-d{2}-d{2}$')]
[string]$DateStr
)
这样既确保参数非空，又强制格式为 YYYY-MM-DD。如果传入空字符串或 "2024/05/01"，都会失败。
调试技巧：快速测试正则是否生效
遇到验证不按预期工作时，可临时改用 if ($input -match $pattern) 单独验证正则逻辑：
- 把 ValidatePattern 中的正则复制出来，在交互式会话中用 "test@test.com" -match '^[^s@]+@[^s@]+.[^s@]+$' 测试
- 确认正则本身能正确区分合法/非法值
- 检查是否因大小写、空白字符或 Unicode 导致误判（ValidatePattern 默认区分大小写）
