如何通过PowerShell SDK按生成顺序捕获各类输出流？

当使用PowerShell SDK（.NET 7 + Microsoft.PowerShell.SDK NuGet包）执行包含多流输出（Write-Verbose、Write-Output、Write-Information等）的脚本时，默认按流分组返回结果，无法还原脚本中的原始输出顺序。且仅Information流的记录带有TimeGenerated属性，无法直接跨流排序。

以下提供两种可行的解决方案：

方案一：在PowerShell脚本中统一输出格式 #

通过自定义函数将所有流的输出包装为包含时间戳、流类型和内容的对象，统一通过Output流返回，C#端只需处理该流并按时间戳排序。

修改后的PowerShell脚本 #

$VerbosePreference = 'Continue'

function Write-TimestampedOutput {
    param(
        [string]$StreamType,
        [string]$Message
    )
    [PSCustomObject]@{
        Timestamp = Get-Date -Format o  # 生成可排序的ISO格式时间戳
        StreamType = $StreamType
        Message = $Message
    }
}

Write-TimestampedOutput -StreamType 'Verbose' -Message 'Line 1'
Write-TimestampedOutput -StreamType 'Output' -Message 'Line 2'
Write-TimestampedOutput -StreamType 'Verbose' -Message 'Line 3'
Write-TimestampedOutput -StreamType 'Information' -Message 'Line 4'
Write-TimestampedOutput -StreamType 'Information' -Message 'Line 5'
Write-TimestampedOutput -StreamType 'Verbose' -Message 'Line 6'

对应的C#代码 #

using System.Management.Automation.Runspaces;
using System.Linq;

var runSpace = RunspaceFactory.CreateRunspace(InitialSessionState.CreateDefault());
runSpace.Open();

var instance = System.Management.Automation.PowerShell.Create(runSpace);

instance.AddScript(@"
    $VerbosePreference = 'Continue'

    function Write-TimestampedOutput {
        param(
            [string]$StreamType,
            [string]$Message
        )
        [PSCustomObject]@{
            Timestamp = Get-Date -Format o
            StreamType = $StreamType
            Message = $Message
        }
    }

    Write-TimestampedOutput -StreamType 'Verbose' -Message 'Line 1'
    Write-TimestampedOutput -StreamType 'Output' -Message 'Line 2'
    Write-TimestampedOutput -StreamType 'Verbose' -Message 'Line 3'
    Write-TimestampedOutput -StreamType 'Information' -Message 'Line 4'
    Write-TimestampedOutput -StreamType 'Information' -Message 'Line 5'
    Write-TimestampedOutput -StreamType 'Verbose' -Message 'Line 6'
");

var output = instance.Invoke();

// 转换为动态对象并按时间戳排序
var sortedOutput = output.Select(o => (dynamic)o.BaseObject)
                         .OrderBy(obj => obj.Timestamp);

foreach (var item in sortedOutput)
{
    string prefix = item.StreamType switch
    {
        "Verbose" => "[V]",
        "Output" => "[N]",
        "Information" => "[I]",
        _ => "[?]"
    };
    Console.WriteLine($"{prefix}: {item.Message}");
}

方案二：在C#端通过事件回调捕获实时输出顺序 #

利用PowerShell各流的DataAdded事件，在输出产生时立即记录并添加时间戳，最后统一排序所有记录。这种方式无需修改原PowerShell脚本。

C#实现代码 #

using System.Management.Automation.Runspaces;
using System.Collections.Generic;
using System.Linq;

// 定义统一存储输出条目的类
public class StreamEntry
{
    public DateTime Timestamp { get; set; }
    public string StreamType { get; set; }
    public string Message { get; set; }
}

var runSpace = RunspaceFactory.CreateRunspace(InitialSessionState.CreateDefault());
runSpace.Open();

var instance = System.Management.Automation.PowerShell.Create(runSpace);
var allEntries = new List<StreamEntry>();

// 监听Verbose流新增数据事件
instance.Streams.Verbose.DataAdded += (sender, e) =>
{
    var verboseStream = (VerboseRecordCollection)sender;
    var record = verboseStream[e.Index];
    allEntries.Add(new StreamEntry
    {
        Timestamp = DateTime.Now,
        StreamType = "Verbose",
        Message = record.Message
    });
};

// 监听Information流新增数据事件（直接使用自带的TimeGenerated）
instance.Streams.Information.DataAdded += (sender, e) =>
{
    var infoStream = (InformationRecordCollection)sender;
    var record = infoStream[e.Index];
    allEntries.Add(new StreamEntry
    {
        Timestamp = record.TimeGenerated,
        StreamType = "Information",
        Message = record.MessageData.ToString()
    });
};

// 监听Output流新增数据事件
instance.Streams.Output.DataAdded += (sender, e) =>
{
    var outputStream = (PSObjectCollection)sender;
    var record = outputStream[e.Index];
    allEntries.Add(new StreamEntry
    {
        Timestamp = DateTime.Now,
        StreamType = "Output",
        Message = record.ToString()
    });
};

// 添加原脚本并执行
instance.AddScript(@"'
    $VerbosePreference = 'Continue'

    Write-Verbose \"Line 1\"
    Write-Output \"Line 2\"
    Write-Verbose \"Line 3\"
    Write-Information \"Line 4\"
    Write-Information \"Line 5\"
    Write-Verbose \"Line 6\"
'");

instance.Invoke();

// 按时间戳排序后输出
var sortedEntries = allEntries.OrderBy(entry => entry.Timestamp);

foreach (var entry in sortedEntries)
{
    string prefix = entry.StreamType switch
    {
        "Verbose" => "[V]",
        "Output" => "[N]",
        "Information" => "[I]",
        _ => "[?]"
    };
    Console.WriteLine($"{prefix}: {entry.Message}");
}

方案对比 #

• 方案一：实现简单，仅需调整脚本，适合脚本内容可控的场景；但需要替换所有原生Write-*命令，第三方模块输出的内容无法自动纳入统一格式。
• 方案二：无需修改原脚本，能捕获所有流的输出；DateTime.Now的精度依赖系统时钟，但对于绝大多数场景足够满足顺序还原需求。

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