Remove-Event
Löscht Ereignisse aus der Ereigniswarteschlange.
Syntax
BySource (Standard)
Remove-Event
[-SourceIdentifier] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByIdentifier
Remove-Event
[-EventIdentifier] <Int32>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Das cmdlet Remove-Event löscht Ereignisse aus der Ereigniswarteschlange in der aktuellen Sitzung.
Dieses Cmdlet löscht nur die Ereignisse, die sich derzeit in der Warteschlange befinden. Verwenden Sie das Cmdlet Unregister-Event, 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
Mit diesem Befehl wird das Ereignis mit einer Ereignis-ID von 30 aus der Ereigniswarteschlange gelöscht.
Beispiel 3: Entfernen aller Ereignisse
PS C:\> Get-Event | Remove-Event
Mit diesem Befehl werden alle Ereignisse aus der Ereigniswarteschlange gelöscht.
Parameter
-Confirm
Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | vgl |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-EventIdentifier
Gibt den Ereignisbezeichner an, für den das Cmdlet gelöscht wird. In jedem Befehl ist ein EventIdentifier oder SourceIdentifier Parameter erforderlich.
Parametereigenschaften
| Typ: | Int32 |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
ByIdentifier
| Position: | 0 |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-SourceIdentifier
Gibt den Quellbezeichner an, aus dem dieses Cmdlet Ereignisse löscht. Wildcards sind nicht zulässig. In jedem Befehl ist ein EventIdentifier oder SourceIdentifier Parameter erforderlich.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
BySource
| Position: | 0 |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
Eingaben
PSEventArgs
Sie können Ereignisse von Get-Event an dieses Cmdlet weiterleiten.
Ausgaben
None
Dieses Cmdlet gibt keine Ausgabe zurück.
Hinweise
Ereignisse, Ereignisabonnements und die Ereigniswarteschlange sind nur in der aktuellen Sitzung verfügbar. Wenn Sie die aktuelle Sitzung schließen, wird die Ereigniswarteschlange verworfen, und das Ereignisabonnement wird abgebrochen.
