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 registrace událostí nebo odběr odběru, použijte tuto 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 zobrazí výzvu 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 parametr EventIdentifier nebo 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 parametr EventIdentifier nebo 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

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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 z této rutiny můžete převést.Get-Event

Výstupy

None

Tato rutina nevrátí žádný výstup.

Poznámky

Na platformách Linux nebo macOS nejsou dostupné žádné zdroje událostí.

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ší.