Hinzufügen von Ereignis-Handlern (Windows-Hosting)

So fügen Sie einen Ereignishandler hinzu:

Nehmen wir an, Sie möchten einen Ereignishandler für das Ereignis "Kunden-Account erstellen" 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 so 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 Kunden-Account
echo "client created" >> c:\windows\temp\event_handler.log
rem Name des Kunden
echo "name: %1" >> c:\windows\temp\event_handler.log
rem Benutzername des Kunden
echo "login: %2" >> c:\windows\temp\event_handler.log
echo "--------------" >> c:\windows\temp\event_handler.log

Dieses Skript gibt Informationen in eine Datei aus, so dass wir die Ausführung steuern können.

Nehmen wir an, das Skript befindet sich im Verzeichnis C:\Programme\parallels\plesk\scripts\. So erstellen Sie mit dem Control Panel einen entsprechenden Ereignishandler:

  1. Gehen Sie zu Start > Event Manager (in der Gruppe Protokolle & Statistiken).
  2. Klicken Sie auf Neuen Ereignishandler hinzufügen. Die Seite für die Einrichtung des Ereignishandlers wird angezeigt:
  3. Wählen Sie in der Dropdown-Liste Ereignis das Ereignis aus, dem Sie den 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 Dropdown-Liste 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:\Programme\parallels\plesk\scripts\test-handler.ba <neuer_Kontaktname> <neuer_Benutzername>.

    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 im folgenden Abschnitt. Denken Sie daran, dass beim Entfernen von Kunden die Parameter des Typs new_xxx und beim Hinzufügen von Kunden die Parameter des Typs old_xxx eine leere Zeichenfolge enthalten.

Wenn Sie sich nun bei Ihrem Parallels Plesk Panel anmelden und einen neuen Kunden erstellen, indem Sie in das Feld Kontaktname den Wert "Ein Kunde" und in das Feld Login den Wert "ein_kunde" eintragen, wird der Handler aufgerufen und die Datei C:\windows\temp\event_handler.log um die folgenden Einträge erweitert:


Sat Jun 26 21:46:34 NOVT 2004
Kunde erstellt
Name: Ein Kunde
Login: ein_kunde

Wenn Sie weitere Handler einrichten möchten, wiederholen Sie die oben beschriebenen Schritte.

Weitere Informationen zu den Ereignissen, die vom Ereignishandler verarbeitet werden können, finden Sie im erweiterten Administrationshandbuch auf der Parallels-Website.