UiPathRobot.msi-Befehlszeilenparameter

Sie können den Roboter installieren, indem Sie das UiPathRobot.msi-Installationsprogramm über die Befehlszeile ausführen.

In den folgenden Abschnitten finden Sie Beschreibungen der verfügbaren Parameter und einige Anwendungsbeispiele.

Hinweis:

• Zur Durchführung dieser Anweisungen sind Administratorrechte erforderlich.
• Die Verwendung der /passive-Option von msiexec.exe zur Ausführung einer Unattended-Installation wird nicht unterstützt.

Beschreibung der Kommandozeilenargumente

Die folgende Liste zeigt alle verfügbaren Befehlszeilenparameter an.

• /q– Installiert die angegebenen UiPath-Funktionen still, ohne die Benutzeroberfläche anzuzeigen.
• /l*vx <LogFile> – Generiert eine Installationsprotokolldatei am angegebenen Pfad. Sie können die Datei an unser Support-Team senden, wenn aus irgendeinem Grund während des Installationsprozesses Schwierigkeiten auftreten.
• ADDLOCAL – Ermöglicht die Auswahl der zu installierenden Funktionen. Ohne diesen Parameter werden folgende Funktionen standardmäßig installiert: Roboter im Servicemodus, Standardaktivitätspakete und JavaScript Add-on. Es unterstützt die folgenden Optionen:
  • Studio (exclusively for UiPathStudio.msi) — Installs Studio.
  • ExcelAddin (exklusiv für UiPathStudio.msi) – Installiert das StudioX Excel Add-in. Muss zusammen mit dem Parameter Studioverwendet werden.
  • Robot — Installs the Robot in User Mode or Service Mode, as well as the Assistant.
  • RegisterService – Erforderlich für Installationen im Servicemodus. Fügen Sie es nicht für Installationen im Benutzermodus hinzu.
  • StartupLauncher — Runs the Robot at Windows startup.
  • JavaBridge – Installiert die UiPath Java Bridge für eine bessere Integration und Automatisierung mit Java-Anwendungen. Das Hinzufügen kann die Installationszeit verlängern. Muss zusammen mit dem Parameter Robotverwendet werden.
  • ChromeExtension – Installiert die Google Chrome-Erweiterung. Muss zusammen mit dem Parameter Robotverwendet werden.
  • FirefoxExtension – Installiert die Firefox-Erweiterung. Muss zusammen mit dem Parameter Robotverwendet werden.
  • EdgeExtension – Installiert die Microsoft Edge Chromium-basierte Erweiterung. Muss zusammen mit dem Parameter Robotverwendet werden.
  • CitrixClient – Installiert die UiPath Citrix Client Extension. Muss zusammen mit dem Parameter Robot verwendet werden. Für Installationen pro Benutzer nicht verfügbar.
  • JavaScriptAddOn – Installiert das Add-on für die Browser-Einbettung. Muss zusammen mit dem Parameter Robot verwendet werden. Kann nicht mit erhöhten Rechten verwendet werden.
  • SapPlugin (exklusiv für UiPathStudio.msi) – Installiert das SAP Lösung Manager-Plugin.Erfordert, dass der SAP Connector für Microsoft auf Ihrer Maschine installiert ist. Bei Neuinstallationen müssen Sie auch eine Adresse für die Instanz mit dem Parameter SAP_SOL_MAN_HOST angeben. Muss zusammen mit dem Parameter Studio verwendet werden. Für Installationen pro Benutzer nicht verfügbar.
  • VMwareExtension – Installiert die UiPath-Erweiterung für VMware Horizon. Muss zusammen mit dem Parameter Robotverwendet werden. Für Installationen pro Benutzer nicht verfügbar.
  • WindowsRdpExtension – Installiert die UiPath-Erweiterung für Windows Remote Desktop. Muss zusammen mit dem Parameter Robotverwendet werden.
• MSIINSTALLPERUSER – Ermöglicht die Installation nur für den aktuellen Benutzer.
  • Für eine Installation auf Benutzerebene fügen Sie MSIINSTALLPERUSER=1 hinzu. Die folgenden Optionen sind in Installationen pro Benutzer nicht verfügbar: RegisterService, CitrixExtension, VMwareExtension, PACKAGES_FOLDER, CODE.
  • Für die Installation pro Maschine sollten Sie diesen Parameter nicht einschließen.
• SAP_SOL_MAN_HOST (exklusiv für UiPathStudio.msi) – Der Hostname oder die IP-Adresse Ihrer SAP Lösung Manager-Instanz.Erforderlich für saubere Installationen, bei denen der Parameter SapPlugin in der Option ADDLOCAL hinzugefügt wurde.
• APPLICATIONFOLDER – Ermöglicht es Ihnen, den Roboter an einem benutzerdefinierten Speicherort zu installieren.
• NUGET_OPTIONS – Für Offline-Umgebungen. Wenn dieser Parameter auf DisableOnlineFeeds festgelegt ist, deaktiviert er die offiziellen Online-Feeds von UiPath und die Community-Feeds für den Roboter und verwendet ausschließlich Orchestrator und lokale Feeds.
  Hinweis:

  Die URL-Feeds verbleiben in den Konfigurationsdateien, werden jedoch ignoriert.

