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:

• Direitos de Administrator são necessários para executar esses comandos.* Alterar uma instalação existente executando o instalador a partir 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. * O uso da opção /passivemsiexec.exe para executar uma instalação não assistida não é compatível.

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:

• Habilite recursos usando o ADDLOCAL.
• Desabilite recursos usando REMOVE. Observe que o Robô não pode estar desabilitado.
• Habilite ou desabilite as opções do Assistant usando o ASSISTANT_OPTIONS.
• 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, disponíveis ao atualizar a partir de uma versão mais antiga, não disponíveis ao alterar uma instalação existente.
• Consulte o endereço do servidor proxy, IP ou nome de domínio usando PROXY_ADDRESS.

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 ^ - UiPathStudio.msi PACKAGES_FOLDER=C:\Some\Path\^%USERNAME^%.
  • Em scripts de lotes, 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^%.
• 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, UiPathStudio.msi APPLICATIONFOLDER="C:\folder name".
  • No PowerShell, envolva com aspas simples e duplas ('" "').Por exemplo, ./UiPathStudio.msi APPLICATIONFOLDER='"C:\folder name"'.

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	Para instalar o robô no modo de serviço, adicione 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. Se você converter o robô do modo de serviço para o modo de usuário, o robô pode não ser capaz de 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 argumento Robot. JavaBridge– Instala o UiPath Java Bridge para integração e automação avançadas de aplicativos Java. 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 argumento Robot. ChromeExtension– Instala a extensão UiPath Google Chrome. Não pode ser usada sem o argumento Robot. FirefoxExtension – Installs the UiPath Mozilla Firefox Extension. It cannot be used without the Robot argument. Example: UiPathStudio.msi ADDLOCAL=Studio,Robot,ChromeExtension,FirefoxExtension. EdgeExtension – Instala a extensão UiPath Microsoft Edge (baseada em Chromium). Não pode ser usada sem o argumento Robot. CitrixClient – Instala a extensão do cliente Citrix da UiPath. Não pode ser usada sem o argumento Robot. JavaScriptAddOn– Instala o complemento JavaScript do robô necessário para o robô JavaScript SDK. SapPlugin– Instala o plugin SAP Solution Manager. Requer o Conector SAP para Microsoft. Para instalações limpas, você também deve fornecer o endereço da instância usando 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 argumento Robot. WindowsRdpExtension – Instala a extensão UiPath para Área de Trabalho Remota da Microsoft. Não pode ser usada sem o argumento Robot. AmazonWorkSpacesClient – Instala a extensão UiPath para Amazon WorkSpaces. Não pode ser usada sem o argumento Robot. LiveStreaming – Instala o software de transmissão ao vivo (RealVNC) necessário para depuração remota. Consulte a funcionalidade de transmissão ao vivo no guia do UiPath Robot.
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. O parâmetro é utilizável 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 foi fornecido para a opção ADDLOCAL. Por exemplo, UiPathStudio.msi ADDLOCAL=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 e comunitários da UiPath para o robô - apenas os feeds locais e do Orchestrator 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. Pode ser usado para instalações e atualizações. Ao atualizar, você pode definir o parâmetro como EnableOnlineFeeds para habilitar feeds online. 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. Esse parâmetro pode ser usado para robôs no modo de serviço ou no modo de usuário. Se você não fornecer esse parâmetro, a pasta padrão será %userProfile%\\.nuget\\packages. Ao alterar a pasta de pacotes, certifique-se de que todos os usuários que precisam executar processos tenham acesso de leitura a essa pasta. Ao usar o parâmetro PACKAGES_FOLDER, há algumas limitações. Saiba mais na documentação de pastas de pacotes personalizados e caminhos de rede . 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 usando o mesmo caminho para vários robôs . 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	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 informações sobre como aplicar a execução assinada após a instalação, consulte Pacotes de Assinatura.
CODE	Licencia sua instância do Studio.
CLIENT_ID e CLIENT_SECRET	Conecta automaticamente o robô ao Orchestrator usando credenciais do cliente enquanto também o instala. Exemplo: UiPathStudio.msi ORCHESTRATOR_URL=https://demo.uipath.com/company/tenant/orchestrator_CLIENT_ID=1234-abcd-1ab2-cd32-1111 CLIENT_SECRET=2143ndafj32k
CHROME_INSTALL_TYPE	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 Chrome é instalada automaticamente por sistema por meio do método de Política de grupo on-line, o equivalente a chamar o /ChromePolicyGlobalcomando 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. Os nomes dos métodos antigos de instalação ( STORE , GLOBAL ) são mantidos para compatibilidade com versões anteriores.
EDGE_INSTALL_TYPE	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. Os nomes dos métodos antigos de instalação ( STORE , GLOBAL ) são mantidos para compatibilidade com versões anteriores.
DISABLE_SECURE_XAML	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. Esse parâmetro só pode ser usado 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	TELEMETRY_ENABLED=0 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 Desativação da Telemetria.
ENABLE_PIP	ENABLE_PIP=1 Exemplo: UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService ENABLE_PIP=1
INSTALLER_LANGUAGE	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
ASSISTANT_OPTIONS	Para habilitar o widget, use ASSISTANT_OPTIONS=EnableMarketplace ou não inclua o parâmetro. Para desabilitar o widget, use ASSISTANT_OPTIONS=DisableMarketplace .
ORCHESTRATOR_AUTO_SIGNIN	Se você instalar o Attended Robot no modo de usuário e seu ambiente estiver configurado para usar SSO com o Azure Active Directory , isso permitirá 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 o URL de serviço padrão. Para habilitar essa opção, use ENFORCE_DEFAULT_SERVICE_URL=1. ORCHESTRATOR_URL também deve estar habilitado.
PROXY_SCRIPT_ADDRESS	Se você usar esse parâmetro, não use outros parâmetros específicos do proxy. Quando todos os parâmetros estão presentes no arquivo UiPath.config, apenas a chave ScriptAddress é usada.
PROXY_BYPASS_LOCAL_ADDRESS PROXY_BYPASS_LIST PROXY_USER_NAME PROXY_PASSWORD PROXY_DOMAIN	O endereço do servidor do proxy, seja nome de IP ou de domínio.Por exemplo, http://my.proxy.net:8008.
PROXY_ADDRESS PROXY_BYPASS_LIST	Permite conexão direta para endereços locais, ignorando o Servidor do Proxy. Defina-o como 1 para ignorar o endereço local ou como 0 de outra forma.
PROXY_ADDRESS PROXY_BYPASS_LOCAL_ADDRESS	A lista de endereços que se conectam diretamente à Internet, passando pelo Servidor do Proxy. Deve conter strings RegExr que contêm as URLs dos servidores para passagem. Por exemplo, "server.domain.local$;www.google.com;192.168.\d{1,3}.\d{1,3}".
PROXY_USER_NAME (requer PROXY_PASSWORD.)	A credencial de nome de usuário para autenticação do Servidor do Proxy.
PROXY_PASSWORD	A senha associada ao nome de usuário para autenticação do Servidor do Proxy.
PROXY_DOMAIN	O domínio onde o Servidor do Proxy reside, necessário para autenticação.

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 UiPathStudio.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 UiPathStudio.msi está localizado. Você pode fazer isso com o seguinte comando, como por exemplo: cd D:\UiPathInstaller.

