Register-EngineEvent - PowerShell Befehl Hilfe und Beispiele

Abonniert Ereignisse, die vom Windows PowerShell-Modul und dem Cmdlet "New-Event" generiert werden. (Register-EngineEvent)


NAME
Register-EngineEvent
ÜBERSICHT
Abonniert Ereignisse, die vom Windows PowerShell-Modul und dem Cmdlet "New-Event" generiert werden.
SYNTAX
Register-EngineEvent [-SourceIdentifier] <string> [[-Action] <scriptblock>] [-Forward] [-MessageData <psobject>] [-SupportEvent] [<CommonParameters>]
BESCHREIBUNG
Mit dem Cmdlet "Register-EngineEvent" werden Ereignisse abonniert, die vom Windows PowerShell-Modul und dem Cmdlet "New-Event" generiert werden. Geben Sie das Ereignis mit dem SourceIdentifier-Parameter an. Sie können dieses Cmdlet verwenden, um das Modulereignis "Exiting" und vom Cmdlet "New-Event" generierte Ereignisse zu abonnieren. Diese Ereignisse werden automatisch der Ereigniswarteschlange in der Sitzung hinzugefügt, ohne dass sie abonniert werden. Durch das Abonnieren von Ereignissen können Sie jedoch die Ereignisse weiterleiten, eine Aktion angeben, mit der auf die Ereignisse reagiert wird, und das Abonnement abbrechen. Wenn das abonnierte Ereignis ausgelöst wird, wird es der Ereigniswarteschlange in der Sitzung hinzugefügt. Verwenden Sie das Cmdlet "Get-Event", um Ereignisse in der Ereigniswarteschlange abzurufen. Wenn Sie ein Ereignis abonnieren, wird der Sitzung ein Ereignisabonnent hinzugefügt. Verwenden Sie das Cmdlet "Get-EventSubscriber", um die Ereignisabonnenten in der Sitzung abzurufen. Wenn das Abonnement abgebrochen werden soll, verwenden Sie das Cmdlet "Unregister-Event". Hierdurch wird der Ereignisabonnent aus der Sitzung gelöscht.
PARAMETER
-Action <scriptblock> Gibt Befehle zum Behandeln der Ereignisse an. Beim Auslösen eines Ereignisses werden die Befehle in der Action ausgeführt, statt das Ereignis an die Ereigniswarteschlange zu senden. Schließen Sie die Befehle in geschweifte Klammern ({}) ein, um einen Skriptblock zu erstellen. Der Wert des Action-Parameters kann die automatischen Variablen "$Event", "$EventSubscriber", "$Sender", "$SourceEventArgs" und "$SourceArgs" enthalten. Diese stellen Informationen zu dem Ereignis im Action-Skriptblock bereit. Weitere Informationen finden Sie unter "about_Automatic_Variables". Wenn Sie eine Aktion angeben, gibt Register-EngineEvent ein Ereignisauftragsobjekt zurück, das diese Aktion darstellt. Sie können die Job-Cmdlets verwenden, um den Ereignisauftrag zu verwalten. Erforderlich? false Position? 102 Standardwert Keiner Pipelineeingaben akzeptieren?false Platzhalterzeichen akzeptieren?false -Forward [<SwitchParameter>] Sendet Ereignisse für dieses Abonnement an die Sitzung auf dem lokalen Computer. Verwenden Sie diesen Parameter, wenn Sie sich auf einem Remotecomputer oder in einer Remotesitzung für Ereignisse registrieren. Erforderlich? false Position? named Standardwert False Pipelineeingaben akzeptieren?false Platzhalterzeichen akzeptieren?false -MessageData <psobject> Gibt weitere dem Ereignis zugeordnete Daten an. Der Wert dieses Parameters wird in der MessageData-Eigenschaft des Ereignisobjekts angezeigt. Erforderlich? false Position? named Standardwert Keiner Pipelineeingaben akzeptieren?false Platzhalterzeichen akzeptieren?false -SourceIdentifier <string> Gibt die Quell-ID des Ereignisses an, das Sie abonnieren. Die Quell-ID muss in der aktuellen Sitzung eindeutig sein. Dieser Parameter ist erforderlich. Der Wert dieses Parameters ist im Wert der SourceIdentifier-Eigenschaft des Abonnentenobjekts und aller diesem Abonnement zugeordneten Ereignisobjekte vorhanden. Erforderlich? true Position? 101 Standardwert Pipelineeingaben akzeptieren?false Platzhalterzeichen akzeptieren?false -SupportEvent [<SwitchParameter>] Blendet das Ereignisabonnement aus. Verwenden Sie diesen Parameter, wenn das aktuelle Abonnement Teil eines komplexeren Ereignisregistrierungsmechanismus ist und nicht unabhängig erfasst werden soll. Um ein Abonnement anzuzeigen oder abzubrechen, das mit dem SupportEvent-Parameter erstellt wurde, verwenden Sie den Force-Parameter der Cmdlets "Get-EventSubscriber" und "Unregister-Event". Erforderlich? false Position? named Standardwert False 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
Keiner Eingaben können nicht über die Pipeline an Register-EngineEvent übergeben werden.
AUSGABEN
Keiner oder System.Management.Automation.PSEventJob Wenn Sie den Action-Parameter verwenden, gibt Register-EngineEvent ein System.Management.Automation.PSEventJob-Objekt zurück. Andernfalls wird keine Ausgabe generiert.
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.

