Hinzufügen von Ereignis-Handlern (Windows)

So fügen Sie einen Ereignis-Handler hinzu:

Nehmen wir an, Sie möchten einen Ereignis-Handler für das Ereignis "Erstellung eines Kundenkontos" erstellen. Der Handler erhält als ersten Parameter den Namen und als zweiten Parameter den Benutzernamen eines Kunden. Zur Vereinfachung verwenden wir eine Batchdatei namens "test-handler.bat", die wie folgt aussieht:

echo "--------------" >> c:\windows\temp\event_handler.log
rem Informationen zu Datum und Uhrzeit des Ereignisses
date /T   >> c:\windows\temp\event_handler.log
rem Informationen zum erstellten Kundenkonto
echo "customer created" >> c:\windows\temp\event_handler.log
rem Name des Kunden
echo "name: %1"       >> c:\windows\temp\event_handler.log
rem Benutzername des Kunden in Plesk
echo "login: %2"       >> c:\windows\temp\event_handler.log
echo "--------------" >> c:\windows\temp\event_handler.log

Dieses Skript schreibt Informationen in eine Datei, sodass wir die Ausführung kontrollieren können.

Nehmen wir an, das Skript befindet sich im Verzeichnis C:\Program Files\Parallels\Plesk\Scripts\. So erstellen Sie mit dem Administrations-Panel einen entsprechenden Ereignis-Handler:

1. Gehen Sie zu Tools & Einstellungen > Ereignis-Manager.
2. Klicken Sie auf Ereignis-Handler hinzufügen.
3. Wählen Sie in der Drop-down-Liste zu Ereignis das Ereignis aus, dem Sie einen Handler zuweisen möchten.
4. Wählen Sie die Priorität für die Ausführung des Handlers aus oder geben Sie einen eigenen Wert an. Wählen Sie zu diesem Zweck in der Drop-down-Liste für die Priorität den Eintrag benutzerdefiniert und tragen Sie den gewünschten Wert ein.

   Wenn Sie einem Ereignis mehrere Handler zuweisen, können Sie mithilfe von Prioritäten die Reihenfolge festlegen, in der diese ausgeführt werden.

5. Wählen Sie den Systembenutzer aus, für den der Handler ausgeführt wird.
6. Geben Sie in das Feld Befehl den Befehl ein, der auf das betreffende Ereignis hin ausgeführt werden soll. In diesem Beispiel lautet der Befehl c:\program files\parallels\plesk\scripts\test-handler.ba <new_contact_name> <new_login_name>.

   Beachten Sie, dass der Pfad in Anführungszeichen zu setzen ist, wenn die Verzeichnisnamen oder der Dateiname Leerzeichen enthalten.

7. Klicken Sie auf OK.

Hinweis: In diesem Befehl sind in spitzen Klammern die Parameter <new_contact_name> und <new_login_name> angegeben. Vor der Ausführung des Handlers werden diese Parameter durch den Namen und den Benutzernamen des jeweiligen Kunden ersetzt. Eine vollständige Liste der verfügbaren Parameter finden Sie unter Ereignisparameter, die von Ereignis-Handlern übergeben werden.

Wenn Sie sich nun in Plesk anmelden und ein Kundenkonto erstellen, für das Sie den Wert 'Ein Kunde' im Feld Name des Kontakts und 'ein_kunde' im Feld Benutzername angeben, wird der Handler aufgerufen und die folgenden Einträge werden zur Datei c:\windows\temp\event_handler.log hinzugefügt:

Mon März 15 21:46:34 NOVT 2010
customer created
name: Ein Kunde
Benutzername: ein_kunde

Wenn Sie weitere Handler einrichten möchten, wiederholen Sie die oben beschriebenen Schritte für einen weiteren Handler.