Delen via

Unregister-Event

  • Referentie
Module:
Microsoft.PowerShell.Utility

Hiermee annuleert u een gebeurtenisabonnement.

Syntaxis

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

Description

De Unregister-Event cmdlet annuleert een gebeurtenisabonnement dat is gemaakt met behulp van de Register-EngineEvent, Register-ObjectEventof Register-WmiEvent cmdlet.

Wanneer een gebeurtenisabonnement wordt geannuleerd, wordt de gebeurtenisabonnee verwijderd uit de sessie en worden de geabonneerde gebeurtenissen niet meer toegevoegd aan de gebeurteniswachtrij. Wanneer u een abonnement opzegt op een gebeurtenis die is gemaakt met behulp van de cmdlet New-Event, wordt de nieuwe gebeurtenis ook uit de sessie verwijderd.

Unregister-Event verwijdert geen gebeurtenissen uit de gebeurteniswachtrij. Gebruik de cmdlet Remove-Event om gebeurtenissen te verwijderen.

Voorbeelden

Voorbeeld 1: Een gebeurtenisabonnement opzeggen op bron-id

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

Met deze opdracht wordt het gebeurtenisabonnement met een bron-id van ProcessStarted geannuleerd.

Gebruik de cmdlet Get-Event om de bron-id van een gebeurtenis te vinden. Gebruik de cmdlet Get-EventSubscriber om de bron-id van een gebeurtenisabonnement te vinden.

Voorbeeld 2: Een gebeurtenisabonnement opzeggen op abonnements-id

PS C:\> Unregister-Event -SubscriptionId 2

Met deze opdracht wordt het gebeurtenisabonnement met een abonnements-id van 2 geannuleerd.

Gebruik de cmdlet Get-EventSubscriber om de abonnements-id van een gebeurtenisabonnement te vinden.

Voorbeeld 3: Alle gebeurtenisabonnementen annuleren

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

Met deze opdracht worden alle gebeurtenisabonnementen in de sessie geannuleerd.

De opdracht gebruikt de cmdlet Get-EventSubscriber om alle objecten voor gebeurtenisabonnees in de sessie op te halen, inclusief de abonnees die zijn verborgen met behulp van de parameter SupportEvent van de cmdlets voor gebeurtenisregistratie.

Er wordt een pijplijnoperator (|) gebruikt om de abonneeobjecten naar Unregister-Eventte verzenden, waardoor ze uit de sessie worden verwijderd. Als u de taak wilt voltooien, is de parameter Forceren ook vereist voor Unregister-Event.

Parameters

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Force

Annuleert alle gebeurtenisabonnementen, inclusief abonnementen die zijn verborgen met behulp van de parameter SupportEvent van Register-ObjectEvent, Register-WmiEventen Register-EngineEvent.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SourceIdentifier

Hiermee geeft u een bron-id op die door deze cmdlet gebeurtenisabonnementen worden geannuleerd.

Een SourceIdentifier- of parameter SubscriptionId moet worden opgenomen in elke opdracht.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-SubscriptionId

Hiermee geeft u een bron-id op die door deze cmdlet gebeurtenisabonnementen worden geannuleerd.

Een SourceIdentifier- of parameter SubscriptionId moet worden opgenomen in elke opdracht.

Type:Int32
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

PSEventSubscriber

U kunt de uitvoer van Get-EventSubscriber naar Unregister-Eventdoorsluisen.

Uitvoerwaarden

None

Deze cmdlet retourneert geen uitvoer.

Notities

Er zijn geen gebeurtenisbronnen beschikbaar op de Linux- of macOS-platforms.

Gebeurtenissen, gebeurtenisabonnementen en de gebeurteniswachtrij bestaan alleen in de huidige sessie. Als u de huidige sessie sluit, wordt de gebeurteniswachtrij verwijderd en wordt het gebeurtenisabonnement geannuleerd.

Unregister-Event kan gebeurtenissen die zijn gemaakt met behulp van de cmdlet New-Event niet verwijderen, tenzij u zich hebt geabonneerd op de gebeurtenis met behulp van de Register-EngineEvent-cmdlet. Als u een aangepaste gebeurtenis uit de sessie wilt verwijderen, moet u deze programmatisch verwijderen of de sessie sluiten.