• PACKAGES_FOLDER
  • Ermöglicht es Ihnen, den Speicherort für Ihre Workflows und deren Abhängigkeiten zu ändern.Der gewählte Ordner kann benutzerspezifisch sein oder für alle Benutzer einer Maschine zugänglich sein.
  • Ohne diesen Parameter ist %userProfile%\.nuget\packages als Standardspeicherort für den Download festgelegt.
  • Für Installationen pro Benutzer nicht verfügbar.
    Hinweis:

    Stellen Sie sicher, dass alle Benutzer, die Prozesse ausführen müssen, Lesezugriff auf den neuen Ordner haben.

  • Für Installationen auf Windows Server-Maschinen, die die gleichzeitige Ausführung aktivieren, müssen Sie für jeden Benutzer spezifische Pfade bereitstellen.Erfahren Sie mehr über .
  • Erfahren Sie, wie Sie den Downloadordner für Pakete nach der Installation ändern.
• CUSTOM_NUGET_FEEDS – Ermöglicht das Hinzufügen benutzerdefinierter NuGet-Aktivitätsfeeds für Studio und/oder Robot Dieser Befehl fügt nur die vorhandenen Feeds hinzu oder aktualisiert sie. Es muss mit Schlüssel-Wert-Paaren des Typs Zeichenfolge gefüllt werden:
  • Gültige Speicherorte sind Online-Feeds, Ordnerpfade und freigegebene Netzwerklaufwerke.
  • Stellen Sie sicher, dass die bereitgestellten Feeds für alle Benutzer auf einer bestimmten Maschine zugänglich sind.
  • Separate Feeds mit Semikolons (;). Zum Beispiel:

    CUSTOM_NUGET_FEEDS="FeedName1,https://my.custom.nuget.feed; FeedName2,D:\Custom\Activities\Packages\"
    

• ENFORCE_SIGNED_EXECUTION – Optional. Ermöglicht Ihnen, die Ausführung nur signierter Pakete durch Ihre Robots zu erzwingen. Ohne diesen Parameter ist die Paketsignierung nicht aktiviert. Es hat folgende Optionen:
  • 1 – Der Roboter verarbeitet nur Pakete, die von UiPath-verifizierten Autoren oder Repositorys signiert sind.Um Ihr eigenes Zertifikat als vertrauenswürdige Quelle hinzuzufügen, ändern Sie die Datei nuget.config.
  • 0– Bei Ihrer Roboterbereitstellung wird keine Paket-Signaturregel erzwungen. Weitere Informationen finden Sie unter Paket-Signatur.
• CODE – Lizenziert Ihre Roboter-Instanz.Für Installationen pro Benutzer nicht verfügbar.
• CLIENT_ID und CLIENT_SECRET – Verbindet den Roboter automatisch mit dem Orchestrator über Client-Anmeldeinformationen und installiert ihn. Zum Beispiel:

  UiPathRobot.msi ORCHESTRATOR_URL=https://demo.uipath.com/company/tenant/orchestrator_ CLIENT_ID=1234-abcd-1ab2-cd32-1111 CLIENT_SECRET=2143ndafj32k
  

• CHROME_INSTALL_TYPE – Ermöglicht es Ihnen, die Installationsmethode für die Chrome-Erweiterung auszuwählen. Erfordert Administratorrechte. Ohne diesen Parameter wird automatisch die am besten geeignete Methode ausgewählt. Es hat folgende Optionen:
  • POLICYOFFLINE – Die Installation der Chrome-Erweiterung erfolgt automatisch pro System über die Offline-Methode der Gruppenrichtlinie, was dem Aufruf des Befehls /Chrome-Policy-Offline mit dem SetupExtensions-Tool entspricht.
  • POLICYONLINE – Die Installation der Edge-Erweiterung erfolgt automatisch pro System über die Online-Methode der Gruppenrichtlinie, was dem Aufruf des Befehls /Edge-Chromium-PolicyGlobal mit dem SetupExtensions-Tool entspricht.
  • MANUALPERMACHINE – Die Chrome-Erweiterung wird für alle Benutzer installiert, was dem Aufruf des Befehls /ChromeGlobal mit dem SetupExtensions-Tool entspricht.
  • NATIVEHOSTONLY – Nur die Native Messaging Host-Komponente (ChromeNativeMessaging.exe) wird installiert, was dem Aufruf des Befehls /ChromeNativeHostGlobal mit dem SetupExtensions-Tool entspricht.
  Hinweis:

  Die alten Installationsmethodennamen (STORE, GLOBAL) werden aus Gründen der Abwärtskompatibilität beibehalten.

