PowerShell传递多非Flags枚举值给C# Cmdlet时的异常行为咨询

首先，咱们来拆解你遇到的现象背后的原因：

为什么会出现这种奇怪的输出？ #

PowerShell的参数绑定系统对枚举类型有一个默认行为：当你传入逗号分隔的多个枚举值时，它会自动尝试将这些值按位进行逻辑或（|）运算，合并成一个单一的枚举值——不管你的枚举有没有标记[Flags]特性。

看你的ExampleEnum定义：

public enum ExampleEnum { A, B, C };

默认情况下，枚举成员的数值是从0开始递增的：

• A = 0
• B = 1
• C = 2

现在看你执行的几个命令：

1. Get-Something A, B：运算结果是0 | 1 = 1，对应ExampleEnum.B，所以代码进入Case B分支，输出"Case B"。
2. Get-Something A, C：运算结果是0 | 2 = 2，对应ExampleEnum.C，所以输出"Case C"。
3. Get-Something B, C：运算结果是1 | 2 = 3，这个数值在ExampleEnum里没有对应的成员，所以PowerShell抛出"无效值"错误。

这种行为是PowerShell的设计逻辑：它假设你可能想组合枚举值，哪怕没有[Flags]标记——但显然这和你预期的"非Flags枚举不应接受多个值"不符。

如何解决这个问题？ #

根据你的需求，这里有两种常见的解决方案：

方案1：严格限制参数只能接受单个枚举值 #

你可以通过两种方式实现：

方式a：给参数添加[ValidateSet]属性

直接在参数上明确允许的枚举值，PowerShell会在参数绑定阶段就拒绝多个值的输入：

[Parameter(
    HelpMessage = "Enter A, B, or C.",
    Mandatory = true,
    Position = 0,
    ValueFromPipelineByPropertyName = true,
    ValueFromPipeline = true
)]
[ValidateSet("A", "B", "C")] // 新增这一行
public ExampleEnum ExampleParameter { get; set; }

这样当你执行Get-Something A, B时，PowerShell会直接报错，符合你的预期。

方式b：在ProcessRecord中检查参数值是否为枚举定义的成员

如果需要更灵活的逻辑，可以在处理时验证参数值是否合法：

protected override void ProcessRecord()
{
    // 检查当前参数值是否是枚举中定义的成员
    if (!Enum.IsDefined(typeof(ExampleEnum), ExampleParameter))
    {
        ThrowTerminatingError(new ErrorRecord(
            new ArgumentOutOfRangeException(nameof(ExampleParameter)),
            "InvalidEnumValue",
            ErrorCategory.InvalidArgument,
            ExampleParameter
        ));
    }

    // 后续原有逻辑
    WriteObject(ExampleParameter);
    switch (ExampleParameter)
    {
        case ExampleEnum.A:
            WriteObject("Case A");
            break;
        case ExampleEnum.B:
            WriteObject("Case B");
            break;
        case ExampleEnum.C:
            WriteObject("Case C");
            break;
        default:
            break;
    }
}

方案2：支持多个枚举值输入（如果需要） #

如果你想让Cmdlet接受多个枚举值并分别处理，可以把参数类型改成数组：

[Parameter(
    HelpMessage = "Enter one or more of A, B, or C.",
    Mandatory = true,
    Position = 0,
    ValueFromPipelineByPropertyName = true,
    ValueFromPipeline = true
)]
public ExampleEnum[] ExampleParameter { get; set; }

protected override void ProcessRecord()
{
    foreach (var enumValue in ExampleParameter)
    {
        WriteObject(enumValue);
        switch (enumValue)
        {
            case ExampleEnum.A:
                WriteObject("Case A");
                break;
            case ExampleEnum.B:
                WriteObject("Case B");
                break;
            case ExampleEnum.C:
                WriteObject("Case C");
                break;
            default:
                break;
        }
    }
}

这样执行Get-Something A, B时，会分别处理A和B，输出对应的结果。

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