如何判断PowerShell中ScriptBlock的执行是否成功？

问题现象 #

直接执行报错命令后，$?能正确返回执行失败状态：

1/0; echo $?

输出：

RuntimeException: Attempted to divide by zero.
false

但用Invoke-Command执行包含报错命令的脚本块时，$?返回的是Invoke-Command自身的执行状态（而非脚本块内部的执行状态）：

$s = { 1/0 }; Invoke-Command $s; echo $?

输出：

RuntimeException: Attempted to divide by zero.
true

需要获取的是脚本块内部代码的执行成功/失败状态，而非调用它的命令的状态，也可以接受改用$s.Invoke()的方案。

背景需求 #

想要封装一个at_place函数，实现切换到指定路径执行脚本块，只有脚本块执行成功才返回原路径，失败则停留在目标路径提示修复。原手动实现的逻辑是：

Push-Location ~/foo; doStuff; If ( $? ){ Pop-Location; } Else { Write-Error "Failed, fix here" }

希望改写成DSL风格：

at_place ~/foo { doStuff; }

但当前的函数实现中，$?无法正确捕获脚本块的执行状态：

function at_place {
    Param(
        [string] $Path,
        [scriptblock] $ScriptBlock
    )

    Push-Location $Path ;

    Invoke-Command $ScriptBlock ;
    # 下面这行代码无法正常工作        
    [bool] $ScriptBlockPass = $? ;
    
    If ( $? ){
        Write-Debug "success!" ;
        Pop-Location ;
    } Else {
        Write-Error "ScriptBlock failed, remaining at $Path, please fix manually." ;
        throw "ScriptBlock failed at $Path" ;
    }
}

解决方案 #

方案1：使用&调用脚本块（推荐） #

直接用调用操作符&执行脚本块，此时$?会正确反映脚本块内部的执行状态：

$s = { 1/0 }; & $s; echo $?

输出：

RuntimeException: Attempted to divide by zero.
false

修改后的at_place函数：

function at_place {
    Param(
        [string] $Path,
        [scriptblock] $ScriptBlock
    )

    Push-Location $Path
    try {
        & $ScriptBlock
        $scriptSuccess = $?
        if ($scriptSuccess) {
            Write-Debug "success!"
            Pop-Location
        } else {
            Write-Error "ScriptBlock failed, remaining at $Path, please fix manually."
            throw "ScriptBlock failed at $Path"
        }
    }
    catch {
        # 捕获脚本块抛出的异常，确保状态判断准确
        Write-Error "ScriptBlock failed, remaining at $Path, please fix manually."
        throw $_
    }
}

方案2：使用ScriptBlock.Invoke()并检查异常 #

Invoke()方法执行脚本块时，若内部出错会抛出异常，可通过try/catch捕获：

$s = { 1/0 }
try {
    $s.Invoke()
    $scriptSuccess = $true
}
catch {
    $scriptSuccess = $false
}
echo $scriptSuccess

输出：false

对应的函数修改：

function at_place {
    Param(
        [string] $Path,
        [scriptblock] $ScriptBlock
    )

    Push-Location $Path
    try {
        $ScriptBlock.Invoke()
        Write-Debug "success!"
        Pop-Location
    }
    catch {
        Write-Error "ScriptBlock failed, remaining at $Path, please fix manually."
        throw "ScriptBlock failed at $Path"
    }
}

关键说明 #

• Invoke-Command主要用于远程执行或多线程执行，本地执行脚本块时，&是更轻量且符合预期的选择，$?会直接反映脚本块的执行结果。
• 无论用哪种方式，结合try/catch都能更可靠地捕获脚本块中的异常，避免遗漏未终止脚本的错误。

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