Introducción
Ejecute un script en línea como parte de una automatización — no se requiere script guardado. Shell es la opción correcta para comandos únicos o lógica ligera que no necesita vivir en su biblioteca de scripts.
Para scripts que planea reutilizar en múltiples automatizaciones, ver la acción Ejecutar script en su lugar.
Configurando la acción Shell
Desde la tubería de automatización en modo de edición, haga clic en + y seleccione Shell de la categoría Sistema.
El panel de acción se abre con los campos de configuración del script.
Idioma
Seleccione el idioma de scripting para este script.
Idiomas soportados: Ansible, Bash, Go, osquery, PowerShell, Python, Zsh .
Tiempo de espera (en segundos)
Cuánto tiempo espera Level a que el script se complete antes de marcarlo como fallido. El valor predeterminado es 100 segundos.
Ejecutar como
El contexto de la cuenta en el que se ejecuta el script.
Opción | Comportamiento |
Sistema local | Se ejecuta como cuenta SYSTEM — elevada, sin contexto de usuario |
Usuario actual | Se ejecuta como usuario actualmente conectado — útil para operaciones de contexto de usuario como aplicar configuraciones de pantalla o configurar preferencias de usuario |
Editor de scripts
Escriba su script en el editor de código. Haga clic en (x) en la esquina inferior derecha del editor para insertar una variable, variable del sistema o referencia de campo personalizado en la posición del cursor.
Seleccionar un elemento lo inserta como ##{{variable_name}} en el cursor. Level resuelve el valor en tiempo de ejecución antes de que se ejecute el script.
💡 CONSEJO: Las variables del sistema como Nombre de host del dispositivo y Apodo del dispositivo no requieren configuración — siempre están disponibles. Las variables de automatización (listadas bajo Variables ) están limitadas a la automatización actual y deben crearse primero, ya sea desde el menú Variables de la automatización o por una acción anterior. Los campos personalizados que ha definido en su organización también aparecen en el selector y se resuelven al valor del campo de ese dispositivo en tiempo de ejecución.
Códigos de salida
Level utiliza el código de salida del script para determinar si la acción tuvo éxito o falló.
Código de salida | Resultado |
| Acción marcada como exitosa |
Distinto de cero (p. ej. | Acción marcada como fallida |
Su configuración En caso de fallo de acción en Opciones adicionales controla lo que sucede después — si la tubería se detiene o continúa.
Asegúrese de que sus scripts salgan explícitamente con el código apropiado. Si un script se cierra 0 después de encontrar un error que no manejó, Level tratará la acción como exitosa.
Condiciones
La sección Condiciones le permite restringir cuándo se ejecuta esta acción según los atributos del dispositivo o el resultado de una acción anterior.
Ver Condiciones de acción para la referencia completa sobre tipos de condición, operadores y valores.
Opciones adicionales
Expanda Opciones adicionales para nombre de acción, comportamiento de fallo, asignación de variable de salida, intentos e interruptor habilitado.
Ver Descripción general de acciones para la referencia completa sobre opciones adicionales disponibles en cada acción.
FAQ
¿Cuál es la diferencia entre Shell y Ejecutar script? Shell escribe el script directamente en el panel de acción — no se guarda en su biblioteca de scripts. Ejecutar script ejecuta un script guardado que puede reutilizarse en múltiples automatizaciones. Utilice Shell para comandos únicos rápidos; utilice Ejecutar script cuando la misma lógica necesita ser mantenida o compartida.
¿Qué sucede si el script se agota el tiempo? La acción se marca como fallida. La configuración En caso de fallo de acción en Opciones adicionales controla si la tubería se detiene o continúa.
¿Puede un script Shell establecer una variable de automatización? Sí — dos formas. Utilice la sintaxis en línea
##{{variable_name=value}}en cualquier lugar de su salida de script para establecer una variable de script; esa variable de script debe asignarse a una variable de automatización en el panel de acción para estar disponible para acciones posteriores. O utilice Asignar salida de acción a variable en Opciones adicionales para capturar la stdout completa del script directamente en una variable de automatización sin mapeo adicional. Ver Establecer variables directamente desde scripts para los detalles de sintaxis en línea.¿Quién puede agregar o modificar acciones Shell? Técnicos con permiso para editar automatizaciones en el grupo relevante. Ver Espacio de trabajo → Permisos para la configuración de control de acceso.