- Benutzerhandbuch
- Einleitung
- Die Desktop-Clients installieren
- Über die Befehlszeile installieren
- Vom klassischen MSI migrieren
- Eine Aktualisierung verschieben
Sie können die UiPath-Desktop-Clients mit dem UiPath Platform Installer (UiPathPlatform.msi) über die Befehlszeile installieren, entweder im vollständig interaktiven oder vollständig stillen Modus und mithilfe der unterstützten MSI-Parameter. Der Silent-Modus ist für unbeaufsichtigte Bereitstellungen vorgesehen. Die interaktive Installation finden Sie unter Installieren der Desktop-Clients.
Syntax
msiexec /i UiPathPlatform.msi [PARAMETER=value ...] [/qn]
msiexec /i UiPathPlatform.msi [PARAMETER=value ...] [/qn]
Parameter werden als PARAMETER=value-Paare nach dem Paketpfad übergeben. Setzen Sie Werte, die Leerzeichen enthalten, in doppelte Anführungszeichen.
Installationsmodi
| Mode | Umschalten (Switch) | Beschreibung |
|---|---|---|
| Vollständig interaktiv | (weglassen) | Führt den Installationsassistenten mit vollständiger Benutzeroberfläche aus. Der Benutzer sieht den Fortschritt und alle Prompts. |
| Vollständig im Hintergrund laufend | /qn | Läuft ohne Benutzeroberfläche und ohne Dialogfelder. Erforderlich für unbeaufsichtigte Bereitstellungen. |
Verwenden Sie /qn für unbeaufsichtigte Installationen. Teilbenutzeroberflächen-Modi (/qb, /qr) werden für unbeaufsichtigte Szenarien nicht unterstützt, da das Installationsprogramm möglicherweise weiterhin Blockierungsdialoge anzeigt.
Unterstützte Parameter
| Parameter | Values | Standard | Beschreibung |
|---|---|---|---|
FORCE_PERUSER | 1 | – | Erzwingt eine Installation pro Benutzer, auch wenn der aktuelle Benutzer ein Administrator ist. |
CHANNEL | Kanalname (z. B. sts) | sts | Update-Kanal, dem die Plattform folgt. |
PLATFORM_CONFIGURATION_FILE | Absoluter Dateipfad | – | Pfad zu einer Produktkonfigurationsdatei, die während der Installation angewendet wird. |
UPDATER_CONFIGURATION_FILE | Absoluter Dateipfad | – | Pfad zu einer aktualisierungsspezifischen Konfigurationsdatei, die während der Installation angewendet wird. |
TELEMETRY_ENABLED | 1 = aktiviert, 0 = deaktiviert | enabled | Steuert, ob Telemetriedaten gesendet werden. |
INSTALLER_LANGUAGE | de, en, es, es-MX, fr, ja, ko, pt-BR, pt, ro, ru, tr, zh-CN, zh-TW | Systemsprache | UI-Sprache des Installationsassistenten. Kein Effekt im stillen Modus. |
Installations-Scope
Das Installationsprogramm ist standardmäßig auf eine Installation pro Benutzer eingestellt.Wenn sie von einem Administrator im interaktiven Modus ausgeführt wird, wird sie automatisch zu einer Installation pro Maschine heraufgestuft.
UiPath empfiehlt eine Installation pro Maschine, bei der die Desktop-Clients für alle Benutzer verfügbar bleiben und zentral verwaltet werden.
- Um „Pro-Benutzer“ auch für einen Administrator zu erzwingen, übergeben Sie
FORCE_PERUSER=1. - Führen Sie für eine Installation pro Maschine „msiexec“ über eine erhöhte (Administrator)-Befehlszeile aus. Eine unbeaufsichtigte Installation wird nicht automatisch auf „pro Maschine“ umgestellt.
Beispiele
Interaktive Installation
Standardkanal, vollständiger Assistent:
msiexec /i UiPathPlatform.msi
msiexec /i UiPathPlatform.msi
Spezifischer Kanal und Konfigurationsdatei:
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"
Pro-Benutzer-Installation für einen Administrator erzwingen
msiexec /i UiPathPlatform.msi FORCE_PERUSER=1
msiexec /i UiPathPlatform.msi FORCE_PERUSER=1
Automatische Installation
Pro Benutzer, Standardkanal:
msiexec /i UiPathPlatform.msi /qn
msiexec /i UiPathPlatform.msi /qn
Stille Installation mit einem bestimmten Kanal, einer Konfigurationsdatei und deaktivierter Telemetrie:
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
Neuinstallation hinter einem Unternehmens-Proxy (Proxy, der über die Updater-Konfigurationsdatei bereitgestellt wird):
msiexec /i UiPathPlatform.msi UPDATER_CONFIGURATION_FILE="C:\Config\updaterConfig.json" /qn
msiexec /i UiPathPlatform.msi UPDATER_CONFIGURATION_FILE="C:\Config\updaterConfig.json" /qn
Konfigurationsdateien
platformConfig.json (PLATFORM_CONFIGURATION_FILE)
Wählt aus, welche Desktop-Clients installiert werden sollen, sowie alle produktspezifischen Parameter.
{
"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)
Konfiguriert den Updater. Hier werden die Proxyeinstellungen bereitgestellt. Bei einer Installation pro Maschine wird der Proxy für die systemweite Verwendung beibehalten.
Minimale Proxykonfiguration:
{
"Proxy": {
"ProxyAddress": "http://proxy.corp:8080",
"BypassLocalAddresses": true
}
}
{
"Proxy": {
"ProxyAddress": "http://proxy.corp:8080",
"BypassLocalAddresses": true
}
}
Proxy mit Authentifizierung und einer Bypass-Liste:
{
"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"
}
}
Alternativ kann ein Skript für die automatische Proxy-Konfiguration (PAC) anstelle einer festen Adresse verwendet werden:
{
"Proxy": {
"ScriptAddress": "http://proxy.corp/proxy.pac"
}
}
{
"Proxy": {
"ScriptAddress": "http://proxy.corp/proxy.pac"
}
}
ProxyAddress und ScriptAddress schließen sich gegenseitig aus. Wenn UserName festgelegt ist, muss auch Password festgelegt werden.