知識マップ: PowerShellのエラー処理と再実行設計 ── try/catchが効かない罠からexit code・リトライの定石まで

記事「PowerShellのエラー処理と再実行設計 ── try/catchが効かない罠からexit code・リトライの定石まで」の主張を、概念と関係(エッジ)に分解した知識グラフの全体です。各関係には根拠・確認日・確度が付いています。

PowerShellのエラーは、パイプラインを続行する非終了エラーと、その場で処理を止める終了エラーに分かれ、非終了エラーは既定のままではtry/catchで捕まえられません。捕まえたいコマンドにErrorAction Stopを付けて終了エラーへ昇格させることで、失敗を握りつぶしたまま正常終了する事故を防げます。robocopyやgitのようなネイティブコマンドはこの仕組みの外側にあり、成否は終了コード($LASTEXITCODE)で確認するのが基本で、PowerShell 7.4以降は$PSNativeCommandUseErrorActionPreferenceと組み合わせてtry/catchに乗せることもできます。成否は最終的に終了コードとしてタスクスケジューラへ伝え、一時的な障害に限り局所的なretryを、冪等な処理設計と指数バックオフの上限つきで行うことで、無人実行に耐えるスクリプトになります。

flowchart LR
    accTitle: PowerShellのエラー処理とリトライ設計の知識マップ
    accDescr: 非終了エラーと終了エラーの違い、ErrorAction Stopによる昇格、ネイティブコマンドの成否判定と終了コード、PowerShell 7.4の新機能、局所的なretryが冪等な処理設計・一時的な障害・指数バックオフと持つ関係を示す図
    non_terminating_error["非終了エラー"]
    limited_retry["局所的なretry"]
    powershell["PowerShell"]
    powershell_try_catch["PowerShellのtry/catch"]
    terminating_error["終了エラー(ステートメント終了/スクリプト終了)"]
    erroraction_stop["ErrorAction Stop"]
    silent_failure_risk["失敗の握りつぶしリスク"]
    native_command["ネイティブコマンド(外部プログラム)"]
    exit_code["終了コード(exit code)"]
    ps_native_command_use_erroraction_preference["$PSNativeCommandUseErrorActionPreference"]
    robocopy["robocopy"]
    task_scheduler["タスクスケジューラの無人実行"]
    idempotent_processing["idempotency(冪等性)を前提にした処理"]
    transient_failure["一時的な障害"]
    permanent_error["恒久的エラー(業務エラー)"]
    exponential_backoff["指数バックオフ"]
    powershell -->|"利用する"| powershell_try_catch
    powershell_try_catch -->|"前提とする"| terminating_error
    non_terminating_error -.->|"両立しない"| powershell_try_catch
    powershell_try_catch -.->|"前提とする"| erroraction_stop
    non_terminating_error -.->|"原因になり得る"| silent_failure_risk
    erroraction_stop -->|"防止する"| silent_failure_risk
    native_command -.->|"両立しない"| powershell_try_catch
    native_command -->|"で確認できる"| exit_code
    native_command -.->|"原因になり得る"| silent_failure_risk
    ps_native_command_use_erroraction_preference -->|"前提とする"| erroraction_stop
    ps_native_command_use_erroraction_preference -.->|"防止する"| silent_failure_risk
    powershell -->|"利用する"| robocopy
    robocopy -->|"で確認できる"| exit_code
    exit_code -->|"で確認できる"| task_scheduler
    limited_retry -->|"前提とする"| idempotent_processing
    limited_retry -->|"軽減する"| transient_failure
    limited_retry -->|"用いるのは非推奨"| permanent_error
    limited_retry -->|"利用する"| exponential_backoff

概念間の関係(全18件)

図と同じ関係を文章でも列挙します。表示している文と機械可読な意味データ(RDFa)は同じ要素に載っています。確度が「確立した関係」のものは直接の関係として、「条件付きの関係」のものは成立条件つきの言明(rdf:Statement)として表現しています。

