HOWTO · PowerShell

Cómo obtener el código de salida de Start-Process en PowerShell

Este artículo explicará cómo obtener el código de salida después de ejecutar un script con el cmdlet start-process.

En esta página

Para obtener el código de salida de un proceso con Start-Process en PowerShell, captura el objeto del proceso con -PassThru y espera a que termine con -Wait. Después, lee su propiedad ExitCode:

$pwshPath = (Get-Process -Id $PID).Path
$workingDirectory = [System.IO.Path]::GetTempPath()
$process = Start-Process -FilePath $pwshPath -ArgumentList @('-NoProfile', '-Command', 'exit 7') -WorkingDirectory $workingDirectory -Wait -PassThru
"Exit code: $($process.ExitCode)"
Exit code: 7

Este ejemplo inicia el ejecutable actual de PowerShell en un directorio de trabajo temporal y pide al proceso secundario que devuelva el código de salida 7. Usar el ejecutable actual hace que el ejemplo no dependa de programas exclusivos de Windows, como cmd.exe; además, especificar el directorio de trabajo evita depender del directorio actual desde el que se ejecuta el comando. Sustituye el ejecutable y los argumentos por el programa que quieras ejecutar. -Wait hace que PowerShell espere a que el proceso termine, y -PassThru devuelve el objeto del proceso para poder leer su propiedad ExitCode. El resultado de ejemplo muestra Exit code: 7; ese rótulo se conserva en inglés porque forma parte del bloque inmutable. El código de salida 0 suele indicar que la ejecución tuvo éxito; el significado de cualquier valor distinto de cero depende del programa.

Obtener el código de salida con -Wait y -PassThru

Usa ambos parámetros cuando la siguiente parte del script dependa del resultado del programa iniciado. -Wait determina cuándo continúa PowerShell, mientras que -PassThru te proporciona el objeto del proceso. Lee ExitCode cuando el proceso haya terminado para obtener su resultado final.

Asigna $process.ExitCode a $exitCode y compáralo con 0 antes de decidir qué debe hacer el script. Adapta la condición a los códigos de salida documentados por el programa. Un valor distinto de cero no tiene un significado universal: puede indicar un error u otro resultado documentado.

Por qué $LastExitCode no informa el código de salida de Start-Process

Start-Process no asigna un valor a $LastExitCode. Esta variable contiene el código de salida del programa nativo ejecutado más recientemente de forma directa en la sesión actual de PowerShell. Iniciar un proceso independiente con Start-Process no hace que su código de salida esté disponible en $LastExitCode.

En su lugar, usa la propiedad ExitCode del objeto de proceso que devuelve Start-Process -PassThru. Si ejecutas directamente un programa nativo, PowerShell actualiza $LastExitCode cuando ese programa termina. Es una forma distinta de iniciar el programa y no permite recuperar el resultado de un proceso iniciado con Start-Process.

Obtener el código de salida de un objeto de proceso con WaitForExit()

También puedes omitir -Wait, conservar el objeto del proceso y llamar a su método WaitForExit() antes de leer ExitCode. Esto resulta útil si necesitas realizar otras tareas antes de esperar. El método bloquea la ejecución hasta que ese proceso termina.

La secuencia equivalente es iniciarlo con -PassThru, llamar a WaitForExit() y, después, leer $process.ExitCode. Conserva el objeto de proceso correspondiente al proceso cuyo resultado necesitas; no uses $LastExitCode para este método. Esta alternativa se describe sin una transcripción de salida aparte porque el paquete no incluye evidencia de ejecución para ella.

Conclusión

Para un proceso iniciado con Start-Process, combina -PassThru con -Wait y lee la propiedad ExitCode del objeto devuelto. Como alternativa, llama a WaitForExit() en ese objeto antes de leer la propiedad. $LastExitCode se aplica a programas nativos ejecutados directamente desde PowerShell, no a procesos iniciados mediante Start-Process.