Beispiele

BEISPIEL 1
C:\PS>$s = new-pssession -computername Server01, Server02 C:\PS> invoke-command -session $s { Register-EngineEvent -sourceIdentifier ([System.Management.Automation.PsEngineEvent]::Exiting) -forward } Beschreibung ----------- Mit diesem Befehl wird ein Windows PowerShell-Modulereignis auf zwei Remotecomputern registriert. Im ersten Befehl wird auf jedem Remotecomputer eine PSSession erstellt. Im zweiten Befehl wird der Befehl "Register-EngineEvent" in den Remotesitzungen mit dem Cmdlet "Invoke-Command" ausgeführt. Der Befehl "Register-EngineEvent" identifiziert das Ereignis mithilfe des SourceIdentifier-Parameters. Die Ereignisse werden mit dem Forward-Parameter von der Remotesitzung an die lokale Sitzung weitergeleitet.
BEISPIEL 2
C:\PS>$j = register-engineEvent -sourceIdentifier PowerShell.ProcessCreated -action { $processName | add-content processLog.txt } C:\PS> get-event C:\PS> $results = $j | receive-job C:\PS> unregister-event PowerShell.ProcessCreated Beschreibung ----------- Dieser Befehl zeigt, wie das Ereignisauftragsobjekt, das von Register-EngineEvent zurückgegeben wird, wenn Sie den Action-Parameter verwenden, mit den Job-Cmdlets verwaltet wird. Ein Ereignisauftrag wird wie jeder andere Windows PowerShell-Auftrag verwaltet. Weitere Informationen finden Sie unter "about_jobs". In diesem Beispiel werden die Ergebnisse des Auftrags mit dem Cmdlet "Receive-Job" abgerufen. Um den Auftrag aus der Sitzung zu löschen, verwenden Sie Remove-Job. Verwenden Sie zum Abbrechen des Ereignisabonnements das Cmdlet "Unregister-Event". Verwenden Sie zum Löschen der Ereignisse in der Ereigniswarteschlange Remove-Event. VERWANDTE LINKS Online version: http://go.microsoft.com/fwlink/?LinkID=135243 (möglicherweise auf Englisch) Register-ObjectEvent Register-WmiEvent Unregister-Event Get-Event New-Event Remove-Event Wait-Event Get-Job Receive-Job Remove-Job Wait-Job C:\Windows>powershell get-help Wait-Event -full

Microsoft Windows [Version 10.0.19045.3693]
Copyright (c) 2023 Microsoft Corporation.

ColorConsole [Version 3.7.1000] PowerShell 2.0-Export

Windows 11, 10, 8.1, 8, 7 / Server 2022, 2019, 2016











Windows-10


... Windows 10 FAQ
... Windows 10 How To


Windows 10 How To


... Windows 11 How To
... Windows 10 FAQ



PowerShell: Abonniert Ereignisse, die vom Windows PowerShell-Modul und dem Cmdlet "New-Event" generiert werden.

HTTP: ... PS_Windows/de/Register-EngineEvent.htm
0.046
21452

Deaktivieren vom Login Bildschirm in Windows 10, aber wie?

Gibt es einen Papierkorb für den Windows 10/11 Desktop?

Öffnen der erweiterten Systemeinstellungen in Windows 10 (vier Lösungen)!

Kann ich eine WiFi-Verbindung entfernen bei Windows 10/11?

Tastenkürzel Fenster Wechsel unter Windows, mit Beispiele!

Kann man Eingänge des Xbox 360 Controllers und Joystick-Ereignisse erkennen?



(0)