如何通过PowerShell替换JSON参数文件中变量的数值？

原脚本的核心问题 #

1. 变量解析错误：-replace中用单引号包裹$OldValue和$NewValue，PowerShell会把它们当作字面量字符串，不会解析为你定义的变量。
2. 未正确处理JSON结构：直接对字符串做替换容易破坏JSON格式（比如引号、嵌套结构），且原脚本没有涉及JSON文件的读取和写入逻辑，只处理了单个$Value变量，无法作用于实际文件。
3. 逻辑不完整：else分支仅输出旧值，没有保留原数据的逻辑。

正确实现方案 #

处理JSON文件的标准做法是先将其转换为PowerShell对象，修改对象属性后再转回JSON写入文件，这样能避免格式破坏，操作更精准。

完整示例脚本

假设你的JSON文件结构如下（以config.json为例）：

{
  "AppSettings": {
    "ApiKey": "xyz_old_key",
    "Timeout": 30
  }
}

要替换ApiKey中包含xyz的部分，将old_key改为new_key，脚本如下：

# 定义路径和变量
$jsonFilePath = "./config.json"
$targetProperty = "ApiKey"
$oldString = "old_key"
$newString = "new_key"

# 读取JSON并转为PowerShell对象
$jsonObject = Get-Content -Path $jsonFilePath -Raw | ConvertFrom-Json

# 定位目标属性并判断修改
if ($jsonObject.AppSettings.$targetProperty -like "*xyz*") {
    # 替换属性内的指定字符串
    $jsonObject.AppSettings.$targetProperty = $jsonObject.AppSettings.$targetProperty -replace $oldString, $newString
    # 如果需要直接替换整个属性值，用：$jsonObject.AppSettings.$targetProperty = $newString
}

# 将修改后的对象转回JSON并写入文件（-Depth 避免嵌套结构截断）
$jsonObject | ConvertTo-Json -Depth 10 | Set-Content -Path $jsonFilePath -Encoding UTF8

关键说明

• 对象化处理：ConvertFrom-Json把JSON文本转为可操作的PowerShell对象，直接修改属性比字符串替换更安全，不会破坏JSON语法。
• 变量解析：-replace的参数直接使用变量名（不用单引号），PowerShell会自动解析变量值；如果变量包含特殊正则字符，可先用[regex]::Escape($oldString)转义。
• 深度控制：ConvertTo-Json默认深度为2，若JSON有多层嵌套，必须指定-Depth参数防止数据截断。
• 文件写入：用Set-Content覆盖原文件，确保修改持久化。

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