Microsoft Windows – Script para instalação via GPO

Este guia fornece um procedimento passo a passo para implantar o Desktop Agent e Agent Server Agent em ambientes Microsoft Windows utilizando Objetos de Política de Grupo (GPO) com um script de inicialização. Esse método permite a instalação centralizada, automatizada e silenciosa em vários dispositivos em um ambiente de domínio.

Antes de começar, certifique-se de que:

• O pacote de instalação (.exe) está disponível através de um compartilhamento de rede (caminho UNC)
• Ambiente de domínio com o Active Directory configurado
• Privilégios administrativos para criar e editar GPOs
• Os computadores de destino estão associados ao domínio

1. Coloque o instalador em uma pasta compartilhada: \\servidor\GPO\DesktopAgent.exe
2. Certifique-se de:
   • Permissão de leitura para computadores do domínio
   • O caminho de rede está acessível a partir das máquinas de destino

Para garantir que o processo Agent Desktop Agent seja devidamente adaptado ao ambiente do cliente, recomenda-se revisar e personalizar as seguintes configurações antes de implementar o script em produção.

Opção 1 – Caminho do pacote de instalação

Variável: networkPackagePath

Esta configuração define o local onde o Agent Desktop Agent está armazenado. Recomenda-se atualizar este valor com o caminho correto do pacote de instalação fornecido pelo cliente, garantindo que o arquivo esteja acessível durante a execução do script.

Opção 3 – Versão de instalação prevista

Variável: expectedInstallerValue=4.7.1

Esta configuração especifica a Agent do Desktop Agent que será validada e instalada pelo script. Recomenda-se atualizar este valor para que ele corresponda exatamente à versão do instalador que está sendo implantado, conforme indicado na página de download ou na documentação da versão.

CIQ > Menu > Configurações > Agent

Opção 5 – Configuração do SRA

Variável: SRA_INSTALADO

Esta configuração indica se o pacote de instalação inclui o componente de Acesso Remoto (SRA). Recomenda-se configurar:

• SIM quando o pacote inclui o módulo de Acesso Remoto.
• NAO quando o ambiente não utiliza esse recurso.

Uma configuração incorreta desta opção pode causar erros de validação desnecessários durante o processo de instalação.

Opção 7 – Configuração do registro de rede

Variáveis: logSharePath e logFileNetwork

Essas configurações definem o compartilhamento de rede usado para armazenar centralmente os registros de instalação. Recomenda-se atualizar o caminho para um compartilhamento de rede válido no ambiente do cliente e garantir que os computadores de destino tenham as permissões de leitura e gravação adequadas.

Observação

As demais configurações do script não devem ser alteradas, a menos que haja instruções específicas da equipe de implantação. Alterações nos parâmetros internos podem afetar a execução, a validação e a instalação corretas do Desktop Agent.

• Deve ser um caminho de rede (UNC), não um caminho local
• Os computadores de destino devem ter permissão de leitura
• O arquivo deve estar acessível durante a inicialização do sistema (execução do GPO)

• Verifica se o agent já agent instalado
• Lê a versão instalada no Registro do Windows
• Compara com a versão esperada
• Se forem diferentes ou estiverem faltando → instale
• Se for igual → ignora a instalação

Isso evita reinstalações desnecessárias e garante o controle de versões em todo o ambiente.

Caminho local padrão: C:\Automatoslog\AgentAlmaden_GPO_Install.log

Caminho de rede: Variável “logSharePath”

Nova instalação

Atualização

A mesma versão