Erstellt ein neues Ereignisprotokoll und eine neue Ereignisquelle auf einem lokalen oder einem Remotecomputer.

Syntax

New-EventLog [-LogName] <string> [-Source] <string[]> [[-ComputerName] <string[]>] [-CategoryResourceFile <string>] [-MessageResourceFile <string>] [-ParameterResourceFile <string>] [<CommonParameters>]

Beschreibung

Dieses Cmdlet erstellt ein neues klassisches Ereignisprotokoll auf einem lokalen oder einem Remotecomputer. Außerdem kann eine Ereignisquelle registriert werden, die in das neue Protokoll oder ein in vorhandenes Protokoll schreibt.

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

-CategoryResourceFile <string>

Gibt den Pfad zu der Datei an, die Kategoriezeichenfolgen für die Quellereignisse enthält. Diese Datei wird auch als Kategoriemeldungsdatei bezeichnet.

Die Datei muss auf dem Computer vorhanden sein, auf dem das Ereignisprotokoll erstellt wird. Dieser Parameter erstellt und verschiebt keine Dateien.

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-ComputerName <string[]>

Erstellt die neuen Ereignisprotokolle auf den angegebenen Computern. Der Standardwert ist der lokale Computer.

Geben Sie den NetBIOS-Namen, eine IP-Adresse oder den vollqualifizierten Domänennamen eines Remotecomputers ein. Um den lokalen Computer anzugeben, geben Sie den Computernamen, einen Punkt (.) oder "localhost" 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.

Erforderlich?

false

Position?

3

Standardwert

.

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-LogName <string>

Gibt den Namen des Ereignisprotokolls an.

Wenn das Protokoll nicht vorhanden ist, erstellt New-EventLog das Protokoll und verwendet diesen Wert für die Log-Eigenschaft und die LogDisplayName-Eigenschaft des neuen Ereignisprotokolls. Wenn das Protokoll vorhanden ist, registriert New-EventLog eine neue Quelle für das Ereignisprotokoll.

Erforderlich?

true

Position?

1

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-MessageResourceFile <string>

Gibt den Pfad zu der Datei an, die Formatzeichenfolgen für Nachrichten für die Quellereignisse enthält. Diese Datei wird auch als Ereignismeldungsdatei bezeichnet.

Die Datei muss auf dem Computer vorhanden sein, auf dem das Ereignisprotokoll erstellt wird. Dieser Parameter erstellt und verschiebt keine Dateien.

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-ParameterResourceFile <string>

Gibt an den Pfad zu der Datei mit Zeichenfolgen an, die für die Parameterersetzungen in Ereignisbeschreibungen verwendet werden. Diese Datei wird auch als Parametermeldungsdatei bezeichnet.

Die Datei muss auf dem Computer vorhanden sein, auf dem das Ereignisprotokoll erstellt wird. Dieser Parameter erstellt und verschiebt keine Dateien.

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-Source <string[]>

Gibt die Namen der Ereignisprotokollquellen an, z. B. Anwendungen, die in das Ereignisprotokoll schreiben. Dieser Parameter ist erforderlich.

Erforderlich?

true

Position?

2

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

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

Eingaben

None

Eingaben können nicht über die Pipeline an dieses Cmdlet übergeben werden.

Ausgaben

System.Diagnostics.EventLogEntry

Hinweise

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

Zum Erstellen einer Ereignisquelle in Windows Vista, Windows XP Professional oder Windows Server 2003 müssen Sie Mitglied der Gruppe "Administratoren" auf dem Computer sein.

Wenn Sie ein neues Ereignisprotokoll und eine neue Ereignisquelle erstellen, registriert das System die neue Quelle für das neue Protokoll, das Protokoll wird jedoch erst erstellt, wenn der erste Eintrag darin geschrieben wird.

Das Betriebssystem speichert Ereignisprotokolle als Dateien. Wenn Sie ein neues Ereignisprotokoll erstellen, wird die dazugehörige Datei auf dem angegebenen Computer im Verzeichnis "%SystemRoot%\System32\Config" gespeichert. Der Dateiname besteht aus den ersten acht Zeichen der Log-Eigenschaft und der Dateinamenerweiterung ".evt".

Beispiel 1

C:\PS>new-eventlog -source TestApp -logname TestLog -MessageResourceFile C:\Test\TestApp.dll

Beschreibung
-----------
Mit diesem Befehl wird das Ereignisprotokoll "TestLog" auf dem lokalen Computer erstellt und eine neue Quelle dafür registriert.






Beispiel 2

C:\PS>$file = "C:\Program Files\TestApps\NewTestApp.dll"

C:\PS> new-eventlog -computername Server01 -source NewTestApp -logname Application -MessageResourceFile $file -CategoryResourceFile $file

Beschreibung
-----------
Mit diesem Befehl wird die neue Ereignisquelle "NewTestApp" dem Anwendungsprotokoll auf dem Remotecomputer "Server01" hinzugefügt.

Für diesen Befehl muss sich die Datei "NewTestApp.dll" auf dem Computer "Server01" befinden.






Siehe auch




Inhaltsverzeichnis