Clear-EventLog
Elimina tutte le voci dai registri eventi specificati nei computer locali o remoti.
Sintassi
Clear-EventLog [-LogName] <string[]> [[-ComputerName] <string[]>] [-Confirm] [-WhatIf] [<CommonParameters>]
Descrizione
Con il cmdlet Clear-EventLog vengono eliminate tutte le voci dai registri eventi specificati nel computer locali o nei computer remoti. Per utilizzare Clear-EventLog, è necessario essere un membro del gruppo Administrators nel computer interessato.
I cmdlet che contengono il sostantivo EventLog (cmdlet EventLog) funzionano solo su registri eventi classici. Per ottenere eventi da registri che utilizzano la tecnologia Registro eventi di Windows in Windows Vista e nelle versioni successive di Windows, utilizzare Get-WinEvent.
Parametri
-ComputerName <string[]>
Specifica un computer remoto. Il valore predefinito è il computer locale.
Digitare il nome NetBIOS, un indirizzo IP (Internet Protocol) o un nome di dominio completo di un computer remoto. Per specificare il computer locale, digitare il nome del computer, un punto (.) o "localhost".
Questo parametro non si basa sulla comunicazione remota di Windows PowerShell. È possibile utilizzare il parametro ComputerName di Get-EventLog anche se il computer non è configurato per l'esecuzione di comandi remoti.
Obbligatorio? |
false |
Posizione? |
2 |
Valore predefinito |
Local computer |
Accettare input da pipeline? |
true (ByPropertyName) |
Accettare caratteri jolly? |
false |
-LogName <string[]>
Specifica i registri eventi. Immettere il nome del registro, ovvero il valore della proprietà Log e non di LogDisplayName, di uno o più registri eventi separati da virgole. Non è consentito l'utilizzo di caratteri jolly. Questo parametro è obbligatorio.
Obbligatorio? |
true |
Posizione? |
1 |
Valore predefinito |
|
Accettare input da pipeline? |
true (ByPropertyName) |
Accettare caratteri jolly? |
false |
-Confirm
Chiede una conferma prima di eseguire il comando.
Obbligatorio? |
false |
Posizione? |
named |
Valore predefinito |
|
Accettare input da pipeline? |
false |
Accettare caratteri jolly? |
false |
-WhatIf
Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.
Obbligatorio? |
false |
Posizione? |
named |
Valore predefinito |
|
Accettare input da pipeline? |
false |
Accettare caratteri jolly? |
false |
<CommonParameters>
Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.
Input e output
Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.
Input |
Nessuno Non è possibile reindirizzare oggetti a Clear-EventLog. |
Output |
Nessuno Questo cmdlet non genera alcun output. |
Note
Per utilizzare Clear-EventLog in Windows Vista e nelle versioni successive di Windows, avviare Windows PowerShell con l'opzione "Esegui come amministratore".
Esempio 1
C:\PS>clear-eventlog "Windows PowerShell"
Descrizione
-----------
Con questo comando vengono eliminate le voci dal registro eventi "Windows PowerShell" nel computer locale.
Esempio 2
C:\PS>clear-eventlog -logname ODiag, OSession -computername localhost, Server02
Descrizione
-----------
Con questo comando vengono eliminate tutte le voci nei registri Microsoft Office Diagnostics (ODiag) e Microsoft Office Sessions (OSession) nel computer locale e nel computer remoto Server02.
Esempio 3
C:\PS>clear-eventlog -log application, system -confirm
Descrizione
-----------
Con questo comando viene richiesta la conferma prima di eliminare le voci nei registri eventi specificati.
Esempio 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
Descrizione
-----------
Con questa funzione vengono cancellati tutti i registri eventi nei computer specificati e viene visualizzato l'elenco dei registri eventi risultante.
Si noti che sono state aggiunte alcune voci ai registri System e Security dopo la cancellazione dei registri, ma prima della loro visualizzazione.
Vedere anche
Concetti
Get-EventLog
Limit-EventLog
New-EventLog
Remove-EventLog
Show-EventLog
Write-EventLog
Get-WinEvent