Bicep字符串参数含连续<>字符致部署报错的解决方案咨询

问题场景 #

当通过PowerShell传递包含连续<、>（任意顺序）的变量作为Bicep部署参数时，会触发类似< was unexpected at this time的报错。手动给参数值加引号能临时解决问题，但实际场景中参数值来自变量，无法预知所有触发报错的字符组合，针对特定组合的替换方案也无法覆盖所有情况（比如>>、>>>这类连续符号）。

通用解决方法 #

方法1：PowerShell中双引号包裹参数值并转义 #

在PowerShell里，用双引号把整个参数键值对包裹，同时用反引号`转义参数值内部的双引号，确保PowerShell不会解析<、>这类重定向字符：

# 假设$variable是包含特殊字符的变量
az deployment sub create --name test --location eastus --template-file .\BicepTest.bicep --parameters "escape_str=`"$variable`""

方法2：使用参数文件传递参数 #

这是最可靠的方案，完全避开命令行的字符解析问题。创建一个JSON参数文件（比如params.json）：

{
  "escape_str": {
    "value": ""
  }
}

部署时直接引用该文件：

az deployment sub create --name test --location eastus --template-file .\BicepTest.bicep --parameters @params.json

如果需要动态填充变量，可以用PowerShell修改JSON文件内容，或者生成临时参数文件。

方法3：对变量进行通用转义处理 #

把变量值用单引号包裹，同时将变量内部的单引号替换为两个单引号（PowerShell中单引号的转义方式），确保所有特殊字符都被当作普通字符串传递：

$escapedValue = "'$($variable -replace "'", "''")'"
az deployment sub create --name test --location eastus --template-file .\BicepTest.bicep --parameters escape_str=$escapedValue

补充说明 #

命令行中<、>属于系统重定向字符，PowerShell会优先解析这些字符，而非当作字符串的一部分。上述方案的核心是让PowerShell将这些特殊字符视为普通字符串内容，避免触发系统级的解析逻辑。

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