Azure DevOps管道中如何替换XML配置文件多个属性值

操作步骤 #

• 首先在Azure DevOps中创建/编辑目标变量组，添加3个变量分别对应fromAddress、toAddress、subjectLineStarter的替换目标值，变量名可自定义，例如命名为EntLib_FromAddress、EntLib_ToAddress、EntLib_SubjectStarter，涉及敏感信息可勾选「机密」选项避免日志明文输出。
• 在Pipeline定义中引用该变量组，YAML示例如下：

trigger:
- main
pool:
  vmImage: windows-latest # 使用Windows代理运行PowerShell对XML文件兼容性最好
variables:
- group: 你提前创建的变量组名称 # 关联存储配置值的变量组

steps:
# 此处放置代码拉取、前置构建等原有步骤

• 添加PowerShell任务执行XML属性替换，这个方案不依赖第三方插件，可控性最高，任务内联脚本参考如下：

# 替换为entlib.config在代码仓库中的实际相对路径
$configFullPath = Join-Path $(Build.SourcesDirectory) "config/entlib.config"
[xml]$xmlContent = Get-Content $configFullPath -Encoding UTF8

# 定位到名称为Email TraceListener的监听器节点
$targetNode = $xmlContent.loggingConfiguration.listeners.add | Where-Object { $_.name -eq "Email TraceListener" }

# 读取变量组传入的值替换目标属性
$targetNode.toAddress = "$(EntLib_ToAddress)"
$targetNode.fromAddress = "$(EntLib_FromAddress)"
$targetNode.subjectLineStarter = "$(EntLib_SubjectStarter)"

# 以无BOM的UTF-8编码保存文件，避免.NET框架读取配置时出现编码异常
$utf8NoBom = New-Object System.Text.UTF8Encoding($false)
$saveWriter = New-Object System.IO.StreamWriter($configFullPath, $false, $utf8NoBom)
$xmlContent.Save($saveWriter)
$saveWriter.Close()

• 后续构建、部署步骤直接读取该配置文件，即可拿到替换完成的属性值。

完全支持，没有XML结构或可替换属性数量的限制：

• 上述PowerShell方案适配性极强，不管XML嵌套层级多深、是否带自定义命名空间，你只需要按照节点层级、属性筛选规则定位到所有需要修改的目标节点，循环给对应属性赋值为变量组传入的变量值即可，一次性替换十几个甚至几十个属性都可以正常运行。
• 如果不想编写脚本，也可以使用官方内置的File Transform任务，通过编写XPath匹配规则实现批量替换，但遇到结构特殊的自定义配置块时，脚本方案的调试成本更低，不容易出现规则匹配失效的问题。

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