Remove-Event

Artikel
10/30/2009

Löscht Ereignisse aus der Ereigniswarteschlange.

Syntax

Remove-Event [-EventIdentifier] <int> [-Confirm] [-WhatIf] [<CommonParameters>]

Remove-Event [-SourceIdentifier] <string> [-Confirm] [-WhatIf] [<CommonParameters>]

Beschreibung

Mit dem Cmdlet "Remove-Event" werden Ereignisse aus der Ereigniswarteschlange in der aktuellen Sitzung gelöscht.

Dieses Cmdlet löscht nur die gegenwärtig in der Warteschlange vorhandenen Ereignisse. Um Ereignisregistrierungen abzubrechen oder das Abonnement von Ereignissen zu kündigen, verwenden Sie das Cmdlet "Unregister-Event".

Parameter

-EventIdentifier <int>

Löscht nur das Ereignis mit der angegebenen Ereignis-ID. In jedem Befehl ist ein EventIdentifier-Parameter oder ein SourceIdentifier-Parameter erforderlich.

Erforderlich?	true
Position?	1
Standardwert	Keiner
Pipelineeingaben akzeptieren?	true (ByPropertyName)
Platzhalterzeichen akzeptieren?	false

-SourceIdentifier <string>

Löscht nur die Ereignisse mit der angegebenen Quell-ID. Platzhalter sind nicht zulässig. In jedem Befehl ist ein EventIdentifier-Parameter oder ein SourceIdentifier-Parameter erforderlich.

Erforderlich?	true
Position?	1
Standardwert	Keiner
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-Confirm

Fordert Sie vor der Ausführung des Befehls zur Bestätigung auf.

Erforderlich?	false
Position?	named
Standardwert
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-WhatIf

Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.

Erforderlich?	false
Position?	named
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

System.Management.Automation.PSEventArgs

Sie können Ereignisse über die Pipeline von Get-Event an Remove-Event übergeben.

Ausgaben

Keiner

Das Cmdlet generiert keine Ausgabe.

Hinweise

Ereignisse, Ereignisabonnements und die Ereigniswarteschlange sind nur in der aktuellen Sitzung vorhanden. Wenn Sie die aktuelle Sitzung schließen, wird die Ereigniswarteschlange verworfen, und das Ereignisabonnement wird abgebrochen.

Beispiel 1

C:\PS>remove-event -sourceIdentifier "ProcessStarted"

Beschreibung
-----------
Dieser Befehl löscht Ereignisse mit der Quell-ID "ProcessStarted" aus der Ereigniswarteschlange.

Beispiel 2

C:\PS>remove-event -eventIdentifier 30

Beschreibung
-----------
Dieser Befehl löscht das Ereignis mit der Ereignis-ID 30 aus der Ereigniswarteschlange.

Beispiel 3

C:\PS>get-event | remove-event

Beschreibung
-----------
Mit diesem Befehl werden alle Ereignisse aus der Ereigniswarteschlange gelöscht.