Ejecuta un script guardado en un dispositivo como parte de una automatización. Compatible con PowerShell, Bash, Python y otros lenguajes. Si tu script necesita datos externos —como el valor de un campo personalizado o una variable de automatización— puedes asignarlos sin modificar la lógica del script.

Desde el flujo de automatización en modo de edición, haz clic en + y selecciona Ejecutar script de la categoría Sistema.

El panel de acción se abre mostrando el campo Script y dos botones: un icono de enlace externo para explorar tus scripts guardados, y Crear script para escribir uno nuevo de forma integrada.

Haz clic en el icono de enlace externo junto al campo Script para abrir el selector de scripts guardados. Los scripts están organizados en carpetas — expande cualquier carpeta para explorar su contenido, o usa el campo de búsqueda para encontrar un script por nombre.

Haz clic en Crear script para escribir un nuevo script sin salir del editor de automatización. El editor de scripts se abre como un panel lateral.

Configura lo siguiente:

Nombre del script Un nombre descriptivo para el script. Se guardará en tu biblioteca de scripts y estará disponible para usarse en otras automatizaciones.

Lenguaje El lenguaje de programación 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.

Escribe tu script en el editor de código. Haz clic en {x} para referenciar variables y campos personalizados de forma integrada en el script. Cuando termines, haz clic en Crear script para guardarlo y adjuntarlo a la acción.

Las variables de script son valores con nombre definidos en la pestaña Variables pestaña. En la Ejecutar Script acción, asignar una variable de script a una variable de automatización permite que el script guardado reciba datos de entrada y envíe un valor actualizado a los pasos posteriores de la automatización.

Cuando se selecciona un script con variables definidas, aparece una sección Variables de script aparece en el panel de acción.

Para asignar una variable de script a una variable de automatización:

Cuando el script se inicia, la variable de script asignada recibe el valor actual de la variable de automatización. Referencíala en el script guardado con {{script_variable_name}}. Para enviar un nuevo valor de vuelta a la automatización, asigna la variable de script con {{script_variable_name=value_expression}}.

Consulta Variables de Automatización para la referencia completa sobre cómo crear y usar variables de automatización.

Las variables de script se definen en el propio script, no en el panel de acción. Abre el editor de scripts y navega a la pestaña Variables pestaña para añadirlas, editarlas o eliminarlas.

Hay dos formas de capturar un valor de un script y hacerlo disponible para las acciones posteriores en el flujo.

Usa {{script_variable_name=value_expression}} en el script guardado para actualizar una variable de automatización mapeada. Por ejemplo, si una variable de script de PowerShell llamada local_ip está mapeada a una variable de automatización, usa {{local_ip=$ip}} después de calcular $ip.

Antes de la ejecución, Level reemplaza la asignación con el comando correcto para establecer la variable según el shell del script. No se analiza desde la salida estándar del script. La variable de script debe existir en la pestaña Variables pestaña y ser mapeada en la Ejecutar Script acción.

Usa esta opción cuando el script genera registros u otra salida y solo necesitas llevar un valor específico hacia adelante.

En Opciones adicionales, usa Asignar salida de acción a variable para capturar toda la salida estándar del script en una variable de automatización. Esto funciona con cualquier script sin requerir cambios en el propio script — pero captura todo lo que el script genera, no solo el valor que necesitas.

Level usa el código de salida del script para determinar si la acción tuvo éxito o falló.

Tu configuración de En caso de fallo de acción en Opciones adicionales controla lo que sucede a continuación — si el flujo se detiene o continúa.

Asegúrate de que tus 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.

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.

Expande Opciones adicionales para el nombre de la acción, comportamiento en caso de fallo, asignación de variable de salida, 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.