PowerShell自定义类对象天然支持管道流式处理，因其基于.NET对象传递而非文本解析；类实例可直接送入管道，函数需用[Parameter(ValueFromPipeline)]接收，避免过早字符串化以保持属性可访问性。
powershell 中自定义类的对象天然支持管道流式处理，关键在于让类实例能被正确识别为对象，并配合 powershell 的 基于对象的管道机制 —— 它不依赖文本解析，而是直接传递 .net 对象及其属性和方法。
确保类定义符合 PowerShell 管道预期
PowerShell 管道默认按“每个对象”逐个流转，因此你的类不需要特殊标记，但需注意以下几点：
- 使用
[class]语法定义的类（PowerShell 5.0+）可直接实例化并送入管道，无需继承或接口 - 避免在类中重写
.ToString()返回冗余信息，否则可能干扰Out-String或显示逻辑 - 若希望对象在终端中清晰展示，可添加
Format.ps1xml视图，或确保关键属性名语义明确（如Name、Status、Timestamp）
用法示例：类实例直连管道
比如定义一个简单日志条目类：
class LogEntry {<br> [string]$Message<br> [datetime]$Time<br> [string]$Level<br> LogEntry([string]$msg, [string]$lvl) {<br> $this.Message = $msg<br> $this.Time = Get-Date<br> $this.Level = $lvl<br> }<br>}
然后创建多个实例并送入管道：
$logs = [LogEntry]::new("Disk full", "Error"), [LogEntry]::new("Service started", "Info")<br>$logs | Where-Object Level -eq "Error" | Select-Object Message, Time
结果会直接筛选出错误日志，无需任何转换——因为每个 [LogEntry] 实例都是完整对象，Where-Object 和 Select-Object 可直接访问其属性。
直播话术巡检系统(Windows版) — 实时语音转写、关键词检测、场景自动切换、告警推送、大屏可视化。支持 Windows VB-Cable 虚拟声卡音频采集，阿里云 ASR 实时识别。一键启动脚本，自动安装环境。
在函数中接收类对象（支持管道输入）
若要编写可接收该类对象的函数，需在参数上标注 [Parameter(ValueFromPipeline)]，并在 process 块中处理每个实例：
-
begin块用于初始化（如新建集合） -
process块对每个传入的LogEntry实例执行逻辑（例如打时间戳、增强属性） -
end块用于汇总（如导出全部结果）
这样函数就能同时支持：$logs | My-EnrichLog（管道流式）和 My-EnrichLog -InputData $logs[0]（单个调用）。
注意事项：避免过早字符串化
一旦调用 Out-String 或 ConvertTo-Json -Compress 等命令，对象结构就丢失了。若后续还需按属性筛选或排序，应尽量把格式化步骤放在管道末端。例如：
$logs | Where-Object Level -eq "Error" | Sort-Object Time | ConvertTo-Json
而不是：$logs | Out-String | Where-Object ...（这会失败，因为字符串没有 Level 属性）。
