La biblioteca de scripts es donde creas, organizas y mantienes scripts que se pueden usar en automatizaciones, monitores de scripts y ejecuciones ad-hoc desde la lista de dispositivos o detalles del dispositivo. Los scripts se guardan una vez y son reutilizables en todo su entorno — cambia un script en la biblioteca y la actualización se refleja en todos los lugares donde se hace referencia.
Scripts
Ve a Scripts en la barra lateral.
La barra lateral izquierda tiene tres elementos fijos en la parte superior:
Todos los scripts — muestra todos los scripts de tu biblioteca, en todos los grupos
Nuevo script — abre el diálogo Crear script
Scripts sin agrupar — scripts que aún no han sido asignados a un grupo
Debajo, la sección Grupos de scripts lista todos los grupos personalizados que hayas creado. Selecciona un grupo para filtrar la tabla solo a los scripts en ese grupo.
La tabla principal muestra todos los scripts que coinciden con la selección actual. Las columnas incluyen Nombre, Grupo, Descripción, Tipo (idioma) e Creado. Haz clic en cualquier nombre de script para abrirlo en el editor.
Crear un Script
Haz clic en + Crear script en la parte superior derecha, o en Nuevo script en la barra lateral. Aparece un diálogo pidiendo un nombre.
Ingresa un nombre y haz clic en Crear. El editor de scripts se abre inmediatamente.
💡 CONSEJO: Nombra los scripts específicamente — "Deshabilitar Cuenta de Invitado - Windows" es más fácil de encontrar y reutilizar que "Script de Cuenta de Invitado". Siempre puedes renombrar más tarde.
Editor de Scripts
Cada script tiene cuatro pestañas en el panel izquierdo: Script, Variables, Automatizaciones vinculadas y Monitores vinculados.
Los campos configurables:
Nombre del script — el nombre mostrado en la biblioteca y en el selector de acción Ejecutar script.
Descripción — opcional. Se muestra en la lista de scripts. Vale la pena rellenar para bibliotecas compartidas.
Idioma — el lenguaje de scripting. Opciones admitidas:
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 marcar la ejecución como fallida. El valor por defecto 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 conectado — usa esto para operaciones de contexto de usuario como aplicar un fondo de pantalla o configurar ajustes por usuario |
El editor de código ocupa el lado derecho de la pantalla. Escribe o pega tu script directamente. Haz clic en {x} en la esquina inferior derecha del editor para insertar una variable, variable del sistema o referencia de campo personalizado en línea.
Haz clic en Guardar script para guardar. Los cambios no surtirán efecto hasta que se guarden.
⚠️ ADVERTENCIA: Los cambios no guardados se pierden si te alejas. Guarda antes de dejar el editor.
Variables
La pestaña Variables muestra cualquier variable de script declarada para este script. Las variables de script son espacios de salida nombrados — el script escribe un valor en ellos durante la ejecución, y puedes mapear ese valor a una variable de automatización en el panel de acción Ejecutar script para pasarlo a través del pipeline.
Haz clic en + Añadir nueva variable para definir una nueva variable. Una vez definidas, las variables aparecen en la sección Variables de script de cualquier acción Ejecutar script que haga referencia a este script.
ℹ️ NOTA: Las variables de script capturan la salida de un script. Para pasar datos en un script — contexto de dispositivo, valores de campo personalizado, información del sistema — usa el selector {x} en el editor de código para hacer referencia a variables o campos personalizados en línea.
Para la referencia completa sobre cómo mapear variables de script a variables de automatización y usarlas en acciones posteriores, consulta Acción Ejecutar Script, Variables de Automatización, y Variables del Sistema.
Automatizaciones Vinculadas
La pestaña Automatizaciones vinculadas lista todas las automatizaciones que hacen referencia a este script a través de una acción Ejecutar script. Haz clic en cualquier nombre de automatización para abrirlo.
ℹ️ NOTA: No se puede eliminar un script mientras tenga automatizaciones vinculadas. Deberás quitar el script de cada automatización que lo referencia primero, o eliminar esas automatizaciones. La pestaña facilita ver exactamente qué se vería afectado.
Monitores Vinculados
La pestaña Monitores vinculados lista todos los monitores de scripts que usan este script. La misma regla de eliminación se aplica: desvincula de todos los monitores antes de que se pueda eliminar un script.
Organización con Grupos de Scripts
Los grupos de scripts te permiten categorizar scripts por plataforma, función, equipo o de la manera que tenga sentido para tu entorno. Los grupos aparecen en la barra lateral bajo Grupos de scripts y como una columna en la lista de scripts.
Para crear un grupo, haz clic en el icono + junto a Grupos de scripts en la barra lateral. Aparece un diálogo pidiendo un nombre de grupo.
Para asignar un script a un grupo, abre el menú Acciones del script (arriba a la derecha) y selecciona Asignar a grupo.
💡 CONSEJO: Los grupos de scripts típicamente reflejan propósito o rol — Seguridad, Software, Monitores, Utilidades — no la estructura de tus grupos de dispositivos. Organizar por función facilita que todo el equipo encuentre el script correcto sin importar en qué dispositivos se ejecute.
Eliminar un Script
Abre el menú Acciones del script y selecciona Eliminar. Aparece un diálogo de confirmación.
⚠️ ADVERTENCIA: La eliminación de scripts no se puede deshacer. Si el script tiene automatizaciones o monitores vinculados, Level bloquea la eliminación — primero elimina todos los vínculos usando las pestañas Automatizaciones vinculadas y Monitores vinculados.
Ejecutar Scripts
Los scripts se pueden ejecutar de varias maneras:
En una automatización — a través de la acción Ejecutar script. El script se ejecuta en cada dispositivo de destino como parte del pipeline de automatización. Esta es la forma principal de ejecutar scripts a gran escala o en un horario. Consulta Acción Ejecutar Script para la referencia completa.
Ad-hoc desde la lista de dispositivos o detalles del dispositivo — selecciona dispositivos y abre el menú Acciones. Aparecen tres opciones relacionadas con scripts:
Ejecutar script guardado — elige un script de tu biblioteca. Level crea una nueva automatización de ejecución de script con dos acciones: Esperar aprobación y Ejecutar script.
Ejecutar nuevo script — escribe un nuevo script sobre la marcha. El script se guarda en tu biblioteca y se crea una automatización de ejecución de script para él.
Añadir a ejecución de script reciente — añade los dispositivos seleccionados a una automatización de ejecución de script existente en lugar de iniciar una nueva.
En un monitor de script — un monitor ejecuta un script en un horario y evalúa su salida para determinar la salud del dispositivo. Consulta Monitores de Script para detalles de configuración.
ℹ️ NOTA: Las automatizaciones de ejecución de script son reutilizables. Puedes renombrarlas, moverlas a un grupo, añadir más acciones o ajustar su disparador antes de aprobar. El script no se ejecutará hasta que el paso Esperar aprobación sea aprobado manualmente. Todas las ejecuciones de scripts se rastrean bajo Automatizaciones → Ejecuciones de scripts en la barra lateral.
Preguntas Frecuentes
¿Cuál es la diferencia entre Ejecutar script guardado, Ejecutar nuevo script y Añadir a ejecución de script reciente? Los tres están en el menú Acciones en la lista de dispositivos y detalles del dispositivo. Ejecutar script guardado elige un script de biblioteca existente y crea una nueva automatización de ejecución de script. Ejecutar nuevo script te permite escribir un nuevo script sobre la marcha — se guarda en la biblioteca y se crea una automatización de ejecución de script. Añadir a ejecución de script reciente añade los dispositivos seleccionados a una automatización de ejecución de script existente en lugar de iniciar una nueva. En todos los casos, el script no se ejecutará hasta que la acción Esperar aprobación sea aprobada.
¿Cuál es la diferencia entre un script guardado y una acción Shell? Un script guardado vive en la biblioteca y es reutilizable — haz referencia a él desde cualquier automatización, monitor o ejecución ad-hoc, y los cambios en un lugar actualizan todas las referencias. La acción Shell ejecuta un script escrito en línea en la automatización, sin entrada de biblioteca. Usa scripts guardados para cualquier cosa que ejecutes más de una vez o que quieras mantener a lo largo del tiempo.
¿Puedo editar un script sin romper las automatizaciones que lo utilizan? Sí. Los cambios en un script guardado surtirán efecto la próxima vez que se ejecute cualquier automatización que lo referencia — no hay necesidad de actualizar la automatización misma. La pestaña Automatizaciones vinculadas muestra exactamente qué automatizaciones se verán afectadas.
¿Qué lenguajes admite Level? Ansible, Bash, Go, osquery, PowerShell, Python y Zsh.
¿Puede un script pasar la salida a acciones de automatización posteriores? Sí — dos maneras. Define variables de script en la pestaña Variables y mapéalas a variables de automatización en el panel de acción Ejecutar script. O usa Asignar salida de acción a variable en las opciones adicionales de la acción para capturar la stdout completa del script. Consulta Acción Ejecutar Script para detalles.
¿Quién puede crear y editar scripts? Técnicos con permiso para editar automatizaciones en el grupo relevante. Consulta Espacio de trabajo → Permisos para la configuración del control de acceso.
¿Qué sucede con las automatizaciones si elimino un script? Level bloquea la eliminación de un script que esté vinculado a automatizaciones o monitores activos. Usa las pestañas Automatizaciones vinculadas y Monitores vinculados para ver qué debe desvincularse primero.