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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EventIdentifier

Gibt den Ereignisbezeichner an, für den das Cmdlet gelöscht wird. In jedem Befehl ist ein EventIdentifier - oder SourceIdentifier-Parameter erforderlich.

Type:Int32
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.