SupportsShouldProcessと-WhatIf/-Confirm

[CmdletBinding(SupportsShouldProcess)]を宣言すると自動で追加される-WhatIf/-Confirmパラメーターと、$PSCmdlet.ShouldProcess()による実行可否の分岐の仕組み。

概念URI

https://comcomponent.com/knowledge/shouldprocess-whatif/

別名・表記

ShouldProcess / WhatIf

最終確認日

2026-08-01

機械可読データ

JSON-LD

この概念が関わる関係

• SupportsShouldProcessと-WhatIf/-Confirmは[CmdletBinding()]属性を前提とします。SupportsShouldProcessは[CmdletBinding()]のオプションとして宣言し、これにより-WhatIf/-Confirmが自動追加される / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• SupportsShouldProcessと-WhatIf/-Confirmは変更系処理の意図しない実行を軽減します。SupportsShouldProcessによる-WhatIf/-Confirmで実行前に影響範囲を確認できるため、変更系処理が意図せず実行されるリスクを減らせる。ただし-WhatIfの伝播は呼び出し先のコマンドまで常に保証されるわけではなく、利用者が-WhatIfを付けて確認しなければ効果を発揮しない / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• Move-ItemはSupportsShouldProcessと-WhatIf/-Confirmで構成できます。ログを移動する関数はSupportsShouldProcessを付け、Move-Itemの直前で$PSCmdlet.ShouldProcess()により実行するか予行だけにするかを判断する / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• SupportsShouldProcessと-WhatIf/-ConfirmはMove-Itemに対する本記事の推奨です。変更処理であるログの移動を実行する前に、-WhatIfで移動予定だけを確認する予行を行うことが推奨される / 確度: 確立した関係 / 確認日: 2026-08-01 出典

この概念を扱う記事

• PowerShellスクリプトの引数設計とモジュール化 ── 「動くスクリプト」から「人に渡せるスクリプト」へ(言及)
• PowerShellスクリプト応用 ── ログ調査・アーカイブ・レポート化を安全に自動化する(主要トピック)

一次資料

• https://learn.microsoft.com/powershell/scripting/learn/deep-dives/everything-about-shouldprocess

このページはサイトの知識グラフ(_data/knowledge/)から自動生成されています。誤りの指摘はお問い合わせからお願いします。