Share via

Unregister-Event

  • Referenz
Modul:
Microsoft.PowerShell.Utility

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 mit dem Register-EngineEventCmdlet , Register-ObjectEventoder Register-WmiEvent 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 mithilfe des New-Event Cmdlets erstellt wurde, wird auch das neue Ereignis aus der Sitzung gelöscht.

Unregister-Event löscht keine Ereignisse aus der Ereigniswarteschlange. Verwenden Sie das Remove-Event Cmdlet, um Ereignisse zu löschen.

Beispiele

Beispiel 1: Kündigen eines Ereignisabonnements nach Quellbezeichner

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

Mit diesem Befehl wird das Ereignisabonnement abgebrochen, das über den Quellbezeichner ProcessStarted verfügt.

Verwenden Sie das Cmdlet, um den Quellbezeichner eines Ereignisses Get-Event zu finden. Verwenden Sie das Cmdlet, um den Get-EventSubscriber Quellbezeichner eines Ereignisabonnements zu finden.

Beispiel 2: Kündigen eines Ereignisabonnements nach Abonnementbezeichner

PS C:\> Unregister-Event -SubscriptionId 2

Mit diesem Befehl wird das Ereignisabonnement gekündigt, das den Abonnementbezeichner „2“ aufweist.

Verwenden Sie das Cmdlet, um den Get-EventSubscriber Abonnementbezeichner eines Ereignisabonnements zu finden.

Beispiel 3: Kündigen aller Ereignisabonnements

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

Mit diesem Befehl werden alle Ereignisabonnements in der Sitzung gekündigt.

Der Befehl verwendet das Get-EventSubscriber Cmdlet, um alle Ereignisabonnentobjekte in der Sitzung abzurufen, einschließlich der Abonnenten, die mithilfe des SupportEvent-Parameters der Ereignisregistrierungs-Cmdlets ausgeblendet werden.

Sie verwendet einen Pipelineoperator (|), um die Abonnentenobjekte an zu Unregister-Eventsenden, wodurch sie aus der Sitzung gelöscht werden. Zum Abschließen der Aufgabe ist auch der Force-Parameter für Unregister-Eventerforderlich.

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required: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-WmiEventund Register-EngineEventausgeblendet wurden.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SourceIdentifier

Gibt einen Quellbezeichner an, mit dem dieses Cmdlet Ereignisabonnements bricht.

In jedem Befehl muss ein SourceIdentifier- oder SubscriptionId-Parameter enthalten sein.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SubscriptionId

Gibt eine Quell-ID an, mit der dieses Cmdlet Ereignisabonnements bricht.

In jedem Befehl muss ein SourceIdentifier- oder SubscriptionId-Parameter enthalten sein.

Type:Int32
Position:0
Default value:None
Required: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.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

PSEventSubscriber

Sie können die Ausgabe an pipen Get-EventSubscriberUnregister-Event.

Ausgaben

None

Dieses Cmdlet gibt keine Ausgabe zurück.

Hinweise

Auf 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 nur gelöscht werden, wenn Sie das Ereignis mithilfe des Register-EngineEvent Cmdlets abonniert haben. Um ein benutzerdefiniertes Ereignis aus der Sitzung zu löschen, müssen Sie es programmgesteuert entfernen oder die Sitzung schließen.