在 PowerShell 脚本中将输出写入日志文件

您可以使用简单的文本日志文件来控制运行并跟踪 PowerShell 脚本中的所有活动。这在调试错误或审核脚本操作时非常有用。在本文中，我们将展示一些通过将输出写入文本日志文件来在 PowerShell 脚本中使用日志记录的方法。

在最简单的情况下，如果要将信息消息或 PowerShell 命令结果的输出写入文本日志文件，可以使用以下格式之一将 PS 输出重定向到文本文件：

Write-Output "Files are successfully created in $env:computername" >> C:\PS\Logs\TestLog.txt
Add-Content -Path C:\PS\Logs\TestLog.txt -Value "Files are successfully created in $env:computername"
"Files are successfully created in $env:computername" | Out-File -FilePath C:\PS\Logs\TestLog.txt -Append

在所有情况下，命令都会使用您指定的文本向 txt 文件添加新行。

如果您想每次都覆盖日志文件内容，请使用

Set-Content

cmdlet。

此方法的主要缺点是您无法确定条目何时写入日志（发生事件）。您可以将当前时间戳添加到日志文件中。它将有助于识别脚本运行和特定事件发生的时间。

为了使其更方便，您可以在 PowerShell 脚本中创建一个单独的函数，将接收到的数据写入日志文件并添加每个事件的时间戳。

您可以创建一个函数，如下所示：

$Logfile = "C:\PS\Logs\proc_$env:computername.log"
function WriteLog
{
Param ([string]$LogString)
$Stamp = (Get-Date).toString("yyyy/MM/dd HH:mm:ss")
$LogMessage = "$Stamp $LogString"
Add-content $LogFile -value $LogMessage
}

如果您想记录某些内容，请调用 WriteLog 函数。

WriteLog "The script is run"
WriteLog "Calculating…."
Start-Sleep 20
WriteLog "The script is successfully executed"

现在您可以看到日志文件中每个条目的时间。

您可以更换

Write-Host

打电话给

LogWrite

你的脚本中的那些。

PowerShell 具有内置的转录功能，可将 PS 控制台中显示的所有命令和输出保存到文本日志文件中。

要记录当前的 PowerShell 会话，请使用 Start-Transcript cmdlet。

运行命令后，会出现一条消息，显示所有命令的输出都记录到的文件。默认情况下，日志文件位于当前用户配置文件中：

Transcript started, output file is C:\Users\user\Documents\PowerShell_transcript.DESKTOP-P2FHTKQ.+IzDgZiN.20210908163729.txt

您可以指定文本文件的路径，如下所示：

Start-Transcript -Append C:\PS\Logs\PSScriptLog.txt

-Append 选项表示新会话将记录到文件末尾（而不覆盖它）。

运行一些 PowerShell 命令，将结果输出到控制台。例如，让我们显示正在运行的进程、服务和 AD 复制状态的列表：

Get-Process| where-object {$_.WorkingSet -GT 500000*1024}|select processname,@{l="Used RAM(MB)"; e={$_.workingset / 1mb}} |sort "Used RAM(MB)" -Descending
Get-Service | Where-Object {$_.status -eq 'Running'}
Get-ADReplicationFailure -Target mun-dc01

停止记录当前 PowerShell 会话：

Stop-Transcript

然后打开转录日志文件。

如您所见，日志显示了在控制台中运行的 PowerShell 命令的完整历史记录以及所有输出。

所有错误和警告也会被记录下来，在调试复杂的 PowerShell 脚本时非常方便。

您可以使用

Start-Transcript

和

Stop-Transcript

PowerShell 脚本中的 cmdlet 可本机记录所有操作和输出。

使用组策略选项打开 PowerShell 转录（计算机配置 -> 管理模板 -> Windows 组件 -> Windows PowerShell），您可以启用计算机上所有运行的 PowerShell 命令和输出的自动日志记录。更新计算机上的 GPO 设置后，将为每个正在运行的 powershell.exe 进程创建一个单独的文本日志文件，并记录所有 PS 命令及其输出。