如何在Jenkins中将PowerShell命令结果设为同stage可外部调用的Jenkins变量

原来的代码无法完成传值，是三层问题叠加导致的：

• 作用域不匹配：把NAMEUPDATE写在steps块外的语法不符合Jenkins声明式流水线的规则，这个位置定义的变量无法在内部script块中正常赋值、读取
• 进程隔离：PowerShell步骤启动的是独立的外部进程，内部定义的所有变量都只存在于这个临时进程的内存中，进程执行结束就会被销毁，不会自动同步到Jenkins流水线的Groovy运行环境
• 上下文缺失：赋值语句NAMEUPDATE = $nameupdate写在PowerShell块外部，此时Groovy上下文里根本不存在名为$nameupdate的变量，自然无法获取到对应值

要实现PowerShell结果在块外使用，核心是让PowerShell步骤把需要的值通过标准输出流返回给Groovy上下文，直接完成变量赋值，不需要在PowerShell内部手动传递变量。

• 核心配置：调用powershell步骤时必须加上returnStdout: true，这个参数会把PowerShell的标准输出内容作为步骤的返回值，同步给Groovy环境；默认情况下该参数值为false，PowerShell输出会直接打印到构建日志，不会回传到Groovy上下文
• 基础代码示例：

steps {
  script {
    // 直接将PowerShell命令的返回值赋值给Jenkins变量
    def NAMEUPDATE = powershell(
      returnStdout: true, 
      script: '''Get-Content D:\\updates\\nameupdates.txt'''
    ).trim() // 必须加trim()，清除PowerShell输出自带的尾部换行符，避免引入多余空字符

    // 赋值完成后，这个变量可以在同stage内PowerShell块外的任意位置正常调用
    echo "从文件读取到的内容是：${NAMEUPDATE}"
  }
}

• 复杂逻辑场景适配：如果需要在PowerShell块内做多层数据处理，只要在块的最后把要传递的值通过Write-Output输出即可，不需要额外的跨进程变量传递逻辑，示例如下：

def PROCESSED_RESULT = powershell(
  returnStdout: true,
  script: '''
    // 块内自由编写PowerShell处理逻辑
    $rawData = Get-Content D:\\updates\\nameupdates.txt
    $filterData = $rawData | Where-Object { $_.Trim() -ne "" }
    // 最后输出需要传递的值，作为步骤返回值
    Write-Output $filterData
  '''
).trim()

• 常见注意事项：
  • 如果读取的文件是多行内容，返回的结果会自动转换为Groovy可直接遍历的字符串列表，不需要额外做格式拆分
  • 末尾的.trim()不能省略，PowerShell的输出默认会在内容末尾追加一个换行符，不做清除的话，赋值的变量会带有不可见的空字符，导致后续的字符串判断、文件路径拼接等逻辑出现莫名错误

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