Índice:
- ¿Qué son los parámetros?
- ¿Cómo puedo saber qué parámetros utilizar en los scripts nativos de instalación o ejecución de aplicaciones de NinjaOne?
- ¿Cómo puedo saber qué parámetros debo utilizar en mis scripts personalizados?
- ¿Cómo se ve esto en NinjaOne?
- Otro uso para los parámetros preestablecidos
- Documentación relacionada
¿Qué son los parámetros?
Los términos «parámetros» y «argumentos» suelen utilizarse indistintamente, pero son muy diferentes. Cuando llamas a una función, un script o un archivo ejecutable, utilizas argumentos. Cuando se define la función, se definen los parámetros que tomarán los argumentos de la llamada para los valores de los parámetros. En el ámbito de la construcción de scripts de automatización para NinjaOne estos términos se pueden utilizar indistintamente, por lo que NinjaOne utiliza el término «parámetros» en todo.
De forma predeterminada, los parámetros no son obligatorios en los scripts personalizados. Sin embargo, si su script personalizado está escrito para aceptar parámetros, tiene la opción de especificar cadenas de parámetros preestablecidas en el editor de script.
¿Cómo puedo saber qué parámetros utilizar en los scripts nativos de instalación o ejecución de aplicaciones de NinjaOne?
En el caso de los archivos .EXE, los parámetros son específicos de la aplicación. No hay un único conjunto de parámetros a utilizar.
En el caso de los archivos .MSI, haga clic aquí para ver una lista de posibles parámetros.
/quiet /qn /norestart /log {ruta a nuestra carpeta de scripts}ninjascript-output-{hora actual}.txt
NinjaOne solo acepta parámetros de valor de cadena.
¿Cómo puedo saber qué parámetros debo utilizar en mis scripts personalizados?
Cada lenguaje de scripting tiene su propio método de consumo de parámetros de script. Los parámetros deben tener el formato que establezcan los requisitos del lenguaje que utilice su script personalizado. Aquí hay algunos recursos sobre cómo funcionan los parámetros en los diferentes lenguajes de scripting que admite NinjaOne:
- Parámetros del lote
- Parámetros JS y VBScript (utilizamos CScript para ejecutar ambos, por lo que el formato de los parámetros será el mismo)
- Parámetros de PowerShell
- Parámetros de ShellScript
- Stack Overflow es otro recurso popular para los scripts personalizados
- No se pueden usar los siguientes caracteres especiales en los parámetros: &|;$><`!
- NinjaOne no puede transmitir varios valores para parámetros de Matriz. Por ejemplo, al agregar -param 1, 2 en el cuadro de texto de nuestros parámetros, solamente muestra «1» en vez de «1» «2».
- NinjaOne es actualmente incapaz de pasar valores booleanos a través de nuestros parámetros.
- NinjaOne solo acepta parámetros de valor de cadena.
También exponemos las siguientes variables de entorno que se pueden utilizar para todos los tipos 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 aplicador de parches.
NINJA_DATA_PATH -Carpeta de datos de agentes (scripts, política, descargas, registros).
NINJA_AGENT_PASSWORD -Contraseña de agente para obtener la clave de sesión.
NINJA_AGENT_MACHINE_ID -La ID de equipo utilizada en el servidor.
NINJA_AGENT_NODE_ID -La ID de nodo utilizada en el servidor.
NINJA_ORGANIZATION_NAME -El nombre de la organización utilizado en el servidor.
NINJA_ORGANIZATION_ID -La ID de la organización utilizada en el servidor.
NINJA_COMPANY_NAME -El nombre de la compañía utilizado en el servidor.
NINJA_LOCATION_ID -La ID de ubicación utilizada en el servidor.
NINJA_LOCATION_NAME -El nombre de la ubicación utilizado en el servidor.
¿Cómo se ven los parámetros preestablecidos en NinjaOne?
El siguiente es un ejemplo de paso de parámetros a un script por lotes que crea un nuevo usuario en un dispositivo.
En la situación anterior, estamos utilizando el siguiente script por lotes para crear un nuevo usuario:
usuario neto %1 %2
%1 y %2 son valores que consumirán parámetros (en este caso, un nombre de usuario y una contraseña para el nuevo usuario).
Hemos creado tres cadenas de parámetros preestablecidos:
Bob Password1Linda NewPasswordJoe Passw0rd
Al ejecutar el script, podemos especificar los parámetros sobre la marcha, o elegir de nuestra lista de cadenas de parámetros preestablecidos.
Los parámetros se pasan a los valores respectivos en el orden en que se introduzcan. Así, si elegimos los parámetros preestablecidos Bob Password1, Bob se convierte en el valor %1 en el script, y Password1 se convierte en el valor %2, lo que da lugar a un nuevo usuario con el nombre de usuario Bob y la contraseña Password1.
Cada vez que se crea un nuevo script en la Biblioteca de scripts de NinjaOne, se crea un nuevo archivo como «customscript1.bat». Por tanto, el comando se parece a esto con los parámetros:
customscript1.bat <SUS PARÁMETROS AQUÍ>
Otro uso para los parámetros preestablecidos:
Si no quiere introducir parámetros de hard text en su script, también puede llamar variables vacías dentro de su script e introducir sus valores en el campo para los parámetros de la derecha antes de ejecutar el script.
Aquí se muestra un ejemplo con un script que llama a tres variables y las muestra en la salida del script:
param(
[String]$variable1='',
[Cadena]$variable2='',
[Cadena]$variable3='')
Write-Host $variable1
Write-Host $variable2
Write-Host $variable3
variable1 toma el valor «5.1.1574», variable2 el valor «5», variable3 el valor «1»: 
«Peter Smith» Pa5sW0rd