Kommandozeilenparameter

Beschreibung der Kommandozeilenargumente

Es ist möglich, Studio oder Robot über die Befehlszeile zu installieren oder zu aktualisieren, vorausgesetzt, Sie haben das Installationsprogramm UiPathStudio.msi. In der folgenden Tabelle sind alle verfügbaren Parameter aufgeführt, die Sie verwenden können, zusammen mit einigen Beispielen.

Hinweis:

Änderungen an Ihrer bestehenden Instanz der UiPath-Plattform können nicht über die Eingabeaufforderung im Lautlos-Modus vorgenommen werden. Aber Änderungen daran, was bei einem Update installiert wird, werden vollständig unterstützt.

Befehlszeilenargument für das Setup funktionieren mit UiPathPlatformInstaller.exe nicht.

Zur Durchführung dieser Anweisungen sind Administratorrechte erforderlich.

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 es Ihnen, auszuwählen, welche Funktionen installiert werden sollen. Wenn ADDLOCAL verwendet wird, werden nur die darin angegebenen Funktionen installiert. Wenn ADDLOCAL nicht verwendet wird, werden die folgenden Funktionen installiert: Studio, der Roboter im Dienstmodus, die Aktivitätspakete und das JavaScript-Add-On. Es unterstützt die folgenden Optionen: DesktopFeature - indicates that you want to install Robot and Studio features. Studio - Installs Studio. It cannot be used without DesktopFeature. ExcelAddin – Installiert das StudioX Excel-Add-in. Kann nicht ohne Studio verwendet werden. Robot – Installiert den Roboter im Benutzermodus oder Dienstmodus. 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. UseLegacyTray – Installiert das Roboter-Tray von der Legacy-Version anstelle von UiPath Assistant. Hinweis: Um nach der Installation zu Assistant zu wechseln, führen Sie REMOVE=UseLegacyTray aus. Packages - Installs the activities packages. It cannot be used without the DesktopFeature and Robot arguments. StartupLauncher - Runs the Robot at Windows startup. It cannot be used without the DesktopFeatureand Robot arguments. JavaBridge - Installs the UiPath Java Bridge for a better integration and automation in regards to Java applications. Please note that installing the Java Bridge may cause the installation to last longer than usual. It cannot be used without the DesktopFeature and Robot arguments. ChromeExtension - Installs the UiPath Google Chrome Extension. It cannot be used without the DesktopFeature and Robot arguments. EdgeExtension – Installiert die UiPath Microsoft Edge Chromium-basierte Erweiterung. Die Verwendung ohne das Argument Robot ist nicht möglich. CitrixClient - Installs the UiPath Citrix Client Extension. It cannot be used without the DesktopFeature and Robot arguments. JavaScriptAddOn – Installiert das Add-on „Browser Embedding“ für den Roboter.
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 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	Damit können Sie den Speicherort zum Herunterladen Ihrer Workflows und deren Abhängigkeiten für Studio und/oder Robot ändern. Dieser Ordner kann benutzerspezifisch oder für alle Benutzer über einen Computer zugänglich sein. Dieser Parameter kann verwendet werden, wenn der Roboter als Dienst oder im Benutzermodus installiert ist. Für den Servicemodus-Roboter werden Pakete gleichzeitig für alle Benutzern installiert. Bitte beachten Sie, dass bei mehreren auf einer Maschine installierten Robotern im Benutzermodus der Paketordner nicht derselbe sein kann (z. B. C:\Packages). Dies liegt daran, dass der erste Benutzermodus-Roboter, der ein Paket herunterlädt und installiert, den .XAML-Dateizugriff nur auf diesen Benutzer beschränkt, sodass andere Benutzermodus-Roboter auf dieser Maschine den entsprechenden Ordner oder das Paket aufgrund unzureichender Berechtigungen nicht verwenden können. Wenn Sie diesen Parameter nicht angeben, ist der Standardordner %userProfile%\.nuget\packages. 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. 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^%. In Batch-Skripts: verwenden Sie % - 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^%. 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 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.
CONNECTIONSTRING	Verbindet den Robot automatisch mit dem Orchestrator lokal über die Verbindungszeichenfolge und installiert ihn. Bitte beachten Sie, dass Folgendes erforderlich ist: der Parameter WindowsAuth.Enabled von der Datei UiPath.Orchestrator.dll.config muss auf true festgelegt werden der Parameter WindowsAuth.Domain muss auf eine gültige Domain festgelegt werden der Dienstmodusroboter eine Standardmaschinen-Konfiguration muss vorhanden sein. Hinweis: Die automatische Registrierung bei Standardmaschinen mit connectionstring kann nur mit Orchestrator v2020.10 verwendet werden.
CHROME_INSTALL_TYPE	Installiert die Chrome-Erweiterung automatisch per Richtlinie. Es unterstützt die folgenden Optionen: GLOBAL: Die Chrome-Erweiterung wird automatisch pro System installiert, was dem Aufruf des Befehls „/ChromeGlobal“ mit dem SetupExtensions-Tool entspricht. STORE: Die Chrome-Erweiterung wird automatisch pro System per Richtlinie installiert, was dem Aufruf des Befehls „/ChromePolicyGlobal“ mit dem SetupExtensions-Tool entspricht.
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 Upgrades 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).
TELEMETRY_ENABLED	Ermöglicht es Ihnen, die Sammlung von Nutzungsdaten zu deaktivieren und kann zur Installationszeit für Studio und Roboter durchgeführt werden. Telemetrie ist standardmäßig für Studio und Roboter aktiviert. Um sie während der Installation zu deaktivieren, verwenden Sie den folgenden Wert für den Parameter: TELEMETRY_ENABLED=0 Hinweis: Dadurch wird die Telemetrie für Studio und Roboter deaktiviert. Wenn Sie die Telemetrie wieder aktivieren möchten, verwenden Sie den folgenden Wert: 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: UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService,Packages ENABLE_PIP=1

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=DesktopFeature,Studio,Robot,RegisterService,Packages
• Installieren von Studio und einem Roboter im Benutzermodus – UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot
• Installieren Sie die gesamte Desktop-Suite im Hintergrund - UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService,Packages,StartupLauncher,JavaBridge /Q
• Installieren Sie die gesamte Desktop-Suite und die Chrome-Erweiterung über eine Richtlinie – UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService,Packages,ChromeExtension CHROME_INSTALL_TYPE=STORE /Q
• Installieren Sie im Hintergrund Studio, den Roboter als Windows-Dienst und die Aktivitätspakete, alle im Ordner D:\UiPath - UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService,Packages APPLICATIONFOLDER=D:\UiPath /Q

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

  UiPathStudio.msi ADDLOCAL=DesktopFeature,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=DesktopFeature,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=DesktopFeature,Studio,Robot,RegisterService,Packages CODE=1234567890 /Q
• Installieren eines Roboters als Windows-Dienst und Deaktivieren der offiziellen Online-Feeds – UiPathStudio.msi ADDLOCAL=DesktopFeature,Robot,RegisterService NUGET_OPTIONS=DisableOnlineFeeds