Parâmetros de linha de comando de UiPathRobot.msi

Você pode instalar o UiPath Robot executando o instalador UiPathRobot.msi a partir da linha de comando.

Veja as seguintes seções para obter descrições dos parâmetros disponíveis e alguns exemplos de uso.

Observação:

• São necessários direitos de administrador para executar esses comandos.
• Usar a opção /passivede msiexec.exe para executar uma instalação não assistida não é suportado.

Descrições de Argumentos de Linha de Comando

A lista a seguir exibe todos os parâmetros de linha de comando disponíveis.

• /q - Instala as funcionalidades da UiPath especificadas silenciosamente, sem exibir a interface do usuário.
• /l*vx <LogFile> - Gera um arquivo de log do instalador no caminho especificado. Se por qualquer motivo você encontrar dificuldades durante o processo de instalação, basta enviar o arquivo para nossa equipe de suporte.
• ADDLOCAL - Permite selecionar as funcionalidades a instalar. Sem esse parâmetro, as seguintes funcionalidades são instaladas por padrão: Robô no Modo de Serviço, pacotes de atividades padrão e complemento JavaScript. Ele suporta as seguintes opções:
  • Studio (exclusivamente para UiPathStudio.msi) — Instala o Studio.
  • ExcelAddin (exclusivamente para UiPathStudio.msi) — Instala o suplemento do StudioX do Excel. Deve ser usado junto com o parâmetro Studio.
  • Robot — Instala o Robô no Modo de usuário ou Modo de serviço, bem como o Assistant.
  • RegisterService — Obrigatório para instalações do Modo de serviço. Não adicioná-lo para instalações no Modo de Usuário.
  • StartupLauncher — Executa o robô na inicialização do Windows.
  • JavaBridge — Instala o UiPath Java Bridge para uma melhor integração e automação com aplicativos Java. Adicionar isso pode aumentar o período de instalação. Deve ser usado junto com o parâmetro Robot.
  • ChromeExtension — Instala a extensão do Google Chrome. Deve ser usado junto com o parâmetro Robot.
  • FirefoxExtension — Instala a extensão do Firefox. Deve ser usado junto com o parâmetro Robot.
  • EdgeExtension — Instala a extensão baseada no Microsoft Edge no Chromium. Deve ser usado junto com o parâmetro Robot.
  • CitrixClient — Instala a extensão do cliente UiPath Citrix. Deve ser usado junto com o parâmetro Robot. Não disponível para instalações por usuário.
  • JavaScriptAddOn — Instala o complemento de Incorporação do Navegador. Deve ser usado junto com o parâmetro Robot. Não pode ser usada com direitos elevados.
  • SapPlugin (exclusivamente para UiPathStudio.msi) — Instala o plugin SAP Solution Manager. Requer que o conector SAP para a Microsoft seja instalado na sua máquina. Em instalações limpas você também deve fornecer um endereço para a instância usando o parâmetro SAP_SOL_MAN_HOST. Deve ser usado junto com o parâmetro Studio. Não disponível para instalações por usuário.
  • VMwareExtension — Instala a extensão da UiPath para VMware Horizon. Deve ser usado junto com o parâmetro Robot. Não disponível para instalações por usuário.
  • WindowsRdpExtension — Instala a extensão da UiPath para o Windows Remote Desktop. Deve ser usado junto com o parâmetro Robot.
• MSIINSTALLPERUSER - Permite que você instale apenas para o usuário atual.
  • Para instalar por usuário, adicione MSIINSTALLPERUSER=1. As opções a seguir não estão disponíveis em instalações por usuário: RegisterService, CitrixExtension, VMwareExtension, PACKAGES_FOLDER e CODE.
  • Para instalar por máquina, não inclua esse parâmetro.
• SAP_SOL_MAN_HOST (exclusivamente para UiPathStudio.msi) - O Nome do Host ou Endereço IP da sua Instância do SAP Solution Manager. Necessário para instalações limpas onde o parâmetro SapPlugin foi adicionado à opçãoADDLOCAL.
• APPLICATIONFOLDER - Permite que você instale o robô em um local personalizado.
• NUGET_OPTIONS - Para ambientes offline. Se definido como DisableOnlineFeeds, esse parâmetro desabilita os feeds online Oficial e Community da UiPath para o Robô, e usa exclusivamente feeds do Orchestrator e locais.
  Observação:

  Os feeds de URL permanecem nos arquivos de configuração, mas são ignorados.

