如何在PowerShell脚本中使用特殊字符？Jenkins参数更新配置文件遇阻

问题根源 #

你的批处理脚本开启了enabledelayedexpansion，而!在cmd的延迟变量扩展模式下属于特殊字符，会被当作延迟变量的标记解析，导致Jenkins传入的带!的密码无法正确传递给PowerShell，最终写入配置文件的值出现错误。另外，cmd和PowerShell之间的参数转义逻辑复杂，容易引发这类特殊字符处理问题。

解决方案1：改用纯PowerShell脚本（推荐） #

直接用PowerShell处理Jenkins参数和配置文件，规避cmd的转义坑，步骤如下：

1. 创建PowerShell脚本（命名为Update-Config.ps1）：

# 配置文件路径，自动基于当前工作目录拼接
$propertiesFile = Join-Path $PWD "src\main\resources\config.properties"

# 读取完整配置文件内容
$content = Get-Content $propertiesFile -Raw

# 替换USERNAME，直接使用Jenkins传入的环境变量
$content = $content -replace 'USERNAME=(.*)', "USERNAME=$env:Username"

# 替换PASSWORD，无需额外转义，直接调用Jenkins环境变量
$content = $content -replace 'PASSWORD=(.*)', "PASSWORD=$env:Password"

# 将修改后的内容写回配置文件
Set-Content $propertiesFile -Value $content

# 可选：打印修改后的内容用于验证
Get-Content $propertiesFile

# 执行Maven测试命令
& mvn clean test -Dtest=ScriptTest

2. Jenkins任务配置：

• 确保已安装PowerShell插件
• 构建步骤选择「Execute Windows PowerShell」，调用脚本：.\Update-Config.ps1
• Jenkins的Username和Password参数会自动作为环境变量传递给PowerShell，无需手动处理转义。

解决方案2：修改原批处理脚本（保留cmd环境） #

如果必须使用批处理，需要关闭延迟变量扩展，避免!被错误解析：

@echo off
:: 关闭延迟变量扩展，防止!被cmd当作特殊字符处理
setlocal disabledelayedexpansion

set "PROPERTIES_FILE=src\main\resources\config.properties"

:: 直接传递参数到PowerShell，无需额外转义特殊字符
powershell -Command "(Get-Content '%PROPERTIES_FILE%') | ForEach-Object { $_ -replace 'USERNAME=(.*)', 'USERNAME=%Username%' } | Set-Content '%PROPERTIES_FILE%'"
powershell -Command "(Get-Content '%PROPERTIES_FILE%') | ForEach-Object { $_ -replace 'PASSWORD=(.*)', 'PASSWORD=%Password%' } | Set-Content '%PROPERTIES_FILE%'"

:: 打印配置文件内容验证
type "%PROPERTIES_FILE%"

:: 执行Maven命令
mvn clean test -Dtest=ScriptTest

endlocal

额外注意 #

• 若业务确实需要延迟变量扩展，可以局部开启并在处理完特殊字符参数后关闭，但逻辑会更复杂，不推荐。
• Jenkins的密码参数建议使用「Password Parameter」类型，确保参数安全传递，不影响脚本的字符处理逻辑。

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