Powershell：带有参数集的 C# 风格函数重载？

Question

在 C# 中，函数重载历史上曾出现过如下情况，其中每个重载都会在更简单的签名之上添加一些参数：

public void Initialize(int version);
public void Initialize(int version, string workspaceName);
public void Initialize(int version, string workspaceName, Path workspaceRoot, bool force);

在 Powershell 中，诸如此类的重载是不可能的；但是，通过 System.Management.Automation.ParameterAttribute 的 ParameterSetName 属性提供了函数重载的某种近似值。这允许我们将参数声明为某些参数集的成员，这使我们能够有效地为我们的函数定义单独的签名。大多数 ParameterSetName 示例中都存在这种简单情况< /a> 是这样的：

function test-param 
{ 
[CmdletBinding(DefaultParametersetName="p2")] 
param( 
[Parameter(ParameterSetName="p1",Position=0)] 
[String] 
$d, 

[Parameter(ParameterSetName="p2", Position=0)] 
[String]$i 
) 
    switch ($PsCmdlet.ParameterSetName) 
{ 
    "p1"  { Write-Host ([DateTime]$d); break} 
    "p2"  { Write-Host ([INT]$i); break} 
    } 
}

Get-help on this function 产生以下结果：

PS D:\.ws> get-help test-param
test-param [[-i] <String>] [-Verbose] [-Debug] [-ErrorAction <ActionPreference>] [-WarningAction <ActionPreference>] [-ErrorVariable <String>] [-WarningVariable <String>] [-OutVariable <String>] [-OutBuffer <Int32>]
test-param [[-d] <String>] [-Verbose] [-Debug] [-ErrorAction <ActionPreference>] [-WarningAction <ActionPreference>] [-ErrorVariable <String>] [-WarningVariable <String>] [-OutVariable <String>] [-OutBuffer <Int32>]

然而，对于参数集的复杂用法来说，这种基本类型的示例并不是令人难以置信，因为参数集是完全互斥的。但是如果我们希望某些参数成为所有参数集的成员怎么办？更有经验的用户可能会认为这是特殊“AllParameterSets”参数集的情况，根据 MSDN，如果未指定参数集，则该参数集是默认值。但是，请考虑以下事项：

PS D:\.ws>     function test-param 
{ 
    [CmdletBinding(DefaultParametersetName="p2")] 
    param
    ( 
        [Parameter(ParameterSetName="p1",Position=0)] 
        [String] 
        $d, 
        [Parameter(ParameterSetName="p2", Position=0)] 
        [String]$i,
        [Parameter(ParameterSetName="AllParameterSets")] 
        [String]$x
    ) 
}

PS D:\.ws> get-help test-param
test-param [[-i] <String>] [-Verbose] [-Debug] [-ErrorAction <ActionPreference>] [-WarningAction <ActionPreference>] [-ErrorVariable <String>] [-WarningVariable <String>] [-OutVariable <String>] [-OutBuffer <Int32>]
test-param [[-d] <String>] [-Verbose] [-Debug] [-ErrorAction <ActionPreference>] [-WarningAction <ActionPreference>] [-ErrorVariable <String>] [-WarningVariable <String>] [-OutVariable <String>] [-OutBuffer <Int32>]
test-param [-x <String>] [-Verbose] [-Debug] [-ErrorAction <ActionPreference>] [-WarningAction <ActionPreference>] [-ErrorVariable <String>] [-WarningVariable <String>] [-OutVariable <String>] [-OutBuffer <Int32>]

显然，当将“AllParameterSets”指定为参数集时，它实际上并不像人们所期望的那样包含在所有参数集中。这可以通过省略声明来看出：

PS D:\.ws>     function test-param 
{ 
    [CmdletBinding(DefaultParametersetName="p2")] 
    param
    ( 
        [Parameter(ParameterSetName="p1",Position=0)] 
        [String] 
        $d, 
        [Parameter(ParameterSetName="p2", Position=0)] 
        [String]$i,
        [String]$x
    ) 
}

PS D:\.ws> get-help test-param
test-param [[-i] <String>] [-x <String>] [-Verbose] [-Debug] [-ErrorAction <ActionPreference>] [-WarningAction <ActionPreference>] [-ErrorVariable <String>] [-WarningVariable <String>] [-OutVariable <String>] [-OutBuffer <Int32>]
test-param [[-d] <String>] [-x <String>] [-Verbose] [-Debug] [-ErrorAction <ActionPreference>] [-WarningAction <ActionPreference>] [-ErrorVariable <String>] [-WarningVariable <String>] [-OutVariable <String>] [-OutBuffer <Int32>]

