如何在PowerShell中通过-StreamingHost将Start-ThreadJob输出重定向到变量

直接通过-StreamingHost $Host无法将输出捕获到变量，但可以通过自定义PSHost主机对象来实现，无需修改脚本块内部的输出逻辑，适配PowerShell 7.5-beta版本。

1. 定义捕获输出的自定义主机类 #

这个类实现PSHost接口，核心是通过自定义PSHostUserInterface来拦截并存储所有流输出：

class CapturingHost : System.Management.Automation.Host.PSHost {
    [System.Collections.Generic.List[string]]$CapturedOutput = @()

    [string] get_Name() { return 'CapturingHost' }
    [Version] get_Version() { return [Version]'1.0' }
    [Guid] get_InstanceId() { return [Guid]::NewGuid() }
    [System.Management.Automation.Host.PSHostUserInterface] get_UI() {
        return [CapturingHostUI]::new($this)
    }
    [System.Management.Automation.Host.PSHostRawUserInterface] get_RawUI() {
        return $Host.RawUI
    }
    [void] EnterNestedPrompt() {}
    [void] ExitNestedPrompt() {}
    [void] NotifyBeginApplication() {}
    [void] NotifyEndApplication() {}
    [void] SetShouldExit([int]$exitCode) {}
}

class CapturingHostUI : System.Management.Automation.Host.PSHostUserInterface {
    [CapturingHost]$HostInstance

    CapturingHostUI([CapturingHost]$hostInstance) {
        $this.HostInstance = $hostInstance
    }

    # 捕获Write-Host的普通输出
    [void] Write([string]$value) {
        $this.HostInstance.CapturedOutput.Add($value.TrimEnd("`n`r"))
    }

    [void] WriteLine([string]$value) {
        $this.HostInstance.CapturedOutput.Add($value.TrimEnd("`n`r"))
    }

    # 捕获Verbose级别的输出
    [void] WriteVerboseLine([string]$message) {
        $this.HostInstance.CapturedOutput.Add("VERBOSE: $message")
    }

    # 捕获错误输出
    [void] WriteErrorLine([string]$message) {
        $this.HostInstance.CapturedOutput.Add("ERROR: $message")
    }

    # 实现其他必要的UI接口方法（用默认/空实现）
    [System.Management.Automation.Host.PSHostRawUserInterface] get_RawUI() {
        return $Host.RawUI
    }
    [void] WriteDebugLine([string]$message) {}
    [void] WriteProgress([long]$sourceId, [System.Management.Automation.Host.ProgressRecord]$record) {}
    [void] WriteWarningLine([string]$message) {}
    [System.Management.Automation.Host.ChoiceResults] Prompt([string]$caption, [string]$message, [System.Collections.ObjectModel.Collection[System.Management.Automation.Host.ChoiceDescription]]$choices, [int]$defaultChoice) {
        return [System.Management.Automation.Host.ChoiceResults]$defaultChoice
    }
    [string] PromptForInput([string]$caption, [string]$message, [string]$defaultInput) {
        return $defaultInput
    }
    [securestring] PromptForSecureInput([string]$caption, [string]$message) {
        return $null
    }
}

2. 使用自定义主机捕获ThreadJob输出 #

创建自定义主机实例，传入-StreamingHost参数，等待作业完成后即可获取捕获的输出：

# 初始化捕获主机
$capturingHost = [CapturingHost]::new()

# 启动线程作业，指定自定义主机
Start-ThreadJob -ScriptBlock {
    try {    
        Write-Host "`nThis is a Write-Host message"
        Write-Verbose 'This is a verbose message.' -Verbose
        Start-Sleep 2  
        throw 'this is an error message'
    }
    catch {
        Write-Host 'Error: ' $_.Exception.Message
    }
} -ThrottleLimit 1 -StreamingHost $capturingHost | Wait-Job | Out-Null

# 获取并查看捕获到的所有输出
$capturedOutput = $capturingHost.CapturedOutput
$capturedOutput

核心要点 #

• 无需修改脚本块内的任何输出代码，Write-Host、Write-Verbose及捕获的错误信息都会被统一收集。
• 必须使用Wait-Job等待作业执行完毕，否则可能获取到不完整的输出内容。
• 自定义主机类可以根据需求扩展，比如区分不同类型的输出（Verbose/Error/Host），或者添加时间戳等。

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