Índice:
Descripción
Cuando se ejecuta un script que incluye variables de script (es decir, formularios de script dinámicos), el agente NinjaOne las añade como variables de entorno solo durante el tiempo que dura la ejecución del script. Si el sistema ya tiene una variable de entorno existente que se envía desde el script, este falla y envía un registro de actividad en el que se aclara qué script ha fallado y por qué.
Los scripts también envían un registro de actividad con los cambios realizados en una variable de script a la pestaña Actividades del panel de control del sistema, así como al panel de control del dispositivo, lo que puede ayudar a los usuarios a identificar y planificar las necesidades de depuración o resolución de problemas.
- Las variables de script añadidas se pueden ver en su propia área dentro del script, en la parte derecha, y se pueden editar o eliminar.
- La lista de variables se puede reordenar por importancia o prioridad.
- Se pueden añadir un máximo de 20 variables a un solo script.
- No se pueden utilizar los siguientes caracteres especiales:
&|;$><`!
También exponemos las siguientes variables de entorno que se pueden utilizar para todo tipo de scripts (Windows, Mac y Linux):
NINJA_EXECUTING_PATH - Ubicación de instalación
NINJA_AGENT_VERSION_INSTALLED - Versión del agente
NINJA_PATCHER_VERSION_INSTALLED - Versión del parche
NINJA_DATA_PATH - Carpeta de datos del agente (scripts, políticas, descargas, registros)
NINJA_AGENT_PASSWORD: contraseña del agente para obtener la clave de sesión
NINJA_AGENT_MACHINE_ID: ID de la máquina utilizada en el servidor
NINJA_AGENT_NODE_ID: ID del nodo utilizado en el servidor.
NINJA_ORGANIZATION_NAME: nombre de la organización utilizado en el servidor.
NINJA_ORGANIZATION_ID: ID de la organización utilizado en el servidor.
NINJA_COMPANY_NAME: el nombre de la empresa utilizado en el servidor.
NINJA_LOCATION_ID: el ID de la ubicación utilizado en el servidor.
NINJA_LOCATION_NAME: el nombre de la ubicación utilizado en el servidor
Creación de variables de script:
Puede añadir nuevas variables de script desde el campo Variables de script situado en la parte derecha del editor de scripts.
- Haga clic en Añadir y seleccione una opción de la lista desplegable. Para obtener una descripción de cada variable, consulte Tipos de variables de script.
La página de configuración de variables se muestra en una ventana emergente. - Introduzca un nombre para la variable; este nombre se convertirá automáticamente en un nombre compatible con scripts para su uso dentro del script, que será visible encima del campo de entrada. Utilice la tabla siguiente para completar el resto de los campos según corresponda.
Campo Descripción Se utiliza para la variable Descripción Campo opcional que establece una descripción de la variable que está añadiendo. Será visible al ejecutar un script en forma de icono informativo (i) sobre la variable, lo que puede ayudar a los usuarios al proporcionarles más información o consejos útiles. Todos Obligatorio Valor opcional que, cuando se activa la casilla de verificación, hace que la variable sea obligatoria cuando se ejecuta el script. Esto significa que el formulario generado por el script exige que se rellene el valor, de lo contrario el script no se ejecutará. Todos excepto CheckBox Establecer valor predeterminado Valor opcional que utiliza contenido predefinido cuando se ejecuta el script. Todos Valor de la opción Valor obligatorio que permite a los usuarios seleccionar opciones de una lista. Cada valor introducido proporciona una opción independiente. Desplegable Opción superior Establecer valor predeterminado Cuando se introducen varios valores para el valor de la opción, este valor establece el superior como predeterminado. Los valores de las opciones se pueden arrastrar y soltar para cambiar el valor predeterminado. Desplegable - Haga clic en Añadir.
Una vez añadidas las variables del script, puede editarlas o eliminarlas utilizando los iconos situados a la derecha del nombre de la variable o arrastrándolas y soltándolas para cambiar el orden. Coloque el puntero del ratón sobre la variable para ver el icono de edición.
Añadir variables a un script:
Los técnicos de NinjaOne pueden añadir las variables de script que han creado al editor de scripts haciendo clic en un espacio vacío del editor de scripts y pulsando CTRL + Espacio en el teclado. El selector de variables de script se muestra como una pequeña ventana emergente; pase el puntero del ratón por encima de las variables para ver una descripción.
Los campos personalizados también se muestran en este selector de variables de script.
Una vez seleccionada la variable en el menú CTRL+Espacio, la variable inserta el código en el editor de scripts específico para el lenguaje seleccionado en la parte derecha del editor de scripts.