• PACKAGES_FOLDER
  • Permite que você altere o local de download para seus fluxos de trabalho e suas dependências. A pasta escolhida pode ser específica do usuário ou acessível por todos os usuários em uma máquina.
  • Sem esse parâmetro, o local de download padrão é %userProfile%\.nuget\packages.
  • Não disponível para instalações por usuário.
    Observação:

    Certifique-se de que todos os usuários que precisam executar processos tenham acesso de leitura à nova pasta.

  • Para instalações em máquinas do Windows Server que habilitam a execução simultânea, você deve fornecer caminhos específicos para cada usuário. Leia mais sobre .
  • Descubra como alterar a pasta de download para pacotes após a instalação.
• CUSTOM_NUGET_FEEDS - Permite que você adicione feeds de atividades personalizados do NuGet para o Studio e/ou robô. Esse comando só adiciona ou atualiza a lista existente de feeds. Ele deve ser preenchido com pares de valor-chave do tipo string:
  • Locais válidos incluem feeds online, caminhos de pastas e unidades de rede compartilhadas.
  • Certifique-se de que os feeds fornecidos sejam acessíveis por todos os usuários em uma determinada máquina.
  • Separar feeds com ponto e vírgula (;). Por exemplo:

    CUSTOM_NUGET_FEEDS="FeedName1,https://my.custom.nuget.feed; FeedName2,D:\Custom\Activities\Packages\"
    

• ENFORCE_SIGNED_EXECUTION - Opcional. Permite que você force seus Robôs a executarem apenas pacotes assinados. Sem esse parâmetro, a assinatura de pacotes não é habilitada. Oferece as seguintes opções:
  • 1 - O robô lida apenas com pacotes assinados por autores ou repositórios verificados pela UiPath. Para adicionar seu próprio certificado como uma origem confiável, modifique o arquivo nuget.config.
  • 0 - Nenhuma regra de assinatura de pacotes é aplicada na implantação do seu Robot. Para obter mais detalhes, consulte Assinatura de pacotes.
• CODE - Licencia sua instância do robô. Não disponível para instalações por usuário.
• CLIENT_ID e CLIENT_SECRET - Conecta automaticamente o Robot ao Orchestrator usando Credenciais do Cliente, enquanto também o instala. Por exemplo:

  UiPathRobot.msi ORCHESTRATOR_URL=https://demo.uipath.com/company/tenant/orchestrator_ CLIENT_ID=1234-abcd-1ab2-cd32-1111 CLIENT_SECRET=2143ndafj32k
  

• CHROME_INSTALL_TYPE - Permite que você escolha o método de instalação para a extensão do Chrome. Necessidades de direitos de administrador. Sem esse parâmetro o método mais apropriado é selecionado automaticamente. Oferece as seguintes opções:
  • POLICYOFFLINE - A extensão Chrome é instalada automaticamente por sistema, por meio do método de Política de grupo off-line, o equivalente a chamar o /Chrome-Policy-Offlinecomando usando a ferramenta SetupExtensions.
  • POLICYONLINE - A extensão Edge é instalada automaticamente por sistema por meio do método de Política de grupo Online, o equivalente a chamar o comando /Edge-Chromium-PolicyGlobal usando a ferramenta SetupExtensions.
  • MANUALPERMACHINE - A extensão do Chrome é instalada para todos os usuários, o equivalente a chamar o /ChromeGlobalcomando usando a ferramenta SetupExtensions.
  • NATIVEHOSTONLY - Apenas o componente do host de mensagens nativas (ChromeNativeMessaging.exe) é instalado, o equivalente a chamar o /ChromeNativeHostGlobalcomando usando a ferramenta SetupExtensions.
  Observação:

  Os nomes dos métodos de instalação antigos (STORE, GLOBAL) são mantidos para compatibilidade com versões anteriores.

