Freigeben über

Remove-Event

  • Referenz
Modul:
Microsoft.PowerShell.Utility

Löscht Ereignisse aus der Ereigniswarteschlange.

Syntax

Remove-Event
      [-SourceIdentifier] <String>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
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 vor dem Ausführen des Cmdlets zur Bestätigung auf.

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. Wildcards 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 passiert, 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

PSEventArgs

Sie können Ereignisse von Get-Event an dieses Cmdlet 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.