• EDGE_INSTALL_TYPE – Ermöglicht es Ihnen, die Installationsmethode für die Edge-Erweiterung auszuwählen. Erfordert Administratorrechte. Ohne diesen Parameter wird automatisch die am besten geeignete Methode ausgewählt. Es hat folgende Optionen:
  • POLICYOFFLINE – Die Installation der Edge-Erweiterung erfolgt automatisch pro System über die Offline-Methode der Gruppenrichtlinie, was dem Aufruf des Befehls /Edge-Policy-Offline mit dem SetupExtensions-Tool entspricht.
  • POLICYONLINE – Die Installation der Edge-Erweiterung erfolgt automatisch pro System über die Online-Methode der Gruppenrichtlinie, was dem Aufruf des Befehls /Edge-Chromium-PolicyGlobal mit dem SetupExtensions-Tool entspricht.
  • MANUALPERMACHINE – Die Edge-Erweiterung wird für alle Benutzer installiert, was dem Aufruf des Befehls /Edge-Chromium-Global mit dem SetupExtensions-Tool entspricht.
  • NATIVEHOSTONLY – Nur die Native Messaging Host-Komponente (ChromeNativeMessaging.exe) wird installiert, was dem Aufruf des Befehls /Edge-Chromium-NativeHostGlobal mit dem SetupExtensions-Tool entspricht.
  Hinweis:

  Die alten Installationsmethodennamen (STORE, GLOBAL) werden aus Gründen der Abwärtskompatibilität beibehalten.

• DISABLE_SECURE_XAML – Ermöglicht es Ihnen, die Sicherheit von XAMLDateien für Roboter zu deaktivieren, die als Windows-Dienst installiert sind. Ungesicherte XAML Dateien ermöglichen es Benutzern, die Prozessdateien und die Logik zu lesen und zu ändern. Es hat folgende Optionen:
  • 0 – Die Standardoption. Aktiviert die Sicherheit von XAMLDateien für Windows-Dienstprogramme.
  • 1: Deaktiviert die Sicherheit von XAML-Dateien für Windows-Dienstroboter.
• SERVICE_URL – Ermöglicht es Ihnen, die URL der Orchestrator-Instanz zu definieren, mit der Sie eine Verbindung über die interaktive Anmeldung herstellen möchten. Dieser Wert wird in der uipath.configDatei gespeichert.Erforderlich für Installationen im Benutzermodus. Installationen im Servicemodus ignorieren diesen Parameter.
• ORCHESTRATOR_URL – In sauberen Installationen können Sie die Orchestrator-Haupt-URL angeben, die zum Abrufen von Informationen zur automatischen Aktualisierung verwendet wird. Zum Beispiel: https://orchestrator.local/organizationName/tenantName.
• TELEMETRY_ENABLED – Ermöglicht es Ihnen, die Nutzungsdatenerfassung zu deaktivieren. Es hat folgende Optionen:
  • 0– Deaktiviert die Telemetrie für Studio und Roboter.
  • 1 – Standardoption. Aktiviert die Telemetrie für Studio und Roboter. Erfahren Sie, wie Sie sich von der Telemetrie abmelden können.
• ENABLE_PIP – Ermöglicht das Aktivieren der Funktionalität der Robotersitzung (Bild in Bild) der Maschine. Es hat folgende Optionen:
  • 0 – Standardoption. Die Funktion Robot-Session ist deaktiviert.
  • 1– Aktiviert die Funktion Roboter-Sitzung.
• INSTALLER_LANGUAGE – Ermöglicht es Ihnen, die Anzeigesprache des Installationsprogramms auszuwählen. Ohne diesen Parameter verwendet das Installationsprogramm die Spracheinstellungen in Windows. Es hat folgende Optionen:
  • 2052 – Chinesisch (vereinfacht)
  • 12 – Französisch
  • 7 – Deutsch
  • 17 – Japanisch
  • 1 – Koreanisch
  • 22 – Portugiesisch (Portugal)
  • 1046 – Portugiesisch (Brasilien)
  • 25 – Russisch
  • 10 – Spanisch (Spanien)
  • 2058 – Spanisch (Mexiko)
  • 31 – Türkisch
• ASSISTANT_OPTIONS – Aktiviert oder deaktiviert das Marketplace Widget für Assistant. Es hat folgende Optionen:
  • Abwesend oder EnableMarketplace – Die Standardoption. Aktiviert das Widget.
  • DisableMarketplace – Deaktiviert das Widget.
