如何向Bicep/ARM部署正确传入XML格式字符串参数

Bicep文件中定义了如下安全参数：

@secure()
param securityToken string

参数值为从环境变量传入的XML格式字符串，不从文件读取。在YAML流水线中配置该参数时先后遇到两类报错：

1. 最初执行的Azure CLI命令：

az deployment sub create --template-file main.bicep --parameters securityToken='<xml>'

返回错误：

< was unexpected at this time.

2. 尝试传入HTML转义字符后的命令：

az deployment sub create --template-file main.bicep --parameters securityToken='<xml>'

返回错误：

The system cannot find the file specified.

需要找到正确传入XML格式字符串参数的方法。

根因说明 #

• 第一个报错是执行环境的shell（Windows Cmd/PowerShell/Bash）将<识别为输入重定向操作符，命令在传入Azure CLI之前就被shell解析失败。
• 第二个报错是Azure CLI的--parameters参数默认解析规则导致：当传入的key=value格式值以<、@开头时，CLI会默认将该值识别为文件路径，尝试读取本地文件，自然触发文件不存在错误。
• HTML转义是完全错误的处理方向，Bicep/ARM不会自动解析HTML实体，转义后传入的是转义后的普通字符串，不是原始XML内容。

推荐实现（全环境兼容） #

放弃key=value的简写传参格式，改用JSON结构传参，从根源规避shell和CLI的特殊字符解析问题，适配所有执行环境和YAML流水线场景：

# 命令行直接执行时，将<完整XML内容>替换为实际值即可
az deployment sub create \
  --template-file main.bicep \
  --parameters "{\"securityToken\":{\"value\":\"<完整XML内容>\"}}"

如果是PowerShell环境执行，优先通过变量构造JSON参数，避免手动转义出错：

$xmlToken = "<完整XML内容>"
$deployParams = @{
  securityToken = @{
    value = $xmlToken
  }
} | ConvertTo-Json -Compress

az deployment sub create --template-file main.bicep --parameters $deployParams

流水线适配注意事项 #

• 在YAML流水线中使用上述JSON传参方式时，直接替换XML内容为对应的流水线环境变量即可，不需要额外做HTML/XML转义。
• 由于参数标记了@secure()，传参过程中避免将XML值打印到执行日志，防止敏感信息泄露。
• 不需要将XML内容落地为本地文件再传入，JSON传参完全支持直接传入内存中的字符串值。

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