- Notas de Versão
- Introdução
- UiPath Assistant
- Instalação e atualização
- Sobre Compatibilidade direta e retroativa
- Requisitos de hardware e software
- Diretrizes de implantação
- Parâmetros de linha de comando de UiPathRobot.msi
- Implantação do AWS
- Implantação do Azure Marketplace
- Implantando robôs não assistidos -licença Community
- Implantando robôs não assistidos -licença Enterprise
- Atualizar o Robô
- Configurar o Windows Server para robôs de alta densidade
- Serviços aos quais o Robô se conecta
- Descrição do arquivo UiPath.Settings
- Tipos de Robô
- Componentes do Robô
- Licenciamento
- Conectar Robôs ao Orchestrator
- Processos e Atividades
- Geração de logs
- Robot JavaScript SDK
- Cenários Específicos
- Reinicialização de componentes dos Robots
- Sessões do Windows
- Login usando o Sistema de Credenciais Thales Luna
- Login usando o Provedor de Armazenamento de Chaves nShield
- Redirecionando Robôs por meio de um Servidor de Proxy
- Executando tarefas em uma Janela RDP Minimizada
- Usando Unidades de Rede Mapeadas
- Interrompendo um Processo
- Desabilitar o Botão Parar
- Pastas de Pacote Personalizados e Caminhos de Rede
- Integração do CrowdStrike
- Virtualização de aplicativos Robot Citrix
- Solução de problemas
- Erros de conexão comuns
- Robô sem resposta sobre RDP
- Logs de Execução Duplicados
- Erros de Robô Frequentemente Encontrados
- Aumento da Duração da Execução do Processo
- Verificação Forçada de Assinatura do Pacote
- Mensagem muito grande para processar
- Erros ao Executar como Administrador
- Pacotes do NuGet não acessíveis após a migração
- Prompt de Controle de Acesso do Usuário e de Automação de Atividades da Interface Gráfica
- .NET necessário durante a instalação
- Montagem não pode ser carregada da rede ou do Azure File Share
- As atividades não podem encontrar o .NET Runtime
Parâmetros de linha de comando de UiPathRobot.msi
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.
- São necessários direitos de administrador para executar esses comandos.
- Usar a opção
/passive
de msiexec.exe para executar uma instalação não assistida não é suportado.
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^%
.
- Quando a configuração é invocada a partir do Prompt de Comando, use
- 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"'
.
- Em Prompt de comando, envolva com aspas duplas (
Command |
Description |
---|---|
|
Ajuda você a instalar as funcionalidades UiPath® especificadas de forma silenciosa, sem exibir a interface do usuário. |
|
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. |
|
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 .
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 .
|
|
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. |
|
Permite que você instale o UiPath Robot em um local personalizado. |
|
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. |
|
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 obter informações sobre como alterar a pasta de download para pacotes após a instalação, consulte Gerenciando pacotes de atividades. |
|
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\" .
|
|
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:
Para informações sobre como aplicar a execução assinada após a instalação, consulte Pacotes de Assinatura. |
|
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 |
|
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:
Observação: os nomes de métodos de instalação antigos (
STORE , GLOBAL ) são mantidos para garantir a retrocompatibilidade.
|
|
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:
Observação: os nomes de métodos de instalação antigos (
STORE , GLOBAL ) são mantidos para garantir a retrocompatibilidade.
|
|
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:
Observação: esse parâmetro pode ser usado apenas durante uma instalação limpa ou uma atualização.
|
|
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).
|
|
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 ).
|
|
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:
Se você quiser habilitar a telemetria, não inclua o parâmetro ou inclua-o com o seguinte valor:
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. |
|
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:
Exemplo:
|
|
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:
|
ASSISTANT_OPTIONS | Permite que você especifique se deseja habilitar ou desabilitar o widget do Marketplace para o Assistant.
|
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 |
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"
)
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_"