在本機或遠端電腦上刪除特定事件記錄檔的所有記錄。

語法

Clear-EventLog [-LogName] <string[]> [[-ComputerName] <string[]>] [-Confirm] [-WhatIf] [<CommonParameters>]

描述

Clear-EventLog Cmdlet 會在本機或遠端電腦上刪除特定事件記錄檔的所有記錄。若要使用 Clear-EventLog,那麼在受影響的電腦上,您必須是 Administrators 群組的成員。

有 EventLog 名詞的 Cmdlet (EventLog Cmdlet) 只適用於傳統事件記錄檔。若要在 Windows Vista 和較新版本的 Windows 上,從使用 Windows 事件記錄檔技術的記錄檔中取得事件,請使用 Get-WinEvent。

參數

-ComputerName <string[]>

指定遠端電腦。預設為本機電腦。

請輸入遠端電腦的 NetBIOS 名稱、網際網路通訊協定 (IP) 位址或完整網域名稱。若要指定本機電腦,請輸入電腦名稱、句點 (.) 或 "localhost"。

此參數並不依存於 Windows PowerShell 遠端。即使沒有將電腦設定成執行遠端命令,也可以使用 Get-EventLog 的 ComputerName 參數。

必要?

false

位置?

2

預設值

Local computer

接受管線輸入?

true (ByPropertyName)

接受萬用字元?

false

-LogName <string[]>

指定事件記錄檔。輸入一個或多個事件記錄檔的記錄檔名稱 (是 Log 屬性的值,而非 LogDisplayName),以逗號分隔。不允許使用萬用字元。此參數為必要項。

必要?

true

位置?

1

預設值

接受管線輸入?

true (ByPropertyName)

接受萬用字元?

false

-Confirm

在執行命令前先提示確認。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-WhatIf

說明執行命令時將會發生何種情況,但不會實際執行命令。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

<CommonParameters>

這個 Cmdlet 支援一般參數:-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊,請參閱 about_Commonparameters.

輸入和輸出

輸入型別是可經由管道輸出至 Cmdlet 的物件型別。傳回型別則是 Cmdlet 所傳回的物件型別。

輸入

您無法經由管道將物件輸出至 Clear-EventLog。

輸出

這個 Cmdlet 不會產生任何輸出。

附註

若要在 Windows Vista 與較新版本的 Windows 上使用 Clear-EventLog,請以 [以系統管理員身分執行] 選項啟動 Windows PowerShell。

範例 1

C:\PS>clear-eventlog "Windows PowerShell"

描述
-----------
這個命令會在本機電腦上刪除 "Windows PowerShell" 事件記錄檔的記錄。






範例 2

C:\PS>clear-eventlog -logname ODiag, OSession -computername localhost, Server02

描述
-----------
這個命令會在本機電腦與 Server02 遠端電腦上,刪除 Microsoft Office Diagnostics (ODiag) 與 Microsoft Office Sessions (OSession) 記錄檔中的所有記錄。






範例 3

C:\PS>clear-eventlog -log application, system -confirm

描述
-----------
這個命令會先提示您進行確認,然後再刪除特定事件記錄檔中的記錄。






範例 4

C:\PS>function clear-all-event-logs ($computerName="localhost")
{
    $logs = get-eventlog -computername $computername -list | foreach {$_.Log} 
    $logs | foreach {clear-eventlog -comp $computername -log $_ }
    get-eventlog -computername $computername -list
}

C:\PS> clear-all-event-logs -comp Server01

  Max(K) Retain OverflowAction        Entries Log                                                                                                      
  ------ ------ --------------        ------- ---                                                                                                      
  15,168      0 OverwriteAsNeeded           0 Application                                                                                               
  15,168      0 OverwriteAsNeeded           0 DFS Replication                                                                                           
     512      7 OverwriteOlder              0 DxStudio                                                                                                  
  20,480      0 OverwriteAsNeeded           0 Hardware Events                                                                                           
     512      7 OverwriteOlder              0 Internet Explorer                                                                                         
  20,480      0 OverwriteAsNeeded           0 Key Management Service                                                                                    
  16,384      0 OverwriteAsNeeded           0 Microsoft Office Diagnostics                                                                              
  16,384      0 OverwriteAsNeeded           0 Microsoft Office Sessions                                                                                 
  30,016      0 OverwriteAsNeeded           1 Security                                                                                                  
  15,168      0 OverwriteAsNeeded           2 System                                                                                                    
  15,360      0 OverwriteAsNeeded           0 Windows PowerShell

描述
-----------
這個函數會刪除特定電腦上的所有事件記錄檔,然後顯示產生的事件記錄檔清單。

請注意,在記錄檔清除後但在顯示記錄檔之前,會有幾筆記錄加入 System 與 Security 記錄檔中。






請參閱




目錄