Write-EventLog

Articolo
10/30/2009

Scrive un evento in un registro eventi.

Sintassi

Write-EventLog [-LogName] <string> [-Source] <string> [-EventID] <int> [-Message] <string> [[-EntryType] {<Error> | <Warning> | <Information> | <SuccessAudit> | <FailureAudit>}] [-Category <Int16>] [-ComputerName <string>] [-RawData <Byte[]>] [<CommonParameters>]

Descrizione

Il cmdlet Write-EventLog scrive un evento in un registro eventi.

Per scrivere un evento in un registro eventi, è necessario che quest'ultimo esista nel computer e che l'origine venga registrata per il registro eventi.

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

-Category <Int16>

Specifica una categoria di attività per l'evento. Immettere un valore intero associato alle stringhe nel file di messaggi delle categorie per il registro eventi.

Obbligatorio?	false
Posizione?	named
Valore predefinito	1
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-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.

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?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-EntryType <EventLogEntryType>

Specifica il tipo di voce dell'evento. I valori validi sono Error, Warning, Information, SuccessAudit e FailureAudit. Il valore predefinito è Information.

Per una descrizione dei valori, vedere System.Diagnostics.EventLogEntryType in MSDN (Microsoft Developer Network) Library all'indirizzo https://go.microsoft.com/fwlink/?LinkId=143599 (le informazioni potrebbero essere in lingua inglese).

Obbligatorio?	false
Posizione?	4
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-EventID <int>

Specifica l'identificatore evento. Questo parametro è obbligatorio.

Obbligatorio?	true
Posizione?	3
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-LogName <string>

Specifica il nome del registro in cui viene scritto l'evento. Immettere il nome del registro (il valore della proprietà Log, non LogDisplayName). Non è consentito l'utilizzo di caratteri jolly. Questo parametro è obbligatorio.

Obbligatorio?	true
Posizione?	1
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-Message <string>

Specifica il messaggio dell'evento. Questo parametro è obbligatorio.

Obbligatorio?	true
Posizione?	5
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-RawData <Byte[]>

Specifica i dati binari associati all'evento, in byte.

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-Source <string>

Specifica l'origine evento che è in genere il nome dell'applicazione che scrive l'evento nel registro.

Obbligatorio?	true
Posizione?	2
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 l'input a questo cmdlet.

Output

System.Diagnostics.EventLogEntry

Write-EventLog restituisce oggetti che rappresentano gli eventi nei registri.

Note

Per utilizzare Write-EventLog in Windows Vista e nelle versioni successive di Windows, avviare Windows PowerShell con l'opzione "Esegui come amministratore".

Esempio 1

C:\PS>write-eventlog -logname Application -source MyApp -eventID 3001 -entrytype Information -message "MyApp added a user-requested feature to the display." -category 1 -rawdata 10,20

Descrizione
-----------
In questo comando viene scritto un evento dall'origine MyApp nel registro eventi dell'applicazione.

Esempio 2

C:\PS>write-eventlog -computername Server01 -logname Application -source MyApp -eventID 3001 -message "MyApp added a user-requested feature to the display."

Descrizione
-----------
In questo comando viene scritto un evento dall'origine MyApp nel registro eventi dell'applicazione nel computer remoto Server01.

Vedere anche

Concetti

Clear-EventLog
Get-EventLog
Limit-EventLog
New-EventLog
Remove-EventLog
Show-EventLog
Write-EventLog
Get-WinEvent

Condividi tramite