Unregister-Event
Storniert ein Ereignisabonnement.
Syntax
Unregister-Event
[-SourceIdentifier] <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Unregister-Event
[-SubscriptionId] <Int32>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Das Unregister-Event
Cmdlet bricht ein Ereignisabonnement ab, das mithilfe des Register-EngineEvent
Cmdlets oder Register-WmiEvent
Register-ObjectEvent
des Cmdlets erstellt wurde.
Wenn ein Ereignisabonnement gekündigt wird, wird der Ereignisabonnent aus der Sitzung gelöscht und die abonnierten Ereignisse werden nicht mehr der Ereigniswarteschlange hinzugefügt. Wenn Sie ein Abonnement für ein ereignis kündigen, das mit dem New-Event
Cmdlet erstellt wurde, wird das neue Ereignis auch aus der Sitzung gelöscht.
Unregister-Event
Ereignisse werden nicht aus der Ereigniswarteschlange gelöscht. Verwenden Sie das Remove-Event
Cmdlet, um Ereignisse zu löschen.
Beispiele
Beispiel 1: Kündigen eines Ereignisabonnements nach Quellbezeichner
Dieser Befehl bricht das Ereignisabonnement ab, das über einen Quellbezeichner von ProcessStarted verfügt.
Unregister-Event -SourceIdentifier "ProcessStarted"
Verwenden Sie das Get-Event
Cmdlet, um den Quellbezeichner eines Ereignisses zu finden. Verwenden Sie das Get-EventSubscriber
Cmdlet, um den Quellbezeichner eines Ereignisabonnements zu finden.
Beispiel 2: Kündigen eines Ereignisabonnements nach Abonnementbezeichner
Mit diesem Befehl wird das Ereignisabonnement gekündigt, das den Abonnementbezeichner „2“ aufweist.
Unregister-Event -SubscriptionId 2
Verwenden Sie das Get-EventSubscriber
Cmdlet, um den Abonnementbezeichner eines Ereignisabonnements zu finden.
Beispiel 3: Kündigen aller Ereignisabonnements
In diesem Beispiel werden alle Ereignisabonnements in der Sitzung abgebrochen.
Get-EventSubscriber -Force | Unregister-Event -Force
Verwenden des Force-Parameters mit Get-EventSubscriber
abrufen aller Ereignisabonnentobjekte in der Sitzung, einschließlich der Abonnenten, die ausgeblendet sind. Die Ausgabe wird weitergeleitet, an Unregister-Event
die die Abonnenten aus der Sitzung gelöscht werden. Der Force-Parameter ist erforderlich Unregister-Event
, um ausgeblendete Abonnenten zu entfernen.
Parameter
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
Typ: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Standardwert: | False |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Bricht alle Ereignisabonnements ab, einschließlich Abonnements, die mithilfe des SupportEvent-Parameters von Register-ObjectEvent
, Register-WmiEvent
und Register-EngineEvent
.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SourceIdentifier
Gibt einen Quellbezeichner an, mit dem dieses Cmdlet Ereignisabonnements abbricht.
Ein SourceIdentifier - oder SubscriptionId-Parameter muss in jedem Befehl enthalten sein.
Typ: | String |
Position: | 0 |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SubscriptionId
Gibt eine Quell-ID an, mit der dieses Cmdlet Ereignisabonnements abbricht.
Ein SourceIdentifier - oder SubscriptionId-Parameter muss in jedem Befehl enthalten sein.
Typ: | Int32 |
Position: | 0 |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Typ: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Standardwert: | False |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Eingaben
Sie können die Ausgabe an Get-EventSubscriber
dieses Cmdlet weiterleiten.
Ausgaben
None
Dieses Cmdlet gibt keine Ausgabe zurück.
Hinweise
Auf den Linux- oder macOS-Plattformen sind keine Ereignisquellen verfügbar.
Ereignisse, Ereignisabonnements und die Ereigniswarteschlange sind nur in der aktuellen Sitzung vorhanden. Wenn Sie die aktuelle Sitzung schließen, wird die Ereigniswarteschlange verworfen, und das Ereignisabonnement wird abgebrochen.
Unregister-Event
Ereignisse, die mit dem New-Event
Cmdlet erstellt wurden, können nicht gelöscht werden, es sei denn, Sie haben das Ereignis mithilfe des Register-EngineEvent
Cmdlets abonniert. Um ein benutzerdefiniertes Ereignis aus der Sitzung zu löschen, müssen Sie es programmgesteuert entfernen oder die Sitzung schließen.