Windows service

Le permite controlar servicios de Windows en servidores remotos. Puede iniciar, detener, reiniciar servicios o verificar su estado actual.

Parámetros¶

Server - Especifique el servidor o servidores Windows donde se encuentra el servicio. Se pueden seleccionar múltiples servidores.
Service - Nombre del Servicio de Windows a controlar (ej., "Spooler", "W32Time", "wuauserv").
Action - Seleccione la acción a realizar en el servicio:
Start - Iniciar el servicio si no está en ejecución
Stop - Detener el servicio si está en ejecución
Restart - Detener y luego iniciar el servicio
Status - Verificar el estado actual del servicio sin realizar cambios
Errors - Defina cómo manejar los errores si la acción falla:
Fail - Lanzar un error y detener la ejecución (por defecto)
Warn - Registrar una advertencia pero continuar la ejecución
Silent - Ignorar errores silenciosamente
Wait until status - (Opcional) Esperar a que el servicio alcance el estado esperado después de la acción
Wait timeout (seconds, 0=infinite) - Tiempo máximo de espera para el cambio de estado. Establecer en 0 para espera infinita. El valor por defecto es 0.

Valor de Retorno¶

Este servicio devuelve una estructura hash con nombres de servidores como claves y estados de servicios como valores:

{
    'Server1' => 'RUNNING',
    'Server2' => 'STOPPED',
    ...
}

Los posibles estados del servicio son:

RUNNING - El servicio está actualmente en ejecución
STOPPED - El servicio está detenido
START_PENDING - El servicio está iniciando
STOP_PENDING - El servicio se está deteniendo
PAUSE_PENDING - El servicio se está pausando
CONTINUE_PENDING - El servicio se está reanudando después de una pausa
PAUSED - El servicio está pausado
SKIPPED - El servidor estaba inactivo y fue omitido

Funcionalidad de Espera¶

Cuando Wait until status está habilitado: - Para acciones Start y Restart: espera hasta que el estado del servicio sea RUNNING - Para acción Stop: espera hasta que el estado del servicio sea STOPPED - El servicio sondea cada 2 segundos hasta que se alcanza el estado esperado o expira el tiempo de espera - Si se alcanza el tiempo de espera antes del estado esperado, se registra una advertencia pero la ejecución continúa

Ejemplos de Uso¶

Iniciar un servicio y esperar a que esté en ejecución¶

Establezca Action en "Start"
Habilite Wait until status
Establezca Wait timeout en 30 segundos
El servicio iniciará y esperará hasta 30 segundos para que el servicio alcance el estado RUNNING

Verificar el estado del servicio en múltiples servidores¶

Seleccione múltiples servidores en el campo Server
Establezca Action en "Status"
El servicio devolverá el estado actual del servicio en cada servidor

Reiniciar un servicio con manejo de errores¶

Establezca Action en "Restart"
Establezca Errors en "Warn" para continuar incluso si el reinicio falla
El servicio intentará reiniciar y registrará advertencias en caso de falla

Notas¶

Este servicio utiliza los comandos sc query y net start/stop de Windows
Soporta servidores Windows multilingües (Inglés, Español, etc.)
Los códigos de estado son independientes del idioma, asegurando resultados consistentes en diferentes locales de Windows
Los servidores inactivos se omiten automáticamente con un mensaje de advertencia