• ORCHESTRATOR_AUTO_SIGNIN – Aktiviert die automatische Anmeldung bei Ihrem Konto. Für Installationen und Umgebungen im Benutzermodus, die für die SSO mit Azure Active Directory konfiguriert sind.Muss zusammen mit dem Parameter ORCHESTRATOR_URL verwendet werden. Es hat folgende Optionen:
  • 0 – Deaktiviert die automatische Anmeldung.
  • 1 – Aktiviert die automatische Anmeldung.

Verwenden von Pfaden in der Befehlszeile

Beachten Sie bei der Eingabe von Pfaden Folgendes:

• Es besteht die Möglichkeit, Umgebungsvariablen wie etwa %USERNAME% oder %USERPROFILE% anzugeben. Beim Sonderzeichen % ist Escaping folgendermaßen durchzuführen:
  • Wenn das Setup von der Eingabeaufforderung aus aufgerufen wird, verwenden Sie ^ – UiPathRobot.msi PACKAGES_FOLDER=C:\Some\Path\^%USERNAME^%.
  • Verwenden Sie in Batch-Skripts ^ – UiPathRobot.msi PACKAGES_FOLDER=C:\Some\Path\^%USERNAME^%.
  • In PowerShell Console oder Skripts: kein Escaping erforderlich.
  • Wenn Ihr Benutzer Teil eines Active Directory-Domänenkontos ist, empfehlen wir, ebenfalls die Domäne in der Ordnerstruktur zu verwenden, wie etwa C:\packages\^%UserDomain^%.^%Username^%.
• Wenn Sie Pfade mit Leerzeichen verwenden müssen, müssen sie wie folgt umgebrochen werden:
  • In der Eingabeaufforderung umgeben Sie sie mit doppelten Anführungszeichen (" "). Zum Beispiel: UiPathRobot.msi APPLICATIONFOLDER="C:\folder name".
  • In PowerShell mit einfachen und doppelten Anführungszeichen ('" "') umgeben. Zum Beispiel: ./UiPathRobot.msi APPLICATIONFOLDER='"C:\folder name"'.

Durchführen einer synchronen Installation

Wenn Sie nach Abschluss der Installation weitere Konfigurationen vornehmen möchten, können Sie das Installationsprogramm synchron ausführen. Auf diese Weise können Sie weitere Befehle hinzufügen, die nach Beendigung des Installationsprogramms ausgeführt werden, z. B. können Sie eine Roboterverbindung einrichten oder Feeds konfigurieren.

Die folgenden Skripte führen die Installation durch und ermöglichen es Ihnen, weitere Befehle hinzuzufügen, die bei erfolgreicher Installation ausgeführt werden sollen.

:: 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"
)

Beispiele

Diese Beispiele wurden unter der Annahme erstellt, dass Sie schon in dem Verzeichnis sind, in dem sich der Installer UiPathRobot.msi befindet. Sie können dies mit dem folgenden Befehl machen, zum Beispiel: cd D:\UiPathInstaller.

• Installieren Sie den Roboter nur für den aktuellen Benutzer im Benutzermodus.

  UiPathRobot.msi MSIINSTALLPERUSER=1 ADDLOCAL=Robot
  

• Installieren Sie den Roboter lautlos.

  UiPathRobot.msi ADDLOCAL=Robot,RegisterService,StartupLauncher,JavaBridge /Q
  

• Installieren Sie den Roboter und die Chrome-Erweiterung über eine Richtlinie.

  UiPathRobot.msi ADDLOCAL=Robot,RegisterService,ChromeExtension CHROME_INSTALL_TYPE=POLICYONLINE /Q
  

• Installieren Sie den Roboter als Windows-Dienst und verbinden Sie ihn mit Orchestrator.

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

• Installieren Sie den Roboter als Windows-Dienst und fügen Sie zwei benutzerdefinierte Aktivitäten hinzu.

  UiPathRobot.msi ADDLOCAL=Robot,RegisterService CUSTOM_NUGET_FEEDS="Feed Name1,https://my.custom.nuget.feed; FeedName2,D:\RPA\Activities\Packages\" /Q
  

• Installieren und lizenzieren Sie einen als Windows-Dienst registrierten Roboter und die lokale Aktivität.

  UiPathRobot.msi ADDLOCAL=Robot,RegisterService,CODE=1234567890 /Q
  

• Installieren Sie den Roboter als Windows-Dienst und deaktivieren Sie die offiziellen Online-Feeds.

  UiPathRobot.msi ADDLOCAL=Robot,RegisterService NUGET_OPTIONS=DisableOnlineFeeds
  

• Deinstallieren Sie die Chrome-Erweiterung.

  UiPathRobot.msi REMOVE=ChromeExtension /Q
  

• Richten Sie die Verbindung zur automatischen Aktualisierung während der Installation des Attended Robot ein.

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

• Richten Sie die Verbindung zur automatischen Aktualisierung während der Installation des Unattended Robot ein.

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