Remove-Event
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 abzubrechen oder abzubestellen.
Beispiele
Beispiel 1: Entfernen eines Ereignisses nach Quellbezeichner
PS C:\> Remove-Event -SourceIdentifier "ProcessStarted"
Mit diesem Befehl werden Ereignisse mit dem Quellbezeichner Prozess gestartet aus der Ereigniswarteschlange gelöscht.
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 löscht. Ein EventIdentifier- oder SourceIdentifier-Parameter ist in jedem Befehl erforderlich.
Type: | Int32 |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SourceIdentifier
Gibt den Quellbezeichner an, für den dieses Cmdlet Ereignisse löscht. Platzhalter sind nicht zulässig. Ein EventIdentifier- oder SourceIdentifier-Parameter ist in jedem Befehl 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
Sie können Ereignisse von an Get-Event
übergeben Remove-Event
.
Ausgaben
None
Das Cmdlet generiert keine Ausgabe.
Hinweise
Auf 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.