about_Trap

[アーティクル]
05/28/2022

簡単な説明

終了エラーを処理するキーワードについて説明します。

長い説明

終了エラーは、ステートメントの実行を停止します。 PowerShell が何らかの方法で終了エラーを処理しない場合、PowerShell は現在のパイプラインで関数またはスクリプトの実行も停止します。 C# などの他の言語では、終了エラーは例外と呼ばれます。

このキーワードは trap 、終了エラーが発生したときに実行するステートメントのリストを指定します。 trap ステートメントは、次の方法で終了エラーを処理できます。

ステートメントブロックを処理し、次を trap 含むスクリプトまたは関数の実行を継続した後、エラーを trap表示します。これは既定の動作です。

注意

ステートメントやforeachループなどのif下位スクリプトブロックで終了エラーが発生すると、ブロック内のtrapステートメントが実行され、下位スクリプトブロックの外部にある次のステートメントで実行が続行されます。
ステートメントに using break を含むtrapスクリプトまたは関数のエラーを表示し、実行をtrap中止します。
エラーを無音にしますが、ステートメントで使用continueして、スクリプトまたは関数を含むtrap関数の実行をtrap続行します。

ステートメントの一覧には、複数の trap 条件または関数呼び出しを含めることができます。 A trap は、ログの書き込み、テスト条件、または別のプログラムの実行を行うことができます。

構文

trap ステートメントの構文は次のとおりです。

trap [[<error type>]] {<statement list>}

ステートメント trap には、終了エラーが発生したときに実行するステートメントの一覧が含まれています。ステートメントは trap 、キーワード ( trap 必要に応じて型式) と、エラーがトラップされたときに実行するステートメントのリストを含むステートメントブロックで構成されます。型式は、キャッチするエラーの種類を絞り trap 込みます。

スクリプトまたはコマンドには、複数の trap ステートメントを含めることができます。 trap ステートメントは、スクリプトまたはコマンド内の任意の場所に表示できます。

終了するすべてのエラーのトラップ

スクリプトまたはコマンドで別の方法で処理されない終了エラーが発生した場合、PowerShell はエラーを trap 処理するステートメントをチェックします。ステートメントが存在する trap 場合、PowerShell はステートメント内のスクリプトまたはコマンドの実行を trap 続行します。

次の例は、非常に単純なステートメントです trap 。

trap {"Error found."}

このステートメントは trap 、終了エラーをトラップします。

次の例では、ランタイムエラーの原因となるナンセンス文字列が関数に含まれています。

function TrapTest {
    trap {"Error found."}
    nonsenseString
}

TrapTest

この関数を実行すると、次の結果が返されます。

Error found.
nonsenseString:
Line |
   3 |      nonsenseString
     |      ~~~~~~~~~~~~~~
     | The term 'nonsenseString' is not recognized as the name of a cmdlet,
function, script file, or operable program. Check the spelling of the name, or
if a path was included, verify that the path is correct and try again.

次の例には、自動変数を trap 使用してエラーを表示するステートメントが $_ 含まれています。

function TrapTest {
    trap {"Error found: $_"}
    nonsenseString
}

TrapTest

このバージョンの関数を実行すると、次が返されます。

Error found: The term 'nonsenseString' is not recognized as the name of a
cmdlet, function, script file, or operable program. Check the spelling of the
name, or if a path was included, verify that the path is correct and try again.
nonsenseString:
Line |
   3 |      nonsenseString
     |      ~~~~~~~~~~~~~~
     | The term 'nonsenseString' is not recognized as the name of a cmdlet,
function, script file, or operable program. Check the spelling of the name, or
if a path was included, verify that the path is correct and try again.

重要

trap ステートメントは、特定のスクリプトブロック内の任意の場所で定義できますが、そのスクリプトブロック内のすべてのステートメントに常に適用されます。実行時には、 trap ブロック内のステートメントは、他のステートメントが実行される前に定義されます。 JavaScript では、これはホイストと呼ばれます。つまり、定義された trap 時点を超えて実行が進んでいなくても、そのブロック内のすべてのステートメントにステートメントが適用されます。たとえば、スクリプトの末尾に a trap を定義し、最初のステートメントでエラーをスローすると、その trapエラーが引き続きトリガーされます。

特定のエラーのトラップ

スクリプトまたはコマンドには、複数の trap ステートメントを含めることができます。 A trap は、特定のエラーを処理するために定義できます。

