Tema
Este artículo describe cómo dar los primeros pasos con la programación de scripts para automatizaciones en la Biblioteca de automatizaciones de NinjaOne.
Entorno
NinjaOne Gestión de endpoints
Descripción
NinjaOne proporciona varios scripts nativos listos para usar, pero también puedes crear y editar scripts personalizados o instalar y ejecutar automatizaciones de aplicaciones. Cuando ejecutes scripts personalizados en los dispositivos, NinjaOne te pedirá que especifiques parámetros opcionales y que indiques si deseas ejecutar los scripts como «Sistema», «Usuario actual» o con credenciales de tu almacén de credenciales.
Ver tutoriales adicionales en nuestra biblioteca de vídeos.
Selecciona un tema para aprender más:
- Consideraciones sobre la programación
- Añadir nuevos scripts
- Importar nuevos scripts
- Ordenar y filtrar scripts de automatización en la biblioteca de automatizaciones
- Editar, copiar o eliminar scripts o aplicaciones existentes
- Automatizaciones en revisión
- Biblioteca de plantillas
- Recursos adicionales
Consideraciones sobre la programación de scripts
Ten en cuenta lo siguiente al planificar tus scripts:
- El agente de NinjaOne no ofrece asistencia técnica para la resolución de problemas relacionados con scripts de reinicio personalizados. Para iniciar un reinicio, recomendamos utilizar el script de reinicio nativo de NinjaOne para garantizar que el agente pueda gestionar la acción correctamente.
- Las automatizaciones marcadas como «Todo» en el parámetro «Arquitectura» se ejecutan en función de la arquitectura nativa del dispositivo (32 bits o 64-bits).
- No se pueden utilizar los siguientes caracteres especiales en los parámetros:
&|;$><`!. - Puede asignar scripts a una categoría (o a varias categorías) para organizar mejor la Biblioteca de automatizaciones. Para crear nuevas categorías o editar o eliminar categorías existentes, haga clic en la pestaña «Categorías» en «Administración» → «Biblioteca » → «Automatización».
- NinjaOne solo acepta parámetros con valores de cadena. Estos incluyen cadenas, números enteros decimales y opciones de casillas de verificación.
Lenguajes de script compatibles
NinjaOne admite los siguientes lenguajes de script:
- JavaScript
- Powershell
- Batch
- ShellScript
- VBS Script
Aplicaciones automatizadas
Los administradores pueden configurar scripts para ejecutar o instalar una aplicación. Las opciones de automatización «Ejecutar» e «Instalar» te permiten crear una biblioteca de scripts de aplicaciones instaladas y en ejecución para añadirlos a una política o a una tarea programada, o bien ejecutarlos bajo demanda. Por ejemplo, si ejecutas CCleaner en los terminales, puedes utilizar NinjaOne para invocarlo.
Una vez instalada una aplicación en la Biblioteca de automatizaciones, puede utilizarla varias veces en diferentes organizaciones y dispositivos. Consulte «NinjaOne Gestión de endpoints: Automatizaciones para ejecutar o instalar aplicaciones» para obtener más información.
Añadir nuevos scripts
Para añadir nuevos scripts, sigue estos pasos:
Configurar los parámetros de la programación
- Vaya a Administración → Biblioteca → Automatización y, a continuación, haga clic en Añadir automatización → Nuevo script.
- Se abrirá la página «Crear script ». Configura los siguientes parámetros según los requisitos del lenguaje de cada script:
| Parámetros | Descripción |
|---|---|
| Nombre | Asigna a tu script un nombre descriptivo. |
| Descripción | Añade una descripción opcional que explique la función del script. |
| Categorías | Elige las categorías de la Biblioteca de automatizaciones en las que quieres que se incluya tu script. Puedes seleccionar una o varias categorías. |
| Idioma | Selecciona el idioma en el que vas a escribir tu script. El formato de los comandos cambiará automáticamente en función del idioma seleccionado. |
| Sistema operativo | Selecciona el sistema operativo adecuado para tu script. Esta opción aparecerá desactivada hasta que selecciones un idioma. |
| Arquitectura | Selecciona una arquitectura de 32 bits o de 64-bits. |
| Ejecutar como | Especifica la función bajo la cual se ejecutará el script. Estas opciones variarán en función del Sistema operativo que selecciones. |
| Variables del script | Haz clic en «Añadir» para seleccionar variables de script en el menú desplegable. Para obtener más información sobre las variables de script, consulta NinjaOne Gestión de endpoints: Uso de variables en scripts de automatización. |
| Parámetros | Define los parámetros que tomarán los argumentos de las llamadas como valores de parámetro. Para obtener más información sobre los parámetros, consulta NinjaOne Gestión de endpoints: Parámetros de automatización. |
Escribe y implementa tu script
Introduzca el script en el panel de edición. Si desea que su script interactúe con datos de campos personalizados, pulse Ctrl+Espacio. Escriba «Get» o «Set» para acceder a fragmentos de código, que son elementos básicos que puede utilizar para leer o escribir en scripts personalizados específicos. Para obtener más información, consulte «Lectura o escritura en campos personalizados en scripts». Cuando haya terminado, haga clic en «Guardar» para guardar su script.
El script ya está disponible para su uso en la automatización programada como una tarea programada o como una ejecución manual. Para obtener más información, consulta los siguientes recursos:
- Políticas de NinjaOne: Automatizaciones programadas
- Gestión de endpoints de NinjaOne: Tareas programadas
- Gestión de endpoints de NinjaOne: Ejecución de scripts de automatización y aplicaciones a pedido
Importar nuevos scripts
Para importar nuevos scripts o archivos a NinjaOne, sigue estos pasos:
- Vaya a Administración → Biblioteca → Automatización y, a continuación, haga clic en Añadir automatización → Importar desde el archivo o Importar desde la plantilla.
- Selecciona el archivo del script que deseas importar. Si eliges importar desde una plantilla, NinjaOne te redirigirá a la pestaña «Biblioteca de plantillas», donde podrás seleccionar uno de los scripts nativos que ofrece NinjaOne. Para obtener más información sobre los scripts que se encuentran en la Biblioteca de plantillas, consulta NinjaOne Gestión de endpoints: Scripts de automatización nativos.
Ordenar y filtrar scripts de automatización en la Biblioteca de automatizaciones
Puede modificar los parámetros de ordenación en la configuración de la tabla de la Biblioteca de automatizaciones siguiendo estos pasos:
- En la Biblioteca de automatizaciones, haz clic en el icono de engranaje.
- Selecciona tus criterios de ordenación. Puedes ordenar, agregar, eliminar y reordenar la visualización de las columnas. Para reordenar las columnas que se muestran en la página, haz clic y mantén pulsado el nombre de la columna y, a continuación, arrástrala hacia arriba o hacia abajo. Cuando hayas terminado, haz clic en «Guardar».
Editar, copiar o eliminar scripts o aplicaciones existentes
Al trabajar con scripts existentes, tenga en cuenta las siguientes consideraciones:
- Solo puedes modificar, copiar o eliminar scripts y aplicaciones personalizados.
- No puedes eliminar los scripts nativos de NinjaOne, pero sí puedes editar sus categorías.
- Puede eliminar o editar aplicaciones de «Ejecutar » e «Instalar», pero no puede copiarlas.
- Solo puedes eliminar o ver los instaladores heredados.
Procedimiento
Vaya a «Administración» → «Biblioteca» → «Automatización» y sitúe el cursor sobre un script o una aplicación. Haga clic en el icono de los tres puntos para ver las opciones del menú.
- Haz clic en «Editar» para abrir el editor de scripts y realizar cambios. Haz clic en «Guardar» para finalizar el nuevo script.
- Haz clic en «Eliminar» para eliminar el script o la aplicación de tu biblioteca. Si eliminas una categoría, NinjaOne la etiquetará como «Sin categorizar».
- Selecciona «Copiar» para crear un nuevo script idéntico al original. NinjaOne te pedirá que le pongas un nombre al nuevo script. Cuando hayas terminado, haz clic en «Guardar».
Automatizaciones en revisión
Cuando añadas una aplicación de instalación a la biblioteca de automatizaciones, aparecerá en la pestaña «En revisión » antes de pasar a la pestaña «Automatizaciones ».
Mientras las automatizaciones están en revisión, NinjaOne valida los archivos principales y de ayuda para garantizar que no contengan malware, virus ni problemas con la URL del instalador que puedan provocar errores en la aplicación.
Biblioteca de plantillas
La biblioteca de plantillas es una colección de scripts escritos por el equipo interno de desarrollo de scripts de NinjaOne, recopilados a partir de las solicitudes más habituales de la Comunidad NinjaOne. NinjaOne proporciona estos scripts «tal cual», y es tu responsabilidad probarlos y evaluarlos antes de su implementación.
Para obtener más información sobre los scripts incluidos en la biblioteca de plantillas, consulta NinjaOne Gestión de endpoints: Scripts de automatización nativos.
Recursos adicionales
Para consultar una lista de preguntas frecuentes sobre la Biblioteca de automatizaciones, consulta «Biblioteca de automatizaciones: FAQ».
Consulta «Programación, automatización, CLI: Catálogo de recursos » para aprender más sobre la automatización en NinjaOne.