Ejecute un script inline como parte de una automatización — no se requiere script guardado. Shell es la opción correcta para comandos puntuales o lógica ligera que no necesita vivir en su biblioteca de scripts.
Para scripts que planea reutilizar en varias automatizaciones, consulte la acción Ejecutar Script.
Configurar la Acción Shell
Desde el pipeline de automatización en modo edición, haga clic en + y seleccione Shell en la categoría Sistema.
El panel de acción se abre con los campos de configuración del script.
Idioma
Seleccione el lenguaje de script para este script.
Lenguajes admitidos: Ansible, Bash, Go, osquery, PowerShell, Python, Zsh.
Tiempo de espera (en segundos)
Cuánto tiempo espera Level a que se complete el script antes de marcarlo como fallido. El valor predeterminado es 100 segundos.
Ejecutar como
El contexto de cuenta en el que se ejecuta el script.
Opción | Comportamiento |
Sistema local | Se ejecuta como la cuenta SYSTEM — elevada, sin contexto de usuario |
Usuario actual | Se ejecuta como el usuario conectado actualmente — ú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 ninguna configuración — siempre están disponibles. Las variables de automatización (enumeradas bajo Variables) se limitan 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 de campo de ese dispositivo en tiempo de ejecución.
Códigos de salida
Level usa el código de salida del script para determinar si la acción fue exitosa o falló.
Código de salida | Resultado |
| Acción marcada como exitosa |
Distinto de cero (por ejemplo | Acción marcada como fallida |
Su configuración En caso de fallo de acción en Opciones adicionales controla qué sucede a continuación — si el pipeline se detiene o continúa.
Asegúrese de que sus scripts salgan explícitamente con el código apropiado. Si un script sale con código 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 en función de atributos del dispositivo o del resultado de una acción anterior.
Consulte Condiciones de Acción para la referencia completa sobre tipos de condiciones, operadores y valores.
Opciones adicionales
Expanda Opciones adicionales para el nombre de la acción, comportamiento de fallo, asignación de variable de salida, reintentos y el botón de activación.
Consulte Descripción General de Acciones para la referencia completa sobre opciones adicionales disponibles en cada acción.
Preguntas frecuentes
¿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 se puede reutilizar en las automatizaciones. Use Shell para comandos puntuales rápidos; use Ejecutar Script cuando la misma lógica necesita mantenerse o compartirse.
¿Qué sucede si el script 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 el pipeline se detiene o continúa.
¿Puede un script Shell establecer una variable de automatización? Sí — de dos formas. Use la sintaxis inline
##{{variable_name=value}}en cualquier lugar de su salida de script para establecer una variable de script; esa variable de script luego debe asignarse a una variable de automatización en el panel de acción para estar disponible para acciones posteriores. O use Asignar salida de acción a variable en Opciones adicionales para capturar el stdout completo del script directamente en una variable de automatización sin ninguna asignación adicional. Consulte Establecer Variables Directamente desde Scripts para obtener los detalles de la sintaxis inline.¿Quién puede agregar o modificar acciones Shell? Técnicos con permiso para editar automatizaciones en el grupo relevante. Consulte Espacio de Trabajo → Permisos para la configuración del control de acceso.