如何在PowerShell中设置无需输入值的默认Help参数集？

问题场景 #

希望调用PowerShell脚本时，无需输入-Help参数，也不会被提示输入参数值，默认触发Help逻辑，但当前代码执行失败。原代码如下（保存为testing.ps1，执行.\testing.ps1可复现错误）：

[CmdletBinding(DefaultParameterSetName='Help')]
Param(
    [Parameter(ParameterSetName='Add', Mandatory=$true)]
    [Switch]$Add,

    [Parameter(ParameterSetName='Remove', Mandatory=$true)]
    [Switch]$Remove,

    [Parameter(ParameterSetName='Help', Mandatory=$true)]
    [Switch]$Help,

    [Parameter(ParameterSetName='Add', Mandatory=$true)]
    [Parameter(ParameterSetName='Remove', Mandatory=$true)]
    [Parameter(ParameterSetName='Help', Mandatory=$false)]
    [String]$UserID
)

switch ($PSCmdlet.ParameterSetName) {
    'Add'    { Write-Host "You chose Add"; }
    'Remove' { Write-Host "You chose Remove"; }
    'Help'   { Write-Host "You chose Help"; }
}

错误原因 #

原代码将Help参数集设为默认，但该参数集内的-Help开关被标记为Mandatory=$true。这会导致PowerShell默认进入Help参数集后，强制要求必须传入-Help参数，与“无需输入-help参数”的需求冲突，因此执行时会报错提示缺少必要参数。

修正方案 #

调整参数定义，确保默认参数集（Help）内没有强制要求的参数，同时让-Help开关可在任意参数集下使用：

[CmdletBinding(DefaultParameterSetName='Help')]
Param(
    [Parameter(ParameterSetName='Add', Mandatory=$true)]
    [Switch]$Add,

    [Parameter(ParameterSetName='Remove', Mandatory=$true)]
    [Switch]$Remove,

    [Parameter(ParameterSetName='Help', Mandatory=$false)]
    [Parameter(ParameterSetName='Add', Mandatory=$false)]
    [Parameter(ParameterSetName='Remove', Mandatory=$false)]
    [Switch]$Help,

    [Parameter(ParameterSetName='Add', Mandatory=$true)]
    [Parameter(ParameterSetName='Remove', Mandatory=$true)]
    [String]$UserID
)

switch ($PSCmdlet.ParameterSetName) {
    'Add'    { 
        if ($Help.IsPresent) {
            Write-Host "=== Add Mode Help ==="
            Write-Host "Usage: .\testing.ps1 -Add -UserID <YourUserID>"
        } else {
            Write-Host "You chose Add, UserID: $UserID"
        }
    }
    'Remove' { 
        if ($Help.IsPresent) {
            Write-Host "=== Remove Mode Help ==="
            Write-Host "Usage: .\testing.ps1 -Remove -UserID <YourUserID>"
        } else {
            Write-Host "You chose Remove, UserID: $UserID"
        }
    }
    'Help'   { 
        Write-Host "=== General Help ==="
        Write-Host "Available commands:"
        Write-Host "  -Add -UserID <ID>    : Add a user with specified ID"
        Write-Host "  -Remove -UserID <ID> : Remove a user with specified ID"
        Write-Host "  -Help                : Show help info for any mode"
    }
}

关键改动说明 #

1. 将-Help开关的Mandatory属性改为$false，并添加到所有参数集，允许用户在任意操作模式下调用帮助
2. 移除Help参数集内的强制参数，确保默认执行脚本时无需输入任何参数即可触发帮助逻辑
3. 优化帮助逻辑：在Add/Remove模式下，若用户传入-Help，会显示对应模式的具体用法；默认执行则显示通用帮助

现在执行.\testing.ps1会直接显示通用帮助，不会提示输入参数；执行.\testing.ps1 -Add -UserID "Bob"会执行添加逻辑；执行.\testing.ps1 -Remove -Help会显示移除模式的帮助信息。

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