Dela via

Remove-Event

  • Referens
Modul:
Microsoft.PowerShell.Utility

Tar bort händelser från händelsekön.

Syntax

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

Description

Cmdleten Remove-Event tar bort händelser från händelsekön i den aktuella sessionen.

Den här cmdleten tar bara bort de händelser som för närvarande finns i kön. Om du vill avbryta händelseregistreringar eller avbryta prenumerationen använder du cmdleten Unregister-Event .

Exempel

Exempel 1: Ta bort en händelse efter källidentifierare

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

Det här kommandot tar bort händelser med en källidentifierare för Process Started från händelsekön.

Exempel 2: Ta bort en händelse efter händelseidentifierare

PS C:\> Remove-Event -EventIdentifier 30

Det här kommandot tar bort händelsen med ett händelse-ID på 30 från händelsekön.

Exempel 3: Ta bort alla händelser

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

Det här kommandot tar bort alla händelser från händelsekön.

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

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

-EventIdentifier

Anger den händelseidentifierare som cmdleten tar bort. En EventIdentifier - eller SourceIdentifier-parameter krävs i varje kommando.

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

-SourceIdentifier

Anger den källidentifierare som den här cmdleten tar bort händelser från. Jokertecken är inte tillåtna. En EventIdentifier - eller SourceIdentifier-parameter krävs i varje kommando.

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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

Indata

PSEventArgs

Du kan skicka händelser från Get-Event till Remove-Event.

Utdata

None

Cmdleten genererar inga utdata.

Kommentarer

Inga händelsekällor är tillgängliga på Linux- eller macOS-plattformarna.

Händelser, händelseprenumerationer och händelsekön finns bara i den aktuella sessionen. Om du stänger den aktuella sessionen ignoreras händelsekön och händelseprenumerationen avbryts.