如何在ARM模板中覆盖对象与数组类型参数？

要修改ARM模板参数文件里containers数组中对象的name和image属性，核心是利用ARM模板参数的完全替换规则，结合AzureResourceManagerTemplateDeployment@3任务的overrideParameters参数传递正确格式的JSON值，以下是两种可行方案：

方案1：直接在overrideParameters中传递完整数组 #

首先确保你的ARM模板里containers参数定义为array类型，示例如下：

"parameters": {
  "containers": {
    "type": "array",
    "defaultValue": [
      {
        "name": "default-app",
        "image": "mcr.microsoft.com/azuredocs/containerapps-helloworld:latest"
      }
    ]
  }
}

YAML流水线写法 #

在任务的overrideParameters中，用转义后的JSON字符串完整替换整个containers数组：

- task: AzureResourceManagerTemplateDeployment@3
  inputs:
    azureResourceManagerConnection: '你的ARM服务连接'
    resourceGroupName: '目标资源组'
    location: '资源所在区域'
    templateLocation: 'Linked artifact'
    csmFile: 'templates/container-app.json'
    csmParametersFile: 'templates/container-app.parameters.json'
    overrideParameters: >
      --containers "[{\"name\":\"new-app-name\",\"image\":\"your-acr.azurecr.io/custom-image:v1\"}]"

注意：YAML中双引号需要用\"转义，也可以用单引号包裹整个数组字符串来避免转义。

经典编辑器写法 #

在可视化界面的「Override template parameters」输入框中直接填写：

--containers [{"name":"new-app-name","image":"your-acr.azurecr.io/custom-image:v1"}]

方案2：先修改参数文件再部署 #

如果仅需修改现有数组中某一个对象的属性，不想重新写整个数组，可以先通过PowerShell任务修改参数文件，再执行部署：

# 读取参数文件
$paramFile = "./templates/container-app.parameters.json"
$params = Get-Content $paramFile | ConvertFrom-Json

# 修改第一个容器的name和image（索引从0开始）
$params.parameters.containers.value[0].name = "updated-app"
$params.parameters.containers.value[0].image = "your-acr.azurecr.io/custom-image:v2"

# 保存修改后的参数文件
$params | ConvertTo-Json -Depth 10 | Set-Content $paramFile

之后执行AzureResourceManagerTemplateDeployment@3任务时，无需在overrideParameters中指定containers参数，直接使用修改后的参数文件即可。

重要注意事项 #

• ARM模板的参数覆盖是完全替换，不是部分更新，所以传递数组时必须写出所有元素，不能只写要修改的对象
• 确保JSON格式正确，转义符符合当前环境（YAML/PowerShell/经典编辑器）的要求
• 模板中需正确引用参数，比如在容器应用配置中使用[parameters('containers')]来绑定数组

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