Delen via

Unregister-Event

  • Referentie
Module:
Microsoft.PowerShell.Utility

Hiermee annuleert u een gebeurtenisabonnement.

Syntax

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 voor een gebeurtenis die is gemaakt met behulp van de New-Event cmdlet, wordt de nieuwe gebeurtenis ook uit de sessie verwijderd.

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

Voorbeelden

Voorbeeld 1: Een gebeurtenisabonnement opzeggen op bron-id

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

Unregister-Event -SourceIdentifier "ProcessStarted"

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

Voorbeeld 2: Een gebeurtenisabonnement opzeggen op abonnements-id

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

Unregister-Event -SubscriptionId 2

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

Voorbeeld 3: Alle gebeurtenisabonnementen annuleren

In dit voorbeeld worden alle gebeurtenisabonnementen in de sessie geannuleerd.

Get-EventSubscriber -Force | Unregister-Event -Force

Met behulp van de parameter Force worden Get-EventSubscriber alle gebeurtenisabonneeobjecten in de sessie opgehaald, inclusief de abonnees die verborgen zijn. De uitvoer wordt doorgesluisd naar Unregister-Event, waardoor de abonnees uit de sessie worden verwijderd. De parameter Force is vereist om Unregister-Event verborgen abonnees te verwijderen.

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliases:cf
Position:Named
standaardwaarde:False
Vereist:False
Accept pipeline input:False
Accept wildcard characters: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
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-SourceIdentifier

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

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

Type:String
Position:0
standaardwaarde:None
Vereist:True
Accept pipeline input:True
Accept wildcard characters:False

-SubscriptionId

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

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

Type:Int32
Position:0
standaardwaarde:None
Vereist:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliases:wi
Position:Named
standaardwaarde:False
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

PSEventSubscriber

U kunt de uitvoer van Get-EventSubscriber naar deze cmdlet doorsluisen.

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 New-Event cmdlet 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.