Jenkins调用PowerShell：传递含美元符的参数需转义吗？

这个问题的核心原因很明确：Groovy（Jenkins流水线使用的语言）的双引号字符串会自动把$当作变量标识符解析。当你的密码里包含$时，Groovy会把$后面的内容当作Groovy变量处理，如果这个变量不存在，就会被替换为空字符串，导致传递到PowerShell的密码只剩下$之前的部分。

下面是几种可靠的解决方案，按推荐程度排序：

方案1：通过环境变量传递凭据（最安全，优先推荐） #

避免在命令行参数中直接传递密码（哪怕是通过withCredentials获取的，也可能在日志中暴露片段），而是把凭据存入环境变量，让PowerShell脚本从环境变量中读取：

Jenkins流水线代码示例： #

withCredentials([usernamePassword(
    credentialsId: '你的SQL凭据ID',
    usernameVariable: 'SQL_USER',
    passwordVariable: 'SQL_PASS'
)]) {
    powershell(
        script: '''
            param ([string]$server='ad1hfddbst930\\shared')
            # 直接从环境变量读取，无需担心特殊字符解析
            $jkuser = $env:SQL_USER
            $jkpass = $env:SQL_PASS
            
            # 执行你的脚本逻辑
            ./Set-CheckmarxTeams -server $server -jkuser $jkuser -jkpass $jkpass
        '''
    )
}

环境变量会完整保留密码中的所有特殊字符，PowerShell读取时不会有解析问题，同时也避免了密码出现在命令行日志中。

方案2：转义密码中的$符号 #

如果坚持要通过命令行参数传递，需要在Groovy中把密码里的$转义为\$，这样Groovy生成的字符串中$会被当作字面量传递给PowerShell：

Jenkins流水线代码示例： #

withCredentials([usernamePassword(
    credentialsId: '你的SQL凭据ID',
    usernameVariable: 'sqluser',
    passwordVariable: 'sqlpass'
)]) {
    // 转义密码中的$为\$，同时转义单引号避免命令字符串意外闭合
    def escapedPassword = sqlpass.replace('$', '\\$').replace("'", "\\'")
    def psCmd = "./Set-CheckmarxTeams -server ${server} -jkuser $sqluser -jkpass '$escapedPassword'"
    
    powershell(script: psCmd)
}

给密码加上单引号是为了让PowerShell把整个字符串当作一个参数，避免空格或其他特殊字符导致参数拆分。

方案3：使用Groovy单引号字符串拼接 #

Groovy的单引号字符串不会解析$变量，所以可以用单引号拼接命令，同时插入Groovy变量：

Jenkins流水线代码示例： #

withCredentials([usernamePassword(
    credentialsId: '你的SQL凭据ID',
    usernameVariable: 'sqluser',
    passwordVariable: 'sqlpass'
)]) {
    def psCmd = './Set-CheckmarxTeams -server ' + server + ' -jkuser ' + sqluser + ' -jkpass "' + sqlpass.replace('"', '\\"') + '"'
    
    powershell(script: psCmd)
}

这里用双引号包裹密码，同时转义密码中可能存在的双引号，确保PowerShell能正确识别完整的密码字符串。

额外提示 #

• 永远不要在Jenkins日志中输出密码，哪怕是调试用的Write-Host $jkpass，建议换成Write-Host "密码长度：$($jkpass.Length)"来验证是否正确接收。
• 如果你的PowerShell脚本需要处理更多特殊字符（比如&、|等），环境变量传递的方式依然是最稳妥的选择。

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