Beendet ein Ereignisabonnement. (Unregister-Event)
NAMEUnregister-EventÜBERSICHTBeendet ein Ereignisabonnement.SYNTAXUnregister-Event [-SubscriptionId] <int> [-Force] [-Confirm] [-WhatIf] [<CommonParameters>] Unregister-Event [-SourceIdentifier] <string> [-Force] [-Confirm] [-WhatIf] [<CommonParameters>]BESCHREIBUNGMit dem Cmdlet "Unregister-Event" wird ein Ereignisabonnement abgebrochen, das mit dem Cmdlet "Register-EngineEvent", "Register-ObjectEvent" oder "Register-WmiEvent" erstellt wurde. Wenn ein Ereignisabonnement abgebrochen wurde, 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 mit dem Cmdlet "New-Event" erstelltes Ereignis abbrechen, wird das neue Ereignis auch aus der Sitzung gelöscht. Mit Unregister-Event werden keine Ereignisse aus der Ereigniswarteschlange gelöscht. Verwenden Sie zum Löschen von Ereignissen das Cmdlet "Remove-Event".PARAMETER-Force [<SwitchParameter>] Bricht alle Ereignisabonnements ab, einschließlich Abonnements, die mit dem SupportEvent-Parameter von Register-ObjectEvent, Register-WmiEvent oder Register-EngineEvent ausgeblendet wurden. Erforderlich? false Position? named Standardwert Pipelineeingaben akzeptieren?false Platzhalterzeichen akzeptieren?false -SourceIdentifier <string> Bricht Ereignisabonnements ab, die die angegebene Quell-ID aufweisen. Jeder Befehl muss einen SourceIdentifier-Parameter oder einen SubscriptionId-Parameter enthalten. Erforderlich? true Position? 1 Standardwert Pipelineeingaben akzeptieren?true (ByPropertyName) Platzhalterzeichen akzeptieren?false -SubscriptionId <int> Bricht Ereignisabonnements ab, die die angegebene Abonnement-ID aufweisen. Jeder Befehl muss einen SourceIdentifier-Parameter oder einen SubscriptionId-Parameter enthalten. Erforderlich? true Position? 1 Standardwert Pipelineeingaben akzeptieren?true (ByPropertyName) Platzhalterzeichen akzeptieren?false -Confirm [<SwitchParameter>] Fordert Sie vor der Ausführung des Befehls zur Bestätigung auf. Erforderlich? false Position? named Standardwert Pipelineeingaben akzeptieren?false Platzhalterzeichen akzeptieren?false -WhatIf [<SwitchParameter>] Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen. Erforderlich? false Position? named Standardwert Pipelineeingaben akzeptieren?false Platzhalterzeichen akzeptieren?false <CommonParameters> Dieses Cmdlet unterstützt folgende allgemeine Parameter: "Verbose", "Debug", "ErrorAction", "ErrorVariable", "WarningAction", "WarningVariable", "OutBuffer" und "OutVariable". Weitere Informationen erhalten Sie mit dem Befehl "get-help about_commonparameters".EINGABENSystem.Management.Automation.PSEventSubscriber Die Ausgabe von Get-EventSubscriber kann über die Pipeline an Unregister-Event übergeben werden.AUSGABENKeiner Dieses Cmdlet gibt keine Ausgabe zurück.HINWEISEEreignisse, 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 kann keine mit dem Cmdlet "New-Event" erstellten Ereignisse löschen, es sei denn, Sie haben das Ereignis mit dem Cmdlet "Register-EngineEvent" abonniert. Um ein benutzerdefiniertes Ereignis aus der Sitzung zu löschen, müssen Sie es programmgesteuert entfernen oder die Sitzung schließen.Beispiele
BEISPIEL 1C:\PS>unregister-event -sourceIdentifier ProcessStarted Beschreibung ----------- Mit diesem Befehl wird das Ereignisabonnement abgebrochen, das die Quell-ID "ProcessStarted" aufweist. Um die Quell-ID eines Ereignisses zu suchen, verwenden Sie das Cmdlet "Get-Event". Um die Quell-ID eines Ereignisabonnements zu suchen, verwenden Sie das Cmdlet "Get-EventSubscriber".BEISPIEL 2C:\PS>unregister-event -subscriptionId 2 Beschreibung ----------- Mit diesem Befehl wird das Ereignisabonnement abgebrochen, das die Abonnement-ID 2 aufweist. Um die Abonnement-ID eines Ereignisabonnements zu suchen, verwenden Sie das Cmdlet "Get-EventSubscriber".BEISPIEL 3C:\PS>get-eventsubscriber -force | unregister-event -force Beschreibung ----------- Mit diesem Befehl werden alle Ereignisabonnements in der Sitzung abgebrochen. Der Befehl verwendet das Cmdlet "Get-EventSubscriber", um alle Ereignisabonnentenobjekte in der Sitzung abzurufen, einschließlich der Abonnenten, die mit dem SupportEvent-Parameter der Cmdlets zur Ereignisregistrierung ausgeblendet werden. Es sendet die Abonnentenobjekte mithilfe eines Pipelineoperators (|) an Unregister-Event, das sie aus der Sitzung löscht. Zum Abschließen der Aufgabe ist auch der Force-Parameter für Unregister-Event erforderlich. VERWANDTE LINKS Online version: http://go.microsoft.com/fwlink/?LinkID=135269 (möglicherweise auf Englisch) Register-ObjectEvent Register-EngineEvent Register-WmiEvent Unregister-Event Get-Event New-Event Remove-Event Wait-Event Get-EventSubscriber C:\Windows>powershell get-help New-Event -full
Microsoft Windows [Version 10.0.19045.3693]
Copyright (c) 2023 Microsoft Corporation.
ColorConsole [Version 3.7.1000] PowerShell 2.0-Export
