Azure Dev管道PowerShell脚本报错：%1不是有效Win32应用

可能的触发原因及排查方向 #

• AZ CLI路径/环境变量异常：Azure Dev Agent的系统PATH可能发生变更，导致az命令无法被正确定位。Start-Process直接调用"az"时依赖PATH环境变量中的可执行文件路径，若Agent更新、AZ CLI版本升级后路径未同步到PATH，就会触发该错误。
  • 排查方式：在脚本开头添加Get-Command az或where.exe az，确认系统能否找到az.exe的完整路径。如果返回空值，说明AZ CLI未正确安装，或路径未加入环境变量。
• Agent架构与AZ CLI不匹配：若Agent为64位，但AZ CLI安装在32位目录（如Program Files (x86)），且脚本在32位PowerShell环境运行，会出现找不到可执行文件的情况，反之亦然。
• AZ CLI版本兼容性：虽然该报错本身不是参数问题，但如果Agent自动更新了AZ CLI版本，部分底层调用逻辑的变化也可能间接引发此问题，可对比之前的版本差异排查。

代码优化方案（同时解决当前报错） #

你的代码用Start-Process传递整串参数存在解析风险，且依赖PATH定位az的方式不够可靠。以下是更健壮的写法：

方案1：指定AZ CLI完整路径+拆分参数数组 #

foreach ($alert in $alerts)
{
    Write-Log "`tCreating alert $($alert.AlertName)"
    # 将参数拆分为数组，避免引号解析错误
    $azArgs = @(
        "monitor", "metrics", "alert", "create",
        "--name", $alert.AlertName,
        "--resource-group", $resourceGroup,
        "--condition", $alert.AlertRule,
        "--scopes", $alert.ResourceId,
        "--window-size", "5m",
        "--evaluation-frequency", "1m",
        "--action", $actionGroupResourceId,
        "--description", "",
        "--subscription", $subscriptionId,
        "--auto-mitigate", "true"
    )
    Write-Verbose ($azArgs -join " ")
    # 获取az.exe的完整路径，避免依赖PATH
    $azPath = (Get-Command az).Source
    Start-Process -FilePath $azPath -ArgumentList $azArgs -NoNewWindow -Wait
}

方案2：直接调用AZ CLI（更简洁） #

无需使用Start-Process，直接在PowerShell中调用az命令，还能直接捕获执行状态：

foreach ($alert in $alerts)
{
    Write-Log "`tCreating alert $($alert.AlertName)"
    $azArgs = @(
        "monitor", "metrics", "alert", "create",
        "--name", $alert.AlertName,
        "--resource-group", $resourceGroup,
        "--condition", $alert.AlertRule,
        "--scopes", $alert.ResourceId,
        "--window-size", "5m",
        "--evaluation-frequency", "1m",
        "--action", $actionGroupResourceId,
        "--description", "",
        "--subscription", $subscriptionId,
        "--auto-mitigate", "true"
    )
    Write-Verbose ($azArgs -join " ")
    # 直接执行az命令
    & az @azArgs
    # 检查执行结果
    if ($LASTEXITCODE -ne 0) {
        Write-Log "`tFailed to create alert $($alert.AlertName)" -Level Error
    }
}

总结 #

当前报错大概率是AZ CLI的路径未被系统正确识别，和Azure平台更新无关，更可能是Agent环境的PATH变动或AZ CLI安装异常。通过上述代码优化（指定完整路径、拆分参数数组）可以解决问题，同时让脚本更健壮，避免参数解析错误。

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