Parâmetros de Linha de Comando

Você pode instalar e atualizar o Studio e o UiPath Robot ou alterar uma instalação existente executando o instalador UiPathStudio.msi ou UiPathStudioCloud.msi na 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.
• Alterar uma instalação existente executando o instalador da linha de comando no modo silencioso não é compatível. No entanto, você pode executar o instalador no modo silencioso para atualizar a partir de uma versão mais antiga.
• 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 tabela a seguir lista todos os parâmetros de linha de comando disponíveis.

Todos os parâmetros podem ser usados para instalações limpas, mas apenas os seguintes são compatíveis ao atualizar a partir de uma versão mais antiga ou alterar uma instalação existente:

• Habilitar / desabilitar funcionalidades usando o ADDLOCAL. Observe que o Robô não pode estar desabilitado.
• SERVICE_URL - disponível ao alterar o Robô do modo de serviço para o modo de usuário não incluindo o argumento RegisterService.
• NUGET_OPTIONS, ENFORCE_SIGNED_EXECUTION, DISABLE_SECURE_XAML e TELEMETRY_ENABLED - não disponível para alterar as instalações existentes.

  Command	Description
  /q	Ajuda você a instalar os recursos especificados da UiPath de forma silenciosa, sem exibir a interface do usuário.
  /l*vx <LogFile>	Gera um arquivo de log do instalador no caminho especificado. A partir da v2018.4.2, esse arquivo também pode incluir informações de licenciamento se você licenciar o Studio ou o UiPath Robot no momento de instalação. Se por qualquer motivo você encontrar dificuldades durante o processo de instalação, basta enviar o arquivo para nossa equipe de suporte.
  ADDLOCAL	Permite que você selecione as funcionalidades que deseja instalar. Se ADDLOCAL for usado, apenas as funcionalidades especificadas nele serão instaladas. Se não ADDLOCALfor usado, os seguintes recursos são instalados: Studio, o Robô no modo de serviço, as extensões para Chrome e Edge (se os navegadores estiverem instalados na máquina) e o complemento JavaScript. Ele oferece suporte para as seguintes opções: DesktopFeature - indica que você deseja instalar as funcionalidades do Robô e do Studio. Studio- Instala o Studio. ExcelAddin — instala o Suplemento do Excel para o StudioX. Não pode ser usado sem Studio. Robot -instala o UiPath Robot no modo de usuário ou modo de serviço, bem como o Assistant. Para instalar o Robô no modo de serviço, adicione também a opção RegisterService. Essa é a escolha recomendada para Robôs não assistidos. Para instalar o Robot no modo de usuário, não adicione a opção RegisterService. Essa é a escolha recomendada para Robôs assistidos e de desenvolvimento. Observação: se você converter o Robô do modo de serviço para o modo de usuário, o Robô pode não acessar os arquivos .xaml da pasta original do NuGet. Para obter detalhes sobre como resolver isso, consulte o artigo de resolução de problemas Pacotes NuGet não acessíveis após a migração. StartupLauncher - Executa o Robô na inicialização do Windows. Não pode ser usada sem o Robot argumento. JavaBridge - Instala o UiPath Java Bridge para uma melhor integração e automação em relação aos aplicativos Java. Note que a instalação do Java Bridge pode fazer com que a instalação demore mais do que o normal. Não pode ser usada sem o Robot argumento. ChromeExtension - Instala a Extensão do UiPath Google Chrome. Não pode ser usada sem o Robot argumento. FirefoxExtension — por exemplo, : UiPathStudio.msi ADDLOCAL=Studio,Robot,ChromeExtension,FirefoxExtension /Q EdgeExtension - Instala a Extensão baseada em Chromium da UiPath para Microsoft Edge. Não pode ser usada sem o Robot argumento. CitrixClient - Instala a Extensão da UiPath para o Cliente Citrix. Não pode ser usada sem o Robot argumento. JavaScriptAddOn - Instala o complemento Robot JavaScript para suportar o SDK JavaScript do robô. SapPlugin -instala o plug-in do 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. Não pode ser usado sem Studio. VMwareExtension - Instala a Extensão UiPath para VMware Horizon. Não pode ser usada sem o Robot argumento. WindowsRdpExtension - Instala a Extensão UiPath para Área de Trabalho Remota da Microsoft. Não pode ser usada sem o Robot argumento.
  MSIINSTALLPERUSER	Esse parâmetro permite que você instale o Studio e UiPath Robot por usuário ou por máquina. Se o parâmetro não for incluído, a instalação será por máquina. Se você adicionar MSIINSTALLPERUSER=1, a instalação é por usuário. Os parâmetros são utilizáveis apenas ao realizar uma instalação limpa. As opções a seguir não estão disponíveis em instalações por usuário: RegisterService, CitrixExtension, VMwareExtension, SapPlugin, PACKAGES_FOLDER, CODE.
  SAP_SOL_MAN_HOST	Hostname ou endereço IP para sua instância do SAP Solution Manager. Obrigatório para instalações limpas se o argumento SapPlugin tiver sido fornecido para a opção ADDLOCAL. Por exemplo, UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,SapPlugin SAP_SOL_MAN_HOST=ip_address
  APPLICATIONFOLDER	Permite que você instale o Studio e o Robô em um local personalizado.
  NUGET_OPTIONS	Esse parâmetro é recomendado se você estiver trabalhando em um ambiente off-line. Se definido como DisableOnlineFeeds, esse parâmetro ajuda você a desabilitar os feeds oficiais do UiPath e Community para o Robô - apenas o Orchestrator e os feeds locais são levados em consideração. Observe que os feeds de URL não são excluídos dos arquivos de configuração, só ignorados. Ele pode ser usado para instalações e atualizações. Observação: o parâmetro NUGET_OPTIONS não desabilita os feeds oficiais e comunitários da UiPath online para o Studio.
  PACKAGES_FOLDER	Permite que você altere o local de download dos seus fluxos de trabalho e suas dependências para o Studio e/ou Robot. Essa pasta pode ser específica do usuário ou acessível por todos os usuários de uma máquina. Este parâmetro pode ser usado para robôs de modo de serviço ou modo de usuário. Se você não fornecer esse parâmetro, a pasta padrão será %userProfile%\.nuget\packages. Observação: ao alterar a pasta de pacotes, certifique-se de que todos os usuários que precisam executar processos tenham acesso de leitura para essa pasta. 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 - UiPathStudio.msi PACKAGES_FOLDER=C:\Some\Path\^%USERNAME^%. Em scripts de lote - use % - UiPathStudio.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^%. Para instalações em máquinas do Windows Server (que habilitam a execução simultânea - HD Robots), você deve fornecer caminhos específicos para cada usuário. Leia mais sobre como usar o mesmo caminho para vários Robots. Observação: ao usar o parâmetro PACKAGES_FOLDER, existem algumas limitações. Saiba mais na documentação das pastas de pacotes personalizados e caminhos da rede. Para obter informações sobre como alterar a pasta de download para pacotes após a instalação, consulte Gerenciando pacotes de atividades.
  CUSTOM_NUGET_FEEDS	Permite que você adicione feeds de atividades do NuGet para o Studio e/ou o Robot. Esse comando só adiciona ou atualiza a lista existente de feeds. Ele deve ser preenchido com pares de valor chave da tipo string. Locais válidos incluem feeds, caminhos de pastas e unidades de rede compartilhadas. Certifique-se de que os feeds fornecidos sejam acessíveis por todos os usuários de uma máquina fornecida. Feeds separados com ponto e vírgula (;). 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. Pode ser usado em instalações ou atualizações limpas das suas instâncias. Se esse parâmetro não estiver especificado na hora da implantação, a assinatura do pacote não estará habilitada. Ele oferece suporte para as seguintes opções: 1 - O Robô é capaz de baixar, instalar ou executar apenas pacotes do autor ou repositório assinados pela UiPath. Se você quiser adicionar seu próprio certificado como uma origem confiável, você precisa fazer isso modificando o arquivonuget.config. Para saber como fazer isso, consulte esta página. 0 - Nenhuma regra de assinatura de pacotes é aplicada na sua implantação do Robô. Para obter informações sobre como impor a execução assinada após a instalação, consulte Pacotes de assinatura.
  CODE	Licencia sua instância do Studio.
  CONNECTIONSTRING	Conecta o Robô ao On-Premises Orchestrator automaticamente usando a string de conexão ao instalá-la. Observe que os seguintes são necessários: o parâmetro WindowsAuth.Enabled do arquivo UiPath.Orchestrator.dll.config deve ser definido como true o parâmetro WindowsAuth.Domain deve ser definido como um domínio válido o Robô de Modo de Serviço uma configuração de Máquina Padrão deve estar implementada. Observação: o registro automático com máquinas padrão usando CONNECTIONSTRING só pode ser usado com o Orchestrator v2020.10.
  CHROME_INSTALL_TYPE	Instala a Extensão do Chrome automaticamente por meio da política. Ele oferece suporte para as seguintes opções: GLOBAL - a extensão do Chrome é instalada automaticamente por sistema, o equivalente de chamar o comando /ChromeGlobal usando a ferramenta SetupExtenstions. STORE - a Extensão do Chrome é instalada automaticamente por sistema por meio da política, o equivalente de chamar o comando /ChromePolicyGlobal usando a ferramenta SetupExtenstions.
  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 usuários possam ler e modificar os arquivos de processo e a lógica. Ele oferece suporte para as seguintes opções: 0 - A opção padrão. Quando usado, 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. Observação: esse parâmetro pode ser usado apenas durante uma instalação limpa ou uma atualização.
  SERVICE_URL	Permite que você defina o URL da instância do Orchestrator à qual os usuários se conectarão usando o Logon Interativo. O URL fornecido é salvo no arquivo uipath.config, e é salvo apenas para Robôs de modo de usuário. Para instalações de modo de serviço, o argumento é ignorado. Ao executar o instalador para atualizar a partir de uma versão mais antiga ou alterar sua instalação existente, esse parâmetro é compatível se você estiver alterando o modo do Robô de serviço para usuário (a opção RegisterService não está incluída).
  ORCHESTRATOR_URL	Em uma instalação limpa, você pode especificar a URL principal do Orchestrator, usada para recuperar informações de atualização automática (por exemplo, https://orchestrator.local/organizationName/tenantName).
  TELEMETRY_ENABLED	Permite que você desabilite a coleta de dados de uso e pode ser feito no momento de instalação do Studio e do UiPath Robot. Observação: esse parâmetro pode ser usado apenas durante uma instalação limpa ou uma atualização. A telemetria é habilitada por padrão para Studio e Robô. Para desabilitá-la, use o seguinte valor para o parâmetro sempre que executar uma instalação limpa ou uma atualização: TELEMETRY_ENABLED=0 Observação: isso desabilita a telemetria para o Studio e o UiPath Robot. Se você quiser habilitar a telemetria, não inclua o parâmetro ou inclua-o com o seguinte valor: TELEMETRY_ENABLED=1 Para obter mais informações sobre a coleta de dados de uso e como alterar as configurações de telemetria, consulte o documento de Desativação da Telemetria.
  ENABLE_PIP	Permite que você habilite a funcionalidade Picture in Picture da máquina, durante a instalação da linha de comando da UiPath. Para habilitá-la, use o seguinte parâmetro: ENABLE_PIP=1 Exemplo: UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService ENABLE_PIP=1
  INSTALLER_LANGUAGE	Permite que você selecione o idioma de exibição do instalador. Se não for especificado, as configurações de idioma do Windows determinam o idioma do instalador. Para especificar o idioma, insira o parâmetro INSTALLER_LANGUAGE=<language_code>. As seguintes opções estão disponíveis: Chinês (simplificado): INSTALLER_LANGUAGE=2052 Inglês: INSTALLER_LANGUAGE=9 Francês: INSTALLER_LANGUAGE=12 Alemão: INSTALLER_LANGUAGE=7 Japonês: INSTALLER_LANGUAGE=17 Coreano: INSTALLER_LANGUAGE=1 Português (Portugal): INSTALLER_LANGUAGE=22 Português (Brasil): INSTALLER_LANGUAGE=1046 Russo: INSTALLER_LANGUAGE=25 Espanhol (Espanha): INSTALLER_LANGUAGE=10 Espanhol (México): INSTALLER_LANGUAGE=2058 Turco: INSTALLER_LANGUAGE=31
  ORCHESTRATOR_AUTO_SIGNIN	Se você instalar o robô assistido no modo de usuário e seu ambiente estiver configurado para usar o SSO com o Azure Active Directory, isso habilita o login automático em sua conta. Esse parâmetro deve ser usado junto com ORCHESTRATOR_URL. Para habilitar essa opção, use ORCHESTRATOR_AUTO_SIGNIN=1.
  ENFORCE_DEFAULT_SERVICE_URL	Para instalações no modo de usuário, esse parâmetro impõe a URL do serviço padrão. Para habilitar essa opção, use ENFORCE_DEFAULT_SERVICE_URL=1. ORCHESTRATOR_URL também deve estar habilitado.

Exemplos

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

• Instalar o Studio e o Robô como um serviço do Windows - UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService
• Instalar o Studio e o Robô no modo usuário apenas para o usuário atual - UiPathStudio.msi MSIINSTALLPERUSER=1 ADDLOCAL=DesktopFeature,Studio,Robot
• Instale todo o pacote de Desktop no modo silencioso - UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService,StartupLauncher,JavaBridge /Q
• Instale todo o pacote de Desktop e a Extensão do Chrome no modo silencioso por meio da política - UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService,ChromeExtension CHROME_INSTALL_TYPE=STORE /Q
• Instalar silenciosamente Studio e Robô como um serviço do Windows, todos na pasta D:\UiPath - UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService APPLICATIONFOLDER=D:\UiPath /Q

• Instale o Robot como um serviço do Windows no modo silencioso e conecte-o ao Orchestrator -

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

• Instale o Studio, o Robô como um serviço do Windows no modo silencioso e adicione dois feeds de atividades personalizados - UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService CUSTOM_NUGET_FEEDS="Feed Name1, https://my.custom.nuget.feed; FeedName2, D:\RPA\Activities\Packages\" /Q
• Instalar e licenciar silenciosamente o Studio e instalar o Robô como um serviço do Windows - UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService CODE=1234567890 /Q
• Instale o Robô como um serviço do Windows e desabilite os feeds oficiais online - UiPathStudio.msi ADDLOCAL=DesktopFeature,Robot,RegisterService NUGET_OPTIONS=DisableOnlineFeeds

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

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

• Configure a conexão de atualização automática durante a instalação do uanattended robot -

  UiPathStudio.msi ADDLOCAL=DesktopFeature,Robot,ORCHESTRATOR_URL="https://demo.uipath.com/myorg/mytenant"