08.1 2種類のエラー

まず動かして確かめる

try {
    Get-ChildItem 'X:\ないパス'
    'ここまで到達した'
} catch {
    'catch に入った'
}

結果は 「ここまで到達した」 です。画面には赤いエラーが表示されるのに、catch には入りません。

どちらになるかは決まっている

解決策 — -ErrorAction Stop

非終了エラーを終了エラーに格上げすると catch できます。

try {
    Get-ChildItem 'X:\ないパス' -ErrorAction Stop
    'ここまで到達した'
} catch {
    'catch に入った: ' + $_.Exception.GetType().Name
}
# → catch に入った: DriveNotFoundException

スクリプト全体を厳しくする

$ErrorActionPreference = 'Stop'      # スクリプトの先頭に書く

08.2 try / catch / finally

基本の形

try {
    $data = Get-Content .\config.json -Raw -ErrorAction Stop
    $config = $data | ConvertFrom-Json
}
catch [System.IO.FileNotFoundException] {
    Write-Host "設定ファイルがありません"
}
catch {
    Write-Host "予期しないエラー: $($_.Exception.Message)"
}
finally {
    Write-Host "後始末（成功・失敗にかかわらず必ず実行）"
}

エラーオブジェクトから取れる情報

catch の中では $_ にエラーの詳細が入っています。実際に取得できる値です。

catch {
    Write-Host "エラー: $($_.Exception.Message)"
    Write-Host "場所  : $($_.InvocationInfo.ScriptName) の $($_.InvocationInfo.ScriptLineNumber) 行目"
}

throw と Write-Error の使い分け

# 続行できないので止める
if (-not (Test-Path $config)) { throw "設定ファイルが見つかりません: $config" }

# 1件失敗しても残りを処理したい
foreach ($f in $files) {
    if (-not (Test-Path $f)) { Write-Error "スキップ: $f"; continue }
    # ...
}

エラーを後から確認する

# 直近のエラーが新しい順に入っている
$Error[0]
$Error.Count

# その場で変数に受け取る
Get-ChildItem 'X:\a','X:\b' -ErrorAction SilentlyContinue -ErrorVariable myErr
$myErr.Count        # → 2

# PowerShell 7 の詳細表示
Get-Error

08.3 外部コマンドと終了コード

exe の失敗は例外にならない 見落としやすい

robocopy、git、7z などの外部コマンドは、失敗しても PowerShell のエラーになりません。

try {
    cmd /c "exit 3"
    "例外なし。`$LASTEXITCODE = $LASTEXITCODE  /  `$? = $?"
} catch {
    'catch に入った'
}
# → 例外なし。$LASTEXITCODE = 3  /  $? = False

2つの判定方法

robocopy $src $dst /MIR
if ($LASTEXITCODE -ge 8) {
    throw "robocopy が失敗しました (終了コード: $LASTEXITCODE)"
}

PowerShell 7 なら例外にできる pwsh 7

$PSNativeCommandUseErrorActionPreference = $true
$ErrorActionPreference = 'Stop'

try { cmd /c "exit 5" }
catch { $_.Exception.Message }
# → Program "cmd.exe" ended with non-zero exit code: 5 (0x00000005).

既定は $false です。5.1 には存在しないので、両対応のスクリプトでは $LASTEXITCODE で書くのが確実です。

スクリプト自身の終了コード

exit 0     # 正常終了
exit 1     # 異常終了

08.4 デバッグ

出力を使い分ける

function Get-Report {
    [CmdletBinding()]
    param([string]$Path)

    Write-Verbose "処理開始: $Path"
    # ...
    Write-Verbose "完了"
}

Get-Report -Path .\a.txt              # 何も出ない
Get-Report -Path .\a.txt -Verbose     # Write-Verbose の内容が出る

止めて中身を見る

# 変数が変更されたときに止める
Set-PSBreakpoint -Script .\main.ps1 -Variable count -Mode Write

# 特定のコマンドが呼ばれたときに止める
Set-PSBreakpoint -Script .\main.ps1 -Command Remove-Item

# 一覧と削除
Get-PSBreakpoint
Get-PSBreakpoint | Remove-PSBreakpoint

行単位のトレース

Set-PSDebug -Trace 1     # 実行された行を表示
Set-PSDebug -Trace 2     # 変数代入も表示
Set-PSDebug -Off         # 解除