PowerShell 5.1中如何捕获远程Invoke-Command的警告信息

在PowerShell 5.1的远程会话中，警告流（3号流）默认不会自动转发到本地执行环境，这就是直接使用本地的3>&1、-WarningVariable、-WarningAction等参数无效的核心原因——警告在远程端生成后直接输出到远程控制台，并未传回本地。

下面是两种规范的处理方式：

1. 远程脚本块内统一重定向流并本地分类 #

在远程脚本块中用*>&1把所有流（警告、详细、信息、错误）都重定向到输出流，本地接收后可通过对象类型区分不同流的内容，逻辑比单独重定向警告流更清晰：

# 执行远程命令并捕获所有流
$allResults = Invoke-Command -ComputerName RemotePC -ScriptBlock {
    # 开启需要捕获的流的输出（按需调整）
    $VerbosePreference = 'Continue'
    $InformationPreference = 'Continue'
    $WarningPreference = 'Continue'
    
    # 示例命令，包含警告输出
    Get-ChildItem -Path 'C:\NonExistentDir' -Verbose *>&1
}

# 本地区分不同类型的记录
$warnings = $allResults | Where-Object { $_ -is [System.Management.Automation.WarningRecord] }
$verboseLogs = $allResults | Where-Object { $_ -is [System.Management.Automation.VerboseRecord] }
$infoLogs = $allResults | Where-Object { $_ -is [System.Management.Automation.InformationRecord] }
$normalOutput = $allResults | Where-Object { 
    $_ -isnot [System.Management.Automation.WarningRecord] -and
    $_ -isnot [System.Management.Automation.VerboseRecord] -and
    $_ -isnot [System.Management.Automation.InformationRecord] -and
    $_ -isnot [System.Management.Automation.ErrorRecord]
}

2. 封装Invoke-Command简化重复操作 #

如果频繁需要处理远程流的捕获，可以封装一个专用函数，自动处理远程端的流配置和本地的结果分类，避免重复编写逻辑：

function Invoke-RemoteCommandWithStreams {
    [CmdletBinding()]
    param(
        [Parameter(Mandatory)]
        [string]$ComputerName,
        [Parameter(Mandatory)]
        [scriptblock]$ScriptBlock
    )

    # 构造包含流配置和重定向的远程脚本块
    $modifiedScript = [scriptblock]::Create(@"
        `$VerbosePreference = 'Continue'
        `$InformationPreference = 'Continue'
        `$WarningPreference = 'Continue'
        & $ScriptBlock *>&1
"@)

    # 执行远程命令
    $rawResults = Invoke-Command -ComputerName $ComputerName -ScriptBlock $modifiedScript

    # 分类返回结果
    [PSCustomObject]@{
        Output       = $rawResults | Where-Object { $_ -isnot [System.Management.Automation.InformationRecord] -and $_ -isnot [System.Management.Automation.WarningRecord] -and $_ -isnot [System.Management.Automation.VerboseRecord] -and $_ -isnot [System.Management.Automation.ErrorRecord] }
        Warnings     = $rawResults | Where-Object { $_ -is [System.Management.Automation.WarningRecord] }
        VerboseLogs  = $rawResults | Where-Object { $_ -is [System.Management.Automation.VerboseRecord] }
        Information  = $rawResults | Where-Object { $_ -is [System.Management.Automation.InformationRecord] }
        Errors       = $rawResults | Where-Object { $_ -is [System.Management.Automation.ErrorRecord] }
    }
}

# 使用示例
$remoteResult = Invoke-RemoteCommandWithStreams -ComputerName RemotePC -ScriptBlock {
    Write-Warning "远程警告信息"
    Write-Verbose "远程详细日志"
    Write-Information "远程信息提示"
    Get-ChildItem 'C:\Temp'
}

# 直接访问各类流内容
$remoteResult.Warnings
$remoteResult.VerboseLogs

补充说明 #

PowerShell 5.1的远程会话流转发机制存在这个局限，直到PowerShell 7及以上版本才优化了远程流的传递逻辑，本地的-WarningVariable等参数可以直接生效。如果无法升级PowerShell版本，上述两种方法是最实用的解决方案。

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