¿Ya eres cliente de NinjaOne? Inicia sesión para ver más guías y las últimas actualizaciones.

Biblioteca de scripts: parámetros

  • Última actualización 23 de abril de 2026

Tema

Este artículo explica la finalidad de los parámetros y las variables de entorno al instalar o ejecutar scripts y automatizaciones en NinjaOne. 

Entorno

Automatización de NinjaOne

Descripción

Los términos «parámetros» y «argumentos» se utilizan a menudo indistintamente, pero son ligeramente diferentes. Cuando se invoca una función, un script o un archivo ejecutable, se utilizan argumentos. Al definir la función, se definen los parámetros que tomarán los argumentos de la invocación como valores de los parámetros. En el contexto de la creación de scripts de automatización para NinjaOne, NinjaOne utiliza el término «parámetros» en todo momento.

Los parámetros no son obligatorios por defecto 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 predefinidas en el editor de scripts.

NinjaOne utiliza variables de entorno para hacer referencia a los parámetros y simplificar la introducción de comandos. Puede obtener más información al respecto en nuestro artículo NinjaOne Endpoint Management: Uso de variables en scripts de automatización. 

Índice

Seleccione una categoría para obtener más información:

Consideraciones importantes

Ten en cuenta las siguientes notas antes de continuar:

  • No se pueden utilizar los siguientes caracteres especiales en los parámetros: &|;$><`!
  • NinjaOne no puede pasar varios valores para los parámetros de matriz. Por ejemplo, al añadir -param 1, 2 en nuestro cuadro de texto de parámetros, solo muestra 1 en lugar de 1 2.
  • Actualmente, NinjaOne no puede pasar valores booleanos a través de nuestros parámetros.
  • NinjaOne solo acepta parámetros de tipo cadena.

Cómo utilizar parámetros en un script

A continuación se muestra un ejemplo de cómo pasar parámetros a un script de PowerShell que cambia el nombre de un usuario local.

Figura 1: Añadir parámetros a un script

En la Figura 1, hemos creado tres cadenas de parámetros predefinidas:

  • Tonya
  • Tony
  • T.S.

Estos parámetros se corresponden con el atributo CmdletBinding resaltado en el script y sustituirán las variables de cadena en el orden introducido, de la siguiente manera:

  • $CurrentName: Tonya
  • $NewName: Tony
  • $NewDisplayName: T.S.

También puede establecer estos parámetros al ejecutar el script mediante una condición de directiva o una tarea programada. El mensaje le pedirá que añada valores para los parámetros.

scheduled task_run automation_parameters.png
Figura 2: Añadir parámetros a una automatización

Otro uso de los parámetros preestablecidos

Si no desea introducir parámetros de texto fijos en su script, también puede llamar a variables vacías dentro de su script e insertar sus valores en el campo de parámetros antes de ejecutar el script.

A continuación se muestra un ejemplo con un script que llama a tres variables y las muestra en la salida del script: 

param(
 [String]$variable1='',
 [String]$variable2='',
 [String]$variable3='')


Write-Host $variable1
Write-Host $variable2
Write-Host $variable3

Al ejecutar este script, introduce los valores que deseas que adopte cada variable en el orden en que se escribieron en el script. Utiliza un espacio entre cada variable. Si tienes valores que contienen espacios, debes añadir comillas para diferenciarlos de las demás variables.

Por ejemplo, si quiero añadir a Peter Smith como $Username y Pa5sW0rd como su $Password, debo escribirlo de la siguiente manera:

"Peter Smith" Pa5sW0rd
NinjaOne no ofrece actualmente soporte para scripts personalizados. Sin embargo, el tema «Script Share» de nuestros foros es un excelente recurso para compartir y solicitar scripts personalizados. Consulte «Community Scripting – NinjaOne Dojo» para obtener más información.

Preguntas frecuentes

¿Cómo sé qué parámetros debo utilizar en los scripts de instalación o ejecución de aplicaciones nativas de NinjaOne?

En el caso de los archivos EXE, los parámetros son específicos de cada aplicación. No hay un conjunto único de parámetros que se pueda utilizar.

Para los archivos MSI, consulta MSIEXEC - Instalador de Windows - CMD de Windows - SS64.com (enlace externo) para ver una lista de los parámetros posibles.

Para el script nativo de instalación de aplicaciones de NinjaOne, todos los archivos MSI se ejecutan utilizando los siguientes parámetros:

/quiet /qn /norestart /log {ruta a nuestra carpeta de scripts}ninjascript-output-{hora-actual}.txt 

¿Cómo sé qué parámetros debo utilizar en mis scripts personalizados?

Cada lenguaje de scripting tiene su propio método para utilizar los parámetros de script. Debe formatear los parámetros según los requisitos del lenguaje que utilice su script personalizado. A continuación, se incluyen algunos recursos externos sobre cómo funcionan los parámetros en los diferentes lenguajes de scripting compatibles con NinjaOne:

También ponemos a su disposición las siguientes variables de entorno que puede utilizar para todo tipo de scripts (Windows, Apple 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: el ID de máquina utilizado en el servidor
NINJA_AGENT_NODE_ID: el ID de nodo utilizado en el servidor.
NINJA_ORGANIZATION_NAME: el 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 servidor
Si cambia una variable y ejecuta un script para recuperar el nuevo valor, reinicie el destino si no ha cambiado. Al reiniciar el destino, se actualizarán las variables.

Recursos adicionales

Consulte NinjaOne Endpoint Management: Scripting, automatización y CLI para obtener más herramientas de la biblioteca de automatización.

FAQ

Próximos pasos