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

In der folgenden Tabelle sind alle verfügbaren Befehlszeilenparameter aufgeführt.

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"'.

Befehl	Beschreibung
/q	Hilft Ihnen, die angegebenen UiPath-Funktionen im Hintergrund zu installieren, ohne die Benutzeroberfläche anzuzeigen.
/l*vx <LogFile>	Erstellt eine Installationsprotokolldatei am angegebenen Pfad. Sie können die Datei an unser Supportteam weitersenden, wenn Sie aus irgendwelchen Gründen Probleme während des Installationsvorgangs haben.
ADDLOCAL	Ermöglicht Ihnen das Auswählen von Funktionen, die Sie installieren möchten. Wenn ADDLOCAL verwendet wird, werden nur die darin angegebenen Funktionen installiert. Wenn ADDLOCAL nicht verwendet wird, werden die folgenden Funktionen installiert: der Roboter im Dienstmodus, die Aktivitätspakete und das JavaScript-Add-on. Es unterstützt die folgenden Optionen: DesktopFeature – Zeigt an, dass Sie die Roboterfunktion installieren möchten. Robot – Installiert den Robot im Benutzermodus oder Dienstmodus sowie den Assistant. Kann nicht ohne DesktopFeature verwendet werden. Um den Roboter im Dienstmodus zu installieren, fügen Sie auch die Option RegisterService hinzu. Das ist die empfohlene Wahl für Unattended-Roboter. Um den Robot im Benutzermodus zu installieren, fügen Sie nicht die Option RegisterService hinzu. Dies ist die empfohlene Wahl für Attended- und Development-Roboter. Hinweis: Beim Konvertieren des Roboters vom Dienstmodus in den Benutzermodus kann der Roboter möglicherweise nicht auf die .xaml-Dateien aus dem ursprünglichen NuGet-Paketordner zugreifen. Weitere Informationen zur Behebung finden Sie im Artikel zur Problembehandlung für NuGet-Pakete, auf die nach der Migration nicht zugegriffen werden kann. StartupLauncher – Führt den Roboter beim Start von Windows aus. Die Verwendung ohne das Argument Robot ist nicht möglich. JavaBridge – Installiert UiPath Java Bridge für eine bessere Integration und Automatisierung in Bezug auf Java-Anwendungen. Hinweis: Durch die Installation von Java Bridge kann die Installation länger als üblich dauern. Die Verwendung ohne das Argument Robot ist nicht möglich. ChromeExtension – Installiert die UiPath Google Chrome-Erweiterung. Die Verwendung ohne das Argument Robot ist nicht möglich. FirefoxExtension – z. B. : UiPathRobot.msi ADDLOCAL=Robot,ChromeExtension,FirefoxExtension /Q EdgeExtension – Installiert die UiPath Microsoft Edge Chromium-basierte Erweiterung. Die Verwendung ohne das Argument Robot ist nicht möglich. CitrixClient – Installiert die UiPath Citrix Client-Erweiterung. Die Verwendung ohne das Argument Robot ist nicht möglich. JavaScriptAddOn – Installiert das Add-on „Browser Embedding“ für den Roboter. VMwareExtension – Installiert die UiPath-Erweiterung für VMware Horizon. Die Verwendung ohne das Argument Robot ist nicht möglich. WindowsRdpExtension – Installiert die UiPath-Erweiterung für Microsoft Remote Desktop. Die Verwendung ohne das Argument Robot ist nicht möglich.
MSIINSTALLPERUSER	Ermöglicht Ihnen die Installation nur für den aktuellen Benutzer. Für eine Installation auf Benutzerebene fügen Sie MSIINSTALLPERUSER=1 hinzu. Für eine Installation auf Maschinenebene lassen Sie diesen Parameter weg. Die folgenden Optionen sind in Installationen pro Benutzer nicht verfügbar: RegisterService, CitrixExtension, VMwareExtension, PACKAGES_FOLDER, CODE.
APPLICATIONFOLDER	Ermöglicht Ihnen die Installation von Robot an einem benutzerdefinierten Speicherort.
NUGET_OPTIONS	Dieser Parameter wird empfohlen, wenn Sie in einer Offline-Umgebung arbeiten. Wenn dieser Parameter auf DisableOnlineFeeds eingestellt ist, hilft er Ihnen, die offiziellen UiPath Online- und Community-Feeds für den Roboter zu deaktivieren - nur die Orchestrator- und lokalen Feeds werden berücksichtigt. Bitte beachten Sie, dass die URL-Feeds nicht aus den Konfigurationsdateien gelöscht, sondern nur ignoriert werden. Kann sowohl für Installationen als auch für Aktualisierungen verwendet werden.
PACKAGES_FOLDER	Ermöglicht es Ihnen, den Speicherort zum Herunterladen Ihrer Workflows und deren Abhängigkeiten für Studio und/oder Robot zu ändern. Dieser Ordner kann benutzerspezifisch oder für alle Benutzer von einer Maschine aus zugänglich sein. Dieser Parameter kann sowohl für Roboter im Dienstmodus als auch im Benutzermodus verwendet werden. Wenn Sie diesen Parameter nicht angeben, ist der Standardordner %userProfile%\.nuget\packages. Hinweis: Stellen Sie beim Ändern des Paketordners sicher, dass alle Benutzer, die Prozesse ausführen müssen, über Lesezugriff auf diesen Ordner verfügen. Hinweis: Bei der Verwendung des Parameters PACKAGES_FOLDER gibt es einige Einschränkungen. Weitere Informationen finden Sie in der Dokumentation zu benutzerdefinierten Paketordnern und Netzwerkpfaden. Für Installationen auf Windows Server-Maschinen (die eine gleichzeitige Ausführung ermöglichen – HD-Roboter) müssen Sie für jeden Benutzer spezifische Pfade angeben. Lesen Sie mehr über die Verwendung desselben Pfads für mehrere Roboter. Informationen zum Ändern des Downloadordners für Pakete nach der Installation finden Sie unter Verwalten von Aktivitätspaketen.
CUSTOM_NUGET_FEEDS	Ermöglicht Ihnen, für Studio und/oder Robot benutzerdefinierte NuGet-Aktivitäts-Feeds hinzuzufügen. Dieser Befehl fügt nur die vorhandene Feed-Liste hinzu oder aktualisiert sie. Muss mit Schlüsselwertpaaren vom Typ Zeichenfolge ausgefüllt sein. Gültige Speicherorte sind nur Onlinefeeds, Ordnerpfade und gemeinsam verwendete Netzwerklaufwerke. Achten Sie darauf, dass die bereitgestellten Feeds für alle Benutzer eines bestimmten Computers zugänglich sind. Die Trennung der Feeds erfolgt mit Semikolon (;). 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 ausschließlich signierter Pakete durch Ihre Roboter zu erzwingen. Kann sowohl bei sauberen Installationen als auch für Aktualisierungen Ihrer Instanzen verwendet werden. Wenn dieser Parameter bei der Bereitstellung nicht angegeben wird, ist die Paketsignierung nicht aktiviert. Es unterstützt die folgenden Optionen: 1 – Der Roboter kann nur Pakete herunterladen, installieren oder ausführen, die von UiPath genehmigt oder im Repository signiert wurden. Wenn Sie Ihr eigenes Zertifikat als vertrauenswürdige Quelle hinzufügen möchten, müssen Sie dazu die Datei nuget.config ändern. Auf dieser Seite erfahren Sie, wie man das macht. 0 - Auf Ihrer Roboterbereitstellung wird keine Paketsignierungsregel erzwungen. Informationen zum Erzwingen der signierten Ausführung nach der Installation finden Sie unter Signieren von Paketen.
CODE	Lizenzen für Ihre Roboterinstanz.
CLIENT_ID und CLIENT_SECRET	Verbindet den Roboter automatisch mit dem Orchestrator mithilfe von Client-Anmeldeinformationen, während er gleichzeitig installiert wird. 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 Ihnen die Auswahl der Installationsmethode für die Chrome-Erweiterung. Dieser Parameter erfordert, dass das Installationsprogramm mit Administratorrechten ausgeführt wird. Wenn Sie diese Option nicht wählen, wird automatisch die am besten geeignete Installationsmethode ausgewählt. Es unterstützt die folgenden 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 Chrome-Erweiterung erfolgt automatisch pro System über die Online-Methode der Gruppenrichtlinie, was dem Aufruf des Befehls /ChromePolicyGlobal 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 für die Abwärtskompatibilität beibehalten.
EDGE_INSTALL_TYPE	Ermöglicht Ihnen die Auswahl der Installationsmethode für die Edge-Erweiterung. Dieser Parameter erfordert, dass das Installationsprogramm mit Administratorrechten ausgeführt wird. Wenn Sie diese Option nicht wählen, wird automatisch die am besten geeignete Installationsmethode ausgewählt. Es unterstützt die folgenden 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 für die Abwärtskompatibilität beibehalten.
DISABLE_SECURE_XAML	Ermöglicht Ihnen das Deaktivieren der Sicherheit von XAML-Dateien für als Windows-Dienst installierte Roboter. Ungesicherte XAML-Dateien ermöglichen Benutzern das Lesen und Ändern der Prozessdateien und der Logik. Es unterstützt die folgenden Optionen: 0: Die Standardoption. Wenn sie verwendet wird, aktiviert sie die Sicherheit von XAML-Dateien für Windows-Dienstroboter. 1: Deaktiviert die Sicherheit von XAML-Dateien für Windows-Dienstroboter. Hinweis: Dieser Parameter kann nur während einer Neuinstallation oder eines Updates verwendet werden.
SERVICE_URL	Ermöglicht es Ihnen, die URL der Orchestrator-Instanz zu definieren, mit der Benutzer mithilfe der interaktiven Anmeldung eine Verbindung herstellen. Die bereitgestellte URL wird in der uipath.config-Datei gespeichert und nur für Roboter im Benutzermodus gespeichert. Bei Installationen im Servicemodus wird das Argument ignoriert. Wenn Sie das Installationsprogramm ausführen, um von einer älteren Version zu aktualisieren oder Ihre vorhandene Installation zu ändern, wird dieser Parameter unterstützt, wenn Sie den Robot vom Dienstmodus in den Benutzermodus wechseln (die Option RegisterService ist nicht enthalten).
ORCHESTRATOR_URL	Bei einer Neuinstallation können Sie die Haupt-Orchestrator-URL angeben, die zum Abrufen von Informationen für automatische Updates verwendet wird (z. B. https://orchestrator.local/organizationName/tenantName).
TELEMETRY_ENABLED	Ermöglicht es Ihnen, die Sammlung von Nutzungsdaten zu deaktivieren und kann zur Installationszeit für den Roboter durchgeführt werden. Telemetrie ist standardmäßig für Studio und Robot aktiviert. Um es zu deaktivieren, verwenden Sie den folgenden Wert für den Parameter, wenn Sie eine Neuinstallation oder ein Update durchführen: TELEMETRY_ENABLED=0 Wenn Sie die Telemetrie aktivieren wollen, lassen Sie den Parameter weg oder fügen Sie ihn mit dem folgenden Wert ein: TELEMETRY_ENABLED=1 Weitere Informationen zur Erfassung von Nutzungsdaten und zum Ändern der Telemetrieeinstellungen finden Sie im Dokument Telemetrie abwählen.
ENABLE_PIP	Ermöglicht es Ihnen, die Bild-in-Bild-Funktion der Maschine während der Installation per UiPath-Befehlszeile zu aktivieren. Verwenden Sie zum Aktivieren den folgenden Parameter: ENABLE_PIP=1 Beispiel: UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService ENABLE_PIP=1
INSTALLER_LANGUAGE	Ermöglicht Ihnen die Auswahl der Anzeigesprache des Installationsprogramms. Wenn nicht angegeben, bestimmen die Spracheinstellungen in Windows die Sprache des Installationsprogramms. Um die Sprache anzugeben, geben Sie den Parameter INSTALLER_LANGUAGE=<language_code> ein. Die folgenden Optionen sind verfügbar: Chinesisch (vereinfacht): INSTALLER_LANGUAGE=2052 Französisch: INSTALLER_LANGUAGE=12 Deutsch: INSTALLER_LANGUAGE=7 Japanisch: INSTALLER_LANGUAGE=17 Koreanisch: INSTALLER_LANGUAGE=1 Portugiesisch (Portugal): INSTALLER_LANGUAGE=22 Portugiesisch (Brasilien): INSTALLER_LANGUAGE=1046 Russisch: INSTALLER_LANGUAGE=25 Spanisch (Spanien): INSTALLER_LANGUAGE=10 Spanisch (Mexiko): INSTALLER_LANGUAGE=2058 Türkisch: INSTALLER_LANGUAGE=31
ASSISTANT_OPTIONS	Hier können Sie angeben, ob das Marketplace-Widget für den UiPath Assistant aktiviert oder deaktiviert werden soll. Um das Widget zu aktivieren, verwenden Sie ASSISTANT_OPTIONS=EnableMarketplace oder lassen Sie den Parameter weg. Um das Widget zu deaktivieren, verwenden Sie ASSISTANT_OPTIONS=DisableMarketplace.
ORCHESTRATOR_AUTO_SIGNIN	Wenn Sie den Attended-Roboter im Benutzermodus installieren und Ihre Umgebung für die Verwendung von SSO mit Azure Active Directory konfiguriert ist, können Sie die automatische Anmeldung bei Ihrem Konto aktivieren. Dieser Parameter muss zusammen mit ORCHESTRATOR_URL verwendet werden. To enable this option, use ORCHESTRATOR_AUTO_SIGNIN=1

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 im Benutzermodus nur für den aktuellen Benutzer – UiPathRobot.msi MSIINSTALLPERUSER=1 ADDLOCAL=DesktopFeature,Robot
• Installieren des Roboters im Hintergrund – UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService,StartupLauncher,JavaBridge /Q
• Installieren Sie den Roboter und die Chrome-Erweiterung über eine Richtlinie im Hintergrund – UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService,ChromeExtension CHROME_INSTALL_TYPE=POLICYONLINE /Q

• Installieren Sie den Roboter als Windows-Dienst im Hintergrund und verbinden Sie diesen mit dem Orchestrator -

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

• Installieren Sie den Roboter im Hintergrund als Windows-Dienst und fügen Sie zwei benutzerdefinierte Aktivitätenfeeds hinzu – UiPathRobot.msi ADDLOCAL=DesktopFeature,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 den lokalen Aktivitätenfeed im Hintergrund. – UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService,CODE=1234567890 /Q
• Installieren eines Roboters als Windows-Dienst und Deaktivieren der offiziellen Online-Feeds – UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService NUGET_OPTIONS=DisableOnlineFeeds
• Deinstallieren der Chrome-Erweiterung – UiPathRobot.msi REMOVE=ChromeExtension /Q

• Einrichten der Verbindung zur automatischen Aktualisierung während der Installation des Attended-Roboters –

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

• Einrichten der Verbindung zur automatischen Aktualisierung während der Installation des Attended-Roboters –

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