Kommandozeilenparameter

Sie können Studio und den Robot installieren und aktualisieren oder eine vorhandene Installation ändern, indem Sie das UiPathStudio.msi oder UiPathStudioCloud.msi-Installationsprogramm über die Befehlszeile ausführen.

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

Hinweis:

• Administratorrechte sind erforderlich, um diese Befehle auszuführen. * Das Ändern einer vorhandenen Installation durch Ausführen des Installationsprogramms über die Befehlszeile im stillen Modus wird nicht unterstützt. Sie können das Installationsprogramm jedoch im stillen Modus ausführen, um eine Aktualisierung aus einer älteren Version zu erstellen.* Die Verwendung der /passiveOption msiexec.exe zur Ausführung einer unbeaufsichtigten Installation wird nicht unterstützt.

Beschreibung der Kommandozeilenargumente

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

Alle Parameter können für Neuinstallationen verwendet werden, aber nur die folgenden werden unterstützt, wenn Sie von einer älteren Version aktualisieren oder eine vorhandene Installation ändern:

• Aktivieren von Funktionen mit ADDLOCAL.
• Deaktivieren Sie Funktionen mithilfe von REMOVE. Bitte beachten Sie, dass der Robot nicht deaktiviert werden kann.
• Aktivieren oder deaktivieren Sie die Assistant-Optionen mit ASSISTANT_OPTIONS.
• SERVICE_URL – verfügbar, wenn Sie den Roboter vom Dienstmodus in den Benutzermodus wechseln, indem das Argument RegisterService nicht berücksichtigt wird.
• NUGET_OPTIONS, ENFORCE_SIGNED_EXECUTION, DISABLE_SECURE_XAML und TELEMETRY_ENABLED – verfügbar beim Aktualisieren von einer älteren Version, nicht verfügbar beim Ändern einer vorhandenen Installation.
• Siehe die Adresse des Proxyservers, entweder IP oder Domänenname, mit PROXY_ADDRESS.

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 ^ – UiPathStudio.msi PACKAGES_FOLDER=C:\Some\Path\^%USERNAME^%.
  • Verwenden Sie in Batch-Skripts ^ – UiPathStudio.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: UiPathStudio.msi APPLICATIONFOLDER="C:\folder name".
  • In PowerShell mit einfachen und doppelten Anführungszeichen ('" "') umgeben. Beispiel: ./UiPathStudio.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	Um den Roboter im Servicemodus zu installieren, fügen Sie die RegisterService Option 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. Wenn Sie den Roboter vom Dienstmodus in den Benutzermodus konvertieren, kann der Roboter möglicherweise nicht auf .xaml die Dateien aus dem ursprünglichen NuGet-Pakete-Ordner zugreifen. Weitere Informationen zur Behebung dieses Problems finden Sie im Artikel NuGet-Pakete, die nach der Migration nicht zugänglich sind. StartupLauncher – Führt den Roboter beim Windows-Start aus. Die Verwendung ohne das Argument Robot ist nicht möglich. JavaBridge – Installiert die UiPath Java Bridge für eine verbesserte Integration und Automatisierung von Java-Anwendungen. Die Installation der Java Bridge kann dazu führen, dass die Installation länger als üblich dauert. 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 – Installs the UiPath Mozilla Firefox Extension. It cannot be used without the Robot argument. Example: UiPathStudio.msi ADDLOCAL=Studio,Robot,ChromeExtension,FirefoxExtension. EdgeExtension – Installiert die UiPath Microsoft Edge-Erweiterung (Chromium-basiert). 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 für das Robot JavaScript SDK erforderliche Roboter JavaScript-Add-on. SapPlugin – Installiert das SAP Lösung Manager-Plugin.Erfordert den SAP Connector für Microsoft. Für saubere Installationen müssen Sie auch die Instanzadresse mit SAP_SOL_MAN_HOSTangeben. Kann nicht ohne Studio verwendet werden. 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. AmazonWorkSpacesClient – Installiert die UiPath-Erweiterung für Amazon WorkSpaces. Die Verwendung ohne das Argument Robot ist nicht möglich. LiveStreaming – Installiert die Live-Streaming-Software (RealVNC), die für das Remote-Debugging erforderlich ist. Weitere Informationen finden Sie im Handbuch zum Roboter zur Funktion Live-Streaming.
