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 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

PSEventArgs

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.