如何将PowerShell的-WhatIf转换为原生命令的对应开关

问题场景 #

我有一个带[CmdletBinding(SupportsShouldProcess)]属性的PowerShell高级脚本，里面要调用原生命令gsutil——这个命令支持-n开关开启dry run（试运行）模式，仅输出操作内容不执行实际动作。当前脚本示例如下：

[CmdletBinding(SupportsShouldProcess)]
param ()
gsutil -m rsync -r -n something gs://something

我需要实现：根据是否向脚本传入-WhatIf开关，自动决定是否给gsutil加上-n参数。已知微软官方文档提到其他Cmdlet会自动继承-WhatIf的值，也建议显式传递-WhatIf:$WhatIfPreference，但这个方法对原生命令无效。

解决办法 #

用PowerShell的$WhatIfPreference自动变量判断，动态构造gsutil的参数列表即可，具体步骤：

• 先定义固定的基础参数数组：

$gsutilArgs = @('-m', 'rsync', '-r')

• 检查$WhatIfPreference的值，若为$true（即脚本传入了-WhatIf），就追加-n开关：

if ($WhatIfPreference) {
    $gsutilArgs += '-n'
}

• 最后补上源和目标路径，调用原生命令：

$gsutilArgs += 'something', 'gs://something'
& gsutil $gsutilArgs

完整脚本示例 #

[CmdletBinding(SupportsShouldProcess)]
param ()

# 构建gsutil基础参数
$gsutilArgs = @('-m', 'rsync', '-r')

# 根据WhatIf状态添加试运行开关
if ($WhatIfPreference) {
    $gsutilArgs += '-n'
}

# 追加操作路径
$gsutilArgs += 'something', 'gs://something'

# 执行原生命令
& gsutil $gsutilArgs

原理说明 #

• $WhatIfPreference是PowerShell自带的自动变量，当脚本被传入-WhatIf开关时，该变量会自动设为$true，未传入则为$false。
• 动态构建参数数组能精准控制原生命令的开关，避免硬编码导致的逻辑冲突。
• 用&调用原生命令是PowerShell的标准写法，可确保参数传递的准确性。

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