Tema
Este artículo describe cómo empezar a crear scripts para automatizaciones en la biblioteca de automatización de NinjaOne.
Entorno
NinjaOne Endpoint Management
Descripción
NinjaOne proporciona varios scripts nativos listos para usar, pero también puede crear y editar scripts personalizados o instalar y ejecutar automatizaciones de aplicaciones. Cuando ejecute scripts personalizados en dispositivos, NinjaOne le pedirá que especifique parámetros opcionales y que indique si desea ejecutar los scripts como Sistema, Usuario actual o con credenciales de su almacén de credenciales.
Consulte tutoriales adicionales en nuestra biblioteca de vídeos.
Seleccione un tema para obtener más información:
- Consideraciones sobre scripts
- Añadir nuevos scripts
- Importar nuevos scripts
- Ordenar y filtrar scripts de automatización en la biblioteca de automatización
- Editar, copiar o eliminar scripts o aplicaciones existentes
- Automatizaciones en revisión
- Biblioteca de plantillas
- Recursos adicionales
Consideraciones sobre la creación de scripts
Tenga en cuenta lo siguiente al planificar sus scripts:
- El agente de NinjaOne no ofrece soporte técnico para la resolución de problemas en 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 «All» para el parámetro «Architecture» se ejecutan en función de la arquitectura nativa del dispositivo (32 o 64 bits).
- No puede 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 de tipo 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ñadir a una política o tarea programada, o ejecutarlas bajo demanda. Por ejemplo, si ejecutas CCleaner en los endpoints, puedes usar NinjaOne para llamarlo.
Una vez que instale una aplicación en la biblioteca de automatización, podrá utilizarla varias veces en diferentes organizaciones y dispositivos. Consulte NinjaOne Endpoint Management: Automatizaciones para ejecutar o instalar aplicaciones para obtener más información.
Añadir nuevos scripts
Para añadir nuevos scripts, siga estos pasos:
Configurar los parámetros de scripting
- 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. Configure los siguientes parámetros según los requisitos de lenguaje de cada script:
| Parámetro | Descripción |
|---|---|
| Nombre | Asigne a su 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 automatización en las que quieres que se incluya tu script. Puedes seleccionar una o varias categorías. |
| Idioma | Seleccione el idioma en el que escribirá su script. El formato de los comandos cambiará automáticamente en función del idioma seleccionado. |
| Sistema operativo | Seleccione el sistema operativo adecuado para su script. Esta opción aparecerá desactivada hasta que seleccione un idioma. |
| Arquitectura | Selecciona una arquitectura de 32 bits o 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 de script | Haga clic en «Añadir» para elegir las variables de script en el menú desplegable. Para obtener más información sobre las variables de script, consulte NinjaOne Endpoint Management: Uso de variables en scripts de automatización. |
| Parámetros | Defina 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, consulte NinjaOne Endpoint Management: Parámetros de automatización. |
Escriba e implemente su 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 bloques de construcción 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 terminales de NinjaOne: Tareas programadas
- Gestión de terminales de NinjaOne: Ejecución de scripts de automatización y aplicaciones bajo demanda
Importar nuevos scripts
Para importar nuevos scripts o archivos a NinjaOne, siga estos pasos:
- Vaya a Administración → Biblioteca → Automatización y, a continuación, haga clic en Añadir automatización → Importar desde archivo o Importar desde plantilla.
- Seleccione el archivo del script que desea importar. Si elige importar desde una plantilla, NinjaOne le redirigirá a la pestaña Biblioteca de plantillas, donde podrá seleccionar uno de los scripts nativos que ofrece NinjaOne. Para obtener más información sobre los scripts alojados en la Biblioteca de plantillas, consulte NinjaOne Endpoint Management: Scripts de automatización nativos.
Ordenar y filtrar scripts de automatización en la Biblioteca de automatización
Puede cambiar los parámetros de ordenación en la configuración de la tabla de la Biblioteca de automatización siguiendo estos pasos:
- En la Biblioteca de automatización, haz clic en el icono de engranaje.
- Seleccione sus criterios de ordenación. Puede ordenar, añadir, eliminar y reordenar la visualización de las columnas. Para reordenar las columnas que se muestran en la página, haga clic y mantenga pulsado el nombre de la columna y, a continuación, arrástrela hacia arriba o hacia abajo. Cuando haya terminado, haga clic en Guardar.
Editar, copiar o eliminar scripts o aplicaciones existentes
Al trabajar con scripts existentes, tenga en cuenta las siguientes consideraciones:
- Solo puede modificar, copiar o eliminar scripts y aplicaciones personalizados.
- No puede eliminar los scripts nativos de NinjaOne, pero puede editar sus categorías.
- Puede eliminar o editar aplicaciones de ejecución e instalación, pero no puede copiarlas.
- Solo puede eliminar o ver instaladores heredados.
Procedimiento
Vaya a Administración → Biblioteca → Automatización y coloque 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.
- Seleccione Copiar para crear un nuevo script idéntico al original. NinjaOne le pedirá que asigne un nombre al nuevo script. Cuando haya terminado, haga 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 auxiliares para garantizar que no contengan malware, virus o 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 populares de la comunidad de NinjaOne. NinjaOne proporciona estos scripts «tal cual», y es su responsabilidad probarlos y evaluarlos antes de su implementación.
Para obtener más información sobre los scripts alojados en la biblioteca de plantillas, consulte NinjaOne Endpoint Management: Scripts de automatización nativos.
Recursos adicionales
Para obtener una lista de preguntas frecuentes sobre la biblioteca de automatización, consulta Biblioteca de automatización: Preguntas frecuentes.
Consulte Scripts, automatización, CLI: Catálogo de recursos para obtener más información sobre la automatización en NinjaOne.