Azure DevOps中从变量组传递PowerShell对象至ARM模板失败

问题现象 #

在Azure DevOps Pipeline中使用Azure PowerShell任务部署ARM模板创建Web Apps时：

• 直接在YAML脚本内定义PowerShell哈希表$WebAppEnvironmentVariables并传递给-TemplateParameterObject，Web Apps环境变量可正常配置
• 从变量组引用$(VariablesObject1)作为环境变量对象传递时，ARM模板部署成功，但Web Apps的环境变量为空

核心原因 #

Azure DevOps变量组中的所有变量本质都是字符串类型，即使你输入的是PowerShell哈希表格式（如@{Name1 = "Value1"}），也会被当作纯字符串存储。直接在Inline脚本中使用$(VariablesObject1)时，传递的是字符串而非PowerShell哈希表对象，导致ARM模板无法解析为有效的环境变量配置。

解决方案 #

方案1：使用JSON格式定义变量组变量（推荐，安全可控） #

1. 在变量组中配置变量：将VariablesObject1的值设置为JSON格式字符串：

   {"Name1": "Value1", "Name2": "Value2"}
   

2. 修改Pipeline脚本：在PowerShell中把JSON字符串转换为哈希表后传递：

   - checkout: self  
   - task: AzurePowerShell@5
     displayName: "Create Web Apps"
     inputs:
       azureSubscription: 'XXX'
       ScriptType: 'InlineScript'
       azurePowerShellVersion: 'LatestVersion'
       pwsh: true
       Inline: |
         # Define variables
         $ARMTemplateFile = "$(Build.Repository.LocalPath)\ARM-Templates\WebApps.json"
         $ResourceGroupName = "XXX"
         # 将JSON字符串转换为PowerShell哈希表
         $envVars = $(VariablesObject1) | ConvertFrom-Json -AsHashtable
         # 部署ARM模板
         New-AzResourceGroupDeployment `
              -ResourceGroupName $ResourceGroupName `
              -TemplateFile $ARMTemplateFile `
              -TemplateParameterObject @{ 
                 "EnvironmentVariables" = $envVars
              }
   

方案2：使用Invoke-Expression解析哈希表字符串（需注意安全风险） #

如果变量组中已经用PowerShell哈希表格式定义了变量，可通过Invoke-Expression将字符串转换为哈希表，但仅在变量内容完全可控时使用（避免注入风险）：

1. 变量组中变量值：

   @{Name1 = "Value1"; Name2 = "Value2"}
   

2. 修改Pipeline脚本：

   - checkout: self  
   - task: AzurePowerShell@5
     displayName: "Create Web Apps"
     inputs:
       azureSubscription: 'XXX'
       ScriptType: 'InlineScript'
       azurePowerShellVersion: 'LatestVersion'
       pwsh: true
       Inline: |
         # Define variables
         $ARMTemplateFile = "$(Build.Repository.LocalPath)\ARM-Templates\WebApps.json"
         $ResourceGroupName = "XXX"
         # 将字符串解析为PowerShell哈希表
         $envVars = Invoke-Expression $(VariablesObject1)
         # 部署ARM模板
         New-AzResourceGroupDeployment `
              -ResourceGroupName $ResourceGroupName `
              -TemplateFile $ARMTemplateFile `
              -TemplateParameterObject @{ 
                 "EnvironmentVariables" = $envVars
              }
   

注意事项 #

• 优先选择方案1，JSON格式更安全且跨语言兼容，避免Invoke-Expression带来的代码注入风险
• 确保ARM模板中的EnvironmentVariables参数类型为object或符合Web Apps环境变量的预期结构

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