Azure DevOps Windows代理中az deployment group what-if执行报错[WinError 2]

问题现象 #

在windows-latest代理的YAML流水线中，使用AzureCLI@2任务执行az deployment group what-if命令时，报错：ERROR: [WinError 2] The system cannot find the file specified。

• 初始设置scriptType: bash触发错误，切换为ps/pscore、改为单行脚本后仍报错
• 已确认Bicep文件和参数文件路径正确，改用PowerShell任务执行相同命令依旧失败
• 其他流水线步骤中az CLI可正常使用，排除工具全局缺失问题
• 原本选择bash是因为官方文档和社区示例多采用Bash语法，且认为Windows代理通过Git安装的Bash可正常工作，但实际集成存在一致性问题
• 预期命令输出Bicep文件部署到指定资源组的计划变更，实现类似az deployment group create的试运行效果

解决方案 #

方案1：切换为PowerShell脚本格式适配Windows代理 #

在Windows代理上优先使用PowerShell语法，避免Bash路径解析冲突。修改AzureCLI@2任务的scriptType为ps，并调整换行符和参数写法：

- task: AzureCLI@2
  displayName: 'What if Bicep file'
  inputs:
    azureSubscription: '$(azureServiceConnection)'
    scriptType: 'ps'
    scriptLocation: 'inlineScript'
    inlineScript: |
      az deployment group what-if `
        --resource-group rg-inbound-integration-dev `
        --mode Incremental `
        --template-file Global/infra/main.bicep `
        --parameters "Global/infra/main-dev.bicepparam"

注意：PowerShell中换行需用反引号`，参数路径用双引号包裹，避免路径解析异常。

方案2：显式指定Bash路径（若坚持使用Bash） #

如果必须使用Bash，通过环境变量将Git Bash路径加入系统PATH，确保任务能找到执行器：

- task: AzureCLI@2
  displayName: 'What if Bicep file'
  inputs:
    azureSubscription: '$(azureServiceConnection)'
    scriptType: 'bash'
    scriptLocation: 'inlineScript'
    inlineScript: |
      az deployment group what-if \
        --resource-group rg-inbound-integration-dev \
        --mode Incremental \
        --template-file Global/infra/main.bicep \
        --parameters 'Global/infra/main-dev.bicepparam'
    workingDirectory: $(System.DefaultWorkingDirectory)
  env:
    PATH: "$(ProgramFiles)/Git/bin:$(PATH)"

方案3：使用绝对路径引用模板和参数文件 #

用代理系统变量指定绝对路径，彻底避免相对路径解析问题：

- task: AzureCLI@2
  displayName: 'What if Bicep file'
  inputs:
    azureSubscription: '$(azureServiceConnection)'
    scriptType: 'ps'
    scriptLocation: 'inlineScript'
    inlineScript: |
      az deployment group what-if `
        --resource-group rg-inbound-integration-dev `
        --mode Incremental `
        --template-file "$(System.DefaultWorkingDirectory)/Global/infra/main.bicep" `
        --parameters "$(System.DefaultWorkingDirectory)/Global/infra/main-dev.bicepparam"

验证要点 #

• 执行az --version确认CLI版本，确保支持Bicep和what-if命令
• 添加前置步骤用dir（PowerShell）或ls（Bash）验证文件实际存在
• 确认服务连接拥有目标资源组的读取、部署验证权限

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