如何使用PowerShell定位并修改XML配置文件指定节点的值？

需求说明 #

需要将XML文件中以下节点：

<Value UseFunction="false" Value="Production">

修改为：

<Value UseFunction="false" Value="Training">

目标XML片段如下：

<?xml version="1.0" encoding="utf-8"?>
<ParametersInfo xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <ParameterGroup TestRequired="false" Name="CommonSystemConfig" xmlns="http://www....">
        <Parameter Name="DefaultEnvironmentId" Text="DefaultEnvironmentId" ParameterType="List">
          <Value UseFunction="false" Value="Production">
            <ValueList>
              <string>Production</string>
              <string>Training</string>
              <string>Staging</string>
            </ValueList>
          </Value>
          <AutoSetValue UseFunction="false" Value="Production" />
          <IsUppercaseInput>false</IsUppercaseInput>
          <Description>The value can only be "Production" or "Training" or "Staging"</Description>
          <IsSetSuccessfully>true</IsSetSuccessfully>
          <Visible Type="0" Value="True" />
          <IsReadOnly Type="0" Value="False" />
          <AllowEmpty Type="0" Value="True" />
        </Parameter>
</ParametersInfo>

问题根源 #

之前使用的脚本无法生效，核心原因是XML中的ParameterGroup节点带有默认命名空间xmlns="http://www...."，而原XPath表达式没有处理命名空间，导致无法匹配到目标节点。

原脚本片段：

# load xml document from disk
$xmlFilePath = 'c:\Userdata\ParamBkUp.xml'
$rootedPath = Convert-Path $xmlFilePath

$xmlDoc = [xml]::new()
$xmlDoc.Load($rootedPath)

$nodesToChange = $xmlDoc |Select-Xml -XPath '//ParametersInfo/ParameterGroup[@Name="CommonSystemConfig"]/Parameter[@Name="DefaultEnvironmentId"]/Value[@Value="Production"]'

foreach($result in $nodesToChange){
    # update the Value attribute on the discovered `Value` nodes
    $result.Node.SetAttribute('Value', 'SomeOtherEnvironmentName')
}

# save changes to disk
$xmlDoc.Save($rootedPath)

修正后的脚本 #

需要先注册XML命名空间，再调整XPath表达式来匹配带命名空间的节点。如果需要同步修改AutoSetValue的Value属性，也可以一并处理：

# 定义XML文件路径
$xmlFilePath = 'c:\Userdata\ParamBkUp.xml'
$rootedPath = Convert-Path $xmlFilePath

# 加载XML文档
$xmlDoc = [xml]::new()
$xmlDoc.Load($rootedPath)

# 注册默认命名空间（替换成XML中ParameterGroup节点实际的xmlns值）
$namespaceManager = [System.Xml.XmlNamespaceManager]::new($xmlDoc.NameTable)
$namespaceManager.AddNamespace("ns", "http://www....")

# 1. 修改<Value>节点的Value属性
$valueNodes = $xmlDoc | Select-Xml -XPath '//ParametersInfo/ns:ParameterGroup[@Name="CommonSystemConfig"]/ns:Parameter[@Name="DefaultEnvironmentId"]/ns:Value[@Value="Production"]' -Namespace $namespaceManager
foreach($node in $valueNodes){
    $node.Node.SetAttribute('Value', 'Training')
}

# 2. 可选：同步修改<AutoSetValue>节点的Value属性
$autoSetNodes = $xmlDoc | Select-Xml -XPath '//ParametersInfo/ns:ParameterGroup[@Name="CommonSystemConfig"]/ns:Parameter[@Name="DefaultEnvironmentId"]/ns:AutoSetValue[@Value="Production"]' -Namespace $namespaceManager
foreach($node in $autoSetNodes){
    $node.Node.SetAttribute('Value', 'Training')
}

# 保存修改后的XML文件
$xmlDoc.Save($rootedPath)

关键说明 #

• 必须将AddNamespace方法中的第二个参数替换为XML文件ParameterGroup节点实际的xmlns值（原XML中是http://www....，需改成真实的命名空间URL）。
• XPath表达式中，所有属于该默认命名空间的节点（ParameterGroup、Parameter、Value、AutoSetValue）都需要加上ns:前缀。

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