如何向调用Shell/进程最佳传递PowerShell可执行包装模块的失败状态？

好问题！你的核心需求是把被包装的可执行程序的真实退出码完整传递给父进程，同时避免不必要的冗长异常输出，还要兼容三种调用场景。这里有几个更优的实现方案，完全解决你提到的两个痛点：

核心思路 #

要兼顾三种场景，关键是做到两点：

1. 传递真实的退出码（而不是默认的0/1）给父进程
2. 控制错误输出的形式，避免PowerShell默认的冗长异常堆栈

下面是两种最实用的实现方式：

方案1：基础函数 + 环境退出码（适合简单模块函数） #

这种方式简单直接，能在交互式PowerShell中保留会话，同时给外部进程传递真实退出码：

function Invoke-WrappedExe {
    param(
        [Parameter(Mandatory)]
        [string]$ExePath,
        [string[]]$Arguments
    )

    # 调用目标可执行程序
    & $ExePath @Arguments
    $exitCode = $LastExitCode

    if ($exitCode -ne 0) {
        # 输出简洁的自定义错误信息（可选，可根据需求调整）
        Write-Error "执行程序失败：$ExePath 退出码 $exitCode"
        
        # 设置PowerShell进程的退出码，供父进程获取
        [Environment]::ExitCode = $exitCode

        # 非交互式环境（如cmd/外部进程调用）直接退出，确保父进程拿到退出码
        if (-not $Host.Name.Equals('ConsoleHost', [StringComparison]::OrdinalIgnoreCase)) {
            exit $exitCode
        }
    }
}

各场景效果：

• PowerShell交互式shell：$?会变为False，$LASTEXITCODE保留真实退出码，会话不会被终止，错误信息简洁无堆栈。
• cmd调用：%errorlevel%会拿到真实的退出码（比如你提到的9），而非固定的1。
• 外部程序调用：父进程获取到的PowerShell进程退出码就是目标程序的真实退出码。

方案2：高级函数 + 结构化错误（符合PowerShell模块规范） #

如果你的模块遵循PowerShell最佳实践（比如使用高级函数），可以用WriteError方法输出结构化错误，同时传递真实退出码：

function Invoke-WrappedExe {
    [CmdletBinding()]
    param(
        [Parameter(Mandatory)]
        [string]$ExePath,
        [string[]]$Arguments
    )

    & $ExePath @Arguments
    $exitCode = $LastExitCode

    if ($exitCode -ne 0) {
        # 创建结构化错误记录
        $errorMsg = "可执行程序 '$ExePath' 运行失败，退出码：$exitCode"
        $exception = [System.Exception]::new($errorMsg)
        $errorRecord = [System.Management.Automation.ErrorRecord]::new(
            $exception,
            "ExeFailure_$exitCode",
            [System.Management.Automation.ErrorCategory]::OperationStopped,
            $ExePath
        )

        # 写入错误但不终止执行
        $PSCmdlet.WriteError($errorRecord)
        # 设置进程退出码
        [Environment]::ExitCode = $exitCode
    }
}

优势：

• 错误信息符合PowerShell的结构化错误规范，方便PowerShell内部调用时处理错误（比如用-ErrorAction参数控制行为）。
• 同样能传递真实退出码，且在交互式shell中不会终止会话。
• 外部进程调用时无冗长堆栈输出，仅输出自定义的简洁错误信息。

解决你之前的两个痛点 #

1. 传递完整范围的退出码：上述两种方案都直接使用目标程序的$LastExitCode设置PowerShell进程的退出码，父进程能拿到真实的数值（比如9、10等），而非固定的0/1。
2. 抑制冗长异常信息：不再使用throw抛出终止异常，而是用Write-Error或WriteError输出简洁错误，避免了PowerShell默认的堆栈跟踪信息（比如CategoryInfo、FullyQualifiedErrorId）。

补充注意事项 #

• [Environment]::ExitCode：这个变量设置的是当前PowerShell进程的退出码，只有当进程退出时才会被父进程感知；在PowerShell内部调用时，$LASTEXITCODE会同步这个值，$?会变为False。
• 交互式vs非交互式：方案1中判断$Host.Name是为了在非交互式环境（比如cmd调用）直接退出进程，确保父进程能拿到退出码；在交互式shell中则保留会话，方便后续操作。
• 终止错误需求：如果你需要在PowerShell内部让函数触发终止错误（即后续命令停止执行），可以把WriteError换成$PSCmdlet.ThrowTerminatingError($errorRecord)，这样既会终止执行，又能传递真实退出码，且错误信息比直接throw更简洁可控。

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