适用于 PowerShell 5.1 及以上版本
为什么需要 ShouldProcess 确认机制 在编写 PowerShell 高级函数时，如果函数会修改系统状态（比如删除文件、停止服务、修改注册表），直接执行这些破坏性操作可能会带来不可逆的后果。想象一下，你写了一个批量清理临时文件的脚本，一个参数写错就可能删掉整台服务器上的重要数据。
PowerShell 提供了一套标准的确认机制——SupportsShouldProcess，它让函数自动获得 -WhatIf 和 -Confirm 两个通用参数。-WhatIf 让函数仅描述将要做什么而不实际执行，-Confirm 则在每次破坏性操作前要求用户确认。这不仅是 PowerShell 模块开发的最佳实践，也是 cmdlet 设计规范（Cmdlet Development Guidelines）中明确要求的标准行为。
本文将从基本用法、确认流程控制、以及批量操作场景三个方面，详细讲解如何在自定义函数中正确实现 ShouldProcess 确认机制。
ShouldProcess 基本用法 要让函数支持 -WhatIf 和 -Confirm 参数，需要在 CmdletBinding 特性中声明 SupportsShouldProcess，然后在执行破坏性操作前调用 $PSCmdlet.ShouldProcess() 方法。下面的示例实现了一个安全的文件清理函数。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 function Remove-OldTempFiles [CmdletBinding (SupportsShouldProcess )] param ( [Parameter (Mandatory )] [string ]$Path , [int ]$OlderThanDays = 30 , [string []]$Extension = @ ('.tmp' , '.log' , '.bak' ) ) if (-not (Test-Path -Path $Path )) { Write-Error "目录不存在: $Path " return } $cutoffDate = (Get-Date ).AddDays(-$OlderThanDays ) $files = Get-ChildItem -Path $Path -File -Recurse -ErrorAction SilentlyContinue | Where-Object { $_ .Extension -in $Extension -and $_ .LastWriteTime -lt $cutoffDate } if ($files .Count -eq 0 ) { Write-Host "未找到符合条件的文件" -ForegroundColor Yellow return } Write-Host "找到 $ ($files .Count) 个符合条件的文件 (超过 $OlderThanDays 天)" -ForegroundColor Cyan $deletedCount = 0 $totalSize = 0 foreach ($file in $files ) { if ($PSCmdlet .ShouldProcess($file .FullName, "删除文件" )) { try { $totalSize += $file .Length Remove-Item -Path $file .FullName -Force -ErrorAction Stop $deletedCount ++ Write-Host " [已删除] $ ($file .FullName)" -ForegroundColor Green } catch { Write-Warning "删除失败: $ ($file .FullName) - $ ($_ .Exception.Message)" } } } Write-Host "`n清理完成: 删除 $deletedCount 个文件, 释放 $ ([math]::Round($totalSize / 1MB, 2)) MB" -ForegroundColor Cyan } Remove-OldTempFiles -Path 'C:\Temp' -OlderThanDays 7 -WhatIf
1 2 3 What if: Performing the operation "删除文件" on target "C:\Temp\install.log". What if: Performing the operation "删除文件" on target "C:\Temp\cache.tmp". What if: Performing the operation "删除文件" on target "C:\Temp\db_backup.bak".
上面的输出说明 -WhatIf 模式下列出了所有将要被删除的文件，但并没有真正执行删除操作。用户可以先确认列表无误，再去掉 -WhatIf 参数执行真正的清理。
确认流程与 ShouldContinue ShouldProcess 适合大多数场景，但有时需要更精细的控制。PowerShell 还提供了 $PSCmdlet.ShouldContinue() 方法，它不受 $ConfirmPreference 变量影响，总是弹出确认提示。下面的示例演示了在一个服务管理函数中同时使用 ShouldProcess 和 ShouldContinue，在重启关键服务前进行二次确认。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 function Restart-CriticalService [CmdletBinding (SupportsShouldProcess )] param ( [Parameter (Mandatory )] [string ]$Name , [string ]$ComputerName = $env:COMPUTERNAME ) $service = Get-Service -Name $Name -ComputerName $ComputerName -ErrorAction SilentlyContinue if (-not $service ) { Write-Error "找不到服务: $Name " return } $criticalServices = @ ('Winmgmt' , 'EventLog' , 'Dnscache' , 'LanmanServer' , 'Netlogon' ) $target = "\\$ComputerName \Service:$Name " if (-not $PSCmdlet .ShouldProcess($target , "重启服务" )) { return } if ($Name -in $criticalServices ) { $message = "服务 '$Name ' 是关键系统服务，重启可能导致系统不稳定。" $caption = "确认重启关键服务" $confirmed = $PSCmdlet .ShouldContinue($message , $caption ) if (-not $confirmed ) { Write-Host "操作已取消" -ForegroundColor Yellow return } } try { $originalStatus = $service .Status Write-Host "服务当前状态: $originalStatus " -ForegroundColor Cyan if ($originalStatus -eq 'Running' ) { Write-Host "正在停止服务 $Name ..." -ForegroundColor Yellow Stop-Service -Name $Name -Force -ComputerName $ComputerName -ErrorAction Stop Start-Sleep -Seconds 2 } Write-Host "正在启动服务 $Name ..." -ForegroundColor Yellow Start-Service -Name $Name -ComputerName $ComputerName -ErrorAction Stop $finalStatus = (Get-Service -Name $Name -ComputerName $ComputerName ).Status Write-Host "服务重启完成，最终状态: $finalStatus " -ForegroundColor Green } catch { Write-Error "服务重启失败: $ ($_ .Exception.Message)" } } Restart-CriticalService -Name 'Spooler' -Confirm Restart-CriticalService -Name 'Winmgmt' -Confirm
1 2 3 4 服务当前状态: Running 正在停止服务 Spooler... 正在启动服务 Spooler... 服务重启完成，最终状态: Running
关键服务执行时会弹出额外的确认对话框，只有用户明确选择”是”才会继续。这种双重确认机制在运维脚本中非常实用，可以有效防止误操作导致的系统故障。
批量操作中的确认影响级别 在批量操作场景中，如果每个操作都弹出确认提示，用户体验会很差。PowerShell 通过 $ConfirmPreference 变量和 ConfirmImpact 参数来控制确认行为。低影响操作可以自动执行，只有高影响操作才需要确认。下面的示例实现了一个批量服务管理函数，演示了不同影响级别的控制方式。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 function Set-ServiceState [CmdletBinding (SupportsShouldProcess , ConfirmImpact = 'Medium' )] param ( [Parameter (Mandatory )] [string []]$ServiceName , [ValidateSet ('Start' , 'Stop' , 'Restart' )] [string ]$Action = 'Restart' , [int ]$DelayBetweenActions = 1 ) $results = @ () foreach ($svc in $ServiceName ) { $service = Get-Service -Name $svc -ErrorAction SilentlyContinue if (-not $service ) { Write-Warning "服务不存在: $svc " $results += [PSCustomObject ]@ { Service = $svc Action = $Action Status = 'NotFound' } continue } $operationDesc = switch ($Action ) { 'Start' { '启动服务' } 'Stop' { '停止服务' } 'Restart' { '重启服务' } } if ($PSCmdlet .ShouldProcess($svc , $operationDesc )) { try { switch ($Action ) { 'Start' { Start-Service -Name $svc -ErrorAction Stop } 'Stop' { Stop-Service -Name $svc -Force -ErrorAction Stop } 'Restart' { Stop-Service -Name $svc -Force -ErrorAction Stop Start-Sleep -Seconds $DelayBetweenActions Start-Service -Name $svc -ErrorAction Stop } } $finalState = (Get-Service -Name $svc ).Status Write-Host " [$Action ] $svc -> $finalState " -ForegroundColor Green $results += [PSCustomObject ]@ { Service = $svc Action = $Action Status = $finalState } } catch { Write-Warning "操作失败: $svc - $ ($_ .Exception.Message)" $results += [PSCustomObject ]@ { Service = $svc Action = $Action Status = "Failed: $ ($_ .Exception.Message)" } } } else { $results += [PSCustomObject ]@ { Service = $svc Action = $Action Status = 'Skipped' } } } Write-Host "`n===== 操作结果汇总 =====" -ForegroundColor Cyan $results | Format-Table -AutoSize } Set-ServiceState -ServiceName 'Spooler' , 'W32Time' , 'Audiosrv' -Action RestartSet-ServiceState -ServiceName 'Spooler' , 'W32Time' -Action Stop -Confirm
1 2 3 4 5 6 7 8 9 10 [Restart] Spooler -> Running [Restart] W32Time -> Running [Restart] Audiosrv -> Running ===== 操作结果汇总 ===== Service Action Status ------- ------ ------ Spooler Restart Running W32Time Restart Running Audiosrv Restart Running
第一组调用因为 ConfirmImpact = 'Medium' 低于默认的 $ConfirmPreference = 'High'，所以三个服务自动执行，没有逐个弹出确认。第二组加了 -Confirm 参数，强制每个操作都需要用户确认，适合在关键环境中谨慎操作。
注意事项
始终声明 SupportsShouldProcess ：任何会修改系统状态的高级函数（创建、删除、修改、停止等操作）都应声明 [CmdletBinding(SupportsShouldProcess)]。这是 PowerShell 的 cmdlet 设计规范要求，也是用户在使用 -WhatIf 时获得一致性体验的前提。没有声明该特性的函数，用户传入 -WhatIf 或 -Confirm 时会报参数不存在的错误。
理解 ConfirmImpact 与 ConfirmPreference 的关系 ：ShouldProcess 的确认行为由函数的 ConfirmImpact（默认 Medium）和用户会话的 $ConfirmPreference（默认 High）共同决定。只有当 ConfirmImpact 大于或等于 $ConfirmPreference 时才会自动弹出确认。显式使用 -Confirm 参数会强制弹出确认，无论影响级别如何。
ShouldProcess 的三个参数 ：ShouldProcess(target, action, description) 中，target 是操作对象（如文件路径、服务名），action 是操作类型（如”删除文件”），description 是补充说明。这三个参数会组合成 -WhatIf 和 -Confirm 的提示信息，建议写得清晰明确，让用户一看就知道将要做什么。
ShouldProcess 与 ShouldContinue 的区别 ：ShouldProcess 受 -WhatIf、-Confirm 和 $ConfirmPreference 控制，适合作为标准确认入口。ShouldContinue 不受这些机制控制，总是弹出确认提示，也不支持 -WhatIf，适合在 ShouldProcess 之后的二次验证场景。不要用 ShouldContinue 替代 ShouldProcess。
批量操作避免逐项确认 ：在 foreach 循环中使用 ShouldProcess 时，每次迭代都会检查确认。如果批量处理数百个对象，逐项确认会让脚本无法使用。解决方法是将函数的 ConfirmImpact 设为 Low 或 Medium（低于默认的 High），这样批量执行时不会弹出确认，但用户仍可通过 -Confirm 强制开启。
正确处理 ShouldProcess 返回 false 的场景 ：当 ShouldProcess 返回 $false 时（用户选择了否或处于 -WhatIf 模式），应立即跳过当前操作，不要继续执行后续的清理或状态更新逻辑。否则可能出现逻辑不一致，比如文件没删除但日志记录显示已删除。