Jenkins Pipeline字符串参数无法传入PowerShell脚本问题

核心问题原因 #

1. Groovy字符串插值限制：你用单引号'''包裹PowerShell脚本，Groovy不会解析其中的Groovy变量（比如$myParamValue、params.CNAME），导致PowerShell拿到的是空值。
2. 远程脚本块变量隔离：Invoke-Command的ScriptBlock在远程服务器执行，无法直接访问本地Jenkins Pipeline的参数，必须显式传递参数到远程会话。

修正后的Pipeline代码 #

pipeline {
    agent any

    parameters {
        string(name: 'CNAME', description: 'ShortName')
        // string(name: 'HostNameAlias', defaultValue: '.domain.com', description: 'DestinationServer.domain.com')
    }

    environment {
        REMOTE_CRED = credentials('netdomaindns')
    }

    stages {
        stage('Run PowerShell on Remote Server') {
            steps {
                script {
                    def cnameParam = params.CNAME
                    // 用双引号包裹PowerShell脚本，让Groovy先插值变量
                    powershell """
                        Write-Host "Preparing to run PowerShell on remote server..."
                        Write-Host "MyParameters from Jenkins: ${cnameParam}"
                        \$username = "\$env:REMOTE_CRED_USR"
                        \$password = "\$env:REMOTE_CRED_PSW"

                        # Convert password to secure string
                        \$securePassword = ConvertTo-SecureString \$password -AsPlainText -Force
                        \$credential = New-Object System.Management.Automation.PSCredential (\$username, \$securePassword)

                        # Define the remote server name or IP
                        \$remoteServer = "ws-server1.domain.com"

                        # 把本地参数通过-ArgumentList传递到远程脚本块
                        Invoke-Command -ComputerName \$remoteServer -ScriptBlock {
                            param(\$cname)
                            Write-Host "Running on remote server: \$env:COMPUTERNAME"
                            Write-Host "MyParameter from Jenkins: \$cname"
                            # 如果启用HostNameAlias参数，同样需要传递
                            # param(\$cname, \$hostAlias)
                            # Write-Host "HostNameAlias: \$hostAlias"

                            Add-DnsServerResourceRecordCName -Name \$cname -HostNameAlias "替换为实际目标域名" -ComputerName "ws-server1.domain.com" -ZoneName "domain.com"
                        } -Credential \$credential -ArgumentList \$cnameParam
                    """
                }
            }
        }
    }
}

关键修改说明 #

• 替换单引号为双引号：用"""包裹PowerShell脚本，Groovy会先解析其中的${cnameParam}等Groovy变量，把实际参数值注入到脚本中。注意PowerShell自身的变量要加转义符\$，避免被Groovy误解析。
• 显式传递参数到远程脚本：
  1. 在本地定义$cnameParam存储Jenkins参数值
  2. Invoke-Command添加-ArgumentList \$cnameParam把参数传递到远程
  3. 远程ScriptBlock开头用param(\$cname)声明接收参数，之后用\$cname引用
• 修正凭据变量引用：保持$env:REMOTE_CRED_USR和$env:REMOTE_CRED_PSW的转义，确保PowerShell能正确读取环境变量。

额外注意事项 #

如果启用HostNameAlias参数，需要：

1. 取消注释参数定义
2. 在Groovy中定义def hostAliasParam = params.HostNameAlias
3. Invoke-Command的-ArgumentList改为\$cnameParam, \$hostAliasParam
4. 远程ScriptBlock的param改为param(\$cname, \$hostAlias)，并在Add-DnsServerResourceRecordCName中用\$hostAlias作为-HostNameAlias的值

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