如何将PowerShell对象数组传入ARM模板？类型不匹配问题求助

我需要通过ARM模板为已部署的Cosmos DB创建防火墙规则，规则参数来自PowerShell脚本输出的对象数组，但遇到参数类型错误：ARM模板期望Array类型，却始终识别为String类型。

场景复现 #

1. PowerShell脚本生成对象数组并转为JSON输出：

# 初始化数组
$ipObjects = @()

# 填充数组逻辑（示例）
$ipPrefixObject = @{name="ip1"; IpAddress="1.2.3.4"}
$ipObjects += $ipPrefixObject
$ipObjects += @{name="ip2"; IpAddress="6.6.6.6"}
$ipObjects += @{name="ip3"; IpAddress="4.4.4.4"}

# 转为JSON并设置流水线输出变量
$jsonOutput = $ipObjects | ConvertTo-Json -Compress
Write-Output "##vso[task.setvariable variable=outputArray;isOutput=true]$jsonOutput"

2. ARM模板定义数组参数：

"firewallRules": {
    "type": "array",
    "defaultValue": [],
    "metadata": {
        "description": "Array of firewall rules"
    }
},

3. Azure DevOps流水线部署任务传递参数：

overrideParameters:    -firewallRules "$(outputArray)"

此时报错：

the provided value for the template parameter 'firewallRules' is not valid. Expected a value of type 'Array', but received a value of type 'String'.

直接传递PowerShell对象数组（不转JSON）也会报同样错误。

问题原因 #

Azure DevOps流水线变量系统会强制将所有输出值转为字符串类型，无论原始类型是数组还是JSON对象。当你通过$(outputArray)引用变量时，ARM部署任务会直接把这个字符串值传入，而不会自动解析为数组。

解决方法 #

方法1：使用ARM参数文件传递（推荐）

通过PowerShell生成标准的ARM参数文件，将数组写入文件后，在部署任务中引用该文件：

1. 修改PowerShell脚本，生成参数文件：

$ipObjects = @()
# 填充数组逻辑...

# 构建ARM参数文件结构
$paramFileContent = @{
    "$schema" = "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#"
    contentVersion = "1.0.0.0"
    parameters = @{
        firewallRules = @{
            value = $ipObjects
        }
    }
}

# 将内容写入参数文件，保存到工件目录
$paramFileContent | ConvertTo-Json -Depth 10 | Out-File -FilePath "$(Build.ArtifactStagingDirectory)\cosmosdb-firewall-params.json" -Encoding utf8

2. 在Azure DevOps的ARM部署任务中，选择使用参数文件，并指定生成的cosmosdb-firewall-params.json路径。

方法2：直接在overrideParameters中解析JSON字符串

如果必须用overrideParameters传递，需要确保ARM能正确解析字符串为数组：

1. 修正PowerShell输出：只输出纯JSON，不要额外内容（比如去掉$jsonOutput.GetType()的输出）
2. 在部署任务的overrideParameters中，去掉JSON字符串的外层引号，并用@()包裹（强制ARM解析为数组）：

overrideParameters: -firewallRules @($(outputArray))

如果是YAML流水线，用单引号包裹避免转义问题：

overrideParameters: '-firewallRules $(outputArray)'

关键注意点 #

• PowerShell输出变量时，确保只输出纯JSON内容，不要包含多余的日志或类型信息，否则会破坏JSON格式。
• ARM模板中firewallRules参数只需定义为type: array，无需额外定义元素结构，ARM会自动匹配传入的对象数组。

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