Delen via

Remove-Event

  • Referentie
Module:
Microsoft.PowerShell.Utility

Hiermee verwijdert u gebeurtenissen uit de gebeurteniswachtrij.

Syntaxis

Remove-Event
      [-SourceIdentifier] <String>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-Event
      [-EventIdentifier] <Int32>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

De Remove-Event cmdlet verwijdert gebeurtenissen uit de gebeurteniswachtrij in de huidige sessie.

Met deze cmdlet worden alleen de gebeurtenissen verwijderd die momenteel in de wachtrij staan. Als u gebeurtenisregistraties wilt annuleren of u wilt afmelden, gebruikt u de Unregister-Event cmdlet.

Voorbeelden

Voorbeeld 1: Een gebeurtenis verwijderen op bron-id

PS C:\> Remove-Event -SourceIdentifier "ProcessStarted"

Met deze opdracht worden gebeurtenissen met een bron-id van Proces gestart uit de gebeurteniswachtrij verwijderd.

Voorbeeld 2: Een gebeurtenis verwijderen op gebeurtenis-id

PS C:\> Remove-Event -EventIdentifier 30

Met deze opdracht wordt de gebeurtenis verwijderd met een gebeurtenis-id van 30 uit de gebeurteniswachtrij.

Voorbeeld 3: Alle gebeurtenissen verwijderen

PS C:\> Get-Event | Remove-Event

Met deze opdracht worden alle gebeurtenissen uit de gebeurteniswachtrij verwijderd.

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-EventIdentifier

Hiermee geeft u de gebeurtenis-id op waarvoor de cmdlet wordt verwijderd. In elke opdracht is een EventIdentifier - of SourceIdentifier-parameter vereist.

Type:Int32
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-SourceIdentifier

Hiermee geeft u de bron-id waaruit deze cmdlet gebeurtenissen verwijdert. Jokertekens zijn niet toegestaan. In elke opdracht is een EventIdentifier - of SourceIdentifier-parameter vereist.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

PSEventArgs

U kunt gebeurtenissen van Get-Event naar deze cmdlet doorsluisen.

Uitvoerwaarden

None

Deze cmdlet retourneert geen uitvoer.

Notities

Er zijn geen gebeurtenisbronnen beschikbaar op de Linux- of macOS-platforms.

Gebeurtenissen, gebeurtenisabonnementen en de gebeurteniswachtrij bestaan alleen in de huidige sessie. Als u de huidige sessie sluit, wordt de gebeurteniswachtrij verwijderd en wordt het gebeurtenisabonnement geannuleerd.