PowerShell脚本中Receive-Job返回任务对象而非结果问题排查

运行PowerShell批量检测机器在线状态的后台任务时，执行Receive-Job得到的是Job对象而非任务执行结果。单独在终端测试时可以正常获取结果，但脚本中执行却返回Job的列表信息（如下所示）：

Id     Name            PSJobTypeName   State         HasMoreData     Location           Command
--     ----            -------------   -----         -----------     --------           -------
1      8.8.8.8         BackgroundJob   Completed     True            localhost          tnc -C...

以下是处理任务的主循环代码：

do {
    # Loop Delay
    Start-Sleep -Milliseconds $JobDelay
    Write-Output "Current Job Count = $($(Get-Job).count)"

    # Can I start another Job?
    if (($(Get-Job).count) -lt $maxJobCount) {
        # check if we started all addresses
        if ($scanningPos -lt $addressesToScan.count - 1) {
            # Start next Job
            Write-Output "Starting Job for $($addressesToScan[$scanningPos])"
            $job = Start-Job {tnc -ComputerName $addressesToScan[$scanningPos] -Port $port -InformationLevel Quiet} -Name "$($addressesToScan[$scanningPos])"
            $scanningPos++
        }
    } else { # we are at Max Job count
        # loop over all the jobs to find the completed jobs
        # if completed remove from job list and add to completed addresses
        ForEach ($job in Get-Job) {
            if ($job.State -eq "Completed") {                   # Handle Completed Jobs
                Write-Output $job
                $result = Receive-Job -Job $job
                Write-Output "$($job.Name) completed"
                Write-Output $result
                $completedAddresses.Add($job.Name, $result)
                Remove-Job -Job $job
            } elseif ($job.State -eq "Failed") {                # Handle Failed Jobs
                Write-Output "Found a failed Job: $job"
                Remove-Job $job
            }
        }
    }

    # We finished all the scans
    if ($scanningPos -eq $addressesToScan.Count - 1) {
        $stopcode = $true
    }

    Write-Output "Completed Addresses: $($completedAddresses.Count)"

} until ($stopcode)

1. 后台Job无法直接访问主会话变量：你在Start-Job的脚本块中直接使用了$addressesToScan[$scanningPos]和$port，但后台Job运行在独立的子会话中，无法读取主会话的变量，导致Job实际执行的命令不完整，最终Receive-Job获取不到有效结果，只能返回Job对象本身。
2. 循环终止条件错误：$scanningPos -eq $addressesToScan.Count - 1会漏掉最后一个地址的Job启动（因为索引从0开始，最后一个元素索引为Count-1，此时直接终止循环会导致最后一个Job未启动），同时没有等待已启动的Job全部完成。

1. 通过-ArgumentList传递变量给后台Job #

启动Job时必须将需要的变量通过-ArgumentList传递，脚本块内部用param()接收：

# 修改Start-Job的代码
$targetAddress = $addressesToScan[$scanningPos]
$job = Start-Job -ArgumentList $targetAddress, $port {
    param($addr, $p)
    tnc -ComputerName $addr -Port $p -InformationLevel Quiet
} -Name $targetAddress

2. 修复循环终止逻辑 #

确保所有地址的Job都已启动，且所有运行中的Job都完成后再终止循环：

# 替换原终止判断逻辑
$allJobsStarted = ($scanningPos -ge $addressesToScan.Count)
$noJobsRunning = (Get-Job).Count -eq 0
if ($allJobsStarted -and $noJobsRunning) {
    $stopcode = $true
}

3. 优化Job处理流程 #

调整循环顺序，先处理已完成的Job，再判断是否启动新Job，避免遗漏任务处理：

# 完整优化后的循环代码
do {
    Start-Sleep -Milliseconds $JobDelay
    Write-Output "Current Job Count = $($(Get-Job).count)"

    # 优先处理所有已完成/失败的Job
    foreach ($job in Get-Job) {
        if ($job.State -eq "Completed") {
            $result = Receive-Job -Job $job
            Write-Output "$($job.Name) completed, Result: $result"
            $completedAddresses.Add($job.Name, $result)
            Remove-Job -Job $job
        } elseif ($job.State -eq "Failed") {
            Write-Output "Found failed Job: $($job.Name)"
            Remove-Job -Job $job
        }
    }

    # 判断是否可以启动新Job
    if ((Get-Job).Count -lt $maxJobCount -and $scanningPos -lt $addressesToScan.Count) {
        $targetAddress = $addressesToScan[$scanningPos]
        Write-Output "Starting Job for $targetAddress"
        $job = Start-Job -ArgumentList $targetAddress, $port {
            param($addr, $p)
            tnc -ComputerName $addr -Port $p -InformationLevel Quiet
        } -Name $targetAddress
        $scanningPos++
    }

    # 终止条件：所有地址已启动Job且无运行中Job
    $allJobsStarted = ($scanningPos -ge $addressesToScan.Count)
    $noJobsRunning = (Get-Job).Count -eq 0
    if ($allJobsStarted -and $noJobsRunning) {
        $stopcode = $true
    }

    Write-Output "Completed Addresses: $($completedAddresses.Count)"

} until ($stopcode)

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