Bicep部署错误控制及PowerShell中红色错误字体实现

1. PowerShell调用az deployment group create的正确错误捕获方式 #

Azure CLI属于外部命令，PowerShell原生的try/catch不会自动捕获其执行错误，必须结合外部命令退出码$LASTEXITCODE和错误输出捕获，才能实现完整的错误处理逻辑，改进后的脚本示例如下：

try {
    # 将Azure CLI的错误输出(stderr)重定向到标准输出(stdout)，确保所有输出都能被捕获
    $deploymentOutput = az deployment group create `
        --resource-group $rg `
        --template-file $TemplateFile `
        --parameters $ParameterFile `
        --name $deployment_name 2>&1

    # 检查CLI命令退出码，非0值说明执行失败
    if ($LASTEXITCODE -ne 0) {
        # 将捕获到的完整错误信息转为字符串抛出
        $errorDetail = $deploymentOutput | Out-String
        Throw "Azure部署失败: $errorDetail"
    }

    # 仅在命令执行成功时解析JSON输出（错误场景下CLI输出可能不是合法JSON）
    $parsedResult = $deploymentOutput | ConvertFrom-Json
    # 后续其他Azure CLI命令逻辑...
}
catch {
    # 统一处理所有异常，包括CLI执行错误和JSON解析错误
    Write-Host "捕获到错误: $_" -ForegroundColor Red
    # 可选：终止脚本执行，避免后续逻辑继续运行
    exit 1
}

核心改进说明：

• 用2>&1重定向错误输出，避免错误信息直接打印而无法被脚本捕获
• 优先检查退出码，再执行JSON解析（错误时CLI输出大概率不是合法JSON，提前判断能避免额外的解析报错）
• 抛出完整错误信息，便于定位模板参数不匹配、模块加载失败等具体问题

2. 用红色字体显示错误信息，区分Bicep警告 #

PowerShell的Write-Host命令支持通过-ForegroundColor参数指定字体颜色，直接在错误处理逻辑中使用该参数即可实现红色高亮错误：

基础实现 #

在catch块中输出红色错误信息：

catch {
    Write-Host "`n=== 错误详情 ===" -ForegroundColor Red
    Write-Host $_ -ForegroundColor Red
    Write-Host "===============`n" -ForegroundColor Red
}

进阶：实时区分错误与警告 #

如果需要在CLI执行过程中实时区分错误和警告，可以过滤输出内容并设置不同颜色：

$deploymentOutput = az deployment group create ... 2>&1
foreach ($line in $deploymentOutput) {
    if ($line -match "ERROR|Failed|模块加载错误") {
        Write-Host $line -ForegroundColor Red
    } elseif ($line -match "WARNING|WARN") {
        Write-Host $line -ForegroundColor Yellow
    } else {
        Write-Host $line
    }
}

这种方式会让错误以红色高亮，警告以黄色显示，普通输出保持默认颜色，彻底避免不同类型信息混淆。

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