PowerShell日志监控函数Wait参数输出缓冲问题原因及解决

问题场景 #

我编写了Watch-Log PowerShell函数，用于解析外部进程写入的日志文件——将每行日志转换为对象传入管道，同时添加了-Wait参数实现持续监控日志变化。但启用-Wait参数时，管道输出会被无限缓冲，无法实时打印到控制台，只有追加Out-Host才能临时实现实时输出。

排查结论 #

问题根源在于PowerShell配置文件中自定义重写的Out-Default函数：该函数并非管道式实现，会先收集全部输入再统一处理，直接导致PowerShell默认的实时输出逻辑失效。

解决方案 #

1. 检查当前Out-Default定义 #

先确认自定义函数的具体内容：

Get-Command Out-Default -CommandType Function | Select-Object Definition

2. 修改自定义Out-Default为管道式实现 #

将原函数改为支持逐行处理的管道版本，确保输入对象能实时流过管道：

function Out-Default {
    [CmdletBinding()]
    param(
        [Parameter(ValueFromPipeline=$true)]
        $InputObject
    )

    process {
        # 保留你的自定义处理逻辑（如果有），但必须在process块中逐行处理
        $InputObject | Microsoft.PowerShell.Core\Out-Default
    }
}

3. 恢复系统默认Out-Default #

如果不需要自定义Out-Default，直接删除自定义版本即可：

Remove-Item Function:\Out-Default

为什么Out-Host能临时解决？ #

Out-Host会绕过自定义的Out-Default，直接将输出投递到控制台，它本身是管道式实现，支持实时逐行输出。

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