Executando o instalador do Agente via linha de comandos

O instalador do Agente NeoCode Activities pode ser executado por meio da linha de comando.

Esse método é especialmente útil em ambientes corporativos, onde a instalação precisa ser realizada em vários dispositivos ou automatizada por meio de scripts.

Com os parâmetros de linha de comando, também é possível realizar uma instalação silenciosa, ou seja, sem exibir a interface gráfica do instalador e sem exigir interação do usuário durante o processo.

Quando utilizar este método?

A instalação pela linha de comando pode ser utilizada quando for necessário:

• automatizar a instalação do Agente;

• instalar o Agente em vários dispositivos;

• realizar uma instalação silenciosa;

• definir previamente algumas configurações da instalação;

• incluir a instalação do Agente em scripts de configuração.

Antes de começar

Tenha em mãos:

• o instalador correspondente ao sistema operacional utilizado;

• a CHAVE_DE_API da conta.

A chave de API pode ser encontrada no menu Gerenciamento -> Conta da interface web.

Para consultar onde baixar os instaladores do Agente, acesse:
Onde encontrar os instaladores do Agente?

Exemplos de instalação

A forma de executar o comando varia conforme o sistema operacional.

Windows

Execute:

ActivitiesInstallerLauncher.exe -k CHAVE_DE_API -q -f -s true

macOS

Execute:

sh install.sh "-k CHAVE_DE_API -q -f -s true"

Linux

Execute:

./neocode-activities-installer.run -k CHAVE_DE_API -q -f -s true

Nos exemplos acima:

• -k CHAVE_DE_API informa a chave de API da conta;

• -q realiza a instalação em modo silencioso;

• -f força a instalação, inclusive quando o Agente já tiver sido instalado anteriormente;

• -s true inicia o Agente após a instalação.

Parâmetros disponíveis

Exemplos de parâmetros adicionais

Para definir mais de um usuário nos parâmetros -ignore-users, -ig ou -only-users, -ou, separe os logins utilizando ponto e vírgula (;).

Exemplo:

user1;user2

Para definir um diretório de instalação que possua espaços no caminho, utilize aspas.

Exemplo:

-d "C:\Caminho da Pasta"

Observações importantes

• Os parâmetros podem ser combinados de acordo com a necessidade da instalação.

• O parâmetro -start, -s utiliza true como padrão.

• O parâmetro -incognito, -i utiliza false como padrão.

• O parâmetro -identifier-by-user, -iu utiliza false como padrão.

• O parâmetro -protect-uninstall, -pu não está disponível para instalações MSI.

• Ao utilizar -ignore-users, -ig, os usuários informados não serão considerados pelo Agente.

• Ao utilizar -only-users, -ou, somente os usuários informados serão monitorados.

• O parâmetro -ignore-absences, -ia impede o questionamento de ausências mesmo quando essa opção estiver configurada na conta, equipe ou equipamento.

O que acontece após a configuração?

O comportamento da instalação dependerá dos parâmetros utilizados no comando.

Por exemplo, é possível definir se a instalação será silenciosa, se o Agente será iniciado automaticamente, se funcionará em Modo incógnito e quais usuários do equipamento deverão ou não ser monitorados.

Resumo

A instalação do Agente NeoCode Activities pela linha de comando permite automatizar o processo e definir previamente diferentes opções de instalação.

Esse método é especialmente útil em ambientes com vários dispositivos, reduzindo a necessidade de realizar manualmente as mesmas configurações em cada equipamento.