studio
2020.10
false
UiPath logo, featuring letters U and I in white
Fora do período de suporte

Guia do usuário do Studio

Última atualização 20 de dez de 2023

Parâmetros de Linha de Comando

Descrições de Argumentos de Linha de Comando

É possível instalar ou atualizar o Studio ou Robot usando a linha de comando, desde que você possua o instalador UiPathStudio.msi. A tabela abaixo lista todos os parâmetros disponíveis que você pode usar, junto com alguns exemplos.
Observação:

As alterações em sua instância existente da UiPath Platform não podem ser feitas do Prompt de Comando, no modo silencioso. No entanto, fazer alterações no que é instalado ao executar uma atualização é totalmente suportado.

Os argumentos de linha de comando de instalação não funcionam no UiPathPlatformInstaller.exe.

São necessários direitos de administrador para executar esses comandos.

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 ADDLOCAL não for usado, as seguintes funcionalidades serão instaladas: Studio, o Robô no modo de serviço, os pacotes de atividades e o suplemento 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. Não pode ser usado sem DesktopFeature.
ExcelAddin — instala o Suplemento do Excel para o StudioX. Ele não pode ser usado sem o Studio.
Robot - instala o Robô no modo de usuário ou modo de serviço. 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.
UseLegacyTray - Instala a bandeja de robô legada em vez do UiPath Assistant.
Observação: para alternar para o Assistant após a instalação, execute REMOVE=UseLegacyTray.
Packages - Instala os pacotes de atividades. Não pode ser usado sem os DesktopFeature e Robot argumentos.
StartupLauncher - Executa o Robô na inicialização do Windows. Não pode ser usado sem os DesktopFeaturee Robot argumentos.
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 dure mais do que o normal. Não pode ser usado sem os DesktopFeature e Robot argumentos.
ChromeExtension - Instala a Extensão do UiPath Google Chrome. Não pode ser usado sem os DesktopFeature e Robot argumentos.
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 usado sem os DesktopFeature e Robot argumentos.
JavaScriptAddOn - Instala o suplemento de Incorporação do Navegador para o robô.

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.

PACKAGES_FOLDER

Permite que você altere o local de download dos seus fluxos de trabalho e suas dependências para o Studio e/ou o UiPath 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 se o Robô estiver instalado como um serviço ou no modo de usuário.

Para o Robô de Modo de Serviço, os pacotes são instalados simultaneamente em todos os usuários.

Observe que, para vários Robôs de Modo de Usuário instalados em uma máquina, a pasta dos pacotes não pode ser a mesma (como C:\Packages). Isso ocorre porque o primeiro Robô de Modo de Usuário que baixou e instala um pacote restringe o acesso do arquivo .XAML apenas para esse usuário, fazendo outros Robôs de Modo de Usuário nessa máquina não podem usar a pasta correspondente ou o pacote devido a privilégios suficientes.
Se você não fornecer esse parâmetro, a pasta padrão será %userProfile%\.nuget\packages.

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 robôs

É possível usar variáveis de ambiente, como %USERNAME% ou %USERPROFILE%. O caractere especial % precisa ser escapado da seguinte maneira:
  • 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.
Se seu usuário for uma conta de domínio do Active Directory, é recomendável que você especifique o nome do domínio na estrutura de pasta, como C:\packages\^%UserDomain^%.^%Username^%.

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

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.

A telemetria é habilitada por padrão para o Studio e o UiPath Robot, para desabilitá-la durante a instalação, use o seguinte valor para o parâmetro:

  • TELEMETRY_ENABLED=0
Observação: isso desabilita a telemetria para o Studio e o UiPath Robot.

Se você quiser reabilitar a telemetria, use 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,Packages ENABLE_PIP=1

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=DesktopFeature,Studio,Robot,RegisterService,Packages
  • Instale o Studio e um Robô no modo de usuário - UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot
  • Instale todo o pacote de Desktop no modo silencioso - UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService,Packages,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,Packages,ChromeExtension CHROME_INSTALL_TYPE=STORE /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=DesktopFeature,Studio,Robot,RegisterService,Packages 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
  • 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=DesktopFeature,Studio,Robot,RegisterService,Packages 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
  • Descrições de Argumentos de Linha de Comando
  • Exemplos

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.