Configuração do arquivo instalador do Windows do Bot Agent
- Última atualização2025/09/02
Configuração do arquivo instalador do Windows do Bot Agent
O arquivo instalador do Windows do Bot Agent é um package de instalação (geralmente um arquivo .msi ou .exe) que pode ser usado para instalar o Bot Agent remotamente em vários dispositivos.
Configuração
Pré-requisito
Instale o Windows SDK que inclui Orca.exe para editar as propriedades públicas do arquivo AutomationAnywhereBotAgent.msi.
- O instalador não exibirá uma mensagem de validação se você informar um diretório virtual ou caminho do mecanismo secreto inválido.
- Para o parâmetro AA_INSTALL_ONLY, se você usar
False
, a tela de configuração será exibida em vez de prosseguir diretamente com a instalação como esperado.
Procedimento
- Edite o AutomationAnywhereBotAgent.msi.
- Clique em Propriedade para exibir as diferentes propriedades públicas.Consulte a tabela a seguir para entender para que serve cada propriedade pública:
Parâmetro Descrição AA_CRURL Insira os URLs da Control Room para conectar o Bot Agent. Nota: Certifique-se de não adicionar uma barra invertida (/) no final do URL da Control Room. Por exemplo,mycr.mydomain.com/
.Você pode configurar até 20 URLs da Control Room e suas chaves de registro correspondentes. Confira se:- Você fornece a chave de registro correta para a Control Room correspondente.
Deve haver uma combinação individual entre CR_URL e CR_TOKEN. Por exemplo: A chave de registro definida em AA_CRTOKEN é gerada para a Control Room onde o URL é definido em AA_CRURL. Da mesma forma, AA_CRTOKEN2 a AA_CRTOKEN20 devem corresponder a AA_CRURL2 a AA_CRURL20.
- Não pule um par CR_URL e CR_TOKEN no meio do caminho.
Os valores devem ser preenchidos consecutivamente nas propriedades do MSI. Por exemplo, para configurar três URLs da Control Room, as seguintes propriedades MSI devem ser preenchidas na ordem especificada:
AA_CRURL, AA_CRURL2, AA_CRURL3 seguidos por AA_CRTOKEN, AA_CRTOKEN2 e AA_CRTOKEN3.
AA_CRTOKEN Digite a chave de registro correspondente para cada Control Room escolhida. Para obter mais informações sobre como gerar ou usar uma chave de registro existente, consulte Gerar chave de registro da Control RoomNota: Você pode configurar até 20 URLs da Control Room. Confira se:- Você fornece a chave de registro correta para a Control Room correspondente.
Deve haver uma combinação individual entre CR_URL e CR_TOKEN. Por exemplo: A chave de registro definida em AA_CRTOKEN é gerada para a Control Room onde o URL é definido em AA_CRURL. Da mesma forma, AA_CRTOKEN2 a AA_CRTOKEN20 devem corresponder a AA_CRURL2 a AA_CRURL20.
- Não pule um par CR_URL e CR_TOKEN no meio do caminho.
Os valores devem ser preenchidos consecutivamente nas propriedades do MSI. Por exemplo, para configurar três URLs da Control Room, as seguintes propriedades MSI devem ser preenchidas na ordem especificada:
AA_CRURL, AA_CRURL2, AA_CRURL3 seguidos por AA_CRTOKEN, AA_CRTOKEN2 e AA_CRTOKEN3.
AA_DELAY_REGISTRATION_UNTIL_LOGIN Digite True
para atrasar o registro do Bot Agent para uma Control Room até que um usuário se conecte à Control Room.Se um usuário fizer login em qualquer uma das Control Rooms configuradas usando a propriedade AA_CRURL, do dispositivo onde o Bot Agent está instalado, o Bot Agent nesse dispositivo será automaticamente registrado com essa Control Room associada. Se o URL da Control Room conectada não estiver configurado, o Bot Agent não será registrado com essa Control Room.
AA_DEVICE_TYPE Insira um dos seguintes valores para o tipo de dispositivo: -
SINGLE_USER
-
MULTIPLE_USERS
Para obter mais informações, consulte Configurar o registro do dispositivo.
Nota: Certifique-se de inserir o valor da propriedade em maiúsculas.AA_LIFESPAN Insira um dos seguintes valores para um dispositivo temporário ou persistente: -
TEMPORÁRIO
-
PERSISTENTE
Para obter mais informações, consulte Configurar o registro do dispositivo.
Nota: Certifique-se de inserir o valor da propriedade em maiúsculas.AA_CONCURRENT_SESSIONS Insira as sessões simultâneas permitidas de 2 a 999. O valor padrão é 2
.Nota: O parâmetro AA_CONCURRENT_SESSIONS é aplicável somente a dispositivos de múltiplos usuários (AA_DEVICE_TYPE =MULTIPLE_USERS
)AA_INSTALL_ONLY Escolha se deseja instalar o Bot Agent com ou sem um registro na Control Room. Nota: Você pode definir AA_INSTALL_ONLY comoTrue
apenas para instalações em nível de sistema. O arquivo autoregistration.properties é criado quando AA_INSTALL_ONLY é configurado paraTrue
..- Insira
True
para apenas instalar o Bot Agent. - Insira
False
para instalar e registrar o Bot Agent com uma Control Room.
AA_DEVICE_POOL_NAME Forneça um nome para o pool de dispositivos. O valor padrão é 0
.Nota: Você deve utilizar um pool de dispositivos existente. - Você fornece a chave de registro correta para a Control Room correspondente.
- Salve as mudanças que você fizer no editor Orca.
Instalação
Instale o Bot Agent remotamente em vários dispositivos usando qualquer gerenciador de configuração de software de sua escolha, como o Microsoft Configuration Manager. Se sua organização usa o Microsoft Active Directory para gerenciamento de dispositivos, use a política de grupo do Microsoft Active Directory para instalar o Bot Agent de maneira remota em vários dispositivos. Consulte Use Microsoft Active Directory Group Policy to remotely install software.
Esta seção fornece as instruções para instalar o Bot Agent de maneira remota em vários dispositivos de um local central usando o Microsoft Configuration Manager:
- Certifique-se de que o Microsoft SCCM esteja instalado em duas máquinas:
- Primeiro em uma máquina que hospeda o site primário e o servidor de distribuição da Control Room.
- Em seguida, em uma segunda máquina que hospeda o servidor de banco de dados para armazenar e processar todas as comunicações e operações cliente-servidor.
- Certifique-se de que o AutomationAnywhereBotAgent.msi mais recente seja baixado e que as propriedades públicas sejam modificadas conforme suas necessidades.
Procedimento
- Configure o aplicativo do Bot Agent no SCCM.
- Adicione detalhes gerais, como o nome do aplicativo.
Por exemplo, Instalador de Windows Automation Anywhere Bot Agent (arquivo *msi).
- Adicione detalhes do conteúdo, como localização do conteúdo, configurações para desinstalação e opções de implantação.Por exemplo:
- Localização do conteúdo: \\crserver\msibackup\
- Configurações para a desinstalação do conteúdo: Igual a instalar conteúdo
- Opções de implantação: Baixe o conteúdo do ponto de distribuição e execução local
- Informe os comandos do programa necessários para instalar o aplicativo.
Por exemplo,
msiexec /i "AutomationAnywhereBotAgent.msi"/q
. - Informe o método de detecção da aplicativo para determinar se a aplicativo já está instalado em algum dispositivo.
O SSCM detecta e adiciona automaticamente a cláusula para o arquivo msi.
- Informe detalhes da experiência do usuário, como comportamento da instalação (instalar para o sistema ou usuário), exigência de logon, visibilidade da instalação (interativa ou oculta), e se deve ou não impor o comportamento do gerente de configuração.Por exemplo:
- Comportamento de instalação: Instalar para o sistema
- Exigência de login: Se um usuário está ou não conectado
- Visibilidade da instalação: Hidden (Oculto)
- Adicione detalhes gerais, como o nome do aplicativo.
- Distribua o aplicativo entre os dispositivos usando o SCCM Distribution Point (DP).
Para instalar o Bot Agent, configure o DP no servidor principal em que a Control Room está instalada. É importante garantir que, após a criação do aplicativo, ele seja distribuída adequadamente ao DP e possa ser monitorado no SCCM.
Para obter mais informações, consulte Install and configure distribution points in Configuration Manager.
- Use limites no SCCM para particionar virtualmente os dispositivos identificados por meio de domínios, sub-redes ou um intervalo de endereços IP.
Os limites ajudam na segregação do DP para diferentes aplicativos e podem ser configurados por meio da seção de configuração hierárquica da opção de Administração do SCCM.
Para obter mais informações, consulte Define network locations as boundaries for Configuration Manager.
- Clique com o botão direito do mouse no aplicativo Automation Anywhere Bot Agent para implantar o Bot Agent usando a opção de Aplicativos do SCCM.
- Assegure-se de que os dispositivos tenham sido adicionados à página Control Room Dispositivos.