MSIINSTALLPERUSER	Mit diesem Parameter können Sie Studio und Robot entweder pro Benutzer oder pro Maschine installieren. Wenn der Parameter nicht enthalten ist, erfolgt die Installation pro Maschine. Wenn Sie MSIINSTALLPERUSER=1 hinzufügen, erfolgt die Installation pro Benutzer. Der Parameter kann nur bei der Durchführung einer sauberen Installation verwendet werden. Die folgenden Optionen sind in Installationen pro Benutzer nicht verfügbar: RegisterService, CitrixExtension, VMwareExtension, SapPlugin, PACKAGES_FOLDER, CODE.
SAP_SOL_MAN_HOST	Hostname oder IP-Adresse für Ihre SAP Solution Manager-Instanz. Erforderlich für Neuinstallationen, wenn das Argument SapPlugin für die Option ADDLOCAL angegeben wurde. Zum Beispiel UiPathStudio.msi ADDLOCAL=Studio,Robot,SapPlugin SAP_SOL_MAN_HOST=ip_address.
APPLICATIONFOLDER	Ermöglicht die Installation von Studio und Robot an einem benutzerdefinierten Speicherort.
NUGET_OPTIONS	Dieser Parameter wird empfohlen, wenn Sie in einer Offline-Umgebung arbeiten. Wenn dieser Parameter auf DisableOnlineFeeds festgelegt ist, können Sie die offiziellen Online-UiPath- und Community-Feeds für den Roboter deaktivieren – nur der Orchestrator und die lokalen Feeds werden berücksichtigt. Bitte beachten Sie, dass die URL-Feeds nicht aus den Konfigurationsdateien gelöscht, sondern einfach ignoriert werden. Es kann sowohl für Installationen als auch für Aktualisierungen verwendet werden. Bei der Aktualisierung können Sie den Parameter auf EnableOnlineFeeds aktivieren, um Online-Feeds zu aktivieren. Hinweis: Der NUGET_OPTIONS Parameter deaktiviert nicht die offiziellen Online-UiPath- und Community-Feeds für Studio.
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 sein oder für alle Benutzer einer Maschine zugänglich sein. Dieser Parameter kann sowohl für Roboter im Servicemodus als auch für Roboter im Benutzermodus verwendet werden. Wenn Sie diesen Parameter nicht angeben, ist der Standardordner %userProfile%\\.nuget\\packages. Stellen Sie beim Ändern des Paketordners sicher, dass alle Benutzer, die Prozesse ausführen müssen, Lesezugriff auf diesen Ordner haben.Bei Verwendung des PACKAGES_FOLDER Parameters 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 die gleichzeitige Ausführung aktivieren – HD Robots) müssen Sie Pfade angeben, die für jeden Benutzer spezifisch sind. Erfahren 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	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 dies durch Ändern der Datei nuget.config tun. Auf dieser Seite können Sie erfahren, 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	Lizenzieren Ihrer Studio-Instanz.
CLIENT_ID und CLIENT_SECRET	Verbindet den Roboter automatisch über Client-Anmeldeinformationen mit dem Orchestrator und installiert ihn. Beispiel: UiPathStudio.msi ORCHESTRATOR_URL=https://demo.uipath.com/company/tenant/orchestrator_CLIENT_ID=1234-abcd-1ab2-cd32-1111 CLIENT_SECRET=2143ndafj32k.
CHROME_INSTALL_TYPE	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. Die Namen der alten Installationsmethoden ( STORE , GLOBAL ) werden aus Gründen der Abwärtskompatibilität beibehalten.
EDGE_INSTALL_TYPE	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. Die Namen der alten Installationsmethoden ( STORE , GLOBAL ) werden aus Gründen der Abwärtskompatibilität beibehalten.
DISABLE_SECURE_XAML	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. Dieser Parameter kann nur während einer sauberen Installation oder einer Aktualisierung 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	TELEMETRY_ENABLED=0 TELEMETRY_ENABLED=1 Weitere Informationen zur Erfassung von Nutzungsdaten und zum Ändern der Telemetrieeinstellungen finden Sie im Dokument Telemetrie abwählen.
ENABLE_PIP	ENABLE_PIP=1 Beispiel: UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService ENABLE_PIP=1
INSTALLER_LANGUAGE	Chinesisch (vereinfacht): INSTALLER_LANGUAGE=2052 Englisch: INSTALLER_LANGUAGE=9 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	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 Robot im Benutzermodus installieren und Ihre Umgebung für die Verwendung von SSO mit Azure Active Directory konfiguriert ist, wird die automatische Anmeldung bei Ihrem Konto aktiviert.Dieser Parameter muss zusammen mit ORCHESTRATOR_URL. verwendet werden. Um diese Option zu aktivieren, verwenden Sie ORCHESTRATOR_AUTO_SIGNIN=1.
ENFORCE_DEFAULT_SERVICE_URL	Für Installationen im Benutzermodus erzwingt dieser Parameter die Standarddienst-URL. Um diese Option zu aktivieren, verwenden Sie ENFORCE_DEFAULT_SERVICE_URL=1.ORCHESTRATOR_URL muss auch aktiviert sein.
PROXY_SCRIPT_ADDRESS	Wenn Sie diesen Parameter verwenden, verwenden Sie keine anderen Proxy-spezifischen Parameter. Wenn alle Parameter in der UiPath.config-Datei vorhanden sind, wird nur der Schlüssel ScriptAddress verwendet.
PROXY_BYPASS_LOCAL_ADDRESS PROXY_BYPASS_LIST PROXY_USER_NAME PROXY_PASSWORD PROXY_DOMAIN	Die Adresse des Proxy-Servers, entweder IP oder Domainname.Beispiel: http://my.proxy.net:8008..
PROXY_ADDRESS PROXY_BYPASS_LIST	Ermöglicht eine direkte Verbindung für lokale Adressen unter Umgehung des Proxyservers. Auf 1 festlegen, um die lokale Adresse zu umgehen, oder andernfalls auf 0.
PROXY_ADDRESS PROXY_BYPASS_LOCAL_ADDRESS	Die Liste der Adressen, die unter Umgehung des Proxyservers eine direkte Verbindung mit dem Internet herstellen. Muss RegExr-Zeichenfolgen enthalten, die die URLs der zu umgehenden Server umfassen. Zum Beispiel: „server.domain.local$;www.google.com;192.168.\d{1,3}.\d{1,3}“.
PROXY_USER_NAME (erfordert PROXY_PASSWORD.)	Der Benutzername der Anmeldeinformationen für die Proxyserver-Authentifizierung.
PROXY_PASSWORD	Das Kennwort, das dem Benutzernamen für die Proxyserver-Authentifizierung zugeordnet ist.
PROXY_DOMAIN	Die Domäne, in der sich der Proxyserver befindet, erforderlich für die Authentifizierung.

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 UiPathStudio.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 UiPathStudio.msi befindet. Sie können dies mit dem folgenden Befehl machen, zum Beispiel: cd D:\UiPathInstaller.

