Introducción
La biblioteca de scripts es donde puede crear, organizar y mantener 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 todos los lugares donde se hace referencia a él.
Scripts
Vaya 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 su biblioteca, en todos los grupos
Nuevo script — abre el cuadro de diálogo Crear script
Scripts sin grupo — scripts que aún no han sido asignados a un grupo
Debajo de esos, la sección Grupos de scripts enumera los grupos personalizados que ha creado. Seleccione un grupo para filtrar la tabla solo a los scripts de 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), y Creado. Haga clic en el nombre de cualquier script para abrirlo en el editor.
Crear un script
Haga clic en + Crear script en la parte superior derecha, o Nuevo script en la barra lateral. Aparece un cuadro de diálogo que solicita un nombre.
Ingrese un nombre y haga clic en Crear. El editor de scripts se abre de inmediato.
💡 CONSEJO: Nombre los scripts de forma específica — «Deshabilitar cuenta de invitado - Windows» es más fácil de encontrar y reutilizar que «Script de cuenta de invitado». Siempre puede cambiar el nombre más adelante.
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 que se muestra en la biblioteca y en el selector de acciones Ejecutar script.
Descripción — opcional. Se muestra en el listado de scripts. Vale la pena completarlo para bibliotecas compartidas.
Lenguaje — el lenguaje de scripting. Opciones compatibles:
Ansible
Bash
Go
osquery
PowerShell
Python
Zsh
Tiempo de espera (en segundos) — el tiempo que Level espera para que el script se complete antes de marcar la ejecución como fallida. 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 — úselo para operaciones en contexto de usuario, como aplicar fondo de pantalla o configurar 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 variable, variable del sistema o referencia de campo personalizado en línea.
Haga clic en Guardar script para guardar. Los cambios no surten efecto hasta que se guardan.
⚠️ ADVERTENCIA: Los cambios no guardados se pierden si navega fuera de la página. Guarde antes de salir del editor.
Variables
La pestaña Variables muestra todas las variables de script declaradas para este script. Las variables de script son ranuras de salida con nombre — el script escribe un valor en ellas durante la ejecución, y puede asignar ese valor a una variable de automatización en el panel de la acción Ejecutar script del panel de acciones para pasarlo por la canalización.
Haga clic en + Agregar nueva variable para definir una nueva variable. Una vez definidas, las variables aparecen en el selector Variables de script de cualquier acción Ejecutar script que hace referencia a este script.
ℹ️ NOTA: Las variables de script capturan la salida de un script. Para pasar datos hacia un script — contexto del dispositivo, valores de campos personalizados, información del sistema — use 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 asignar variables de script a variables de automatización y usarlas en acciones posteriores, consulte Acción Ejecutar script, Variables de automatización, y Variables del sistema.
Automatizaciones vinculadas
La pestaña Automatizaciones vinculadas muestra todas las automatizaciones que hacen referencia a este script mediante una acción Ejecutar script acción. Haga clic en el nombre de cualquier automatización para abrirla.
ℹ️ NOTA: Un script no puede eliminarse mientras tenga automatizaciones vinculadas. Deberá eliminar el script de cada automatización que lo referencia, o eliminar esas automatizaciones. La pestaña facilita ver exactamente qué se vería afectado.
Monitores vinculados
La pestaña Monitores vinculados muestra todos los monitores de scripts que utilizan este script. La misma regla de eliminación aplica: desvincule de todos los monitores antes de poder eliminar un script.
Organización con grupos de scripts
Los grupos de scripts le permiten categorizar los scripts por plataforma, función, equipo o lo que tenga sentido para su entorno. Los grupos aparecen en la barra lateral bajo Grupos de scripts y como columna en el listado de scripts.
Para crear un grupo, haga clic en el icono + junto a Grupos de scripts en la barra lateral. Aparece un cuadro de diálogo que solicita un nombre de grupo.
Para asignar un script a un grupo, abra el menú Acciones (parte superior derecha) y seleccione Asignar a grupo.
💡 CONSEJO: Los grupos de scripts generalmente reflejan el 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 menú Acciones y seleccione Eliminar. Aparece un cuadro de 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 — elimine todos los vínculos primero usando las pestañas Automatizaciones vinculadas y Monitores vinculados pestañas.
Ejecutar scripts
Los scripts se pueden ejecutar de varias maneras:
En una automatización — a través de la acción Ejecutar 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. Consulte Acción Ejecutar script para la referencia completa.
Ad hoc desde el listado de dispositivos o detalles del dispositivo — seleccione dispositivos y abra el menú Acciones Aparecen tres opciones relacionadas con scripts:
Ejecutar script guardado — seleccione un script de su biblioteca. Level crea una nueva automatización de ejecución de script con dos acciones: Esperar aprobación y Ejecutar script.
Ejecutar nuevo script — escriba un nuevo script en el momento. 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 scripts — un monitor ejecuta un script según un horario y evalúa su salida para determinar el estado del dispositivo. Consulte Monitores de scripts para obtener detalles de configuración.
ℹ️ NOTA: Las automatizaciones de ejecución de scripts son reutilizables. Puede cambiarles el nombre, moverlas a un grupo, agregar más acciones o ajustar su activador antes de aprobarlas. El script no se ejecutará hasta que el paso Esperar aprobación se aprueba manualmente. Todas las ejecuciones de scripts se registran en Automatizaciones → Ejecuciones de scripts en la barra lateral.
Preguntas frecuentes
¿Cuál es la diferencia entre Ejecutar script guardado, Ejecutar nuevo script y Agregar a ejecución de script reciente? Las tres opciones están en el menú Acciones en el listado de dispositivos y detalles del dispositivo. Ejecutar script guardado selecciona un script existente de la biblioteca y crea una nueva automatización de ejecución de script para él. Ejecutar nuevo script le permite escribir un nuevo script en el momento — 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 la acción Esperar aprobación se aprueba.
¿Cuál es la diferencia entre un script guardado y una acción Shell? Un script guardado vive en la biblioteca y es reutilizable — refiérase 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 directamente en la automatización, sin entrada en la biblioteca. Use scripts guardados para cualquier cosa que vaya a ejecutar más de una vez o que desee mantener con el tiempo.
¿Puedo editar un script sin romper las automatizaciones que lo usan? Sí. Los cambios en un script guardado surten efecto la próxima vez que se ejecute cualquier automatización que lo referencie — no es necesario actualizar la propia automatización. 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 su salida a acciones de automatización posteriores? Sí — de dos maneras. Defina variables de script en la pestaña Variables y asígnelas a variables de automatización en el panel de la acción Ejecutar script del panel de acciones. O use Asignar salida de acción a variable en las opciones adicionales de la acción para capturar la salida estándar completa del script. Consulte Acción Ejecutar script para obtener más detalles.
¿Quién puede crear y editar scripts? Técnicos con permiso para editar automatizaciones en el grupo correspondiente. Consulte Workspace → Permissions para la configuración de control de acceso.
¿Qué sucede con las automatizaciones si elimino un script? Level bloquea la eliminación de un script vinculado a automatizaciones o monitores activos. Use las pestañas Automatizaciones vinculadas y Monitores vinculados para ver qué debe desvincularse primero.