PowerShell Replace匹配异常及appsettings.json配置修改问题

问题原因分析 #

1. 字符串替换残留字符：用-Replace直接处理JSON文本时，容易因匹配边界不精确（比如原行的引号、空格、特殊字符）导致残留内容，比如你遇到的末尾*"，本质是没有完全覆盖原字符串的所有部分。
2. Add-Member空值报错：未将读取的JSON文本转换为PowerShell对象（缺少ConvertFrom-Json），或文件读取失败导致对象为空，Add-Member无法对非对象类型操作。
3. 数组配置困惑：不清楚PowerShell数组与JSON数组的转换规则，直接用字符串拼接会破坏JSON结构。

正确实现方法 #

处理JSON文件应该用PowerShell的结构化对象操作，而非文本替换，步骤如下：

1. 读取并解析JSON为PowerShell对象 #

$appSettingsPath = ".\appsettings.json"
# -Raw参数确保读取完整的JSON文本，避免换行拆分
$appSettings = Get-Content $appSettingsPath -Raw | ConvertFrom-Json

2. 修改AllowedHosts（按需调整） #

直接对对象属性赋值，无需字符串替换：

$appSettings.AllowedHosts = "*" # 可替换为指定域名，如"yourdomain.com"

3. 添加Kestrel配置（含数组类型的SslProtocols） #

先创建Kestrel的配置对象，PowerShell数组用@()定义，会自动转换为JSON数组：

# 构建Kestrel的端点配置
$kestrelEndpoints = [PSCustomObject]@{
    Http = [PSCustomObject]@{
        Url = "http://*:5000"
    }
    Https = [PSCustomObject]@{
        Url = "https://*:5001"
        SslProtocols = @("Tls12", "Tls13")
    }
}

# 将Kestrel配置添加到appsettings对象，-Force参数覆盖已存在的Kestrel节点
$appSettings | Add-Member -MemberType NoteProperty -Name "Kestrel" -Value ([PSCustomObject]@{Endpoints = $kestrelEndpoints}) -Force

4. 写回JSON文件 #

使用ConvertTo-Json转换回JSON文本，-Depth参数确保嵌套结构不被截断（默认深度为2，需设为大于实际嵌套层数的值）：

$appSettings | ConvertTo-Json -Depth 10 | Set-Content $appSettingsPath -Encoding UTF8

完整示例脚本 #

$appSettingsPath = ".\appsettings.json"

# 读取解析JSON
$appSettings = Get-Content $appSettingsPath -Raw | ConvertFrom-Json

# 修改AllowedHosts
$appSettings.AllowedHosts = "*"

# 构建Kestrel配置
$kestrelEndpoints = [PSCustomObject]@{
    Http = [PSCustomObject]@{Url = "http://*:5000"}
    Https = [PSCustomObject]@{
        Url = "https://*:5001"
        SslProtocols = @("Tls12", "Tls13")
    }
}

$appSettings | Add-Member -MemberType NoteProperty -Name "Kestrel" -Value ([PSCustomObject]@{Endpoints = $kestrelEndpoints}) -Force

# 写回文件
$appSettings | ConvertTo-Json -Depth 10 | Set-Content $appSettingsPath -Encoding UTF8

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