PowerShell函数内如何输出日志且不影响函数返回值

方案核心逻辑 #

PowerShell 中函数的返回值默认走1号成功输出流，只要避免日志内容写入该流，就不会干扰函数正常返回，以下是可直接落地的实现方案：

方案1：自定义通用日志函数（推荐，适配全场景） #

封装独立的日志函数，同时输出到控制台和日志文件，完全不触碰成功输出流：

# 通用日志函数，全局复用
function Write-Log {
    param(
        [Parameter(Mandatory=$true)][string]$Message,
        [string]$LogPath = "C:\path\to\your\script.log"
    )
    # 给日志加时间戳，可选
    $formattedMsg = "[$(Get-Date -Format 'yyyy-MM-dd HH:mm:ss')] $Message"
    # 同时写日志文件和控制台，不进入成功流
    $formattedMsg | Tee-Object -FilePath $LogPath -Append | Write-Host
}

在业务函数中直接调用即可，返回值正常返回即可：

# 你的业务函数
function Update-User {
    param([string]$Account)
    # 打日志，完全不影响返回值
    Write-Log "Updating user $Account"

    # 你的业务逻辑...
    $updateResult = $true # 这里替换为实际业务结果

    # 正常返回业务结果，不会混入日志内容
    return $updateResult
}

适配计划任务场景说明

如果需要计划任务运行时也能捕获控制台日志，将日志函数中的Write-Host替换为Write-Information -InformationAction Continue，同时在脚本开头添加全局配置：

$InformationPreference = "Continue"

方案2：低版本PowerShell兼容方案 #

如果需要兼容PowerShell 5.0及更早版本，可直接分离控制台写入和文件写入，完全规避流干扰：

function Write-Log {
    param(
        [Parameter(Mandatory=$true)][string]$Message,
        [string]$LogPath = "C:\path\to\your\script.log"
    )
    $formattedMsg = "[$(Get-Date -Format 'yyyy-MM-dd HH:mm:ss')] $Message"
    # 直接写控制台
    [Console]::WriteLine($formattedMsg)
    # 直接追加写日志文件
    $formattedMsg | Out-File -FilePath $LogPath -Append -Encoding UTF8
}

注意事项 #

• 禁止在函数内部使用Write-Output、隐式对象输出（如直接写变量名无输出命令）来打印日志，这类操作都会把内容写入成功流，混入函数返回值。
• 日志函数的路径可以做成全局变量或者脚本参数，方便不同场景灵活配置。

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