Write-EventLog

Schreibt ein Ereignis in ein Ereignisprotokoll.

Syntax

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

Beschreibung

Das Cmdlet "Write-EventLog" schreibt ein Ereignis in ein Ereignisprotokoll.

Damit ein Ereignis in ein Ereignisprotokoll geschrieben werden kann, muss das Ereignisprotokoll auf dem Computer vorhanden sein, und die Quelle muss für das Ereignisprotokoll registriert sein.

Die Cmdlets, die das Substantiv "EventLog" enthalten (die EventLog-Cmdlets) können nur für klassische Ereignisprotokolle verwendet werden. Verwenden Sie Get-WinEvent, um Ereignisse aus Protokollen abzurufen, die die Windows-Ereignisprotokolltechnologie in Windows Vista und höheren Versionen von Windows verwenden.

Parameter

-Category <Int16>

Gibt eine Aufgabenkategorie für das Ereignis an. Geben Sie eine ganze Zahl ein, die den Zeichenfolgen in der Kategoriemeldungsdatei für das Ereignisprotokoll zugeordnet ist.

-ComputerName <string>

Gibt einen Remotecomputer an. Der Standardwert ist der lokale Computer.

Geben Sie den NetBIOS-Namen, eine IP-Adresse oder den vollqualifizierten Domänennamen eines Remotecomputers ein.

Dieser Parameter beruht nicht auf Windows PowerShell-Remoting. Sie können den ComputerName-Parameter von Get-EventLog auch dann verwenden, wenn der Computer nicht für das Ausführen von Remotebefehlen konfiguriert ist.

-EntryType <EventLogEntryType>

Gibt den Eintragstyp des Ereignisses an. Gültige Werte sind "Error", "Warning", "Information", "SuccessAudit" und "FailureAudit". Der Standardwert ist "Information".

Eine Beschreibung der Werte finden Sie unter "System.Diagnostics.EventLogEntryType" in der MSDN Library (Microsoft Developer Network) unter "https://go.microsoft.com/fwlink/?LinkId=143599" (möglicherweise auf Englisch).

-EventID <int>

Gibt die Ereignis-ID an. Dieser Parameter ist erforderlich.

-LogName <string>

Gibt den Namen des Protokolls an, in das das Ereignis geschrieben wird. Geben Sie den Protokollnamen (den Wert der Log-Eigenschaft, nicht den "LogDisplayName") ein. Platzhalterzeichen sind nicht zulässig. Dieser Parameter ist erforderlich.

-Message <string>

Gibt die Ereignismeldung an. Dieser Parameter ist erforderlich.

-RawData <Byte[]>

Gibt die dem Ereignis zugeordneten Binärdaten in Bytes an.

-Source <string>

Gibt die Ereignisquelle an. Dabei handelt es sich normalerweise um den Namen der Anwendung, die das Ereignis in das Protokoll schreibt.

<CommonParameters>

Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.

Eingaben und Ausgaben

Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.

Hinweise

Wenn Sie Write-EventLog unter Windows Vista und höheren Versionen von Windows verwenden möchten, starten Sie Windows PowerShell mit der Option "Als Administrator ausführen".

Beispiel 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

Beschreibung
-----------
Dieser Befehl schreibt ein Ereignis aus der Quelle "MyApp" in das Anwendungsereignisprotokoll.

Beispiel 2

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

Beschreibung
-----------
Dieser Befehl schreibt ein Ereignis aus der Quelle "MyApp" in das Anwendungsereignisprotokoll auf dem Remotecomputer "Server01".

Siehe auch

Konzepte

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