PowerShell ： Object reference not set エラーの回避テクニック

PowerShell を使っていると、突然こんなエラーに出くわすことがあります。

日本語にすると 「オブジェクト参照がオブジェクトインスタンスに設定されていません」 という意味で、.NET系スクリプトによくある Null 参照エラー です。

PowerShell では比較的ありがちなエラーですが、原因さえ分かれば回避は簡単です。本記事では、発生パターンと回避方法を整理します。

🔍 このエラーが発生する典型例

→ $val に値が無いため .Length が処理できずエラー。

Get-ADUser が該当ユーザーを返さない場合、$user が null となりエラー。

$hash が未作成のまま使用するとエラー。

PowerShell の比較は == より -eq / -ne を推奨。

→ $user.DisplayName が null なら "Unknown" が代わりに入る。

→ $user が null でもエラーにならず null を返す。

try {
    $val.Length
} catch {
    Write-Host "エラー: $($_.Exception.Message)"
}

try {

$val.Length

} catch {

Write-Host "エラー: $($_.Exception.Message)"

}

毎回判定するのが面倒なら、関数化して管理すると楽になります。

Object reference not set は null のままプロパティやメソッドを呼び出した場合に発生するエラーです。

回避方法のポイントは以下の3つ。

PowerShell のエラー処理が整うと、スクリプトの信頼性と実行結果の安定性が一気に上がります。
業務バッチや自動化処理では、特に意識しておきたいポイントです。