Limit-EventLog

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

Limit-EventLog コマンドレットは、クラシック イベント ログの最大サイズ、各イベントを保持する必要がある期間、ログが最大サイズに達したときの動作を設定します。 これを使用して、ローカル コンピューターまたはリモート コンピューター上のイベント ログを制限できます。

EventLog 名詞 (EventLog コマンドレット) を含むコマンドレットは、クラシック イベント ログでのみ機能します。 Windows Vista 以降のバージョンの Windows で Windows イベント ログ テクノロジを使用するログからイベントを取得するには、Get-WinEvent を使用します。

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

このコマンドは、ローカル コンピューター上の Windows PowerShell イベント ログの最大サイズを 20480 バイト (20 KB) に増やします。

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

このコマンドを実行すると、Server01 および Server02 コンピューターのセキュリティ ログ内のイベントが少なくとも 7 日間保持されます。

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 に変更します。

最初のコマンドは、ローカル コンピューター上のすべてのログのログ名を取得します。 2 番目のコマンドは、オーバーフロー アクションを設定します。 3 番目のコマンドは結果を表示します。

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

このコマンドレットに入力を pip することはできません。

このコマンドレットは出力を生成しません。

• Windows Vista 以降のバージョンの Windows でこのコマンドレットを使用するには、[管理者として実行] オプションを使用して Windows PowerShell を開きます。

  このコマンドレットは、クラシック イベント ログを表す System.Diagnostics.EventLog オブジェクトのプロパティを変更します。 イベント ログのプロパティの現在の設定を表示するには、「Get-EventLog -List」と入力します。