Delen via

Remove-Event

Module:
Microsoft.PowerShell.Utility Module

Hiermee verwijdert u gebeurtenissen uit de gebeurteniswachtrij.

Syntaxis

BySource (Standaard) 

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

ByIdentifier 

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

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Cf

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-EventIdentifier

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

Parametereigenschappen

Type:Int32
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

ByIdentifier
Position:0
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

BySource
Position:0
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-WhatIf

Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Wi

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

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.