validateset 是 powershell 中限制参数值的验证属性，仅允许预定义字符串（默认区分大小写），支持 ignorecase、与其它验证属性组合，但不支持运行时动态值。

validateset 是 powershell 中用于限制函数或脚本参数可接受值的内置验证属性。它确保用户只能传入预定义的几个固定值，一旦输入不在列表中，powershell 会立即报错并拒绝执行。

基本用法：在参数上直接声明允许的值

在 param 块中，给参数加上 [ValidateSet(...)] 属性，并在括号内列出所有合法字符串（区分大小写）：

function Test-Environment {
    param(
        [ValidateSet('Dev', 'Test', 'Prod')]
        [string]$Env
    )
    "运行环境：$Env"
}

调用示例：

• Test-Environment -Env 'Prod' → 正常执行
• Test-Environment -Env 'Staging' → 报错："Cannot validate argument on parameter 'Env'. The allowed values are ..."

支持大小写不敏感匹配

默认区分大小写。如需忽略大小写，添加 -IgnoreCase 参数：

[ValidateSet('dev', 'test', 'prod', IgnoreCase = $true)]

此时 -Env 'DEV' 和 -Env 'dev' 都会被接受。

windows-shell

Windows 命令行编码与兼容规范。涵盖 GBK/UTF-8 编码、PowerShell/pwsh 互操作、Python/Node.js、Git 配置及代码生成规则。适用于 Windows 10/11 + MSYS2/Git Bash 环境下的所有命令行操作。

下载

动态生成可选值（结合变量或表达式）

ValidateSet 的值必须是编译期确定的常量，**不能直接使用变量或命令结果**。但可通过以下方式间接实现动态枚举：

• 在模块或脚本开头预先定义数组变量，再在 ValidateSet 中引用（仅限字面量数组，不能带运算符）
• 更灵活的做法：改用 ValidateScript 手动检查（牺牲自动补全和错误提示的清晰度）
• 若需 Tab 补全 + 动态值，建议配合 ArgumentCompleter 属性增强体验

和其他验证属性组合使用

ValidateSet 可与 Mandatory、ValidateNotNullOrEmpty 等共存，顺序无关：

[Parameter(Mandatory)]
[ValidateNotNullOrEmpty()]
[ValidateSet('Start', 'Stop', 'Restart')]
[string]$Action

这样既强制提供参数，又确保内容在指定范围内。