Unregister-Event

Zruší odběr události.

Syntax

Unregister-Event
          [-SourceIdentifier] <String>
          [-Force]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]
Unregister-Event
          [-SubscriptionId] <Int32>
          [-Force]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]

Description

Rutina Unregister-Event zruší odběr událostí vytvořený pomocí rutiny Register-EngineEvent, Register-ObjectEventnebo Register-WmiEvent rutiny.

Po zrušení odběru událostí se odběratel události odstraní z relace a odebírané události se už nepřidají do fronty událostí. Když zrušíte odběr události vytvořené pomocí New-Event rutiny, nová událost se také odstraní z relace.

Unregister-Event neodstraní události z fronty událostí. K odstranění událostí použijte rutinu Remove-Event .

Příklady

Příklad 1: Zrušení odběru událostí podle identifikátoru zdroje

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

Tento příkaz zruší odběr událostí, který má zdrojový identifikátor ProcessStarted.

Pokud chcete najít zdrojový identifikátor události, použijte rutinu Get-Event . Ke zjištění zdrojového identifikátoru odběru událostí použijte rutinu Get-EventSubscriber .

Příklad 2: Zrušení odběru událostí podle identifikátoru předplatného

PS C:\> Unregister-Event -SubscriptionId 2

Tento příkaz zruší odběr událostí, který má identifikátor odběru 2.

Pokud chcete najít identifikátor odběru odběru události, použijte rutinu Get-EventSubscriber .

Příklad 3: Zrušení všech odběrů událostí

PS C:\> Get-EventSubscriber -Force | Unregister-Event -Force

Tento příkaz zruší všechna odběry událostí v relaci.

Tento příkaz pomocí rutiny Get-EventSubscriber získá všechny objekty odběratele událostí v relaci, včetně odběratelů, kteří jsou skryti pomocí parametru SupportEvent rutin pro registraci událostí.

Používá operátor kanálu (|) k odeslání objektů odběratele Unregister-Event, který je odstraní z relace. K dokončení úkolu je také vyžadován parametr Force v Unregister-Event.

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

-Force

Zruší všechna předplatná událostí, včetně předplatných, která byla skrytá, pomocí parametru SupportEvent parametru Register-ObjectEvent, Register-WmiEventa Register-EngineEvent.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SourceIdentifier

Určuje identifikátor zdroje, který tato rutina zruší odběry událostí.

Parametr SourceIdentifier nebo SubscriptionId musí být součástí každého příkazu.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SubscriptionId

Určuje ID identifikátoru zdroje, které tato rutina zruší odběry událostí.

Parametr SourceIdentifier nebo SubscriptionId musí být součástí každého příkazu.

Type:Int32
Position:0
Default value:None
Required:True
Accept pipeline input:True
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

PSEventSubscriber

Výstup můžete převést do Get-EventSubscriber této rutiny.

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

Unregister-Event Aplikace nemůže odstranit události vytvořené pomocí New-Event rutiny, pokud jste se k odběru události neodhlásili pomocí rutiny Register-EngineEvent . Pokud chcete odstranit vlastní událost z relace, musíte ji odebrat programově nebo relaci zavřít.