robot
2023.10
false
UiPath logo, featuring letters U and I in white
Guia do usuário do robô
Last updated 25 de out de 2024

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 tabela a seguir lista todos os parâmetros de linha de comando disponíveis.

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"'.

Command

Description

/q

Ajuda você a instalar as funcionalidades UiPath® especificadas 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 ADDLOCAL não for usado, as seguintes funcionalidades serão instaladas: UiPath Robot no modo de serviço, os pacotes de atividades e o complemento JavaScript.

Ele oferece suporte para as seguintes opções:

DesktopFeature - indica que você deseja instalar a funcionalidade UiPath Robot.
Robot -instala o UiPath Robot no modo de usuário ou modo de serviço, bem como o Assistant. Não pode ser usado sem DesktopFeature.
  • 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 no que diz respeito 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 argumento Robot.
ChromeExtension - Instala a Extensão UiPath® Google Chrome. Não pode ser usada sem o argumento Robot.
FirefoxExtension — por exemplo, : UiPathRobot.msi ADDLOCAL=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 do Cliente UiPath® Citrix. Não pode ser usada sem o argumento Robot.
JavaScriptAddOn - Instala o suplemento de Incorporação do Navegador para o robô.
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.

MSIINSTALLPERUSER

Permite que você instale apenas para o usuário atual. Para instalar por usuário, adicione MSIINSTALLPERUSER=1. Para instalar por máquina, não inclua esse parâmetro.

As opções a seguir não estão disponíveis em instalações por usuário: RegisterService, CitrixExtension, VMwareExtension, PACKAGES_FOLDER e CODE.

APPLICATIONFOLDER

Permite que você instale o UiPath Robot 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® online para o UiPath Robot - apenas os feeds do Orchestrator e 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.

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.
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 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.

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 UiPath Robot pode baixar, instalar ou executar apenas o autor ou repositório de pacotes assinados pela UiPath®. Se quiser adicionar seu próprio certificado como uma fonte confiável, você precisa fazer isso modificando o arquivo nuget.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 UiPath Robot.

CLIENT_ID e CLIENT_SECRET

Conecta e instala automaticamente o Robô no Orchestrator usando as credenciais do cliente.

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 escolher o método de instalação para a extensão do Chrome. Este parâmetro requer que o instalador seja executado com direitos de administrador. Se for omitido, o método de instalação mais adequado é selecionado automaticamente.

Ele oferece suporte para 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 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.
Observação: os nomes de métodos de instalação antigos (STORE, GLOBAL) são mantidos para garantir a retrocompatibilidade.

EDGE_INSTALL_TYPE

Permite escolher o método de instalação para a extensão do Edge. Este parâmetro requer que o instalador seja executado com direitos de administrador. Se for omitido, o método de instalação mais adequado é selecionado automaticamente.

Ele oferece suporte para 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 de métodos de instalação antigos (STORE, GLOBAL) são mantidos para garantir a retrocompatibilidade.

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 UiPath Robot.

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

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 Desativação da Telemetria.

ENABLE_PIP

Permite habilitar a funcionalidade Picture in Picture da máquina durante a instalação da linha de comando UiPath®.

Para habilitá-la, use o seguinte parâmetro:

  • ENABLE_PIP=1

Exemplo:

UiPathRobot.msi ADDLOCAL=DesktopFeature,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
  • 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_OPTIONSPermite que você especifique se deseja habilitar ou desabilitar o widget do Marketplace para o Assistant.
  • 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_SIGNINSe 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

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"
):: 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.
  • Instalar o UiPath Robot no modo de usuário apenas para o usuário atual - UiPathRobot.msi MSIINSTALLPERUSER=1 ADDLOCAL=DesktopFeature,Robot
  • Instalar o UiPath Robot silenciosamente - UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService,StartupLauncher,JavaBridge /Q
  • Instalar o UiPath Robot e o Chrome Extension silenciosamente de acordo com a política - UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService,ChromeExtension CHROME_INSTALL_TYPE=POLICYONLINE /Q
  • Instale o Robot como um serviço do Windows no modo silencioso e conecte-o ao Orchestrator -

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

  • Instalar o UiPath Robot silenciosamente como um serviço do Windows e adicionar dois feeds de atividades personalizados - UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService CUSTOM_NUGET_FEEDS="Feed Name1,https://my.custom.nuget.feed; FeedName2,D:\RPA\Activities\Packages\" /Q
  • Instalar e licenciar um UiPath Robot silenciosamente registrado como um serviço do Windows e o feed de atividades local - UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService,CODE=1234567890 /Q
  • Instale o Robô como um serviço do Windows e desabilite os feeds oficiais online - UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService NUGET_OPTIONS=DisableOnlineFeeds
  • Desinstale a extensão para 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=DesktopFeature,Robot,RegisterService SERVICE_URL="https://demo.uipath.com/myorg/mytenant"

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

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

Esta página foi útil?

Obtenha a ajuda que você precisa
Aprendendo RPA - Cursos de automação
Fórum da comunidade da Uipath
Uipath Logo White
Confiança e segurança
© 2005-2024 UiPath. Todos os direitos reservados.