PowerShell => 共通パラメータ

備考

共通パラメーターは任意のコマンドレットで使用できます（つまり、関数をcmdlet [ CmdletBinding() ]としてマークすると、これらのパラメーターはすべて無料になります）。

すべての一般的なパラメータの一覧を示します（エイリアスは、対応するパラメータの後の括弧内にあります）。

-Debug (db)
-ErrorAction (ea)
-ErrorVariable (ev)
-InformationAction (ia) # introduced in v5
-InformationVariable (iv) # introduced in v5
-OutVariable (ov)
-OutBuffer (ob)
-PipelineVariable (pv)
-Verbose (vb) 
-WarningAction (wa)
-WarningVariable (wv)
-WhatIf (wi)
-Confirm (cf)

ErrorActionパラメータ

このパラメータの値は、コマンドレットが非終了エラー（たとえばWrite-Errorから生成されたもの;エラー処理の詳細については[ 未作成トピック ]を参照）を処理する方法を決定します。

デフォルト値（このパラメーターを省略した場合）はContinueです。

-ErrorActionを続行

このオプションはエラーメッセージを生成し、実行を続行します。

PS C:\> Write-Error "test" -ErrorAction Continue ; Write-Host "Second command"

-ErrorAction無視する

このオプションはエラーメッセージを生成せず、実行を続行します。また、 $Error自動変数に$Errorが追加されません。
このオプションはv3で導入されました。

PS C:\> Write-Error "test" -ErrorAction Ignore ; Write-Host "Second command"

-ErrorAction Inquire

このオプションを選択すると、エラーメッセージが表示され、ユーザーは実行するアクションを選択するよう求められます。

PS C:\> Write-Error "test" -ErrorAction Inquire ; Write-Host "Second command"

-ErrorActionは黙って続けます

このオプションはエラーメッセージを生成せず、実行を続行します。すべてのエラーは$Error自動変数に追加されます。

PS C:\> Write-Error "test" -ErrorAction SilentlyContinue ; Write-Host "Second command"

-ErrorAction Stop

このオプションはエラーメッセージを生成し、実行を続行しません。

PS C:\> Write-Error "test" -ErrorAction Stop ; Write-Host "Second command"

-ErrorAction Suspend

Powershellワークフローでのみ使用できます。コマンドを使用すると、コマンドがエラーになった場合、ワークフローは中断されます。これにより、そのようなエラーの調査が可能になり、ワークフローを再開できるようになります。ワークフローシステムの詳細については、[まだ作成されていないトピック]を参照してください。

Modified text is an extract of the original Stack Overflow Documentation

ライセンスを受けた CC BY-SA 3.0

所属していない Stack Overflow

PowerShell
共通パラメータ

サーチ…

備考