Remove-Event
Löscht Ereignisse aus der Ereigniswarteschlange.
Syntax
Remove-Event
[-SourceIdentifier] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-Event
[-EventIdentifier] <Int32>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Das Remove-Event
Cmdlet löscht Ereignisse aus der Ereigniswarteschlange in der aktuellen Sitzung.
Mit diesem Cmdlet werden nur Ereignisse gelöscht, die sich aktuell in der Warteschlange befinden. Verwenden Sie das Unregister-Event
Cmdlet, um ereignisregistrierungen oder abbestellen zu können.
Beispiele
Beispiel 1: Entfernen eines Ereignisses nach Quellbezeichner
PS C:\> Remove-Event -SourceIdentifier "ProcessStarted"
Dieser Befehl löscht Ereignisse mit einem Quellbezeichner von "Prozess gestartet" aus der Ereigniswarteschlange.
Beispiel 2: Entfernen eines Ereignisses nach Ereignisbezeichner
PS C:\> Remove-Event -EventIdentifier 30
Dieser Befehl löscht das Ereignis mit der Ereignis-ID 30 aus der Ereigniswarteschlange.
Beispiel 3: Entfernen aller Ereignisse
PS C:\> Get-Event | Remove-Event
Dieser Befehl löscht alle Ereignisse aus der Ereigniswarteschlange.
Parameter
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
Typ: | SwitchParameter |
Aliase: | cf |
Position: | Named |
Standardwert: | False |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-EventIdentifier
Gibt den Ereignisbezeichner an, für den das Cmdlet gelöscht wird. In jedem Befehl ist ein EventIdentifier - oder SourceIdentifier-Parameter erforderlich.
Typ: | Int32 |
Position: | 0 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-SourceIdentifier
Gibt den Quellbezeichner an, aus dem dieses Cmdlet Ereignisse löscht. Platzhalter sind nicht zulässig. In jedem Befehl ist ein EventIdentifier - oder SourceIdentifier-Parameter erforderlich.
Typ: | String |
Position: | 0 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Typ: | SwitchParameter |
Aliase: | wi |
Position: | Named |
Standardwert: | False |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Eingaben
Sie können Ereignisse von Get-Event
diesem Cmdlet aus weiterleiten.
Ausgaben
None
Dieses Cmdlet gibt keine Ausgabe zurück.
Hinweise
Auf den Linux- oder macOS-Plattformen sind keine Ereignisquellen verfügbar.
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.