Sdílet prostřednictvím

Remove-Event

  • Reference
Modul:
Microsoft.PowerShell.Utility

Odstraní události z fronty událostí.

Syntaxe

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

Description

Rutina Remove-Event odstraní události z fronty událostí v aktuální relaci.

Tato rutina odstraní pouze události, které jsou aktuálně ve frontě. Pokud chcete zrušit registraci událostí nebo odhlásit odběr, použijte rutinu Unregister-Event.

Příklady

Příklad 1: Odebrání události podle identifikátoru zdroje

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

Tento příkaz odstraní události se zdrojovým identifikátorem procesu spuštěného z fronty událostí.

Příklad 2: Odebrání události podle identifikátoru události

PS C:\> Remove-Event -EventIdentifier 30

Tento příkaz odstraní událost s ID události 30 z fronty událostí.

Příklad 3: Odebrání všech událostí

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

Tento příkaz odstraní všechny události z fronty událostí.

Parametry

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-EventIdentifier

Určuje identifikátor události, pro kterou rutina odstraní. Každý příkaz vyžaduje EventIdentifier nebo Parametr SourceIdentifier.

Typ:Int32
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-SourceIdentifier

Určuje identifikátor zdroje, ze kterého tato rutina odstraní události. Zástupné dokumentace nejsou povoleny. Každý příkaz vyžaduje EventIdentifier nebo Parametr SourceIdentifier.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

PSEventArgs

Události můžete řadit z Get-Event do Remove-Event .

Výstupy

None

Rutina negeneruje žádný výstup.

Poznámky

  • Události, odběry událostí a fronta událostí existují pouze v aktuální relaci. Pokud zavřete aktuální relaci, fronta událostí se zahodí a odběr události se zruší.