Remove-EventLog

参考

模块:: Microsoft.PowerShell.Management

删除事件日志或注销事件源。

语法

Remove-EventLog
      [[-ComputerName] <String[]>]
      [-LogName] <String[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-EventLog
      [[-ComputerName] <String[]>]
      [-Source <String[]>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

说明

Remove-EventLog cmdlet 从本地或远程计算机中删除事件日志文件，并注销日志的所有事件源。你还可以使用此 cmdlet 注销事件源，而无需删除任何事件日志。

包含 EventLog 名词（ 即 EventLog cmdlet）的 cmdlet 仅适用于经典事件日志。若要从 Windows Vista 和更高版本的 Windows 操作系统中使用 Windows 事件日志技术的日志获取事件，请使用 Get-WinEvent。

警告：此 cmdlet 可能会删除操作系统事件日志，这可能会导致应用程序故障和意外的系统行为。

示例

示例 1：从本地计算机中删除事件日志

PS C:\> Remove-EventLog -LogName "MyLog"

此命令从本地计算机中删除 MyLog 事件日志并注销其事件源。

示例 2：从多台计算机中删除事件日志

PS C:\> Remove-EventLog -LogName "MyLog", "TestLog" -ComputerName "Server01", "Server02", "localhost"

此命令从本地计算机以及 Server01 和 Server02 远程计算机中删除 MyLog 和 TestLog 事件日志。该命令也将注销这些日志的事件源。

示例 3：删除事件源

PS C:\> Remove-EventLog -Source "MyApp"

此命令从本地计算机上的日志中删除 MyApp 事件源。命令完成后，MyApp 程序无法写入任何事件日志。

示例 4：删除事件日志并确认操作

The first command lists the event logs on the local computer.
PS C:\> Get-EventLog -List
Max(K) Retain OverflowAction        Entries Log
------ ------ --------------        ------- ---
15,168      0 OverwriteAsNeeded      22,923 Application
15,168      0 OverwriteAsNeeded          53 DFS Replication
15,168      7 OverwriteOlder              0 Hardware Events
512      7 OverwriteOlder              0 Internet Explorer
20,480      0 OverwriteAsNeeded           0 Key Management Service
30,016      0 OverwriteAsNeeded      50,060 Security
15,168      0 OverwriteAsNeeded      27,592 System
15,360      0 OverwriteAsNeeded      18,355 Windows PowerShell
15,168      7 OverwriteAsNeeded          12 ZapLog

The second command deletes the ZapLog event log.
PS C:\> Remove-EventLog -LogName "ZapLog"

The third command lists the event logs again. The ZapLog event log no longer appears in the list.
PS C:\> Get-EventLog -List
Max(K) Retain OverflowAction        Entries Log
------ ------ --------------        ------- ---
15,168      0 OverwriteAsNeeded      22,923 Application
15,168      0 OverwriteAsNeeded          53 DFS Replication
15,168      7 OverwriteOlder              0 Hardware Events
512      7 OverwriteOlder              0 Internet Explorer
20,480      0 OverwriteAsNeeded           0 Key Management Service
30,016      0 OverwriteAsNeeded      50,060 Security
15,168      0 OverwriteAsNeeded      27,592 System
15,360      0 OverwriteAsNeeded      18,355 Windows PowerShell

这些命令演示如何列出计算机上的事件日志并验证 Remove-EventLog 命令是否成功。

示例 5：删除事件源并确认操作

PS C:\> Get-WmiObject win32_nteventlogfile -Filter "logfilename='TestLog'" | foreach {$_.sources}
MyApp
TestApp
PS C:\> Remove-Eventlog -Source "MyApp"
PS C:\> Get-WmiObject win32_nteventlogfile -Filter "logfilename='TestLog'"} | foreach {$_.sources}
TestApp

这些命令使用 Get-WmiObject cmdlet 列出本地计算机上的事件源。可以使用这些命令验证用于删除事件源的命令是否成功。

第一个命令获取本地计算机上 TestLog event 日志的事件源。 MyApp 就是其中一个事件源。

第二个命令使用 Remove-EventLog 的 Source 参数删除 MyApp 事件源。

第三个命令与第一个命令相同。它显示 MyApp 事件源已删除。

参数

-ComputerName

指定远程计算机。默认为本地计算机。

键入远程计算机的 NetBIOS 名称、IP 地址或完全限定的域名。若要指定本地计算机，请键入该计算机名称、句点 (.) 或 localhost。

此参数不依赖于 Windows PowerShell 远程处理。即使计算机未配置为运行远程命令，也可以使用 Remove-EventLog 的 ComputerName 参数。

Type:	String[]
Aliases:	CN
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

提示你在运行 cmdlet 之前进行确认。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LogName

指定事件日志。输入一个或多个事件日志的日志名称，用逗号分隔。日志名称是 Log 属性的值，而不是 LogDisplayName，不允许使用通配符。此参数是必需的。

Type:	String[]
Aliases:	LN
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Source

指定此 cmdlet 注销的事件源。输入源名称，而不是可执行文件名称，用逗号分隔。

Type:	String[]
Aliases:	SRC
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。此 cmdlet 未运行。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

输入

None

不能通过管道将输入传递给此 cmdlet。

输出