PowerShell 中互斥参数集：为什么会出现歧义？

Question

我一直在尝试让多组互斥发挥作用。 我希望“Width”与“WidthReset”互斥，“Height”与“HeightReset”互斥。

cmdlet 的帮助显示：

    Get-ArgTest [-Width <int>] [-Height <int>]  [<CommonParameters>]
    Get-ArgTest [-Width <int>] [-HeightReset]  [<CommonParameters>]
    Get-ArgTest [-Height <int>] [-WidthReset]  [<CommonParameters>]
    Get-ArgTest [-WidthReset] [-HeightReset]  [<CommonParameters>]

请参阅以下代码。

一切正常，但 Get-ArgTest -WidthReset 似乎不明确。

为什么这一案子是模棱两可的呢？ 其他对称情况不会被标记为不明确。

我怎样才能解决歧义？

将 DefaultParameterSetName 更改为 B 或 C 会更改不明确的大小写。

这向我表明它应该有效。

##########################################
# This cmdlet *should* accept
# [-Width | -WidthReset] [-Height | -HeightReset]
##########################################
function Get-ArgTest
{
  [CmdletBinding(DefaultParameterSetName = 'A')]
    param(
            [Parameter(ParameterSetName='A')]
            [Parameter(ParameterSetName='B')]
            [int] $Width,

            [Parameter(ParameterSetName='C')]
            [Parameter(ParameterSetName='A')]
            [int] $Height,

            [Parameter(ParameterSetName='C')]
            [Parameter(ParameterSetName='D')]
            [switch] $WidthReset,

            [Parameter(ParameterSetName='B')]
            [Parameter(ParameterSetName='D')]
            [switch] $HeightReset
    )

    Write-Output "HELLO, Width=$Width, Height=$Height, WidthReset=$WidthReset, HeightReset=$HeightReset"
}

##########################################
# Tests
##########################################
# First, display HELP
Get-ArgTest -?

####
## Try each combination
# First, just the values
Get-ArgTest 
Get-ArgTest -Width 2
Get-ArgTest          -Height 4
Get-ArgTest -Width 2 -Height 4

# Values and the opposite reset
Get-ArgTest -Width 2                         -HeightReset
Get-ArgTest          -Height 4   -WidthReset

# The Resets
Get-ArgTest                      -WidthReset -HeightReset
Get-ArgTest                      -WidthReset -HeightReset:$False
Get-ArgTest                      -WidthReset:$False -HeightReset:$True

# I cannot get the following cases to work :-(
Get-ArgTest                      -WidthReset
Get-ArgTest                                  -HeightReset

Answer 1

为了避免歧义，请在您的 D 参数集中将 -WidthReset 和 -HeightReset 设置为强制：

function Get-ArgTest
{
  [CmdletBinding(DefaultParameterSetName = 'A')]
    param(
            [Parameter(ParameterSetName='A')]
            [Parameter(ParameterSetName='B')]
            [int] $Width,

            [Parameter(ParameterSetName='C')]
            [Parameter(ParameterSetName='A')]
            [int] $Height,

            [Parameter(ParameterSetName='C')]
            [Parameter(ParameterSetName='D', Mandatory)]
            [switch] $WidthReset,

            [Parameter(ParameterSetName='B')]
            [Parameter(ParameterSetName='D', Mandatory)]
            [switch] $HeightReset
    )

    Write-Output "HELLO, Width=$Width, Height=$Height, WidthReset=$WidthReset, HeightReset=$HeightReset"
}

这会导致以下语法图（Get-Command -Syntax Get-ArgTest）：

Get-ArgTest [-Width <int>] [-Height <int>] [<CommonParameters>]

Get-ArgTest [-Width <int>] [-HeightReset] [<CommonParameters>]

Get-ArgTest [-Height <int>] [-WidthReset] [<CommonParameters>]

Get-ArgTest -WidthReset -HeightReset [<CommonParameters>]

结果：

• 如果两者 -WidthReset 且-HeightReset 存在，参数集 D 明确暗示。

• 如果-WidthReset或-HeightReset存在，则参数设置C 或 B 是明确暗示的。

---

至于您尝试的内容：

根据您的原始函数定义，以下调用不明确：

Get-ArgTest                      -WidthReset
Get-ArgTest                                  -HeightReset

因为前者匹配两者参数集C和D,
后者两者B和D，
并且它们都不是默认参数集（它将充当决胜局）。