Terminar un script en PowerShell

He estado buscando una forma de terminar un script de PowerShell (PS1) cuando se produce un error irrecuperable dentro de una función. Por ejemplo:

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

Por supuesto que no existe tal cosa $host.Exit(). Lo hay $host.SetShouldExit(), pero en realidad esto cierra la ventana de la consola, que no es lo que quiero. Lo que necesito es algo equivalente a Python sys.exit()que simplemente detendrá la ejecución del script actual sin más adiós.

Editar: Sí, es solo exit. Duh

Deberías usar la exitpalabra clave .

Me doy cuenta de que esta es una publicación antigua, pero me encuentro volviendo mucho a este hilo, ya que es uno de los principales resultados de búsqueda al buscar este tema. Sin embargo, siempre me dejo más confundido que cuando vine debido a la información conflictiva. En última instancia, siempre tengo que realizar mis propias pruebas para resolverlo. Así que esta vez publicaré mis hallazgos.

TL; DR La mayoría de las personas querrán usar Exitpara terminar un script en ejecución. Sin embargo, si su script simplemente declara funciones para usarlas posteriormente en un shell, entonces querrá usarlas Returnen las definiciones de dichas funciones.

Salida vs retorno vs descanso

• Salir: Esto "saldrá" del contexto actual. Si llama a este comando desde un script, saldrá del script. Si llama a este comando desde el shell, saldrá del shell.

  Si una función llama al comando Salir, saldrá del contexto en el que se esté ejecutando. Entonces, si esa función solo se llama desde un script en ejecución, saldrá de ese script. Sin embargo, si su script simplemente declara la función para que pueda usarse desde el shell actual y ejecuta esa función desde el shell, saldrá del shell porque el shell es el contexto en el que Exitse ejecuta la función que contiene el comando.

  Nota: De forma predeterminada, si hace clic con el botón derecho en un script para ejecutarlo en PowerShell, una vez que el script se haya ejecutado, PowerShell se cerrará automáticamente. Esto no tiene nada que ver con el Exitcomando o cualquier otra cosa en su secuencia de comandos. Es solo un comportamiento predeterminado de PowerShell para los scripts que se ejecutan utilizando este método específico de ejecutar un script. Lo mismo es cierto para los archivos por lotes y la ventana de línea de comandos.

• Regresar: Esto volverá al punto de llamada anterior. Si llama a este comando desde un script (fuera de las funciones), volverá al shell. Si llama a este comando desde el shell, volverá al shell (que es el punto de llamada anterior para un solo comando ejecutado desde el shell). Si llama a este comando desde una función, volverá a donde se llamó la función.

  La ejecución de cualquier comando después del punto de llamada al que se devuelve continuará desde ese punto. Si se llama a un script desde el shell y contiene el Returncomando fuera de cualquier función, cuando regrese al shell no hay más comandos para ejecutar, por lo que un Returnuso de esta manera es esencialmente el mismo que Exit.

• Descanso: Esto saldrá de los bucles y cambiará los casos. Si llama a este comando mientras no está en un bucle o caso de cambio, saldrá del guión. Si llama Breakdentro de un bucle que está anidado dentro de un bucle, solo saldrá del bucle en el que se llamó.

  También hay una característica interesante de Breakdónde puede prefijar un bucle con una etiqueta y luego puede salir de ese bucle etiquetado incluso si el Breakcomando se llama dentro de varios grupos anidados dentro de ese bucle etiquetado.

  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
  }

Exittambién saldrá de PowerShell. Si desea "romper" solo la función o script actual, use 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 es para errores que no terminan y throw es para errores que terminan

El cmdlet Write-Error declara un error que no termina. Por defecto, los errores se envían en la secuencia de errores al programa host para que se muestre, junto con la salida.

Los errores que no terminan escriben un error en la secuencia de error, pero no detienen el procesamiento del comando. Si se declara un error que no termina en un elemento de una colección de elementos de entrada, el comando continúa procesando los otros elementos de la colección.

Para declarar un error de terminación, use la palabra clave Throw. Para obtener más información, consulte about_Throw ( http://go.microsoft.com/fwlink/?LinkID=145153 ).

Termina este proceso y le da al sistema operativo subyacente el código de salida especificado.

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

[Environment]::Exit(1)

Esto le permitirá salir con un código de salida específico, que puede obtener de la persona que llama.

Creo que estás buscando en Returnlugar de Break. La ruptura generalmente se usa para bucles y solo se rompe desde el bloque de código más interno. Use Volver para salir de una función o script.

Lanzar una excepción será bueno, especialmente si desea aclarar la razón del error:

throw "Error Message"

Esto generará un error de terminación.

Puede ser mejor usar "trap". Una captura de PowerShell especifica un bloque de código para ejecutarse cuando se produce una terminación o un error. Tipo

Get-Help about_trap

para aprender más sobre la declaración de trampa.

Casualmente descubrí que (por ejemplo , simplemente , donde la etiqueta no existe ) parece salir del guión completo (incluso desde una función) y mantiene vivo al host. De esta manera, podría crear una función que rompa el script desde cualquier lugar (por ejemplo, un bucle recursivo) sin conocer el alcance actual (y crear etiquetas):Break <UnknownLabel>Break ScriptScript

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

Usé esto para volver a ejecutar un programa. No sé si ayudaría, pero es una declaración simple si solo requiere dos entradas diferentes. Funcionó en PowerShell para mí.

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

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

No sé si esto ayuda, pero creo que sería similar a la finalización de un programa después de haberlo ejecutado. Sin embargo, en este caso, cada entrada definida requiere una salida listada y categorizada. También puede hacer que la salida llame una nueva línea de solicitud y finalice el programa de esa manera.