Freigeben über

New-EventLog

  • Referenz
Modul:
Microsoft.PowerShell.Management

Erstellt ein neues Ereignisprotokoll und eine neue Ereignisquelle auf einem lokalen oder 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 Remotecomputer. Sie kann auch eine Ereignisquelle registrieren, die in das neue Protokoll oder in ein vorhandenes Protokoll schreibt.

Die Cmdlets, die das EventLog Substantiv (die Cmdlets für ereignisprotokollieren) enthalten, funktionieren nur in klassischen Ereignisprotokollen. Um Ereignisse aus Protokollen abzurufen, die die Windows-Ereignisprotokolltechnologie in Windows Vista und höheren Versionen von Windows verwenden, verwenden Sie Get-WinEvent.

Beispiele

Beispiel 1 : Erstellen eines neuen Ereignisprotokolls

Dieser Befehl erstellt das TestLog Ereignisprotokoll auf dem lokalen Computer und registriert eine neue Quelle dafür.

New-EventLog -Source TestApp -LogName TestLog -MessageResourceFile C:\Test\TestApp.dll

Beispiel 2 : Hinzufügen einer neuen Ereignisquelle zu einem vorhandenen Protokoll

Mit diesem Befehl wird dem Anwendungsprotokoll auf dem Remotecomputer Server01 eine neue Ereignisquelle NewTestApphinzugefügt.

$file = "C:\Program Files\TestApps\NewTestApp.dll"
New-EventLog -ComputerName Server01 -Source NewTestApp -LogName Application -MessageResourceFile $file -CategoryResourceFile $file

Der Befehl erfordert, dass sich die NewTestApp.dll Datei auf dem Server01-Computer befindet.

Parameter

-CategoryResourceFile

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

Die Datei muss auf dem Computer vorhanden sein, auf dem das Ereignisprotokoll erstellt wird. Mit diesem Parameter werden keine Dateien erstellt oder verschoben.

Typ:String
Aliase:CRF
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ComputerName

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

Der NetBIOS-Name, die IP-Adresse oder der vollqualifizierte Domänenname eines Remotecomputers. Um den lokalen Computer anzugeben, geben Sie den Computernamen, einen Punkt (.) oder localhostein.

Dieser Parameter basiert nicht auf PowerShell-Remoting. Sie können den ComputerName Parameter von Get-EventLog verwenden, auch wenn Ihr Computer nicht für die Ausführung von Remotebefehlen konfiguriert ist.

Typ:String[]
Aliase:CN
Position:3
Standardwert:Local computer
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-LogName

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 und LogDisplayName Eigenschaften des neuen Ereignisprotokolls. Wenn das Protokoll vorhanden ist, registriert New-EventLog eine neue Quelle für das Ereignisprotokoll.

Typ:String
Aliase:LN
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MessageResourceFile

Gibt den Pfad zu der Datei an, die Nachrichtenformatierungszeichenfolgen 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. Mit diesem Parameter werden keine Dateien erstellt oder verschoben.

Typ:String
Aliase:MRF
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ParameterResourceFile

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

Die Datei muss auf dem Computer vorhanden sein, auf dem das Ereignisprotokoll erstellt wird. Mit diesem Parameter werden keine Dateien erstellt oder verschoben.

Typ:String
Aliase:PRF
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Source

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

Typ:String[]
Aliase:SRC
Position:2
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Sie können keine Eingabe an dieses Cmdlet weiterleiten.

Ausgaben

Hinweise

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

Um eine Ereignisquelle in Windows Vista, Windows XP Professional oder Windows Server 2003 zu erstellen, 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, aber das Protokoll wird erst erstellt, wenn der erste Eintrag in das Protokoll geschrieben wird.

Das Betriebssystem speichert Ereignisprotokolle als Dateien.

Wenn Sie ein neues Ereignisprotokoll erstellen, wird die zugeordnete Datei im verzeichnis $Env:SystemRoot\System32\Config auf dem angegebenen Computer gespeichert.

Der Dateiname ist die ersten acht Zeichen der eigenschaft Log mit einer .evt Dateinamenerweiterung.