如何在PowerShell Try Catch块中处理AZ CLI？资源未找到时异常未捕获

AZ CLI是外部可执行程序，它执行失败时只会返回非零退出码，但不会抛出PowerShell的终止错误。而PowerShell的try/catch默认仅捕获终止错误，所以即便AZ CLI触发错误，代码也不会进入catch块。

以下两种方法可让catch块正常捕获AZ CLI的错误：

方法一：手动检查退出码并抛出错误 #

调用AZ CLI命令后，立即检查PowerShell内置变量$LASTEXITCODE（存储外部程序的退出码），若不为0则手动抛出错误，强制触发catch块。

修改后的代码：

try{
    $state=$(az synapse sql pool show --name $DB_NAME --resource-group $RG_NAME --workspace-name $WKSPC_NAME --query "status")
    
    # 检查AZ CLI命令的执行状态
    if ($LASTEXITCODE -ne 0) {
        throw "未找到指定的SQL池资源"
    }

    Write-Host("State = $state")

    if($state -match "Paused")
    {
        Write-Host("Resume Pool xxx")
        
        az synapse sql pool resume --name $DB_NAME --resource-group $RG_NAME --workspace-name $WKSPC_NAME
        # 检查恢复命令的执行状态
        if ($LASTEXITCODE -ne 0) {
            throw "SQL池恢复操作失败"
        }

        az synapse sql pool wait --sql-pool-name $DB_NAME --resource-group $RG_NAME --workspace-name $WKSPC_NAME --custom "state==Online"
        # 检查等待命令的执行状态
        if ($LASTEXITCODE -ne 0) {
            throw "等待SQL池上线超时"
        }
    }
}
catch
{
    Write-Host("Handle error - no need to do anything....")
    # 输出具体错误详情（可选）
    Write-Host("错误信息: $_")
}

方法二：修改错误行为并重定向错误流 #

临时将$ErrorActionPreference设置为Stop，同时把AZ CLI的错误流（2>&1）重定向到PowerShell的错误流，让外部程序的错误被识别为终止错误。

修改后的代码：

try{
    # 临时保存原错误行为设置
    $originalErrorAction = $ErrorActionPreference
    $ErrorActionPreference = 'Stop'

    # 重定向AZ CLI错误流到PowerShell错误流
    $state=$(az synapse sql pool show --name $DB_NAME --resource-group $RG_NAME --workspace-name $WKSPC_NAME --query "status" 2>&1)

    Write-Host("State = $state")

    if($state -match "Paused")
    {
        Write-Host("Resume Pool xxx")
        
        az synapse sql pool resume --name $DB_NAME --resource-group $RG_NAME --workspace-name $WKSPC_NAME 2>&1
        az synapse sql pool wait --sql-pool-name $DB_NAME --resource-group $RG_NAME --workspace-name $WKSPC_NAME --custom "state==Online" 2>&1
    }
}
catch
{
    Write-Host("Handle error - no need to do anything....")
    Write-Host("错误信息: $_")
}
finally{
    # 恢复原错误行为设置，避免影响后续代码
    $ErrorActionPreference = $originalErrorAction
}

• 方法一更灵活，可针对每个AZ CLI命令的执行结果做个性化处理；
• 方法二适合批量处理外部程序错误，但必须记得恢复原错误行为设置。

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