• Installieren Sie Studio, einen Roboter als Windows-Dienst und die Aktivitätenpakete - UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService
• Studio und einen Robot im Benutzermodus nur für den aktuellen Benutzer installieren – UiPathStudio.msi MSIINSTALLPERUSER=1 ADDLOCAL=Studio,Robot
• Installieren Sie die Livestreaming-Funktion für die Roboterversionen 2024.10+ – UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService,LiveStreaming.
• Installieren Sie die gesamte Desktop-Suite im Hintergrund - UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService,StartupLauncher,JavaBridge /Q
• Installieren Sie die gesamte Desktop-Suite und die Chrome-Erweiterung über eine Richtlinie – UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService,ChromeExtension CHROME_INSTALL_TYPE=POLICYONLINE /Q
• Installieren Sie im Hintergrund Studio, den Roboter als Windows-Dienst und die Aktivitätspakete, alle im Ordner D:\UiPath - UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService APPLICATIONFOLDER=D:\UiPath /Q
• Installieren Sie den Roboter als Windows-Dienst im Hintergrund und verbinden Sie diesen mit dem Orchestrator -

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

• Installieren von Studio im Hintergrund, Installieren des Roboters als Windows-Dienst und Hinzufügen von zwei benutzerdefinierten Aktivitäts-Feeds – UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService CUSTOM_NUGET_FEEDS="Feed Name1,https://my.custom.nuget.feed; FeedName2,D:\RPA\Activities\Packages\" /Q
• Installieren und lizenzieren Sie Studio im Hintergrund sowie einen als Windows-Dienst registrierten Roboter und den lokalen Aktivitätsfeed - UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService CODE=1234567890 /Q
• Installieren eines Roboters als Windows-Dienst und Deaktivieren der offiziellen Online-Feeds – UiPathStudio.msi ADDLOCAL=Robot,RegisterService NUGET_OPTIONS=DisableOnlineFeeds
• Deinstallieren der Chrome-Erweiterung – UiPathStudio.msi REMOVE=ChromeExtension /Q
• Einrichten der Verbindung zur automatischen Aktualisierung während der Installation des Attended-Roboters – UiPathStudio.msi ADDLOCAL=Robot, SERVICE_URL="https://demo.uipath.com/myorg/mytenant"
• Einrichten der Verbindung zur automatischen Aktualisierung während der Installation des Unattended-Roboters – UiPathStudio.msi ADDLOCAL=Robot,RegisterService ORCHESTRATOR_URL="https://demo.uipath.com/myorg/mytenant/orchestrator_"