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 cmdlet Remove-Event 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 cmdlet Unregister-Event.

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

U wordt 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. Voor 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. Voor 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

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. 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 Remove-Eventdoorsluisen.

Uitvoerwaarden

None

De cmdlet genereert geen uitvoer.

Notities

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