Introducción
Ejecuta un script en línea como parte de una automatización, sin necesidad de un script guardado. Shell es la opción adecuada para comandos únicos o lógica ligera que no necesita residir en tu biblioteca de scripts.
Para scripts que planeas reutilizar en múltiples automatizaciones, consulta Ejecutar Script en su lugar.
Configuración de la Acción Shell
Si el lienzo aún no tiene acciones, selecciona Agregar una acción. Para agregar este paso a un lienzo que ya tiene acciones, haz clic en el botón en línea + donde lo desees y selecciona Agregar otra acción. Luego elige Shell de Sistema.
El panel de acciones se abre con los campos de configuración del script.
Lenguaje
Selecciona 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 cual 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 contexto de usuario, como aplicar configuraciones de pantalla o configurar preferencias del usuario |
Editor de scripts
Escribe tu script en el editor de código. Haz clic en (x) en la esquina inferior derecha del editor para insertar una variable, variable del sistema o referencia a un 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 apodo del dispositivo, no requieren ninguna configuración: siempre están disponibles. Las variables de automatización (enumeradas en Variables) están limitadas a la automatización actual y deben crearse primero, ya sea desde el menú Variables o por una acción anterior. Los campos personalizados que hayas definido en tu 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 usa 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 |
Tu configuración de En caso de fallo de acción en Opciones adicionales controla qué sucede a continuación: si el flujo se detiene o continúa.
Asegúrate de que tus scripts finalicen 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 te 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.
Consulta Condiciones de acción para la referencia completa sobre tipos de condiciones, operadores y valores.
Opciones adicionales
Expande 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.
Consulta 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 y no se guarda en tu biblioteca de scripts. Ejecutar Script ejecuta un script guardado que puede reutilizarse entre automatizaciones. Usa Shell para comandos únicos rápidos; usa Ejecutar Script cuando la misma lógica necesita mantenerse o compartirse.
¿Qué ocurre si el script supera el tiempo de espera? La acción se marca como fallida. La configuración de En caso de fallo de acción en Opciones adicionales controla si el flujo se detiene o continúa.
¿Puede un script Shell establecer una variable de automatización? Sí, de dos formas. Usa la sintaxis en línea
{{variable_name=value}}en cualquier parte de la salida de tu 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 para las acciones siguientes. O usa 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 ningún mapeo adicional. Consulta Establecer variables directamente desde scripts para los detalles de sintaxis en línea.¿Quién puede agregar o modificar acciones Shell? Los técnicos con permiso para editar automatizaciones en el grupo correspondiente. Consulta Espacio de trabajo → Permisos para la configuración del control de acceso.