Introducción
Ejecute un script en línea como parte de una automatización: no se requiere ningún script guardado. Shell es la opción adecuada para comandos únicos o lógica liviana que no necesita residir en su biblioteca de scripts.
Para los scripts que planea reutilizar en múltiples automatizaciones, consulte Ejecutar Script en su lugar.
Configuración de la acción de Shell
Desde el pipeline 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.
Lenguaje
Seleccione el lenguaje de scripting para este script.
Lenguajes compatibles: Ansible, Bash, Go, osquery, PowerShell, Python, Zsh.
Tiempo de espera (en segundos)
Tiempo que Level espera a que el script se complete antes de marcarlo como fallido. El valor predeterminado es 100 segundos.
Ejecutar como
El contexto de cuenta bajo 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 que ha iniciado sesión actualmente — útil para operaciones en el contexto del usuario, como aplicar configuraciones de pantalla o ajustar 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.
Al seleccionar un elemento, se inserta como {{variable_name}} en el cursor. Level resuelve el valor en tiempo de ejecución antes de que el script se ejecute.
💡 CONSEJO: Las variables del sistema, como el nombre de host del dispositivo y el alias del dispositivo, no requieren ninguna configuración: siempre están disponibles. Las variables de automatización (enumeradas bajo Variables) están limitadas a la automatización actual y deben crearse primero, ya sea desde el menú Variables o mediante una acción anterior. Los campos personalizados que haya 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 fue exitosa o fallida.
Código de salida | Resultado |
| Acción marcada como exitosa |
Distinto de cero (p. ej. | Acción marcada como fallida |
Su configuración de En caso de fallo de la 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 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 los atributos del dispositivo o el 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, el comportamiento ante fallos, la asignación de variables de salida, los reintentos y el interruptor de habilitación.
Consulte Descripción general de acciones para la referencia completa sobre las 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 distintas automatizaciones. Use Shell para comandos únicos rápidos; use Ejecutar Script cuando la misma lógica necesite mantenerse o compartirse.
¿Qué sucede si el script supera el tiempo de espera? La acción se marca como fallida. La configuración de En caso de fallo de la acción en Opciones adicionales controla si el pipeline se detiene o continúa.
¿Puede un script de Shell establecer una variable de automatización? Sí, de dos formas. Use la sintaxis en línea
{{variable_name=value}}en cualquier parte de la salida de su script para establecer una variable de script; esa variable de script luego debe mapearse a una variable de automatización en el panel de acción para que esté disponible en acciones posteriores. O use Asignar salida de acción a variable en Opciones adicionales para capturar la salida estándar completa del script directamente en una variable de automatización sin ningún mapeo adicional. Consulte Establecer variables directamente desde scripts para los detalles de sintaxis en línea.¿Quién puede agregar o modificar acciones de Shell? Los técnicos con permiso para editar automatizaciones en el grupo correspondiente. Consulte Espacio de trabajo → Permisos para la configuración del control de acceso.