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
Mit dem Cmdlet Remove-Event werden Ereignisse aus der Ereigniswarteschlange in der aktuellen Sitzung gelöscht.
Dieses Cmdlet löscht nur die Ereignisse, die sich derzeit in der Warteschlange befinden. Verwenden Sie das Cmdlet Unregister-Event, um Ereignisregistrierungen abzubrechen oder das Abonnement aufzuheben.
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. Platzhalter 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 Remove-Event weiterleiten.
Ausgaben
None
Das Cmdlet generiert keine Ausgabe.
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.