• EDGE_INSTALL_TYPE - Permite que você escolha o método de instalação para a extensão do Edge. Necessidades de direitos de administrador. Sem esse parâmetro o método mais apropriado é selecionado automaticamente. Oferece as seguintes opções:
  • POLICYOFFLINE - A extensão Edge é instalada automaticamente por sistema por meio do método de Política de grupo off-line, o equivalente a chamar o /Edge-Policy-Offlinecomando usando a ferramenta SetupExtensions.
  • POLICYONLINE - A extensão Edge é instalada automaticamente por sistema por meio do método de Política de grupo Online, o equivalente a chamar o comando /Edge-Chromium-PolicyGlobal usando a ferramenta SetupExtensions.
  • MANUALPERMACHINE - A Extensão Edge é instalada para todos os usuários, o equivalente a chamar o comando /Edge-Chromium-Global usando a ferramenta SetupExtensions.
  • NATIVEHOSTONLY - Apenas o componente do host de mensagens nativas (ChromeNativeMessaging.exe) é instalado, o equivalente a chamar o /Edge-Chromium-NativeHostGlobalcomando usando a ferramenta SetupExtensions.
  Observação:

  Os nomes dos métodos de instalação antigos (STORE, GLOBAL) são mantidos para compatibilidade com versões anteriores.

• DISABLE_SECURE_XAML - Permite que você desabilite a segurança de arquivos XAML para robôs instalados como um serviço do Windows. Arquivos XAML não seguros permitem que os usuários leiam e modifiquem os arquivos e a lógica do processo. Oferece as seguintes opções:
  • 0 - A opção padrão. Habilita a segurança para arquivos XAML para Robôs de Serviço do Windows.
  • 1 - Desabilita a segurança para arquivos XAML para Robôs de serviço do Windows.
• SERVICE_URL - Permite definir o URL da instância do Orchestrator à qual se conectar usando o logon interativo. Esse valor é salvo no arquivo uipath.config. Exigido por instalações do Modo de Usuário. As instalações do Modo de Serviço ignoram esse parâmetro.
• ORCHESTRATOR_URL - Em instalações limpas, você pode especificar o URL principal do Orchestrator, usado para recuperar informações de atualização automática. Por exemplo: https://orchestrator.local/organizationName/tenantName.
• TELEMETRY_ENABLED - Permite que você desabilite a coleção de dados de uso. Oferece as seguintes opções:
  • 0 - Desabilita a telemetria para o Studio e o robô.
  • 1 - Opção padrão. Habilita a telemetria para o Studio e o robô. Saiba como desativar a telemetria.
• ENABLE_PIP - Permite que você habilite a funcionalidade Sessão do robô (Picture in Picture) da máquina. Oferece as seguintes opções:
  • 0 - Opção padrão. O recurso Sessão do Robô é desabilitado.
  • 1 - Habilita o recurso de sessão do robô.
• INSTALLER_LANGUAGE - Permite que você selecione o idioma de exibição do instalador. Sem esse parâmetro, o instalador usa as configurações de idioma no Windows. Oferece as seguintes opções:
  • 2052 - Chinês (simplificado)
  • 12 - Francês
  • 7 - Alemão
  • 17 - Japonês
  • 1 - Coreano
  • 22 - Português (Portugal)
  • 1046 - Português (Brasil)
  • 25 - Russo
  • 10 - Espanhol (Espanha)
  • 2058 - Espanhol (México)
  • 31 - Turco
• ASSISTANT_OPTIONS - Habilita ou desabilita o widget do Marketplace para o Assistant. Oferece as seguintes opções:
  • Ausente ou EnableMarketplace - A opção padrão. Habilita o widget.
  • DisableMarketplace - Desabilita o widget.
• ORCHESTRATOR_AUTO_SIGNIN - Permite o login automático em sua conta. Para instalações e ambientes do Modo Usuário configurados para usar SSO com o Azure Active Directory. Deve ser usado junto com o parâmetro ORCHESTRATOR_URL. Oferece as seguintes opções:
  • 0 - Desabilita o login automático.
  • 1 - Habilita o login automático.

Uso de caminhos na linha de comando

Ao inserir caminhos, considere o seguinte:

