Remove-Event
Odstraní události z fronty událostí.
Syntax
BySource (Výchozí)
Remove-Event
[-SourceIdentifier] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByIdentifier
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 cmdletu vás vyzve k potvrzení.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | viz |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-EventIdentifier
Určuje identifikátor události, pro kterou rutina odstraní. Každý příkaz vyžaduje EventIdentifier nebo Parametr SourceIdentifier.
Vlastnosti parametru
| Typ: | Int32 |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
ByIdentifier
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | 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.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
BySource
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-WhatIf
Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Wi |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
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í sezení, fronta událostí se vyprázdní a odběr události se zruší.