PowerShellはPowerShellのtry/catchを利用します。PowerShellはtry/catch/finally構文によるエラー処理をサポートする / 確度: 確立した関係 / 確認日: 2026-08-01 出典
PowerShellのtry/catchは終了エラー(ステートメント終了/スクリプト終了)を前提とします。catchブロックが処理を捕まえられるのは、対象が終了エラーである場合に限られる / 確度: 確立した関係 / 確認日: 2026-08-01 出典
非終了エラーはPowerShellのtry/catchと両立しません。既定の設定のままでは、非終了エラーはtry/catch/finallyのcatchに渡らず、パイプラインの実行を続行する。-ErrorAction Stopや$ErrorActionPreference = "Stop"で終了エラーへ格上げすれば、catchで捕まえられる / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
PowerShellのtry/catchはErrorAction Stopを前提とします。非終了エラーを出すコマンドをcatchで確実に扱うには、そのコマンドへのErrorAction Stopの明示、または$ErrorActionPreference='Stop'の設定が前提になる / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
非終了エラーは失敗の握りつぶしリスクの原因になることがあります。非終了エラーを想定せずに書くと、エラーメッセージが出ているのに処理が続行し、外部からは正常終了したスクリプトに見えてしまうことがある / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
ErrorAction Stopは失敗の握りつぶしリスクを防ぎます。ErrorAction Stopや$ErrorActionPreference='Stop'を使えば、非終了エラーの時点で確実に停止させ、失敗を握りつぶしたまま正常終了する事故を防げる / 確度: 確立した関係 / 確認日: 2026-08-01 出典
ネイティブコマンド(外部プログラム)はPowerShellのtry/catchと両立しません。既定の設定のままでは、ネイティブコマンドの非ゼロ終了コードはErrorRecordを生成せず、try/catchのcatchには入らない。PowerShell 7.4以降で$PSNativeCommandUseErrorActionPreferenceを有効にし、$ErrorActionPreferenceをStopにすれば、非ゼロ終了はcatchできる終了エラーになる / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
ネイティブコマンド(外部プログラム)は終了コード(exit code)で確認できます。ネイティブコマンドの成否は終了コード($LASTEXITCODE)で確認できる。$?は終了コード0のときだけ$trueになる / 確度: 確立した関係 / 確認日: 2026-08-01 出典出典
ネイティブコマンド(外部プログラム)は失敗の握りつぶしリスクの原因になることがあります。ネイティブコマンドの失敗は既定でPowerShellのエラーにならないため、$LASTEXITCODEを確認しなければ失敗に気づかないまま処理が続くことがある / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
$PSNativeCommandUseErrorActionPreferenceはErrorAction Stopを前提とします。$PSNativeCommandUseErrorActionPreferenceを$trueにしても、ネイティブコマンドの失敗をtry/catchで捕まえるには$ErrorActionPreference='Stop'と組み合わせる必要がある / 確度: 確立した関係 / 確認日: 2026-08-01 出典出典
$PSNativeCommandUseErrorActionPreferenceは失敗の握りつぶしリスクを防ぎます。非ゼロ終了コードを非終了エラーとして扱う設定とErrorAction Stopを組み合わせれば、ネイティブコマンドの失敗が気づかれないまま進む事故を防げる / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
PowerShellはrobocopyを利用します。PowerShellはrobocopyのようなネイティブコマンド(外部プログラム)を呼び出せる / 確度: 確立した関係 / 確認日: 2026-08-01 出典
robocopyは終了コード(exit code)で確認できます。robocopyの成否は0〜7が成功系(コピーの有無等の情報)、8以上が失敗という独自の終了コード体系で確認できる / 確度: 確立した関係 / 確認日: 2026-08-01 出典
終了コード(exit code)はタスクスケジューラの無人実行で確認できます。exitキーワードで設定した終了コードは、pwsh -File起動時にプロセスの終了コードとなり、タスクスケジューラの「前回の実行結果」で確認できる / 確度: 確立した関係 / 確認日: 2026-08-01 出典出典
局所的なretryはidempotency(冪等性)を前提にした処理を前提とします。リトライはタスクスケジューラの再実行も含め同じ処理がもう一度走ることを意味するため、二重処理にならない冪等な設計が前提になる / 確度: 確立した関係 / 確認日: 2026-08-01 出典
局所的なretryは一時的な障害を軽減します。一時的な障害は時間の経過で解消しうるため、局所的なretryで自動的に吸収できる / 確度: 確立した関係 / 確認日: 2026-08-01 出典
局所的なretryを恒久的エラー(業務エラー)に用いることは推奨されません。入力不正や権限不足のような恒久的エラーは再試行しても結果が変わらないため、リトライの対象にすべきでない / 確度: 確立した関係 / 確認日: 2026-08-01 出典
局所的なretryは指数バックオフを利用します。再試行の間隔は指数バックオフで広げ、障害中の相手への負荷集中を避ける / 確度: 確立した関係 / 確認日: 2026-08-01 出典

主要概念の定義

非終了エラー: コマンドレットが個々の入力の処理に失敗したときなどに発生する、パイプラインの実行を止めずに報告だけするPowerShellのエラー。既定ではtry/catchのcatchブロックに渡らない。
局所的なretry: 一時的失敗と分かっている・冪等性がある・上限回数と待ち方が決まっている・失敗時の最終挙動が明確、という4条件が揃うときだけ外部I/O境界で行うretry。
PowerShell: オブジェクトパイプラインとエラー処理機構を持つ、Microsoftが最も堅牢で最新のWindows自動化に推奨するコマンドラインシェル兼スクリプト言語。
PowerShellのtry/catch: 文終了エラーやスクリプト終了エラーを捕捉し、finallyで後始末を書けるPowerShellのエラー処理構文。
ErrorAction Stop: コマンドレットの共通パラメーターErrorActionにStopを指定し、処理を続けるはずの非終了エラーも例外(RuntimeException)として扱わせる指定。
ネイティブコマンド(外部プログラム): robocopyやgit、社内EXEなど、PowerShellのエラーシステムに参加せず、既定では終了コードだけで結果を報告する外部プログラム。
$PSNativeCommandUseErrorActionPreference: PowerShell 7.4で正式機能になった設定で、$trueにするとネイティブコマンドの非ゼロ終了コードが$ErrorActionPreferenceに従う非終了エラーを発生させる(既定は$false)。
robocopy: リトライ(既定100万回)・ミラーリング・ログ機能を持つ、Windows標準のファイルコピー用コマンドラインツール。0〜8以上という独特の終了コード体系を持つ。
終了コード(exit code): プロセスが終了時に返す整数値。bat側は%ERRORLEVEL%、PowerShell側はexitキーワードや$LASTEXITCODEで扱う。

機械可読データ

JSON-LD / Turtle ── この記事の知識グラフ全体
概念一覧 / 語彙(述語)の定義

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