Dela via

Unregister-Event

  • Referens
Modul:
Microsoft.PowerShell.Utility

Avbryter en händelseprenumeration.

Syntax

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

Description

Cmdleten Unregister-Event avbryter en händelseprenumeration som skapades med hjälp av cmdleten Register-EngineEvent, Register-ObjectEventeller Register-WmiEvent .

När en händelseprenumeration avbryts tas händelseprenumeranten bort från sessionen och de prenumererade händelserna läggs inte längre till i händelsekön. När du avbryter en prenumeration på en händelse som skapats med hjälp av cmdleten New-Event tas även den nya händelsen bort från sessionen.

Unregister-Event tar inte bort händelser från händelsekön. Om du vill ta bort händelser använder du cmdleten Remove-Event .

Exempel

Exempel 1: Avbryt en händelseprenumeration efter källidentifierare

Det här kommandot avbryter händelseprenumerationen som har en källidentifierare för ProcessStarted.

Unregister-Event -SourceIdentifier "ProcessStarted"

Om du vill hitta källidentifieraren för en händelse använder du cmdleten Get-Event . Om du vill hitta källidentifieraren för en händelseprenumeration använder du cmdleten Get-EventSubscriber

Exempel 2: Avbryt en händelseprenumeration efter prenumerationsidentifierare

Det här kommandot avbryter händelseprenumerationen som har en prenumerationsidentifierare på 2.

Unregister-Event -SubscriptionId 2

Om du vill hitta prenumerationsidentifieraren för en händelseprenumeration använder du cmdleten Get-EventSubscriber .

Exempel 3: Avbryt alla händelseprenumerationer

I det här exemplet avbryts alla händelseprenumerationer i sessionen.

Get-EventSubscriber -Force | Unregister-Event -Force

Om du använder force-parametern med Get-EventSubscriber hämtas alla händelseprenumerantobjekt i sessionen, inklusive de prenumeranter som är dolda. Utdata skickas till Unregister-Event, som tar bort prenumeranterna från sessionen. Force-parametern krävs på Unregister-Event för att ta bort eventuella dolda prenumeranter.

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Aliases:cf
Position:Named
standardvärde:False
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Avbryter alla händelseprenumerationer, inklusive prenumerationer som har dolts med hjälp av parametern SupportEvent för Register-ObjectEvent, Register-WmiEventoch Register-EngineEvent.

Typ:SwitchParameter
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-SourceIdentifier

Anger en källidentifierare som den här cmdleten avbryter händelseprenumerationer.

En SourceIdentifier - eller SubscriptionId-parameter måste ingå i varje kommando.

Typ:String
Position:0
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-SubscriptionId

Anger ett källidentifierar-ID som den här cmdleten avbryter händelseprenumerationer.

En SourceIdentifier - eller SubscriptionId-parameter måste ingå i varje kommando.

Typ:Int32
Position:0
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:SwitchParameter
Aliases:wi
Position:Named
standardvärde:False
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

Indata

PSEventSubscriber

Du kan skicka utdata från Get-EventSubscriber till den här cmdleten.

Utdata

None

Den här cmdleten returnerar inga utdata.

Kommentarer

Inga händelsekällor är tillgängliga på Linux- eller macOS-plattformarna.

Händelser, händelseprenumerationer och händelsekön finns bara i den aktuella sessionen. Om du stänger den aktuella sessionen ignoreras händelsekön och händelseprenumerationen avbryts.

Unregister-Event kan inte ta bort händelser som skapats med hjälp av cmdleten New-Event såvida du inte prenumererar på händelsen med hjälp av cmdleten Register-EngineEvent . Om du vill ta bort en anpassad händelse från sessionen måste du ta bort den programmatiskt eller stänga sessionen.