Adición de controladores de eventos (Windows)

Para añadir un controlador de eventos:

Por ejemplo, creemos un controlador de eventos para el evento 'creación de cuenta de cliente'. El controlador aceptará un nombre de cliente como primer parámetro y el nombre de usuario del cliente como segundo parámetro. Para simplificarlo, usaremos un archivo batch denominado test-handler.bat que tiene la siguiente apariencia:

echo "--------------" >> c:\windows\temp\event_handler.log
información rem sobre la fecha y hora del evento
date /T>> c:\windows\temp\event_handler.log
información rem sobre la cuenta de cliente creada
echo "customer created" >> c:\windows\temp\event_handler.log
nombre del cliente rem
echo "name: %1">> c:\windows\temp\event_handler.log
nombre de usuario del cliente rem en Plesk
echo "login: %2">> c:\windows\temp\event_handler.log
echo "--------------" >> c:\windows\temp\event_handler.log

Este script imprime alguna información en el archivo para que podamos controlar su ejecución.

Supongamos que nuestro script está en el directorio c:\program files\parallels\plesk\scripts\. Lo registramos creando un controlador de eventos a través del Panel Administrativo:

1. Vaya a Herramientas y configuración > Administrador de eventos.
2. Haga clic en Añadir controlador de eventos.
3. En la casilla desplegable Evento, seleccione el evento que desea asignar al controlador.
4. Seleccione la prioridad de la ejecución del controlador o indique un valor personalizado. Para ello, vaya a la lista desplegable Prioridad, seleccione personalizada e introduzca el valor deseado.

   Cuando se asignan controladores a un único evento, puede indicar la secuencia de ejecución del controlador ajustando las distintas prioridades (un valor superior corresponde a una prioridad más elevada).

5. Seleccione el usuario de sistema, en nombre del cual se ejecutará el controlador.
6. En el campo Comando, indique el comando a ejecutar en el evento seleccionado. En nuestro ejemplo es c:\program files\parallels\plesk\scripts\test-handler.bat" <NEW_CONTACT_NAME> <NEW_LOGIN_NAME>.

   Tenga en cuenta que si el nombre del directorio o del archivo tiene espacios, la ruta debe indicarse entre comillas.

7. Haga clic en ACEPTAR.

Nota: en el comando hemos indicado los parámetros entre paréntesis angulares <NEW_CONTACT_NAME> y <NEW_LOGIN_NAME>. Antes de ejecutar el controlador, se sustituirán por el nombre y el nombre de usuario del cliente creado. Puede examinar la lista de los parámetros disponibles en el Apéndice C. Parámetros de eventos pasados por controladores de eventos.

Ahora, si usted inicia sesión en su Plesk y crea una cuenta de cliente, especificando el valor 'Algún cliente' en el campo Nombre del contacto y 'algún_cliente' en el campo Inicio de sesión, el controlador será invocado y se añadirán los siguientes registros a c:\windows\temp\event_handler.log:

Mon March 15 21:46:34 NOVT 2010
customer created
nombre: Algún Cliente
Nombre de usuario: algún_cliente

Si desea indicar uno o más controladores, repita la operación para cada uno de los nuevos controladores.