Löscht Ereignisse aus der Ereigniswarteschlange.
Syntax
Remove-Event [-EventIdentifier] <int> [-Bestätigung] [-WhatIf] [<CommonParameters>] Remove-Event [-SourceIdentifier] <string> [-Bestätigung] [-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 |
keine |
|
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 |
keine |
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Bestätigung
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 |
None 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