Introducción
La biblioteca de scripts es donde crea, organiza y mantiene scripts que se pueden usar en automatizaciones, monitores de scripts y ejecuciones ad-hoc desde el listado de dispositivos o los detalles del dispositivo. Los scripts se guardan una vez y son reutilizables en todo su entorno — cambie un script en la biblioteca y la actualización se refleja en todas partes donde se hace referencia.
Scripts
Go to Scripts in the sidebar.
La barra lateral izquierda tiene tres elementos fijos en la parte superior:
All scripts — muestra cada script en su biblioteca, en todos los grupos
New script — abre el cuadro de diálogo Crear script
Scripts sin agrupar — scripts que aún no están asignados a un grupo
Debajo, la Script groups La sección enumera cualquier grupo personalizado que haya creado. Seleccione un grupo para filtrar la tabla a scripts solo en ese grupo.
La tabla principal muestra todos los scripts que coinciden con la selección actual. Las columnas incluyen Name, Group, Description , Type (language), and Created. Haga clic en cualquier nombre de script para abrirlo en el editor.
Crear un script
Click + Create script en la esquina superior derecha, u New script en la barra lateral. Aparece un cuadro de diálogo pidiendo un nombre.
Ingrese un nombre y haga clic enCreate . El editor de script se abre inmediatamente.
💡 TIP:Nombre 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 puede renombrar más tarde.
Script Editor
Cada script tiene cuatro pestañas en el panel izquierdo: Script, Variables, Automatizaciones vinculadas, and Linked monitors .
Los campos configurables:
Script name — el nombre que se muestra en la biblioteca y en el selector de acciones Ejecutar script.
Description — opcional. Se muestra en el listado de scripts. Vale la pena llenar para bibliotecas compartidas.
Language— el idioma de secuencias de comandos. 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 marcarlo como fallido. El valor predeterminado es de 100 segundos.
Run as— el contexto de cuenta en el que se ejecuta el script:
Option | Behavior |
Local system | Se ejecuta como cuenta SYSTEM — elevada, sin contexto de usuario |
Current user | Se ejecuta como el usuario que ha iniciado sesión — úselo para operaciones de contexto de usuario como aplicar fondos de pantalla o configurar los ajustes por usuario |
El editor de código ocupa el lado derecho de la pantalla. Escriba o pegue su script directamente. Haga clic en {x} en la esquina inferior derecha del editor para insertar una referencia de variable, variable del sistema o campo personalizado en línea.
Click Save script para guardar. Los cambios no surten efecto hasta que se guarden.
⚠️ WARNING: Los cambios no guardados se pierden si se aleja del editor. Guarde antes de salir.
Variables
The Variables La pestaña muestra cualquier variable de script declarada para este script. Las variables de script son ranuras de salida nombradas — el script escribe un valor en ellas durante la ejecución y puede asignar ese valor a una variable de automatización en el Run Script panel de acción para pasarlo a través de la canalización.
Click + Agregar nueva variable para definir una nueva variable. Una vez definidas, las variables aparecen en la Variables de script section of any Run Script acción que referencia este script.
ℹ️ NOTA: Las variables de script capturan la salida de un script. Para pasar datos into un script — contexto de dispositivo, valores de campos personalizados, información del sistema — use el{x} selector en el editor de código para hacer referencia a variables o campos personalizados en línea.
Para la referencia completa sobre cómo asignar variables de script a variables de automatización y usarlas en acciones posteriores, vea Acción Ejecutar script, Variables de automatización , and Variables del sistema .
Automatizaciones vinculadas
The La pestaña Automatizaciones vinculadas enumera cada automatización que hace referencia a este script a través de unaRun Script acción. Haga clic en cualquier nombre de automatización para abrirlo.
ℹ️ NOTA: Un script no se puede eliminar mientras tenga automatizaciones vinculadas. Deberá quitar primero el script de cada automatización de referencia o eliminar esas automatizaciones. La pestaña facilita ver exactamente qué se vería afectado.
Linked Monitors
The Linked monitorsLa pestaña enumera todos los monitores de script que usan este script. Se aplica la misma regla de eliminación: desvincularse de todos los monitores antes de que se pueda eliminar un script.
Organización con grupos de scripts
Los grupos de scripts le permiten categorizar scripts por plataforma, función, equipo o lo que tenga sentido para su entorno. Los grupos aparecen en la barra lateral bajo Script groups y como una columna en el listado de scripts.
Para crear un grupo, haga clic en el + icon next to Script groups en la barra lateral. Aparece un cuadro de diálogo pidiendo un nombre de grupo.
Para asignar un script a un grupo, abra el script Actionsmenú (arriba a la derecha) y seleccioneAssign to group .
💡 TIP:Los grupos de scripts típicamente reflejan propósito o rol — Seguridad, Software, Monitores, Utilidades — no la estructura de sus grupos de dispositivos. Organizar por función facilita que todo el equipo encuentre el script correcto independientemente de en qué dispositivos se ejecute.
Eliminar un script
Abra el script Actions menu and select Delete . Aparece un cuadro de diálogo de confirmación.
⚠️ WARNING: La eliminación de un script no se puede deshacer. Si el script tiene automatizaciones o monitores vinculados, Level bloquea la eliminación — primero elimine todos los vínculos usando el Automatizaciones vinculadas y Linked monitors tabs.
Running Scripts
Los scripts se pueden ejecutar de varias formas:
En una automatización — via the Run Script acción. El script se ejecuta en cada dispositivo de destino como parte de la canalización de automatización. Esta es la forma principal de ejecutar scripts a escala o según un horario. VerAcción Ejecutar script para la referencia completa.
Ad-hoc desde el listado de dispositivos o detalles del dispositivo — seleccione dispositivos y abra elActions menú. Aparecen tres opciones relacionadas con scripts:
Ejecutar script guardado — elija un script de su biblioteca. Level crea una nueva automatización de ejecución de script con dos acciones: Esperar aprobación y Run script .
Run new script — escriba un nuevo script en el acto. El script se guarda en su biblioteca y se crea una automatización de ejecución de script para él.
Agregar a ejecución de script reciente — agregue 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 según un horario y evalúa su salida para determinar el estado del dispositivo. VerScript Monitors para detalles de configuración.
ℹ️ NOTA: Las automatizaciones de ejecución de script son reutilizables. Puede cambiarles el nombre, moverlas a un grupo, agregar más acciones o ajustar su disparador antes de aprobar. El script no se ejecutará hasta que el Esperar aprobación El paso se aprueba manualmente. Todas las ejecuciones de script se rastrean bajoAutomatizaciones → Ejecuciones de script in the sidebar.
Preguntas frecuentes
¿Cuál es la diferencia entre Ejecutar script guardado, Ejecutar nuevo script y Agregar a ejecución de script reciente? Los tres están en el Actions menú en el listado 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 para él. Run new script le permite escribir un nuevo script en el acto — se guarda en la biblioteca y se crea una automatización de ejecución de script. Agregar a ejecución de script reciente agrega 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 elEsperar aprobación La acción se aprueba.
¿Cuál es la diferencia entre un script guardado y una acción de Shell? Un script guardado vive en la biblioteca y es reutilizable — hágale referencia desde cualquier automatización, monitor o ejecución ad-hoc, y los cambios en un lugar actualizan todas las referencias. ElShell La acción ejecuta un script escrito en línea en la automatización, sin entrada de biblioteca. Use scripts guardados para cualquier cosa que ejecute más de una vez o que desee mantener a lo largo del tiempo.
¿Puedo editar un script sin romper las automatizaciones que lo usan? Sí. Los cambios a un script guardado surten efecto la próxima vez que se ejecuta cualquier automatización de referencia — no es necesario actualizar la automatización en sí. ElAutomatizaciones vinculadas La pestaña muestra exactamente qué automatizaciones se verán afectadas.
¿Qué idiomas admite Level? Ansible, Bash, Go, osquery, PowerShell, Python y Zsh.
¿Puede un script pasar salida a acciones de automatización posteriores? Sí — dos formas. Defina variables de script en la Variables pestaña y asígnelas a variables de automatización en el Run Script panel de acción. O utilizar Asignar salida de acción a una variable en Opciones adicionales para capturar la salida estándar completa del script. VerAcción Ejecutar script para más detalles.
¿Quién puede crear y editar scripts? Técnicos con permiso para editar automatizaciones en el grupo relevante. VerEspacio 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. Use el Automatizaciones vinculadas y Linked monitors pestañas para ver qué necesita ser desvinculado primero.