如何编写可灵活处理文本的PowerShell管道函数？

原函数的核心问题是处理逻辑放在了Begin块，而Begin块在管道对象开始传递前就会执行，此时$content并未接收到任何管道传入的对象（值为$null）。此外，函数没有适配管道逐个传递对象的特性，且类型判断只针对数组，忽略了单个对象的情况。

Function Test {
    [Cmdletbinding()]
    Param(
        [Parameter(ValueFromPipeline = $true, Position = 0)] 
        [Object[]] $Content  # 改为数组类型，兼容一次性传入数组或管道逐个传对象
    )

    Process {
        foreach ($item in $Content) {
            $processedItem = switch ($item.GetType()) {
                # 处理字符串：按换行符分割
                [string] {
                    [regex]::Split($item, "\r?\n")
                }
                # 处理FileInfo对象：读取文件内容
                [System.IO.FileInfo] {
                    [System.IO.File]::ReadAllText($item.FullName)
                }
                # 处理其他对象：转为字符串
                default {
                    $item | Out-String -Stream  # 使用-Stream避免末尾多余空行
                }
            }

            # 输出处理后的结果（保留原逻辑的Write-Host，可按需改为Write-Output）
            Write-Host "处理后的类型: $($processedItem.GetType().Name)"
            $processedItem | ForEach-Object { Write-Host $_ }
        }
    }
}

• 将处理逻辑移至Process块：Process块会对管道传入的每个对象执行一次，完美适配管道流式处理的特性。
• 参数改为[Object[]]类型：既支持一次性传入数组，也支持管道逐个传递对象（PowerShell会自动将单个对象包装为数组）。
• 使用switch判断类型：更清晰地处理不同类型的输入，同时支持单个对象的判断（原函数只判断了数组类型）。
• FileInfo处理优化：直接使用[System.IO.File]::ReadAllText读取文件，比调用$_.ReadAllText()更可靠（部分场景下FileInfo对象可能没有这个方法）。
• Out-String添加-Stream参数：避免默认情况下Out-String会在末尾添加多余的空行，让输出更干净。

• 管道传入FileInfo对象：dir *.txt | Test
• 管道传入字符串："line1rnline2" | Test
• 传入对象数组：Get-Process | Select-Object -First 3 | Test

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