如何用PowerShell合并ARM模板参数文件并覆盖重复参数

针对PowerShell中New-AzResourceGroupDeployment仅支持单个参数文件的限制，以下提供两种实用的合并方案，实现覆盖文件参数优先、默认参数保留的需求：

方案1：生成合并后的参数JSON文件 #

适合需要留存合并结果文件的场景，步骤清晰可追溯：

# 读取基础参数文件与覆盖参数文件
$commonParams = Get-Content -Path "./common.parameters.json" | ConvertFrom-Json
$devParams = Get-Content -Path "./development.parameters.json" | ConvertFrom-Json

# 将基础参数转换为哈希表，便于键值操作
$mergedParamsHash = $commonParams.parameters | ConvertTo-Hashtable -AsHashtable

# 遍历覆盖参数，替换/新增键值对
foreach ($paramKey in $devParams.parameters.PSObject.Properties.Name) {
    $mergedParamsHash[$paramKey] = $devParams.parameters.$paramKey
}

# 重构标准ARM参数文件结构
$mergedParamFile = [PSCustomObject]@{
    '$schema'       = $commonParams.'$schema'
    contentVersion  = $commonParams.contentVersion
    parameters      = $mergedParamsHash
}

# 导出为UTF-8编码的JSON文件
$mergedParamFile | ConvertTo-Json -Depth 10 | Out-File "./merged.parameters.json" -Encoding utf8

方案2：直接生成哈希表用于部署 #

无需生成中间文件，直接将合并后的参数传入部署命令，提升效率：

# 读取并转换参数为哈希表
$commonParamHash = (Get-Content "./common.parameters.json" | ConvertFrom-Json).parameters | ConvertTo-Hashtable -AsHashtable
$devParamHash = (Get-Content "./development.parameters.json" | ConvertFrom-Json).parameters | ConvertTo-Hashtable -AsHashtable

# 合并哈希表：覆盖参数优先
$finalDeploymentParams = $commonParamHash.Clone()
$devParamHash.GetEnumerator() | ForEach-Object {
    $finalDeploymentParams[$_.Key] = $_.Value
}

# 直接执行部署
New-AzResourceGroupDeployment -ResourceGroupName "你的资源组名称" `
                              -TemplateFile "./main.bicep" `
                              -TemplateParameterObject $finalDeploymentParams

关键注意事项 #

1. PowerShell版本兼容：
   • ConvertTo-Hashtable -AsHashtable是PowerShell 7+的内置功能，若使用PowerShell 5.x，需手动实现转换函数：

     function ConvertTo-Hashtable {
         param([Parameter(ValueFromPipeline)]$InputObject)
         process {
             if ($null -eq $InputObject) { return $null }
             if ($InputObject -is [System.Collections.IEnumerable] -and $InputObject -isnot [string]) {
                 $collection = @()
                 foreach ($item in $InputObject) { $collection += ConvertTo-Hashtable $item }
                 return $collection
             }
             elseif ($InputObject -is [PSObject]) {
                 $hash = @{}
                 foreach ($prop in $InputObject.PSObject.Properties) {
                     $hash[$prop.Name] = ConvertTo-Hashtable $prop.Value
                 }
                 return $hash
             }
             else {
                 return $InputObject
             }
         }
     }
     

2. 嵌套参数处理：
   上述代码会直接覆盖整个嵌套对象参数，如果需要深度合并嵌套属性（比如仅覆盖对象中的某个子属性），需修改循环逻辑实现递归合并。
3. 元数据一致性：
   合并时默认沿用基础文件的$schema和contentVersion，若覆盖文件有不同配置，可手动调整赋值逻辑。

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