書き換えた .ps1 を流す前に、[System.Management.Automation.Language.Parser]::ParseFile で構文エラーの数を数えようとしたら、チェックそのものが [ref] は、存在しない変数には適用できません。 で落ちました。
[ref] に渡した変数を、その前に作っていなかったのが原因です。
$tk = $null; $e = $null を先に書いておくだけで通ります。
症状
スクリプトを書き換えて新しい版を作り、そのまま構文チェックまで流す、という一続きの処理を書いていました。その最後の方です。
$null = [System.Management.Automation.Language.Parser]::ParseFile($dst, [ref]$tk, [ref]$e)
"parseErrors=$($e.Count)"
結果はこうでした。
InvalidOperation:
Line |
10 | $null=[System.Management.Automation.Language.Parser]::ParseFile($dst, …
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
| [ref] は、存在しない変数には適用できません。
parseErrors=0
厄介なのは、エラーの後に parseErrors=0 が出ていることです。ParseFile が動いていないので $e は空のままで、$e.Count が 0 になっているだけです。ぱっと見ると「構文エラー 0 件」に見えてしまいます。
環境
- Windows 11
- PowerShell 7(
pwsh -NoProfile)
原因
ParseFile の 2 つ目と 3 つ目の引数は、結果を書き戻してもらうための [ref](参照渡し)です。
PowerShell の [ref]$変数 は、その変数がまだ一度も作られていないとエラーになります。今回のスクリプトでは $tk も $e もそれより前に出てこなかったので、ParseFile を呼ぶ前の段階で止まっていました。
解決手順
ParseFileを呼ぶ前に、[ref]で渡す変数を$nullで作っておきます。
powershell
$tk = $null; $e = $null
$null = [System.Management.Automation.Language.Parser]::ParseFile('C:\path\to\script.ps1', [ref]$tk, [ref]$e)
"parseErrors=$($e.Count)"
- 流し直して、エラーが出ずに件数だけが出ることを確かめます。今回は
parseErrors=0だけが出て、新しい版の構文に問題が無いことを確かめられました。
再発防止・気づき
[ref]を使うときは、すぐ上の行で変数を作る、を癖にしておくと迷いません。- 「エラー 0 件」を表示する作りのチェックは、チェック自体が失敗しても 0 と出ることがあります。件数だけを見ずに、その前にエラーが出ていないかも見ること。