PowerShell中Out-File性能问题及脚本限制下的优化咨询

我有一个名为Write-Logs的函数，被多个脚本及ForEach循环调用。当循环调用（比如遍历上千个文件）时耗时极长，推测是I/O开销导致。由于限制无法修改任何主脚本，请问能否在函数层面进行性能优化？

原始函数代码 #

Function Write-Logs {
Param(
    [parameter(Mandatory=$true)][string]$logContent,
    [parameter(Mandatory=$true)][string]$logPath
)

    $currentTime = Get-Date

    If(!(Test-Path $logPath)){
    
        New-Item -Path $logPath -ItemType 'file' -Force
    }

    Write-Output "$($currentTime): $($logContent)" | Out-File $logPath -Append
}

示例主脚本（无法修改） #

# This test folder could contain more than 1000 items
$mySrc = 'D:\test'
$myLogPath = 'D:\Logs\mylog.txt'

Get-ChildItem -Path $mySrc -Recurse | ForEach-Object {
    Write-Logs -logContent $_.FullName -logPath $myLogPath

} 

优化方案 #

方案1：复用文件句柄（最大程度降低I/O次数） #

每次调用Out-File -Append都会重复执行打开文件→写入→关闭文件的操作，上千次调用会产生大量无意义的I/O开销。我们可以在函数内部维护静态文件句柄，同一个日志路径复用句柄，直到PowerShell退出时再统一关闭。

修改后的函数：

Function Write-Logs {
Param(
    [parameter(Mandatory=$true)][string]$logContent,
    [parameter(Mandatory=$true)][string]$logPath
)
    # 静态变量存储不同日志路径的文件句柄
    static $fileHandles = @{}

    $currentTime = Get-Date -Format 'yyyy-MM-dd HH:mm:ss.fff'
    $logEntry = "$currentTime`: $logContent`r`n"

    # 检查当前日志路径的句柄是否有效
    if (-not $fileHandles.ContainsKey($logPath) -or $fileHandles[$logPath].IsClosed) {
        # 确保文件存在，无需单独Test-Path
        $null = New-Item -Path $logPath -ItemType 'file' -Force
        # 以追加+共享读模式打开文件
        $fileHandles[$logPath] = [System.IO.File]::Open(
            $logPath, 
            [System.IO.FileMode]::Append, 
            [System.IO.FileAccess]::Write, 
            [System.IO.FileShare]::Read
        )
    }

    # 直接通过.NET写入，避免管道开销
    $bytes = [System.Text.Encoding]::UTF8.GetBytes($logEntry)
    $fileHandles[$logPath].Write($bytes, 0, $bytes.Length)
    $fileHandles[$logPath].Flush()
}

# 注册PowerShell退出事件，清理所有打开的文件句柄
Register-EngineEvent PowerShell.Exiting -Action {
    foreach ($handle in $Write-Logs::fileHandles.Values) {
        if (-not $handle.IsClosed) {
            $handle.Close()
            $handle.Dispose()
        }
    }
} | Out-Null

方案2：批量写入（利用管道缓存减少I/O次数） #

保留原函数的调用签名，同时支持批量缓存日志条目，达到阈值后一次性写入文件，减少I/O操作次数。

修改后的函数：

Function Write-Logs {
[CmdletBinding(DefaultParameterSetName='Single')]
Param(
    [parameter(Mandatory=$true, ParameterSetName='Single')][string]$logContent,
    [parameter(Mandatory=$true, ParameterSetName='Single')][string]$logPath,
    [parameter(Mandatory=$true, ParameterSetName='Batch', ValueFromPipeline=$true)][string[]]$logContentBatch,
    [parameter(Mandatory=$true, ParameterSetName='Batch')][string]$logPath,
    [int]$batchSize = 100  # 可根据实际情况调整批量阈值
)

    begin {
        $currentBatch = @()
        # 提前确保日志文件存在并解析绝对路径
        $logPath = New-Item -Path $logPath -ItemType 'file' -Force | Select-Object -ExpandProperty FullName
    }

    process {
        # 兼容原单条调用和批量管道输入
        if ($PSCmdlet.ParameterSetName -eq 'Single') {
            $currentBatch += "$(Get-Date -Format 'yyyy-MM-dd HH:mm:ss.fff'): $logContent"
        } else {
            $currentBatch += $logContentBatch | ForEach-Object { "$(Get-Date -Format 'yyyy-MM-dd HH:mm:ss.fff'): $_" }
        }

        # 达到阈值时批量写入
        if ($currentBatch.Count -ge $batchSize) {
            $currentBatch | Out-File -Path $logPath -Append -Encoding UTF8
            $currentBatch = @()
        }
    }

    end {
        # 写入剩余的日志条目
        if ($currentBatch.Count -gt 0) {
            $currentBatch | Out-File -Path $logPath -Append -Encoding UTF8
        }
    }
}

方案3：精简不必要的操作（轻量优化） #

针对原函数的冗余步骤做精简，减少文件系统检查和管道开销：

修改后的函数：

Function Write-Logs {
Param(
    [parameter(Mandatory=$true)][string]$logContent,
    [parameter(Mandatory=$true)][string]$logPath
)
    # 用New-Item -Force替代Test-Path+New-Item，减少一次文件检查
    $logPath = New-Item -Path $logPath -ItemType 'file' -Force | Select-Object -ExpandProperty FullName

    # 直接拼接字符串，避免Write-Output的管道开销
    "$(Get-Date -Format 'yyyy-MM-dd HH:mm:ss.fff'): $logContent" | Out-File -Path $logPath -Append -Encoding UTF8
}

内容的提问来源于stack exchange，提问作者0xNewbie Lam