PowerShell高级函数启用-WhatIf需三步：1.在[CmdletBinding()]中设SupportsShouldProcess=$true；2.用$PSCmdlet.ShouldProcess()判断执行；3.将副作用操作包裹于if块中。
powershell 高级函数要支持 -whatif 参数，核心是启用确认支持（supportsshouldprocess），并配合 shouldprocess() 方法控制实际操作逻辑。这不是简单加个参数就能用的功能，而是需要显式声明、判断和封装。
启用 -WhatIf 支持的三个必要步骤
在函数开头的
[CmdletBinding()]属性中添加SupportsShouldProcess = $true
这是开关，没有它，-WhatIf和-Confirm参数根本不会出现，也不会被识别。使用
ShouldProcess()判断是否真执行
它接收提示信息（如目标对象名、操作描述），返回$true表示用户允许执行（或未启用-WhatIf），$false表示跳过（即-WhatIf模式下只输出模拟信息）。将所有有副作用的操作（如删除、写入、重启）包裹在
if (ShouldProcess(...)) { ... }块中
确保“真干活”的代码只在确认通过后运行。
示例：一个带 -WhatIf 的文件清理函数
function Remove-OldLog {
[CmdletBinding(SupportsShouldProcess)]
param(
[Parameter(Mandatory)]
[string]$Path,
[int]$Days = 7
)
$cutoff = (Get-Date).AddDays(-$Days)
$files = Get-ChildItem $Path -Filter "*.log" | Where-Object LastWriteTime -lt $cutoff
foreach ($file in $files) {
if ($PSCmdlet.ShouldProcess($file.FullName, "Remove log file")) {
Remove-Item $file.FullName -Force
}
}
}调用时：
-
Remove-OldLog -Path C:\Logs→ 正常执行 -
Remove-OldLog -Path C:\Logs -WhatIf→ 输出类似What if: Performing the operation "Remove log file" on target "C:\Logs\app_20260915.log"，不删文件 -
Remove-OldLog -Path C:\Logs -Confirm→ 每个文件都弹确认提示
注意事项
-
ShouldProcess()的第一个参数通常是目标对象（如文件路径、服务名），第二个是操作动词短语（建议用动宾结构，如"Stop service"、"Update registry key"），这样-WhatIf输出才清晰易懂。 - 如果函数里调用了其他支持
ShouldProcess的 cmdlet（如Remove-Item,Set-Service），它们会自动继承当前作用域的-WhatIf状态——但前提是你的函数已声明SupportsShouldProcess = $true。 - 不要手动检查
$WhatIfPreference变量；应始终使用$PSCmdlet.ShouldProcess()，它已封装了所有逻辑（包括-Confirm、$ConfirmPreference、作用域继承等）。
本质上，-WhatIf 不是“模拟执行”，而是“跳过执行 + 输出提示”。真正的安全边界在于你是否把所有变更性操作都放进 ShouldProcess() 的保护块里。
