Parâmetros de instalação do agente

info

O macOS é compatível apenas com os seguintes parâmetros da lista fornecida abaixo: RTPrimary, RTSecondary, ClientID, DefaultDomain, AuthMode, LogLevel.

Os parâmetros marcados com * são obrigatórios apenas em cenários específicos. Consulte a descrição do parâmetro para conhecer as condições.

Quando usar aspas

As aspas dependem do valor, não do parâmetro. Use aspas duplas em dois casos:

• Valores com espaços: sem aspas, o msiexec retorna o erro 1639 e a instalação não chega a começar.
• Valores vazios: sem aspas, o msiexec usa o argumento seguinte como valor e grava um valor incorreto sem avisar. Por exemplo, DEFAULTDOMAIN= pode acabar gravando CURRENTDIRECTORY="C:\Users\usuario" como domínio.

No comando a seguir, o caminho do MSI leva aspas porque contém espaços e DEFAULTDOMAIN leva aspas porque fica em branco, algo comum ao reinstalar um agente que antes usava SAML2 ou OAUTH2. Substitua VERSÃO-SUFIXO pela versão do seu pacote, SERVIDOR_PRIMÁRIO pelo endereço do seu servidor e SEU_CLIENT_ID pelo identificador de cliente da sua instalação.

msiexec /i "C:\Implantação\Agentes Redtrust\rt-agent-x64-VERSÃO-SUFIXO.msi" RTPRIMARY=SERVIDOR_PRIMÁRIO CLIENTID=SEU_CLIENT_ID DEFAULTDOMAIN="" /qn

Os demais valores funcionam da mesma forma com e sem aspas, como endereços IP, nomes de host, códigos de idioma, números, palavras-chave como SERVER e as chaves em base64 do ClientID.

Parâmetro	Opcional	Valor Padrão	Descrição
RTPrimary	Não		Endereço IP ou nome de host do servidor Redtrust primário.
RTSecondary	Não		Endereço IP ou nome de host do servidor Redtrust secundário. Se não houver servidor secundário disponível, use o nome de host do servidor primário.
ClientID	Não		Chave compartilhada com o servidor. É única para cada cliente e pode ser consultada no console de administração em: Sistema > Unidade > Informações.
DEFAULTDOMAIN	Não*		Domínio padrão oferecido ao usuário para login. Não é efetivo para login via Entra ID. *Obrigatório quando AuthMode é SAML2 ou OAUTH2.
AuthMode	Sim	ActiveDirectory	Indica o modo de autenticação do agente. Valores possíveis: * LocalUsers * LDAP * ActiveDirectory * ActivationCode * SAML2 (Nota: Deve ser acompanhado pelo parâmetro DEFAULTDOMAIN) * OAUTH2 (Nota: Deve ser acompanhado pelo parâmetro DEFAULTDOMAIN)
Language	Sim	es-ES	Idioma do agente. Os valores possíveis são espanhol (es-ES), inglês (en-US) e português brasileiro (pt-BR).
TIMEOUT_SECONDS	Sim	31	Tempo limite em segundos após o qual o agente considera que o servidor está indisponível.
START_DELAYED	Sim	0	Especifica o modo de inicialização do serviço instalado: 0 - Início automático 1 - Início atrasado
PIN_EXPIRATION	Sim	0	Número de segundos após os quais o PIN deve ser reinserido ao usar um certificado.
NO_REDIST	Sim	0	0 - Instala os redistribuíveis do C++ 1 - Não instala os redistribuíveis do C++.
NO_UPDATER	Sim	0	0 - Instala o programa de atualização Redtrust RTUpdater 1 - Não instala o programa de atualização Redtrust RTUpdater.
NO_FIREFOX	Sim	0	0 - Instala a extensão para Firefox 1 - Não instala a extensão para Firefox.
NO_CHROME	Sim	0	0 - Instala a extensão para Chrome 1 - Não instala a extensão para Chrome.
NO_EDGE	Sim	0	0 - Instala a extensão para MS Edge 1 - Não instala a extensão para MS Edge.
UNATTENDED_BROWSERS	Sim	0	0 - Instalação padrão com a extensão do navegador. 1 - Instala o agente no modo navegadores autônomos, sem nenhum componente da extensão do navegador (chaves de registro, host de mensagens nativas, arquivo XPI do Firefox, entre outros). O agente ignora o rastreamento de URL, portanto a assinatura no navegador exige uma política com a opção Navegadores autônomos ativada. Consulte Navegadores autônomos. Disponível a partir da versão 4.42.3.
WEBPROXY_URI	Sim	Empty	URL do proxy. O proxy deve ser transparente e sem autenticação.
AGENTMODE	Sim	USER	`USER
ONLY_KSP	Sim	0	0 - Modo normal. CSP+KSP 1 - Modo KSP
EXT_V3	Sim	1	0 - Usa extensões com o manifest V2. 1 - Usa a nova versão das webextensions.
REQUEST_LOGIN_AT_STARTUP	Sim	0	0 - Não faz login automático na inicialização. 1 - Ativa o login automático na inicialização.
AUTO_SET_INCOGNITO_MODE	Sim	0	0 - O Redtrust pede permissão para fechar o navegador antes de ativar o modo anônimo da extensão. 1 - O Redtrust fecha e reabre o navegador automaticamente para ativá-lo, sem perguntar. *
STARTUPBOOST	Sim	0	0 - Desativa e bloqueia a opção de inicialização rápida do Microsoft Edge. 1 - Não desativa a inicialização rápida e deixa a opção desbloqueada para o cliente.

Sobre o parâmetro AUTO_SET_INCOGNITO_MODE (*)

O modo automático (1) não pode ser garantido: por design, os navegadores exigem que o próprio usuário ative a extensão no modo anônimo, portanto o instalador não consegue configurá-lo de forma estável. Consulte A extensão no modo anônimo e InPrivate para saber por que e conhecer as alternativas suportadas.