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.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-EventIdentifier

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

Typ:Int32
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken: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.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

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

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

PSEventArgs

Du kan skicka händelser från Get-Event till den här cmdleten.

Utdata

None

Den här cmdleten returnerar 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.