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