Unregister-Event
Bricht ein Ereignisabonnement ab.
Syntax
BySource (Standard)
Unregister-Event
[-SourceIdentifier] <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ById
Unregister-Event
[-SubscriptionId] <Int32>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Das Unregister-Event Cmdlet bricht ein Ereignisabonnement ab, das mithilfe des Register-EngineEventCmdlets oder Register-WmiEventRegister-ObjectEventdes Cmdlets erstellt wurde.
Wenn ein Ereignisabonnement abgebrochen wird, wird der Ereignisabonnent aus der Sitzung gelöscht, und die abonnierten Ereignisse werden der Ereigniswarteschlange nicht mehr 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
Dieser Befehl bricht das Ereignisabonnement ab, das über einen Abonnementbezeichner von 2 verfügt.
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-Eventdie die Abonnenten aus der Sitzung gelöscht werden. Der Force-Parameter ist erforderlich Unregister-Event , um ausgeblendete Abonnenten zu entfernen.
Parameter
-Confirm
Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Cf |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Force
Bricht alle Ereignisabonnements ab, einschließlich Abonnements, die mithilfe des SupportEvent-Parameters von Register-ObjectEvent, Register-WmiEventund Register-EngineEvent.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-SourceIdentifier
Gibt einen Quellbezeichner an, mit dem dieses Cmdlet Ereignisabonnements abbricht.
Ein SourceIdentifier - oder SubscriptionId-Parameter muss in jedem Befehl enthalten sein.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
BySource
| Position: | 0 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-SubscriptionId
Gibt eine Quell-ID an, mit der dieses Cmdlet Ereignisabonnements abbricht.
Ein SourceIdentifier - oder SubscriptionId-Parameter muss in jedem Befehl enthalten sein.
Parametereigenschaften
| Typ: | Int32 |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
ById
| Position: | 0 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
Eingaben
PSEventSubscriber
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 verfügbar. 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.