次の例は、特定の trap エラー CommandNotFoundException をトラップするステートメントです。

trap [System.Management.Automation.CommandNotFoundException]
    {"Command error trapped"}

関数またはスクリプトが既知のコマンドと一致しない文字列を検出すると、この trap ステートメントは "Command error trapped" 文字列を表示します。ステートメントリストを trap 実行した後、PowerShell はエラーオブジェクトをエラーストリームに書き込み、スクリプトを続行します。

PowerShell では、.NET 例外の種類が使用されます。次の例では、 System.Exception エラーの種類を指定します。

trap [System.Exception] {"An error trapped"}

CommandNotFoundException エラーの種類は 、System.Exception 型から継承されます。このステートメントは、不明なコマンドによって作成されたエラーをトラップします。また、他のエラーの種類もトラップします。

スクリプトには複数の trap ステートメントを含めることができます。各エラーの種類は、1 つの trap ステートメントによってのみトラップできます。終了エラーが発生すると、PowerShell は、現在のスクリプトの実行ブロックから、最も具体的な一致を検索 trap します。

次のスクリプトの例には、エラーが含まれています。このスクリプトには、終了エラーをトラップする一般的trapなステートメントと、CommandNotFoundException 型を指定する特定trapのステートメントが含まれています。

trap {"Other terminating error trapped" }
trap [System.Management.Automation.CommandNotFoundException] {
  "Command error trapped"
}
nonsenseString

このスクリプトを実行すると、次の結果が生成されます。

Command error trapped
nonsenseString:
Line |
   5 |  nonsenseString
     |  ~~~~~~~~~~~~~~
     | The term 'nonsenseString' is not recognized as the name of a cmdlet,
function, script file, or operable program. Check the spelling of the name, or
if a path was included, verify that the path is correct and try again.

PowerShell はコマンドレットまたはその他の項目として "nonsenseString" を認識しないため、 CommandNotFoundException エラーを返します。この終了エラーは、特定 trap のステートメントによってトラップされます。

次のスクリプトの例には、同じ trap ステートメントと異なるエラーが含まれています。

trap {"Other terminating error trapped" }
trap [System.Management.Automation.CommandNotFoundException]
    {"Command error trapped"}
1/$null

このスクリプトを実行すると、次の結果が生成されます。

Other terminating error trapped
RuntimeException:
Line |
   4 |  1/$null
     |  ~~~~~~~
     | Attempted to divide by zero.

0 で除算しようとしても 、CommandNotFoundException エラーは発生しません。代わりに、そのエラーは他 trap のステートメントによってトラップされ、終了エラーがトラップされます。

スクリプトブロック内のエラーのトラップ

既定では、終了エラーがスローされると、実行は trap ステートメントに転送されます。ブロックが trap 実行されると、エラーの場所の後の次のステートメントブロックに制御が戻ります。

たとえば、ステートメントで foreach 終了エラーが発生すると、ステートメントが実行され、 trap ブロック内ではなく、ブロックの後の次の foreach ステートメントで実行が foreach 続行されます。

trap { 'An error occurred!'}
foreach ($x in 3..0) {
   1/$x
   'after division'
}
'after loop'

0.333333333333333
after division
0.5
after division
1
after division
An error occurred!
RuntimeException: untitled:Untitled-1:3:4
Line |
   3 |     1/$x
     |     ~~~~
     | Attempted to divide by zero.

after loop

上記の出力では、ループが最後のイテレーションまで続くことがわかります。スクリプトが 1 を 0 で除算しようとすると、終了エラーがスローされます。スクリプトブロックの foreach 残りの部分はスキップされ、 try ステートメントが実行され、スクリプトブロックの後もスクリプトが foreach 続行されます。

エラーとスコープのトラップ

ステートメントと同じスクリプトブロック trap で終了エラーが発生した場合、PowerShell によって定義されたステートメントの一覧が trap実行されます。エラーの後、ステートメントで実行が続行されます。ステートメントが trap エラーとは異なるスクリプトブロック内にある場合は、ステートメントと同じスクリプトブロック内にある次のステートメントで実行が trap 続行されます。

たとえば、関数でエラーが発生し、ステートメントが trap 関数内にある場合、スクリプトは次のステートメントで続行されます。次のスクリプトには、エラーとステートメントが trap 含まれています。

function function1 {
    trap { "An error: " }
    NonsenseString
    "function1 was completed"
}

function1

このスクリプトを実行すると、次の結果が生成されます。

