如何通过PowerShell访问修改.NET框架根web.config配置文件

路径 C:\Windows\Microsoft.NET\Framework64\v4.0.30319\Config\web.config 是64位.NET Framework 4.x站点的全局根配置文件，在此处写入的规则会默认被所有运行在64位4.x版本应用池下的站点、子应用、虚拟目录继承。若需覆盖32位站点，需同步修改 C:\Windows\Microsoft.NET\Framework\v4.0.30319\Config\web.config 路径下的同名文件。

不存在只能通过Get-ChildItem读取XML修改的限制，以下三种方案均经过生产环境验证，按优先级排序：

方案1：PowerShell DSC xWebConfigProperty 实现（幂等推荐） #

该资源直接调用IIS配置API操作，无需手动处理XML结构、编码、节点创建逻辑，支持幂等校验，符合基础设施即代码要求。

• 前置依赖：已安装xWebAdministration DSC模块
• 示例配置（以禁用全局Session、全局压缩为例）：

Configuration GlobalDotNetWebConfigHardening {
    Import-DscResource -ModuleName xWebAdministration
    Node localhost {
        # 全局禁用SessionState，禁止下级站点覆盖
        xWebConfigProperty GlobalSessionOff {
            WebsitePath        = 'MACHINE/WEBROOT'
            Filter             = 'system.web/sessionState'
            PropertyName       = 'mode'
            Value              = 'Off'
            Ensure             = 'Present'
            ConfigurationPath  = 'C:\Windows\Microsoft.NET\Framework64\v4.0.30319\Config\web.config'
            Metadata           = @{overrideMode = 'Deny'}
        }

        # 全局禁用静态压缩
        xWebConfigProperty GlobalStaticCompressionOff {
            WebsitePath        = 'MACHINE/WEBROOT'
            Filter             = 'system.webServer/urlCompression'
            PropertyName       = 'doStaticCompression'
            Value              = 'false'
            Ensure             = 'Present'
            ConfigurationPath  = 'C:\Windows\Microsoft.NET\Framework64\v4.0.30319\Config\web.config'
            Metadata           = @{overrideMode = 'Deny'}
        }

        # 全局禁用动态压缩
        xWebConfigProperty GlobalDynamicCompressionOff {
            WebsitePath        = 'MACHINE/WEBROOT'
            Filter             = 'system.webServer/urlCompression'
            PropertyName       = 'doDynamicCompression'
            Value              = 'false'
            Ensure             = 'Present'
            ConfigurationPath  = 'C:\Windows\Microsoft.NET\Framework64\v4.0.30319\Config\web.config'
            Metadata           = @{overrideMode = 'Deny'}
        }
    }
}

方案2：旧版WebAdministration模块原生实现 #

旧版WebAdministration模块自带的Set-WebConfiguration cmdlet原生支持操作全局根配置，无需手动解析XML，兼容性覆盖Windows Server 2008 R2及以上版本。

• 操作示例：

# 加载模块
Import-Module WebAdministration -Force

# 操作前强制备份原配置
$configPath = "C:\Windows\Microsoft.NET\Framework64\v4.0.30319\Config\web.config"
Copy-Item $configPath "$configPath.bak_$(Get-Date -Format 'yyyyMMddHHmmss')" -Force

# 全局禁用SessionState，禁止下级覆盖
Set-WebConfiguration -PSPath 'MACHINE/WEBROOT' `
    -Filter 'system.web/sessionState' `
    -Value @{mode = 'Off'} `
    -Metadata @{overrideMode = 'Deny'}

# 全局禁用静态、动态压缩，禁止下级覆盖
Set-WebConfiguration -PSPath 'MACHINE/WEBROOT' `
    -Filter 'system.webServer/urlCompression' `
    -Value @{doStaticCompression = 'false'; doDynamicCompression = 'false'} `
    -Metadata @{overrideMode = 'Deny'}

# 验证配置是否写入成功
Get-WebConfiguration -PSPath 'MACHINE/WEBROOT' -Filter 'system.web/sessionState' | Select-Object mode
Get-WebConfiguration -PSPath 'MACHINE/WEBROOT' -Filter 'system.webServer/urlCompression' | Select-Object doStaticCompression, doDynamicCompression

方案3：原生PowerShell加载XML修改（兜底方案） #

仅当前两种方案因环境极端限制无法使用时采用，需手动处理节点存在性、XML命名空间、文件编码问题，操作前必须备份。

$configPath = "C:\Windows\Microsoft.NET\Framework64\v4.0.30319\Config\web.config"
# 备份
Copy-Item $configPath "$configPath.bak_$(Get-Date -Format 'yyyyMMddHHmmss')" -Force
# 按UTF8无BOM编码加载XML
[xml]$webConfig = Get-Content $configPath -Encoding UTF8

# 配置SessionState为关闭
$sessionNode = $webConfig.SelectSingleNode('//system.web/sessionState')
if (-not $sessionNode) {
    $sessionNode = $webConfig.CreateElement('sessionState')
    $webConfig.SelectSingleNode('//system.web').AppendChild($sessionNode)
}
$sessionNode.SetAttribute('mode', 'Off')
$sessionNode.SetAttribute('allowOverride', 'false')

# 配置压缩为关闭
$wsNode = $webConfig.SelectSingleNode('//system.webServer')
if (-not $wsNode) {
    $wsNode = $webConfig.CreateElement('system.webServer')
    $webConfig.configuration.AppendChild($wsNode)
}
$compressionNode = $wsNode.SelectSingleNode('urlCompression')
if (-not $compressionNode) {
    $compressionNode = $webConfig.CreateElement('urlCompression')
    $wsNode.AppendChild($compressionNode)
}
$compressionNode.SetAttribute('doStaticCompression', 'false')
$compressionNode.SetAttribute('doDynamicCompression', 'false')
$compressionNode.SetAttribute('allowOverride', 'false')

# 按原编码格式保存
$utf8NoBom = New-Object System.Text.UTF8Encoding($false)
$writer = New-Object System.IO.StreamWriter($configPath, $false, $utf8NoBom)
$webConfig.Save($writer)
$writer.Close()

操作注意事项 #

• 所有配置修改完成后执行iisreset重启IIS服务，确保所有应用池加载最新配置
• 配置overrideMode='Deny'或allowOverride='false'属性后，下级站点无法在自身web.config中覆盖对应规则，实现强制级联生效；若需允许下级站点按需覆盖，移除该属性即可
• 禁止直接在生产环境无备份操作，配置格式错误会导致服务器上所有对应版本.NET站点无法访问
• 基于IIS API的前两种方案不会引入XML编码、格式损坏问题，稳定性远高于手动修改XML的方案

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