Tema
En este artículo se explica cómo utilizar las variables de entorno al ejecutar scripts en NinjaOne.
Entorno
Gestión de endpoints de NinjaOne
Descripción
Cuando se ejecuta un script que incluye variables, el agente de NinjaOne las añade como variables de entorno solo durante el tiempo que dura la ejecución del script. Si NinjaOne ya tiene una variable de entorno existente del script, el script 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 una entrada de registro de actividad para los cambios realizados en una variable. Esta información puede ayudar a los usuarios a identificar y planificar las necesidades de depuración o resolución de problemas.
Selecciona una categoría para obtener más información:
- Variables de entorno
- Crear variables de script
- Editar o eliminar variables creadas
- Añadir variables a un script
- Recursos adicionales
Variables de entorno
También ponemos a su disposición las siguientes variables de entorno que puede utilizar para todo tipo de scripts (Windows, macOS 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 parcheador
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 máquina utilizado en el servidor
NINJA_AGENT_NODE_ID: ID de nodo utilizado en el servidor.
NINJA_ORGANIZATION_NAME: nombre de la organización utilizado en el servidor.
NINJA_ORGANIZATION_ID: el 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 servidorWindows tiene una variable adicional, NINJARMMCLI, con el siguiente valor:
C:ProgramDataNinjaRMMAgentninjarmm-cli.exeLa frase C:ProgramData al principio de esta ruta es igual a los siguientes valores de variables de entorno nativas:
$env:ALLUSERSPROFILE$env:ProgramData
Crear variables de script
Puede añadir nuevas variables de script desde el campo Variables de script en el editor de scripts. Consulte NinjaOne Endpoint Management: Introducción a los scripts de automatización para obtener más información.
&|;$><`!.Para añadir una variable de script, siga estos pasos:
- Cree un nuevo script o abra una plantilla de la biblioteca de automatización de NinjaOne.
- Haga clic en Añadir en la sección Variables de script y seleccione una opción del menú desplegable. Puede añadir un máximo de 20 variables a un solo script. Para obtener una descripción de cada variable, consulte NinjaOne Endpoint Management: Tipos de variables de script de automatización.
- Se abrirá el cuadro de diálogo «Añadir variable» y mostrará las opciones de configuración relevantes para el tipo de variable que haya seleccionado. Consulte la tabla siguiente para obtener una explicación de cada campo de configuración y los tipos de variables a los que se aplica.
| Campo | Descripción | Tipos de variables relevantes |
|---|---|---|
| Hacer que la variable sea obligatoria | Active el conmutador para que la variable sea un requisito cuando se ejecute el script. Si se activa, el formulario generado por el script no se ejecutará si este valor no está presente. | Todos excepto Casilla de verificación |
| Nombre | Asigna a tu variable un nombre descriptivo. | Todos |
| Nombre calculado | NinjaOne rellenará automáticamente un nombre de variable en este campo. | Todo |
| Descripción | Este campo opcional establece una descripción de la variable. Al ejecutar un script, NinjaOne muestra la descripción como un icono de información (i) sobre la variable, que proporciona más información o consejos útiles. | Todo |
| Establecer valor predeterminado | Este valor opcional utiliza contenido predefinido al ejecutar el script. El formato de este campo variará en función del tipo de variable seleccionado. | Todo |
| Valor de la opción | Este valor obligatorio permite a los usuarios seleccionar opciones de una lista. Cada valor introducido proporciona una opción independiente. | Menú desplegable |
Editar o eliminar variables creadas
Puede editar o eliminar variables de script según sea necesario. Mueva el cursor del ratón sobre el nombre de la variable y, a continuación, haga clic en el icono Editar, o haga clic en la X para eliminarla. También puede cambiar el orden de las variables arrastrándolas hacia arriba o hacia abajo en la pila.
Añadir variables a un script
En el editor de scripts, haz clic en el panel de edición y, a continuación, pulsa CTRL + Espacio. El selector de variables de script se muestra como un menú contextual. Coloca el cursor sobre la variable para ver una descripción. Los campos personalizados también se muestran en este selector de variables de script.
Una vez seleccionada la variable, NinjaOne la inserta en el código del editor de scripts, con el formato correspondiente al lenguaje que seleccionaste al añadir la variable.
Recursos adicionales
Consulte NinjaOne Endpoint Management: Scripting, automatización y CLI para obtener más información sobre la biblioteca de automatización de NinjaOne.