Freigeben über


Remove-Event

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.





Siehe auch

Konzepte

Register-ObjectEvent
Register-EngineEvent
Register-WmiEvent
Unregister-Event
Get-Event
New-Event
Remove-Event
Wait-Event