• Se você precisar usar variáveis ambientais como %USERNAME% ou %USERPROFILE%, o caractere especial % precisará ser escapado da seguinte forma:
  • Quando a configuração é invocada a partir do Prompt de Comando, use ^ - UiPathRobot.msi PACKAGES_FOLDER=C:\Some\Path\^%USERNAME^%.
  • Em scripts de lotes, use ^ - UiPathRobot.msi PACKAGES_FOLDER=C:\Some\Path\^%USERNAME^%.
  • No console do PowerShell ou scripts - não é necessária escaping.
  • Ao usar contas de domínio do Active Directory, é recomendável especificar também o nome de domínio na estrutura de pastas, como C:\packages\^%UserDomain^%.^%Username^%.
• Se você precisar usar caminhos com espaços, eles devem ser envolvidos da seguinte forma:
  • Em Prompt de comando, envolva com aspas duplas (" ").Por exemplo, UiPathRobot.msi APPLICATIONFOLDER="C:\folder name".
  • No PowerShell, envolva com aspas simples e duplas ('" "').Por exemplo,./UiPathRobot.msi APPLICATIONFOLDER='"C:\folder name"'.

Executando uma instalação síncrona

Se desejar fazer configurações adicionais após a instalação ser concluída, você pode executar o instalador de forma síncrona. Isso permite adicionar outros comandos para serem executados depois que o instalador terminar, por exemplo, você pode instalar e configurar uma conexão de robô ou configurar feeds.

Os scripts a seguir executam a instalação e permitem adicionar outros comandos para serem executados se a instalação for bem-sucedida.

:: Runnning the MSI synchronously
start /wait /b UiPathRobot.msi /Q
:: Assert the exit code and continue accordingly
set "_isSuccess="
if %ERRORLEVEL% EQU 0 Set "_isSuccess=1"
if %ERRORLEVEL% EQU 1641 Set "_isSuccess=1"
if %ERRORLEVEL% EQU 3010 Set "_isSuccess=1"
:: test for success and run follow-up commands
if (%_isSuccess% EQU 1) (
    echo "success"
) ELSE (
    echo "fail"
)

Exemplos

Esses exemplos foram escritos considerando que você já está no diretório no qual o instalador do UiPathRobot.msi está localizado. Você pode fazer isso com o seguinte comando, como por exemplo: cd D:\UiPathInstaller.

• Instale o robô no modo de usuário apenas para o usuário atual

  UiPathRobot.msi MSIINSTALLPERUSER=1 ADDLOCAL=Robot
  

• Instale o robô silenciosamente

  UiPathRobot.msi ADDLOCAL=Robot,RegisterService,StartupLauncher,JavaBridge /Q
  

• Instale silenciosamente o robô e a extensão do Chrome por meio da política.

  UiPathRobot.msi ADDLOCAL=Robot,RegisterService,ChromeExtension CHROME_INSTALL_TYPE=POLICYONLINE /Q
  

• Instale silenciosamente o robô como um serviço do Windows e conecte-o ao Orchestrator.

  UiPathRobot.msi ADDLOCAL=Robot,RegisterService CONNECTIONSTRING=https://demo.uipath.com/api/robotsservice/GetConnectionData?tenantId=1 /Q
  

• Instale silenciosamente o robô como um serviço do Windows e adicione dois feeds de atividade personalizada

  UiPathRobot.msi ADDLOCAL=Robot,RegisterService CUSTOM_NUGET_FEEDS="Feed Name1,https://my.custom.nuget.feed; FeedName2,D:\RPA\Activities\Packages\" /Q
  

• Instale e licencie silenciosamente um robô registrado como um serviço do Windows e o feed de atividades local

  UiPathRobot.msi ADDLOCAL=Robot,RegisterService,CODE=1234567890 /Q
  

• Instale o robô como um serviço do Windows e desabilite os feeds oficiais online

  UiPathRobot.msi ADDLOCAL=Robot,RegisterService NUGET_OPTIONS=DisableOnlineFeeds
  

• Desinstale a extensão do Chrome

  UiPathRobot.msi REMOVE=ChromeExtension /Q
  

• Configure a conexão de atualização automática durante a instalação do Attended Robot

  UiPathRobot.msi ADDLOCAL=Robot,RegisterService SERVICE_URL="https://demo.uipath.com/myorg/mytenant"
  

• Configure a conexão de atualização automática durante a instalação do robô não assistido

  UiPathRobot.msi ADDLOCAL=Robot,RegisterService ORCHESTRATOR_URL="https://demo.uipath.com/myorg/mytenant/orchestrator_"