Limit-EventLog

参考

模块:: Microsoft.PowerShell.Management

设置用于限制事件日志大小及其条目期限的事件日志属性。

语法

Limit-EventLog
     [-LogName] <String[]>
     [-ComputerName <String[]>]
     [-RetentionDays <Int32>]
     [-OverflowAction <OverflowAction>]
     [-MaximumSize <Int64>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

说明

Limit-EventLog cmdlet 设置经典事件日志的最大大小、必须保留每个事件的时间，以及日志达到最大大小时会发生什么情况。可以使用它来限制本地或远程计算机上的事件日志。

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

示例

示例 1：增加事件日志的大小

Limit-EventLog -LogName "Windows PowerShell" -MaximumSize 20KB

此命令将本地计算机上的 Windows PowerShell 事件日志的最大大小增加到 20480 字节（20 KB）。

示例 2：保留指定持续时间的事件日志

Limit-EventLog -LogName Security -ComputerName "Server01", "Server02" -RetentionDays 7

此命令可确保服务器01 和 Server02 计算机上的安全日志中的事件至少保留 7 天。

示例 3：更改所有事件日志的溢出作

$Logs = Get-EventLog -List | foreach {$_.Log}
Limit-EventLog -OverflowAction OverwriteOlder -LogName $Logs
Get-EventLog -List

Max(K) Retain OverflowAction     Entries  Log
------ ------ --------------     -------  ---
15,168      0 OverwriteOlder       3,412  Application
512         0 OverwriteOlder           0  DFS Replication
512         0 OverwriteOlder          17  DxStudio
10,240      7 OverwriteOlder           0  HardwareEvents
512         0 OverwriteOlder           0  Internet Explorer
512         0 OverwriteOlder           0  Key Management Service
16,384      0 OverwriteOlder           4  ODiag
16,384      0 OverwriteOlder         389  OSession Security
15,168      0 OverwriteOlder      19,360  System
15,360      0 OverwriteOlder      15,828  Windows PowerShell

此示例将本地计算机上的所有事件日志的溢出作更改为 OverwriteOlder。

第一个命令获取本地计算机上所有日志的日志名称。第二个命令设置溢出作。第三个命令显示结果。

参数

-ComputerName

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

键入远程计算机的 NetBIOS 名称、Internet 协议（IP）地址或完全限定的域名（FQDN）。若要指定本地计算机，请键入计算机名称、点（.）或 localhost。

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

类型:	String[]
别名:	CN
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Confirm

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

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-LogName

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

类型:	String[]
别名:	LN
Position:	0
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-MaximumSize

指定事件日志的最大大小（以字节为单位）。输入介于 64 KB 和 4 GB 之间的值。该值必须以 64 KB（65536）分隔。

此参数指定表示经典事件日志的 System.Diagnostics.EventLog 对象的 MaximumKilobytes 属性的值。

类型:	Int64
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-OverflowAction

指定事件日志达到其最大大小时会发生什么情况。

此参数的可接受值为：

DoNotOverwrite：保留现有条目，并丢弃新条目。
OverwriteAsNeeded：每个新条目覆盖最早的条目。
OverwriteOlder：新事件覆盖早于 MinimumRetentionDays 属性指定的值的事件。如果没有早于 MinimumRetentionDays 属性值指定的事件，则丢弃新事件。

此参数指定表示经典事件日志的 System.Diagnostics.EventLog 对象的 OverflowAction 属性的值。

类型:	OverflowAction
别名:	OFA
接受的值:	OverwriteOlder, OverwriteAsNeeded, DoNotOverwrite
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RetentionDays

指定事件必须保留在事件日志中的最小天数。

此参数指定表示经典事件日志的 System.Diagnostics.EventLog 对象的 MinimumRetentionDays 属性的值。

类型:	Int32
别名:	MRD
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

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

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

输入

None

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

输出