Guía del producto

Scripts

Cree, dirija y ejecute secuencias de comandos en endpoints gestionados y lea el resultado de cada endpoint.

Qué son los scripts#

Los scripts son secuencias de comandos reutilizables que se ejecutan en endpoints gestionados. Son la contraparte bajo demanda de las automatizaciones: la misma capacidad de ejecución, activada por una persona en lugar de un evento.

¿Necesita un punto de partida? Copie un script probado de la biblioteca de scripts.

Como un script puede cambiar un dispositivo, la plataforma lo trata como una operación sensible: necesita un destino explícito, una confirmación explícita y se registra por endpoint.

Pantalla de la biblioteca de scripts — Biblioteca de scripts reutilizables con grupos, idiomas y filtros de SO.

Creación de un script#

Una definición de script tiene cinco partes. Complételas para que el siguiente operador no tenga que leer el cuerpo para entender la intención:

Campo	Qué controla
Nombre y descripción	Identifica el script en la biblioteca y explica qué hace al siguiente operador.
Sistema operativo de destino	Los scripts se escriben para un shell específico, por lo que el sistema operativo decide qué intérprete los ejecuta.
Cuerpo del script	La secuencia de comandos que el agente ejecuta en el endpoint.
Alcance de destino	Grupos, perfiles, etiquetas o endpoints individuales en los que el script puede ejecutarse.
Ejecutar como	Si el script se ejecuta con privilegios de sistema o como el usuario actual del sistema operativo.

Escriba para el shell de destino

Un script escrito para un shell de Windows no se ejecutará correctamente en un endpoint Linux. Establezca el sistema operativo de destino para que el script solo se ofrezca donde pueda funcionar.

Ejecución de un script#

1
Seleccione el script
Abra el script desde la biblioteca y revise su cuerpo y sistema operativo de destino antes de ejecutarlo.
2
Elija el destino
Seleccione grupos, perfiles, etiquetas o endpoints individuales. Cuando el script sea nuevo, ejecútelo primero en un solo endpoint.
3
Confirme la acción
Ejecutar un script es una operación sensible, por lo que requiere una confirmación explícita. Revise la lista de endpoints resueltos en el paso de confirmación.
4
Revise la salida
Cada endpoint devuelve su propio estado de salida y salida. Lea los fallos individualmente; una ejecución parcialmente exitosa es el caso común.

Haga un piloto en un endpoint

Ejecute primero un script nuevo o modificado en un solo endpoint. La ejecución masiva convierte un error en un incidente, y un error de script es mucho más barato de encontrar en un solo dispositivo.

Resultados y registro#

Cada endpoint reporta su propio estado de salida y salida; los resultados no se fusionan en un solo resumen.
Una ejecución parcialmente exitosa es normal cuando los endpoints difieren, por lo que los fallos deben leerse individualmente.
La ejecución se atribuye al operador que la inició.
La ejecución de scripts se registra en el registro de actividad y en el registro de auditoría.

Preguntas frecuentes#

¿En qué se diferencia un script de una automatización?

Un script es una secuencia de comandos que un operador ejecuta bajo demanda. Una automatización ejecuta un pipeline en respuesta a un desencadenador. Use un script para tareas puntuales y una automatización para cualquier cosa repetible.

¿Se registran las ejecuciones de scripts?

Sí. Se registran la ejecución, sus endpoints de destino, el operador y el resultado de cada endpoint. La ejecución de scripts también se escribe en el registro de auditoría.

¿Qué ocurre si un endpoint está fuera de línea?

La ejecución se encola para ese endpoint y se ejecuta cuando se reconecta, a menos que la ejecución tenga un límite de tiempo. Revise la última vez visto si un resultado nunca llega.

¿Puedo restringir qué scripts puede ejecutar un operador?

Sí. Los permisos deciden quién puede crear y ejecutar scripts, y el alcance de destino limita a qué endpoints puede llegar un script.