Beendet ein Ereignisabonnement. (Unregister-Event)

   

NAME
Unregister-Event

# ÜBERSICHT
Beendet ein Ereignisabonnement.

# SYNTAX
Unregister-Event [-SubscriptionId] <int> [-Force] [-Confirm] [-WhatIf] [<CommonParameters>]

Unregister-Event [-SourceIdentifier] <string> [-Force] [-Confirm] [-WhatIf] [<CommonParameters>]

# BESCHREIBUNG
Mit 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".

# EINGABEN
System.Management.Automation.PSEventSubscriber
Die Ausgabe von Get-EventSubscriber kann über die Pipeline an Unregister-Event übergeben werden.

# AUSGABEN
Keiner
Dieses Cmdlet gibt keine Ausgabe zurück.

# HINWEISE

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 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.

# BEISPIEL 1

C:\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 2

C:\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 3

C:\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

ColorConsole [Version 1.7.1000] PowerShell 2.0-Export
Microsoft Windows [Version 6.1.7600]
Copyright (c) 2014 Microsoft Corporation.

OS: Windows 10, 8.1, 8, 7, Vista / Windows Server 2016, 2012, 2008
»»»» ColorConsole





... Home  
... Impressum
... ColorConsole

... CMD
... Netsh-XP
... Netsh-7
... Netsh-Vista
... Powershell










Windows 10 download: Starter, Home (Basic Premium), Professional und Win 10 Ultimate!

... facebook.de
HTTP: ... PS_Windows/de/Unregister-Event.htm
0.062

Der Leistungsindex in Windows 8.1 / 10 fehlt?

 /

Create and mange user accounts in Windows 10?

 /

Ist die Remoteunterstützung bei Win-7 auch möglich?

 /

Windows 7 Benutzer beim Startbildschirm alle Benutzer anzeigen?

 /