Jenkins调用PsExec无标准输出，如何获取远程桌面SessionID？

阿华AIGC实验室

2026-5-8

问题分析与解决方案

你遇到的问题我很熟悉——PsExec在Jenkins环境下的输出处理确实容易踩坑，但你的包装器思路完全没问题，只要调整几个关键细节，就能实现在Jenkins中获取远程桌面SessionID并输出到标准输出的需求，同时保留完善的错误报告机制。

为什么Jenkins里没有标准输出？

核心原因是Jenkins的PowerShell执行环境和本地环境的差异，加上包装器的输出处理逻辑需要适配：

输出捕获逻辑差异：Jenkins默认只捕获显式输出到stdout的内容，而你的Get-SessionID用return $sessionID终止函数，PowerShell在Jenkins环境下可能不会把这个值自动输出到标准输出。
PsExec的输出流向：PsExec经常把正常状态信息（比如连接提示）输出到stderr，你的包装器原本会把未匹配的stderr行直接标记为错误（设置exit_code=-13），这不仅会误判状态，还可能吞噬部分输出。
日志函数的影响：Write-Log会把日志写入指定位置，但不会输出到Jenkins的构建日志里，导致你看不到中间过程。

包装器的适配修改（针对Jenkins）

1. 确保SessionID显式输出到标准输出

在Get-SessionID函数的末尾，把return $sessionID替换为：

# 显式输出到stdout，确保Jenkins能捕获
Write-Output $sessionID
Pop-Location

return在PowerShell中更偏向于终止执行，而Write-Output才是明确向标准输出发送内容的方式，Jenkins能完美捕获这个输出。

2. 修正包装器的stderr处理逻辑

PsExec的stderr不一定都是错误，很多是正常的连接/启动状态信息。修改包装器中elseif ($std_type -eq 'std_err')的逻辑：

elseif ($std_type -eq 'std_err') {
    $return_dict['std_err'].Add($line)
    # 移除默认设置错误码的逻辑，只在未匹配到有效退出码时设为0（正常状态）
    if ($return_dict['exit_code'] -eq $null) {
        $return_dict['exit_code'] = 0
    }
}

这样不会把PsExec的正常状态信息误判为错误，也不会导致Jenkins构建被标记为失败。

3. 增强Jenkins中的输出可见性

在Jenkins的PowerShell构建步骤中，调用函数后显式打印结果：

$remoteSessionID = Get-SessionID
Write-Output "Successfully retrieved remote Session ID: $remoteSessionID"

这会直接把结果显示在Jenkins的构建日志里，方便排查和后续步骤使用。

包装器 vs 直接调用：怎么选？

你已经用直接调用实现了需求，但包装器的优势明显：

结构化错误处理：可以统一过滤PsExec的冗余输出（比如版权信息、连接提示），只保留关键结果和错误信息
可复用性：后续其他PsExec调用可以直接复用这个包装器，不用重复写输出处理逻辑
明确的返回值：通过字典返回std_out、std_err、session_id、exit_code等信息，便于后续脚本做分支处理

如果要进一步完善包装器，还可以添加：

参数验证：检查$psexec路径是否存在、远程主机是否可达
超时处理：给$process.WaitForExit()添加超时时间，避免Jenkins构建挂起
命令兼容性：比如taskhost*在不同Windows版本中可能是taskhostw.exe，可以调整正则或命令参数

优化后的Get-SessionID示例

function Get-SessionID {
<#
.SYNOPSIS
Retrieve remote machine desktop Session ID using PsExec.
.DESCRIPTION
Gets the desktop Session ID of a remote machine via PsExec, with structured error handling and Jenkins-friendly output.
#>
    Push-Location $PSScriptRoot
    Import-module .\Write-Log.ps1 -Force
    Import-module .\CheckAndLoad-EnvironmentVariable.ps1 -Force
    Import-module .\Psexec-Wrapper.ps1 -Force

    # 建议改为参数传入，提升灵活性（这里保留原逻辑）
    $hostName = "<IP Address of the remote machine>"
    $psexec = "<Path to PSExec.exe>"
    $user = "<Remote Machine User Name>"
    $pass = "<Remote Machine Password>"
    $cmd = "-u $user -p $pass -accepteula -nobanner cmd /c tasklist /FI ""IMAGENAME eq taskhost*"" /FO List | findstr ""Session#:"""

    Write-Log("Executing PsExec command: $psexec \$hostName $cmd")

    $result = Psexec-Wrapper $psexec $hostName $cmd

    # 核心错误检查
    if ($LASTEXITCODE -ne 0 -or [string]::IsNullOrEmpty($result.session_id) -or $result.session_id -eq "None") {
        $errorMessage = "Failed to get Session ID. Details: $(ConvertTo-Json $result)"
        Report-Error $errorMessage "-13"
        Pop-Location
        Write-Output $null
        return
    }

    Write-Log("PsExec raw output: $(Out-String -InputObject $result)")

    # 检查PsExec退出码
    if ($result.exit_code -ne 0) {
        $errorMessage = "PsExec command failed: $(Out-String -InputObject $result.std_err)"
        Report-Error $errorMessage $result.exit_code
        Pop-Location
        Write-Output $null
        return
    }

    # 显式输出结果到stdout
    $sessionID = $result.session_id
    Write-Log("Successfully got Session ID: $sessionID")
    Pop-Location
    Write-Output $sessionID
}