Microsoft Windows: script para la instalación mediante GPO

Esta guía ofrece un procedimiento paso a paso para implementar el Agent de escritorio y Agent de servidor en entornos Microsoft Windows mediante un objeto de política de grupo (GPO) con un script de inicio. Este método permite una instalación centralizada, automatizada y silenciosa en múltiples dispositivos dentro de un entorno de dominio.

Antes de empezar, asegúrate de:

• Se puede acceder al paquete de instalación (.exe) a través de un recurso compartido de red (ruta UNC)
• Entorno de dominio con Active Directory configurado
• Privilegios administrativos para crear y editar objetos de política de grupo (GPO)
• Los equipos de destino están unidos al dominio

1. Coloca el instalador en una carpeta compartida: \\servidor\GPO\DesktopAgent.exe
2. Asegúrese de:
   • Permiso de lectura para los equipos del dominio
   • Se puede acceder a la ruta de red desde los equipos de destino

Para garantizar que el proceso Agent Desktop Agent se adapte correctamente al entorno del cliente, se recomienda revisar y personalizar los siguientes ajustes antes de implementar el script en el entorno de producción.

Opción 1: ruta del paquete de instalación

Variable: networkPackagePath

Esta configuración define la ubicación en la que se encuentra el Agent de Desktop Agent . Se recomienda actualizar este valor con la ruta correcta del paquete de instalación facilitado por el cliente, asegurándose de que se pueda acceder al archivo durante la ejecución del script.

Opción 3: versión de instalación prevista

Variable: expectedInstallerValue=4.7.1

Esta configuración especifica la Agent de Desktop Agent que el script validará e instalará. Se recomienda actualizar este valor para que coincida exactamente con la versión del instalador que se va a implementar, tal y como se indica en la página de descargas o en la documentación de la versión.

CIQ > Menú> Configuración> Agent

Opción 5: Configuración de SRA

Variable: SRA_INSTALADO

Esta configuración indica si el paquete de instalación incluye el componente de acceso remoto (SRA). Se recomienda configurar:

• SIM cuando el paquete incluye el módulo de acceso remoto.
• NAO cuando el entorno no utiliza esta función.

Una configuración incorrecta de esta opción puede provocar errores de validación innecesarios durante el proceso de instalación.

Opción 7: Configuración del registro de red

Variables: logSharePath y logFileNetwork

Estos ajustes definen el recurso compartido de red que se utiliza para almacenar de forma centralizada los registros de instalación. Se recomienda actualizar la ruta a un recurso compartido de red válido dentro del entorno del cliente y asegurarse de que los equipos de destino dispongan de los permisos de lectura y escritura adecuados.

Nota

No se deben modificar los demás ajustes del script, salvo que el equipo de implementación lo indique expresamente. Los cambios en los parámetros internos pueden afectar al correcto funcionamiento, la validación y la instalación del Desktop Agent.

• Debe ser una ruta de red (UNC), no una ruta local
• Los equipos de destino deben tener permiso de lectura
• El archivo debe estar disponible durante el arranque del sistema (ejecución de GPO)

• Comprueba si el agent ya agent instalado
• Lee la versión instalada del Registro de Windows
• Se compara con la versión prevista
• Si son diferentes o faltan → se instalan
• Si es igual → se omite la instalación

Esto evita reinstalaciones innecesarias y garantiza el control de las versiones en todo el entorno.

Ruta local predeterminada: C:\Automatoslog\AgentAlmaden_GPO_Install.log

Ruta de red: Variable «logSharePath»

Nueva instalación

Actualización

La misma versión