Limit-EventLog

Specifies a remote computer. The default is the local computer.

Type the NetBIOS name, an Internet Protocol (IP) address, or a fully qualified domain name of a remote computer. To specify the local computer, type the computer name, a dot (.), or "localhost".

This parameter does not rely on Windows PowerShell remoting. You can use the ComputerName parameter of Limit-EventLog even if your computer is not configured to run remote commands.

Specifies the event logs. Enter the log name (the value of the Log property; not the LogDisplayName) of one or more event logs , separated by commas. Wildcard characters are not permitted. This parameter is required.

Specifies the maximum size of the event logs in bytes. Enter a value between 64 kilobytes (KB) and 4 gigabytes (GB). The value must be divisible by 64 KB (65536).

This parameter specifies the value of the MaximumKilobytes property of the System.Diagnostics.EventLog object that represents a classic event log.

Specifies what happens when the event log reaches its maximum size.

Valid values are:

-- DoNotOverwrite: Existing entries are retained and new entries are discarded.

-- OverwriteAsNeeded: Each new entry overwrites the oldest entry.

-- OverwriteOlder: New events overwrite events older than the value specified by the MinimumRetentionDays property. If there are no events older than specified by the MinimumRetentionDays property value, new events are discarded.

This parameter specifies the value of the OverflowAction property of the System.Diagnostics.EventLog object that represents a classic event log.

Specifies the minimum number of days that an event must remain in the event log.

This parameter specifies the value of the MinimumRetentionDays property of the System.Diagnostics.EventLog object that represents a classic event log.

Prompts you for confirmation before running the cmdlet.

Shows what would happen if the cmdlet runs. The cmdlet is not run.

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see  about_CommonParameters (http://go.microsoft.com/fwlink/p/?LinkID=113216).

This command increases the maximum size of the Windows PowerShell event log on the local computer to 20480 kilobytes (KB) (20 KB).

PS C:\> limit-eventLog -logname "Windows PowerShell" -MaximumSize 20KB

This command ensures that events in the Security log on the Server01 and Server02 computers are retained for at least 7 days.

PS C:\> limit-eventlog -logname Security -comp Server01, Server02 -retentionDays 7

These commands change the overflow action of all event logs on the local computer to "OverwriteOlder".

The first command gets the log names of all of the logs on the local computer. The second command sets the overflow action. The third command displays the results.

PS C:\> $logs = get-eventlog -list | foreach {$_.log}PS C:\>limit-eventlog -overflowaction OverwriteOlder -logname $logsPS C:\>get-eventlog -listMax(K) Retain OverflowAction     Entries  Log------ ------ --------------     -------  ---15,168      0 OverwriteOlder       3,412  Application512      0 OverwriteOlder           0  DFS Replication512      0 OverwriteOlder          17  DxStudio10,240      7 OverwriteOlder           0  HardwareEvents512      0 OverwriteOlder           0  Internet Explorer512      0 OverwriteOlder           0  Key Management Service16,384      0 OverwriteOlder           4  ODiag16,384      0 OverwriteOlder         389  OSessionSecurity15,168      0 OverwriteOlder      19,360  System15,360      0 OverwriteOlder      15,828  Windows PowerShell