PowerShell Start-Process封装脚本无法捕获子进程退出码问题

问题根源 #

1. -NoExit参数强制进程保持运行：你在Start-Process里硬加了-NoExit，这会让PowerShell执行完命令后不退出，不管你在finally块里写了exit都没用。进程一直处于运行状态，自然拿不到有效的ExitCode。
2. -exit参数完全没生效：函数里定义了-exit开关，但根本没在逻辑里使用，等于白传。
3. 脚本调用方式有隐患：直接写$command执行脚本，要是脚本路径带空格或者不在当前目录/PATH里，会执行失败，还没法正确捕获退出码。

修复后的代码 #

process.ps1

function Start-PowershellProcess {
    param(
        [string]$command,
        [string]$stderrFile,
        [string]$stdoutFile,
        [bool]$exit    = $true,
        [int] $timeout = 0,
        [ValidateSet("PowerShell7","PowerShell5")]
        [string]$type   = "PowerShell7"
    )

    # 用&调用脚本确保路径解析正确，显式捕获退出码
    $commandBlock = @"
try {
    & "$command"
    `$exitCode = `$LASTEXITCODE
} catch {
    Write-Error `$_.Exception.Message
    `$exitCode = 1
} finally {
    exit `$exitCode
}
"@

    $exe     = if ($type -eq "PowerShell7") { "pwsh" } else { "powershell" }
    $args    = @("-Command", $commandBlock)
    
    # 仅当不需要退出时才添加-NoExit参数
    if (-not $exit) {
        $args = @("-NoExit") + $args
    }

    $process = Start-Process $exe `
        -PassThru `
        -RedirectStandardOutput $stdoutFile `
        -RedirectStandardError  $stderrFile `
        -ArgumentList $args

    # 更高效的等待方式，支持超时（转换为毫秒）
    if ($timeout -gt 0) {
        $process.WaitForExit($timeout * 1000)
    } else {
        $process.WaitForExit()
    }

    return $process
}

setup.ps1调用调整

因为你需要获取退出码，所以不需要传-exit $false（默认就是$true）：

$process = Start-PowershellProcess `
  -command      $scriptToRun `
  -type         PowerShell7 `
  -stderrFile   $stderrFile `
  -stdoutFile   $stdoutFile `
  -timeout      1200

修复要点说明 #

• 去掉默认的-NoExit：只有当你确实需要保持子PowerShell会话时，再通过-exit $false开启这个参数，正常执行脚本获取退出码的场景下必须让进程退出。
• 用&执行脚本：解决路径包含空格、非当前目录的脚本执行问题，保证$LASTEXITCODE能正确捕获脚本的退出状态。
• 显式处理退出码：把$LASTEXITCODE赋值给变量，即使脚本抛出异常，也能返回非0的退出码，避免父脚本误判。
• 替换循环等待为WaitForExit()：系统原生的等待方法更高效，还能直接支持超时参数，不用自己写循环。

验证效果 #

修改后运行setup.ps1，子脚本正常执行时会输出ExitCode: 0和绿色的成功提示；如果子脚本执行失败（比如返回非0退出码），会正确捕获并触发错误提示。

内容的提问来源于stack exchange，提问作者Kevin James