Remove-Event
Odstraní události z fronty událostí.
Syntax
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í.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EventIdentifier
Určuje identifikátor události, pro kterou rutina odstraní. Každý příkaz vyžaduje parametr EventIdentifier nebo SourceIdentifier .
Type: | Int32 |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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 .
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Vstupy
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
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ší.
Související odkazy
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro