- Guia do Usuário
- Introdução
- Instalar os clientes da área de trabalho
- Instalar a partir da linha de comando
- Migrar do MSI clássico
- Adiar uma atualização
Instale os clientes para desktop da UiPath pela linha de comando no modo interativo ou silencioso, usando os parâmetros compatíveis do UiPathPlatform.msi e os arquivos de configuração.
É possível instalar os clientes da área de trabalho da UiPath com o UiPath Platform Installer (UiPathPlatform.msi) a partir da linha de comando, no modo totalmente interativo ou totalmente silencioso, usando os parâmetros do MSI compatíveis. O modo silencioso é destinado a implantações não assistidas. Para a instalação interativa, consulte Instalar os clientes da área de trabalho.
Sintaxe
msiexec /i UiPathPlatform.msi [PARAMETER=value ...] [/qn]
msiexec /i UiPathPlatform.msi [PARAMETER=value ...] [/qn]
Parâmetros são passados como PARAMETER=value pares após o caminho do pacote. Coloque valores que contêm espaços entre aspas duplas.
Modos de instalação
| Mode | Mudar | Description |
|---|---|---|
| Interativa completa | (omitir) | Executa o assistente de instalação com a UI completa. O usuário vê o progresso e quaisquer solicitações. |
| Totalmente silencioso | /qn | Executa sem interface do usuário e sem caixas de diálogo. Necessário para implantações não assistidas. |
Use /qn para instalações não assistidas. Os modos de UI parcial (/qb, /qr) não são compatíveis para cenários não assistidos, porque o instalador ainda pode exibir caixas de diálogo de bloqueio.
Parâmetros compatíveis
| Parâmetro | Valores | Padrão | Description |
|---|---|---|---|
FORCE_PERUSER | 1 | — | Força uma instalação por usuário, mesmo quando o usuário atual é um Administrator. |
CHANNEL | Nome do canal (por exemplo, sts) | sts | O canal de atualização que a plataforma segue. |
PLATFORM_CONFIGURATION_FILE | Caminho do arquivo absoluto | — | Caminho para um arquivo de configuração de produtos aplicado durante a instalação. |
UPDATER_CONFIGURATION_FILE | Caminho do arquivo absoluto | — | Caminho para um arquivo de configuração específico do atualizador aplicado durante a instalação. |
TELEMETRY_ENABLED | 1 = habilitado, 0 = desabilitado | enabled | Controla se os dados de telemetria são enviados. |
INSTALLER_LANGUAGE | de, en, es, es-MX, fr, ja, ko, pt-BR, pt, ro, ru, tr, zh-CN, zh-TW | Idioma do Sistema | Idioma da UI do assistente de instalação. Sem efeito no modo silencioso. |
Escopo da instalação
O instalador define como padrão uma instalação por usuário. Quando um Administrator o executa no modo interativo, ele é promovido automaticamente para uma instalação por máquina.
A UiPath recomenda uma instalação por máquina, que mantém os clientes da área de trabalho disponíveis para todos os usuários e gerenciados centralmente.
- Para forçar por usuário, mesmo para um Administrator, passe
FORCE_PERUSER=1. - Para uma instalação por máquina, execute msiexec a partir de uma solicitação de comando elevada (Administrator). Uma instalação silenciosa não é promovida automaticamente para por máquina.
Exemplos
Instalação interativa
Canal padrão, assistente completo:
msiexec /i UiPathPlatform.msi
msiexec /i UiPathPlatform.msi
Canal específico e arquivo de configuração:
msiexec /i UiPathPlatform.msi CHANNEL=sts PLATFORM_CONFIGURATION_FILE="C:\Config\platformConfig.json"
msiexec /i UiPathPlatform.msi CHANNEL=sts PLATFORM_CONFIGURATION_FILE="C:\Config\platformConfig.json"
Forçar por usuário para um Administrator:
msiexec /i UiPathPlatform.msi FORCE_PERUSER=1
msiexec /i UiPathPlatform.msi FORCE_PERUSER=1
Instalação silenciosa
Por usuário, canal padrão:
msiexec /i UiPathPlatform.msi /qn
msiexec /i UiPathPlatform.msi /qn
Instalação silenciosa com um canal específico, arquivo de configuração e telemetria desabilitados:
msiexec /i UiPathPlatform.msi CHANNEL=sts PLATFORM_CONFIGURATION_FILE="C:\Config\platformConfig.json" TELEMETRY_ENABLED=0 /qn
msiexec /i UiPathPlatform.msi CHANNEL=sts PLATFORM_CONFIGURATION_FILE="C:\Config\platformConfig.json" TELEMETRY_ENABLED=0 /qn
Instalação limpa por trás de um proxy corporativo (proxy fornecido por meio do arquivo de configuração do atualizador):
msiexec /i UiPathPlatform.msi UPDATER_CONFIGURATION_FILE="C:\Config\updaterConfig.json" /qn
msiexec /i UiPathPlatform.msi UPDATER_CONFIGURATION_FILE="C:\Config\updaterConfig.json" /qn
Arquivos de configuração
platformConfig.json (PLATFORM_CONFIGURATION_FILE)
Seleciona quais clientes da área de trabalho instalar e quaisquer parâmetros específicos do produto.
{
"Packages": [
{
"PackageName": "Studio",
"InstallRequested": true,
"Parameters": {
"INSTALL_ROBOTJS": "true",
"SERVICE_URL": "https://cloud.uipath.com/org/tenant/orchestrator_"
}
},
{
"PackageName": "BrowserExtensions",
"InstallRequested": true,
"Parameters": {
"INSTALL_CHROME_EXTENSION": "true",
"INSTALL_EDGE_EXTENSION": "true"
}
}
]
}
{
"Packages": [
{
"PackageName": "Studio",
"InstallRequested": true,
"Parameters": {
"INSTALL_ROBOTJS": "true",
"SERVICE_URL": "https://cloud.uipath.com/org/tenant/orchestrator_"
}
},
{
"PackageName": "BrowserExtensions",
"InstallRequested": true,
"Parameters": {
"INSTALL_CHROME_EXTENSION": "true",
"INSTALL_EDGE_EXTENSION": "true"
}
}
]
}
updaterConfig.json (UPDATER_CONFIGURATION_FILE)
Configura o atualizador. É aqui que as configurações de proxy são fornecidas. Em uma instalação por máquina, o proxy persiste para uso em todo o sistema.
Configuração de proxy mínima:
{
"Proxy": {
"ProxyAddress": "http://proxy.corp:8080",
"BypassLocalAddresses": true
}
}
{
"Proxy": {
"ProxyAddress": "http://proxy.corp:8080",
"BypassLocalAddresses": true
}
}
Proxy com autenticação e uma lista de ignoráveis:
{
"Proxy": {
"ProxyAddress": "http://proxy.corp:8080",
"BypassList": "localhost;*.corp.local",
"BypassLocalAddresses": true,
"UserName": "proxyuser",
"Password": "proxypassword",
"Domain": "CORP"
}
}
{
"Proxy": {
"ProxyAddress": "http://proxy.corp:8080",
"BypassList": "localhost;*.corp.local",
"BypassLocalAddresses": true,
"UserName": "proxyuser",
"Password": "proxypassword",
"Domain": "CORP"
}
}
Ou então, é possível usar um script de configuração automática de proxy (PAC) em vez de um endereço fixo:
{
"Proxy": {
"ScriptAddress": "http://proxy.corp/proxy.pac"
}
}
{
"Proxy": {
"ScriptAddress": "http://proxy.corp/proxy.pac"
}
}
ProxyAddress e ScriptAddress são mutuamente exclusivos. Se UserName estiver definido, Password também deve ser definido.