多实例PowerShell脚本使用Start-Transcript写入同一日志文件的问题求助

问题根源 #

PowerShell的Start-Transcript搭配-Append参数时，仅支持单进程场景下的日志追加。第一个启动的实例会独占日志文件的写入锁，后续实例因无法获取文件锁，导致日志无法写入——这是Windows文件系统的排他锁机制导致的，并非你遗漏了PowerShell特性。

可行解决方案 #

方案1：自定义共享日志函数替代Transcript #

放弃直接使用Start-Transcript，用Add-Content实现支持多实例写入的日志函数，它默认采用共享写入模式，不会锁死文件。示例代码：

function Write-SharedLog {
    param(
        [Parameter(Mandatory=$true)]
        [string]$Content,
        [string]$LogFile = ".\shared_script.log"
    )
    $timestamp = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
    $logEntry = "[$timestamp] [$env:PROCESS_ID] $Content"
    Add-Content -Path $LogFile -Value $logEntry -Encoding UTF8
}

# 调用示例
Write-SharedLog -Content "脚本实例启动"
Write-SharedLog -Content "完成数据处理操作"

这个函数支持多个脚本实例同时写入同一日志，还能通过进程ID区分不同实例的日志条目。

方案2：用命名管道中转日志（保留Transcript完整输出） #

如果必须保留Start-Transcript的全量控制台输出，可启动一个单独的后台进程负责写入日志，其他实例通过命名管道将Transcript内容转发给它：

1. 先启动日志守护进程（只需运行一次）：

$pipeName = "SharedScriptLogPipe"
while ($true) {
    $pipe = New-Object System.IO.Pipes.NamedPipeServerStream($pipeName, [System.IO.Pipes.PipeDirection]::In)
    $pipe.WaitForConnection()
    $reader = New-Object System.IO.StreamReader($pipe)
    while ($line = $reader.ReadLine()) {
        Add-Content -Path ".\shared_transcript.log" -Value $line -Encoding UTF8
    }
    $reader.Close()
    $pipe.Close()
}

2. 在每个脚本实例中，将Transcript输出定向到命名管道：

$pipeName = "SharedScriptLogPipe"
$pipe = New-Object System.IO.Pipes.NamedPipeClientStream(".", $pipeName, [System.IO.Pipes.PipeDirection]::Out)
$pipe.Connect()
$writer = New-Object System.IO.StreamWriter($pipe)
$writer.AutoFlush = $true

# 启动Transcript并将输出发送到管道
Start-Transcript -Path "pipe:$pipeName" -NoClobber
# 这里编写你的脚本逻辑
Write-Host "实例[$env:PROCESS_ID]开始执行任务"
# ...
Stop-Transcript

$writer.Close()
$pipe.Close()

这种方式既保留了Start-Transcript的完整输出格式，又实现了多实例共享写入同一日志文件。

关键提示 #

• Start-Transcript的-Append参数仅针对单进程设计，多进程场景下必然遇到文件锁问题。
• Add-Content是多实例日志写入的可靠选择，默认的文件共享模式允许多进程同时操作同一文件。

内容的提问来源于stack exchange，提问作者SHANIL t s