如何仅为PowerShell特定参数/函数提供-WhatIf与-Confirm功能？

你遇到的问题很典型：当在脚本顶层的CmdletBinding中启用SupportsShouldProcess时，所有参数集都会自动继承-WhatIf和-Confirm参数，包括像Help这种完全不需要这些功能的场景。下面是两种干净且符合PowerShell最佳实践的解决方案：

方案一：仅在目标函数中启用SupportsShouldProcess（推荐） #

这种方法最直接，把SupportsShouldProcess从脚本顶层移除，只在需要该功能的函数中启用。如果希望用户能在脚本层面控制函数的WhatIf/Confirm行为，可以在脚本的目标参数集中添加对应的参数，再传递给函数。

修改后的代码如下：

[CmdletBinding(DefaultParameterSetName="Help")]
Param(
    [parameter(ParameterSetName="Help")]
    [switch]$Help,

    # Client Management
    [parameter(ParameterSetName="MoveAdComputerObjects", Position=0)]
    [switch]$MoveAdComputerObjects,

    # Additional parameters
    [parameter(ParameterSetName="MoveAdComputerObjects", Mandatory)]
    [ValidatePattern("foobar")]
    [string]$Src,

    [parameter(ParameterSetName="MoveAdComputerObjects", Mandatory)]
    [ValidatePattern("foobar")]
    [string]$Dst,

    # 仅在MoveAdComputerObjects参数集生效的WhatIf/Confirm参数
    [parameter(ParameterSetName="MoveAdComputerObjects")]
    [switch]$WhatIf,

    [parameter(ParameterSetName="MoveAdComputerObjects")]
    [switch]$Confirm
)

Function Help {
    Write-Host (Get-Command -Syntax $MyInvocation.ScriptName)
}

Function MoveAdComputerObjects {
    [CmdletBinding(SupportsShouldProcess)]
    param(
        [ValidatePattern("foobar")]
        [string]$Src,

        [ValidatePattern("foobar")]
        [string]$Dst
    )
    # 使用ShouldProcess包裹实际操作，这是支持WhatIf/Confirm的标准方式
    if ($PSCmdlet.ShouldProcess("AD计算机对象", "从$Src移动到$Dst")) {
        # 执行实际操作
        Write-Host "执行移动：源=$Src，目标=$Dst"
    }
}

switch($PSCmdlet.ParameterSetName) {
    "Help" { Help }
    "MoveAdComputerObjects" { 
        # 将脚本层面的参数传递给函数
        MoveAdComputerObjects -Src $Src -Dst $Dst -WhatIf:$WhatIf -Confirm:$Confirm
    }
}

这样修改后：

• 用户使用-Help参数时，脚本不会显示-WhatIf或-Confirm选项，完全符合预期
• 只有使用-MoveAdComputerObjects参数集时，才能看到并使用这两个控制参数
• 函数内部通过$PSCmdlet.ShouldProcess()处理逻辑，完全遵循PowerShell的设计规范

方案二：顶层保留SupportsShouldProcess，但在不需要的参数集中忽略功能 #

如果你必须在顶层保留SupportsShouldProcess（比如脚本还有其他需要该功能的逻辑），可以在Help参数集的处理逻辑中检查是否使用了-WhatIf或-Confirm，并给出提示或直接忽略：

[CmdletBinding(DefaultParameterSetName="Help", SupportsShouldProcess)]
Param(
    [parameter(ParameterSetName="Help")]
    [switch]$Help,

    # Client Management
    [parameter(ParameterSetName="MoveAdComputerObjects", Position=0)]
    [switch]$MoveAdComputerObjects,

    # Additional parameters
    [parameter(ParameterSetName="MoveAdComputerObjects", Mandatory)]
    [ValidatePattern("foobar")]
    [string]$Src,

    [parameter(ParameterSetName="MoveAdComputerObjects", Mandatory)]
    [ValidatePattern("foobar")]
    [string]$Dst
)

Function Help {
    # 检查是否传入了无关参数
    if ($WhatIfPreference -eq $true -or $ConfirmPreference -ne 'High') {
        Write-Warning "提示：Help参数集不支持-WhatIf和-Confirm功能"
    }
    Write-Host (Get-Command -Syntax $MyInvocation.ScriptName)
}

Function MoveAdComputerObjects {
    [CmdletBinding(SupportsShouldProcess)]
    param(
        [ValidatePattern("foobar")]
        [string]$Src,

        [ValidatePattern("foobar")]
        [string]$Dst
    )
    if ($PSCmdlet.ShouldProcess("AD计算机对象", "从$Src移动到$Dst")) {
        # 执行实际操作
        Write-Host $Src, $Dst
    }
}

switch($PSCmdlet.ParameterSetName) {
    "Help" { Help }
    "MoveAdComputerObjects" { MoveAdComputerObjects -Src $Src -Dst $Dst }
}

这种方法的缺点是用户仍然能看到-WhatIf和-Confirm参数在Help模式下可用，但会收到明确的警告提示。

内容的提问来源于stack exchange，提问作者Matthias Güntert