Limit-EventLog

参考

模块:: Microsoft.PowerShell.Management

设置限制事件日志大小及其条目存在时间的事件日志属性。

语法

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

说明

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

包含 EventLog 名词的 cmdlet (EventLog cmdlet) 仅适用于传统事件日志。若要从使用 Windows Vista 以及 Windows 更高版本中的 Windows 事件日志技术的日志中获取事件，请使用 Get-WinEvent。

示例

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

PS C:\> Limit-EventLog -LogName "Windows PowerShell" -MaximumSize 20KB

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

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

PS C:\> Limit-EventLog -LogName Security -ComputerName "Server01", "Server02" -RetentionDays 7

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

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

PS C:\> $Logs = Get-EventLog -List | ForEach {$_.log}
PS C:\> Limit-EventLog -OverflowAction OverwriteOlder -LogName $Logs
PS C:\> 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 的 ComputerName 参数。

Type:	String[]
Aliases:	CN
Position:	Named
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

-MaximumSize

指定事件日志的最大大小（以字节为单位）。输入一个介于 64 千字节 (KB) 和 4 千兆字节 (GB) 之间的值。该值必须能够被 64 KB (65536) 整除。

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

Type:	Int64
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-OverflowAction

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

此参数的可接受值为：

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

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

Type:	OverflowAction
Aliases:	OFA
Accepted values:	OverwriteOlder, OverwriteAsNeeded, DoNotOverwrite
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RetentionDays

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

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

Type:	Int32
Aliases:	MRD
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。

输出