PowerShellでスクリプトを終了する

関数内で回復不可能なエラーが発生したときにPowerShell（PS1）スクリプトを終了する方法を探していました。例えば：

function foo() {
    # Do stuff that causes an error
    $host.Exit()
}

もちろんのようなものはありません$host.Exit()。はありますが$host.SetShouldExit()、これは実際にはコンソールウィンドウを閉じます。私が必要としているのsys.exit()は、現在のスクリプトの実行をさらに回避することなく単に停止するPythonのものと同等のものです。

編集：ええ、それだけexitです。ああ。

キーワードを使用してexitください。

これは古い投稿であることに気づきましたが、このトピックを検索する際の上位の検索結果の1つであるため、このスレッドに何度も戻ってきます。しかし、私は情報が矛盾しているために来たときよりも常に混乱しています。最終的には、それを理解するために常に自分のテストを実行する必要があります。今回は調査結果を掲載します。

TL; DRほとんどの人はExit、実行中のスクリプトを終了するために使用したいと思うでしょう。ただし、スクリプトが単にシェルで後で使用する関数を宣言している場合Returnは、その関数の定義で使用する必要があります。

終了vsリターンvsブレイク

• 終了：現在実行中のコンテキストを「終了」します。スクリプトからこのコマンドを呼び出すと、スクリプトが終了します。シェルからこのコマンドを呼び出すと、シェルを終了します。

  関数がExitコマンドを呼び出すと、実行中のコンテキストがすべて終了します。そのため、その関数が実行中のスクリプト内からのみ呼び出される場合、そのスクリプトは終了します。ただし、現在のシェルから使用できるようにスクリプトで関数を宣言するだけで、その関数をシェルから実行する場合、シェルはExitコマンドを含む関数が実行されているコンテキストであるため、シェルを終了します。

  注：デフォルトでは、スクリプトを右クリックしてPowerShellで実行すると、スクリプトの実行が完了すると、PowerShellが自動的に閉じます。これは、Exitコマンドやスクリプト内の他のものとは関係ありません。これは、この特定のスクリプト実行方法を使用して実行されるスクリプトの既定のPowerShell動作にすぎません。バッチファイルとコマンドラインウィンドウについても同様です。

• 戻る：前の呼び出しポイントに戻ります。このコマンドをスクリプトから（関数の外で）呼び出すと、シェルに戻ります。このコマンドをシェルから呼び出すと、シェルに戻ります（これは、シェルから実行された単一のコマンドの前の呼び出しポイントです）。このコマンドを関数から呼び出すと、関数が呼び出された場所に戻ります。

  コールポイントが戻された後のコマンドの実行は、そのポイントから続行されます。スクリプトがシェルから呼び出され、Return関数の外にコマンドが含まれている場合、スクリプトがシェルに戻ると、実行するコマンドがなくなるReturnため、この方法でのの使用方法はと本質的に同じになりExitます。

• Break：ループから抜け出し、ケースを切り替えます。ループまたはスイッチケースではないときにこのコマンドを呼び出すと、スクリプトから抜け出します。Breakループ内にネストされているループ内で呼び出すと、呼び出されたループから抜け出すだけです。

  Breakループの前にラベルを付けることができ、そのラベル付きループBreak内のネストされた複数のグループ内でコマンドが呼び出された場合でも、そのラベル付きループから抜け出すことができるという興味深い機能もあります。

  While ($true) {
      # Code here will run
  
      :myLabel While ($true) {
          # Code here will run
  
          While ($true) {
              # Code here will run
  
              While ($true) {
                  # Code here will run
                  Break myLabel
                  # Code here will not run
              }
  
              # Code here will not run
          }
  
          # Code here will not run
      }
  
      # Code here will run
  }

ExitPowerShellも終了します。現在の関数またはスクリプトだけから「脱出」したい場合-を使用してくださいBreak:)

If ($Breakout -eq $true)
{
     Write-Host "Break Out!"
     Break
}
ElseIf ($Breakout -eq $false)
{
     Write-Host "No Breakout for you!"
}
Else
{
    Write-Host "Breakout wasn't defined..."
}

Write-Errorは非終了エラー用であり、throwは終了エラー用です

Write-Errorコマンドレットは、終了しないエラーを宣言します。デフォルトでは、エラーはエラーストリームでホストプログラムに送信され、出力とともに表示されます。

非終了エラーはエラーストリームにエラーを書き込みますが、コマンド処理は停止しません。入力項目のコレクション内の1つの項目で非終了エラーが宣言されている場合、コマンドはコレクション内の他の項目の処理を続行します。

終了エラーを宣言するには、Throwキーワードを使用します。詳細については、about_Throw（http://go.microsoft.com/fwlink/?LinkID=145153）を参照してください。

このプロセスを終了し、基になるオペレーティングシステムに指定された終了コードを提供します。

https://msdn.microsoft.com/en-us/library/system.environment.exit%28v=vs.110%29.aspx

[Environment]::Exit(1)

これにより、呼び出し元から取得できる特定の終了コードで終了できます。

のReturn代わりにあなたが探していると思いますBreak。通常、Breakはループに使用され、最も内側のコードブロックからのみブレークします。関数またはスクリプトを終了するには、Returnキーを使用します。

例外をスローすることは、特にエラーの理由を明確にしたい場合に適しています。

throw "Error Message"

これにより、終了エラーが発生します。

「トラップ」を使用する方が良いかもしれません。PowerShellトラップは、終了またはエラーが発生したときに実行するコードブロックを指定します。タイプ

Get-Help about_trap

トラップステートメントの詳細については、

私は偶然ということが分かった（例えば、単に、ラベルがどこに存在するしない（でも関数内から）、スクリプト全体から抜け出すために表示され、生きているホストを保持します）。 このようにして、現在のスコープを知らずに（そしてラベルを作成せずに）どこからでもスクリプトを中断する関数（たとえば、再帰ループ）を作成できます。Break <UnknownLabel>Break ScriptScript

Function Quit($Text) {
    Write-Host "Quiting because: " $Text
    Break Script
} 

これをプログラムの再実行に使用しました。それが役立つかどうかはわかりませんが、2つの異なるエントリのみを必要とする単純なifステートメントです。それは私のためにPowerShellで動作しました。

$rerun = Read-Host "Rerun report (y/n)?"

if($rerun -eq "y") { Show-MemoryReport }
if($rerun -eq "n") { Exit }

これが役立つかどうかはわかりませんが、これは、プログラムを実行した後にプログラムを終了することになると思います。ただし、この場合、定義されたすべての入力には、リストおよび分類された出力が必要です。出口で新しいプロンプト行を呼び出して、プログラムをそのように終了することもできます。