An error:
NonsenseString:
Line |
   3 |      NonsenseString
     |      ~~~~~~~~~~~~~~
     | The term 'NonsenseString' is not recognized as the name of a cmdlet,
function, script file, or operable program. Check the spelling of the name, or
if a path was included, verify that the path is correct and try again.
function1 was completed

関数内のステートメントによって trap エラーがトラップされます。メッセージを表示すると、PowerShell は関数の実行を再開します。完了した点に Function1 注意してください。

これは、同じエラーとステートメントを持つ次の例と trap 比較してください。この例では、ステートメントは trap 関数の外部で発生します。

function function2 {
    NonsenseString
    "function2 was completed"
}

trap { "An error: " }

function2

この関数を Function2 実行すると、次の結果が生成されます。

An error:
NonsenseString:
Line |
   2 |      NonsenseString
     |      ~~~~~~~~~~~~~~
     | The term 'NonsenseString' is not recognized as the name of a cmdlet,
function, script file, or operable program. Check the spelling of the name, or
if a path was included, verify that the path is correct and try again.

この例では、"function2 was completed" コマンドは実行されませんでした。どちらの例でも、終了エラーは関数内で発生します。ただし、この例では、 trap ステートメントは関数の外部にあります。 PowerShell は、ステートメントの実行後に関数に trap 戻りません。

注意事項

同じエラー条件に対して複数のトラップが定義されている場合は、最初 trap に定義された構文 (スクリプトブロック内で最も高い) が使用されます。

次の例では、 trap "whoops 1" のみを実行します。

Remove-Item -ErrorAction Stop ThisFileDoesNotExist
trap { "whoops 1"; continue }
trap { "whoops 2"; continue }

重要

Trap ステートメントのスコープは、コンパイル先です。関数またはドットソーススクリプト内にステートメントがある trap 場合、関数またはドットソーススクリプトが終了すると、内部のすべての trap ステートメントが削除されます。

break キーワードと continue キーワードの使用

ステートメント内の trap and continue キーワードをbreak使用して、終了エラーの後もスクリプトまたはコマンドが引き続き実行されるかどうかを判断できます。

ステートメントリストにステートメントをbreak``trap含める場合、PowerShell は関数またはスクリプトを停止します。次のサンプル関数では、ステートメントでキーワードをbreak``trap使用します。

function break_example {
    trap {
        "Error trapped"
        break
    }
    1/$null
    "Function completed."
}

break_example

Error trapped
ParentContainsErrorRecordException:
Line |
   6 |      1/$null
     |      ~~~~~~~
     | Attempted to divide by zero.

ステートメントに trap キーワードが break 含まれているため、関数は引き続き実行されず、"Function completed" 行は実行されません。

ステートメントにキーワードをcontinue含めると、エラーの原因となったステートメントの後に PowerShell が再開されます。エラーが発生しないbreak場合とcontinue同様trapです。ただし、このキーワードを continue 使用すると、PowerShell はエラーストリームにエラーを書き込むことはありません。

次のサンプル関数では、ステートメントでキーワードをcontinue``trap使用します。

function continue_example {
    trap {
        "Error trapped"
        continue
    }
    1/$null
    "Function completed."
}

continue_example

Error trapped
Function completed.

エラーがトラップされた後に関数が再開され、"Function completed" ステートメントが実行されます。エラーストリームにエラーは書き込まれなくなります。

メモ

trap ステートメントは、スクリプトブロック内のすべての終了エラーが確実に処理されるようにする方法を提供します。より詳細なエラー処理を行うには、ステートメントを使用 try/catch してトラップを定義するブロックを使用 catch します。ステートメントは catch 、関連付けられた try ステートメント内のコードにのみ適用されます。詳細については、「about_Try_Catch_Finally」を参照してください。

about_Trap

簡単な説明

長い説明

構文

終了するすべてのエラーのトラップ

特定のエラーのトラップ

スクリプトブロック内のエラーのトラップ

エラーとスコープのトラップ

break キーワードと continue キーワードの使用

メモ

こちらもご覧ください

フィードバック

about_Trap

簡単な説明

長い説明

構文

終了するすべてのエラーのトラップ

特定のエラーのトラップ

スクリプト ブロック内のエラーのトラップ

エラーとスコープのトラップ

break キーワードと continue キーワードの使用

メモ

こちらもご覧ください

フィードバック

スクリプトブロック内のエラーのトラップ