现在，$x 参数出现在所有函数签名中，就像我们期望的那样。

最后是最复杂的情​​况。如果我们希望一个参数出现在某些签名中，而不是所有签名中，该怎么办？原始示例中给出的workspaceName 参数符合此描述。也许此解决方案的关键是认识到可以为 param 块中的每个参数声明多个 Parameter 属性。这允许我们为每个签名建立一个参数集，并用它所属的每个集合的 Parameter 属性来装饰每个参数。请考虑以下情况：

PS D:\.ws> function Initialize-Something
{
    [CmdletBinding()]
    param
    (
        [Parameter(ParameterSetName="version")]
        [Parameter(ParameterSetName="workspaceName")]
        [Parameter(ParameterSetName="createWorkspace")]
        [int] $Version,
        [Parameter(ParameterSetName="workspaceName")]
        [Parameter(ParameterSetName="createWorkspace")]
        [string] $WorkspaceName,
        [Parameter(ParameterSetName="createWorkspace")]
        [string] $WorkspaceRoot,
        [Parameter(ParameterSetName="createWorkspace")]
        [switch] $Force
    )
}

PS D:\.ws> get-help initialize-something
Initialize-Something [-Version <Int32>] [-WorkspaceName <String>] [-WorkspaceRoot <String>] [-Force] [-Verbose] [-Debug] [-ErrorAction <ActionPreference>] [-WarningAction <ActionPreference>] [-ErrorVariable <String>] [-WarningVariable <String>] [-OutVariable <String>] [-OutBuffer <Int32>]
Initialize-Something [-Version <Int32>] [-WorkspaceName <String>] [-Verbose] [-Debug] [-ErrorAction <ActionPreference>] [-WarningAction <ActionPreference>] [-ErrorVariable <String>] [-WarningVariable <String>] [-OutVariable <String>] [-OutBuffer <Int32>]
Initialize-Something [-Version <Int32>] [-Verbose] [-Debug] [-ErrorAction <ActionPreference>] [-WarningAction <ActionPreference>] [-ErrorVariable <String>] [-WarningVariable <String>] [-OutVariable <String>] [-OutBuffer <Int32>]

PS D:\.ws> initialize-something -workspacename "test"
Initialize-Something : Parameter set cannot be resolved using the specified named parameters.
At line:1 char:21
+ initialize-something <<<<  -workspacename "test"
    + CategoryInfo          : InvalidArgument: (:) [Initialize-Something], ParameterBindingException
    + FullyQualifiedErrorId : AmbiguousParameterSet,Initialize-Something

Powershell 声称它无法确定参数集，很可能是因为 WorkspaceName 出现在多个签名中。根据记录，当仅指定 -Version 或除最复杂的签名之外的任何签名时，也会发生这种情况。这可以通过 [CmdletBinding(DefaultParameterSetName="version")] 或其他东西来缓解，但这不是一个合适的解决方案。

所以在这一切之后，我的问题是：我怎样才能获得我正在寻找的签名？我是否需要创建一组过于明确的开关（例如 -VersionMode、-WorkspaceNameMode、-CreateWorkspaceMode）来指定我希望它运行的模式，从本质上否定了参数集检测的优点？也许是模式枚举？可以通过使用 ParameterAttribute 的 Mandatory 和 Position 属性来实现这一点吗？

谢谢！

Answer 1

如果您尝试模拟 C# 函数重载，最简单的方法是简单地允许“可选”参数，例如：

function Initialize([int]$version, [string]$workspaceName, [string]workspaceRoot, [switch]Force)

调用者未指定的参数将默认为 $null（开关将默认为 $false）。您还可以为参数提供默认值，如下所示：

function Initialize([int]$version, [string]$workspaceName = $(<script here>), [string]workspaceRoot, [switch]Force)

Answer 2

关于参数集，需要记住的两件重要事情是，Windows PowerShell 运行时仅对特定输入使用一个参数集，并且每个参数集必须至少有一个对该参数集唯一的参数。

在您的情况下，您需要指定第二个参数，例如 -WorkspaceRoot ，它将起作用：

initialize-something -workspacename "test" -WorkspaceRoot "test2"