Azure DevOps模板参数未正确展开，AZ CLI执行报错求助

核心问题定位 #

你的问题出在模板参数传递与展开的时机不匹配：${{ parameters.xxx }}是编译时语法，需要在流水线初始化阶段就完成值的替换；如果传递参数时写法错误，会导致模板接收到的是变量名字符串而非实际值，最终在AZ CLI执行时出现未识别参数的错误。

正确实现示例 #

1. 模板文件template_task.yaml的正确定义

确保参数类型明确，且在任务中用${{ }}正确引用参数：

parameters:
  - name: service_connection_name
    type: string
  - name: storage_account_name
    type: string

steps:
  - task: AzureCLI@2
    displayName: '查询存储账户信息'
    inputs:
      azureSubscription: ${{ parameters.service_connection_name }}
      scriptType: bash
      inlineScript: |
        # 直接用${{ }}展开模板参数，编译时就会替换为实际值
        az storage account show --name ${{ parameters.storage_account_name }}

2. 流水线中引用模板的正确写法

必须用${{ variables.xxx }}将变量组的变量值传递给模板参数，确保编译时就能完成替换：

variables:
  - group: Dev  # 加载变量组

steps:
  - template: template_task.yaml
    parameters:
      # 用${{ variables.变量名 }}传递变量组中的值给模板参数
      service_connection_name: ${{ variables.DEV_SERVICE_CONNECTION }}
      storage_account_name: ${{ variables.DEV_STORAGE_ACCOUNT }}

常见错误排查 #

1. 参数传递未用${{ variables.xxx }}
   如果直接写storage_account_name: DEV_STORAGE_ACCOUNT，模板接收到的是字符串DEV_STORAGE_ACCOUNT而非变量组的实际值，导致AZ CLI执行时出现unrecognized arguments: parameters.storage_account_name }}错误。

2. 混淆${{ }}与$()的作用

   • ${{ parameters.xxx }}：编译时展开，流水线运行前就替换为实际值，是模板参数传递的正确方式。
   • $()：运行时读取环境变量，直接用它会绕过模板参数传递逻辑，不符合模板复用的设计。

3. 验证参数展开结果
   运行流水线后，查看任务日志的"展开后的模板"部分，确认${{ parameters.storage_account_name }}是否被替换为变量组的实际值。如果显示的还是parameters.storage_account_name，说明传递参数的写法有误。

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