• Instale o Studio, um Robô como um serviço do Windows e os pacotes de atividades - UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService
• Instalar o UiPath Studio e um Robot no modo de usuário apenas para o usuário atual -UiPathStudio.msi MSIINSTALLPERUSER=1 ADDLOCAL=Studio,Robot
• Instale a funcionalidade de transmissão ao vivo para versões do UiPath Robot 2024.10+ - UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService,LiveStreaming
• Instale todo o pacote de Desktop no modo silencioso - UiPathStudio.msi ADDLOCAL=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=Studio,Robot,RegisterService,ChromeExtension CHROME_INSTALL_TYPE=POLICYONLINE /Q
• Instale o Studio, o Robô como um serviço do Windows e os pacotes de atividades silenciosamente, todos na pasta D:\UiPath - UiPathStudio.msi ADDLOCAL=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=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=Studio,Robot,RegisterService CUSTOM_NUGET_FEEDS="Feed Name1,https://my.custom.nuget.feed; FeedName2,D:\RPA\Activities\Packages\" /Q
• Instale e licencie o Studio, um Robô registrado como um serviço do Windows e o feed de atividades locais no modo silencioso - UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService CODE=1234567890 /Q
• Instale o Robô como um serviço do Windows e desabilite os feeds oficiais online - UiPathStudio.msi ADDLOCAL=Robot,RegisterService NUGET_OPTIONS=DisableOnlineFeeds
• Desinstale a extensão para Chrome — UiPathStudio.msi REMOVE=ChromeExtension /Q
• Configure a conexão de atualização automática durante a instalação do Attended Robot - UiPathStudio.msi ADDLOCAL=Robot, SERVICE_URL="https://demo.uipath.com/myorg/mytenant"
• Configure a conexão de atualização automática durante a instalação do Unattended Robot - UiPathStudio.msi ADDLOCAL=Robot,RegisterService ORCHESTRATOR_URL="https://demo.uipath.com/myorg/mytenant/orchestrator_"