Befehlszeilenschnittstelle

Die Roboter-Befehlszeilenschnittstelle (UiRobot.exe) ist eine Konsolenanwendung, die Aufträge starten kann und auf ihre Ausgabe wartet. Es handelt sich um einen direkten Client des Roboterdienstes, und die Kommunikation erfolgt über einen WCF-Kanal.

Um die von den Robotern unterstützten Kommandozeilenargumente nutzen zu können, müssen Sie sicherstellen, dass der UiPath Robot-Dienst läuft. Ist dies nicht der Fall, starten Sie ihn über das Dienste-Snap-In der Microsoft Management Console.

Um sich die Arbeit mit Kommandozeilenargumenten zu erleichtern, navigieren Sie mithilfe des Befehls Verzeichnis wechseln (cd) zu dem Verzeichnis, in dem der Roboter installiert ist. Wenn Sie zum Beispiel das Standardverzeichnis des Roboters nicht verändert haben, können Sie Folgendes verwenden: cd C:\Program Files\UiPath\Studio.

Alle im Kapitel Beschreibung der Argumente dargestellten Beispiele bauen darauf auf, dass Sie diese Aktion durchgeführt haben.

Beschreibung der Argumente

Um sich die Arbeit mit Befehlszeilenargumenten zu erleichtern, navigieren Sie mithilfe des Befehls "Verzeichnis wechseln" (cd) zu dem Verzeichnis, in dem der Roboter installiert ist. Wenn Sie zum Beispiel das Standardverzeichnis des Roboters nicht verändert haben, können Sie den folgenden Befehl verwenden:

cd C:\Program Files\UiPath\Studio.

Alle hier dargestellten Beispiele bauen auf der Annahme auf, dass Sie zuerst den Befehl oben ausgeführt haben.

Attended-Roboter dürfen nur unter Aufsicht eines Mitarbeiters laufen.

Der Execute-Befehl

• UiRobot.exe execute [--process <Package_ID> | --file <File_Path>] [--folder <Orchestrator_Folder_ID>] [--input <Input_Parameters>]

Dieser Befehl wird verwendet, um die Ausführung eines Prozesses oder einer Datei (.json, .xaml, oder .nupkg) zu starten. Bitte beachten Sie, dass die Argumente --process (-p) und --file (-f) nicht gleichzeitig mit dem execute-Befehl verwendet werden können. Er unterstützt die folgenden Argumente:

Argument	Beschreibung
-p--process <Package_ID>	Obligatorisch. Startet die Ausführung eines lokalen oder Orchestrator-Prozesses. Beispiele: UiRobot.exe execute --process UiPathDemoProcess UiRobot.exe execute -p UiPathDemoProcess
-f--file <File_Path>	Obligatorisch. Startet die Ausführung einer lokalen Projektdatei. Die Zieldatei kann .json, .xaml oder .nupkg sein. Beispiele: UiRobot.exe execute --file "C:\UiPath\Automation\Project.json" UiRobot.exe execute --file "C:\UiPath\Automation\Main.xaml" UiRobot.exe execute --file "C:\UiPath\Automation\Notepad.1.0.6682.21636.nupkg"
--folder <Orchestrator_Folder_ID>	Optional. Hier können Sie den Orchestrator-Ordner angeben, aus dem der Zielprozess installiert und ausgeführt werden soll. Kann nur zusammen mit dem Argument --process verwendet werden. Beispiel: UiRobot.exe -Execute --process UiPathDemoProcess --folder OrchFolder1
--input <Input_Parameters>	Optional. Ermöglicht das Angeben von Eingabeargumenten für die Ausführung. Kann mit den Argumenten --process oder --file verwendet werden. Beispiele: UiRobot.exe execute --process UiPathDemoProcess --input "{'inArg' : 'value' , 'Integer' : 3}" UiRobot.exe execute --process UiPathDemoProcess --folder OrchFolder1 --input "{'inArg' : 'value' , 'Integer' : 3}" UiRobot.exe execute --file "C:\UiPath\Automation\Main.xaml" --input "{'inArg' : 'value' , 'Integer' : 3}"
entry	Ermöglicht es Ihnen, den Einstiegspunkt eines Prozesses auszuwählen, wenn Sie ihn über die Befehlszeile starten. Beispiel: UiRobot execute --file "C:\UiPath\Project\project.1.0.3.nupkg" --input "{'inArg':'value','integer':3}" --entry "OtherEntryPoint.xaml"

Wichtig: für Windows- oder portierbare Projekte nicht unterstützt.

Der Pack-Befehl

Hinweis: Für Studio v2018.4.4 und spätere Versionen empfehlen wir die Veröffentlichung mit dem Befehl UiPath.Studio.CommandLine.exe publish anstelle von UiRobot.exe pack. Weitere Informationen finden Sie im Studio-Handbuch unter Massenhafte Aktualisierung von Befehlszeilenparametern.

• UiRobot.exe pack <Project_Path> --output <Destination_Folder> [-v <Project_Version>]

Dieser Befehl wird verwendet, um eine Project.json-Datei in eine .nupkg-Datei zu packen. Er unterstützt die folgenden Argumente:

Argument	Beschreibung
-o --output <Destination_Folder>	Obligatorisch. Ermöglicht es Ihnen, anzugeben, wo die .nupkg-Datei erstellt wird. Beispiel: UiRobot.exe pack "C:\UiPath\Automation\Project.json" --output "C:\UiPath\Automation\Packages"
-v <Project_Version>	Optional. Ermöglicht es Ihnen, eine Version für die .nupkg-Datei anzugeben. Beispiel: UiRobot.exe pack "C:\UiPath\Automation\Project.json" --output "C:\UiPath\Automation\Packages" -v 1.0.6820.22047

Der Connect-Befehl

• UiRobot.exe connect [--url <Orchestrator_Server_URL> --key <Machine_Key>] | [--connectionString <Connection_String>]

  Hinweis: Wenn der Roboter bereits verbunden ist, gibt das Ausführen des Befehls connect die folgende Meldung zurück: Orchestrator already connected!.

Dieser Befehl wird verwendet, um den Roboter mit einer Orchestrator-Instanz zu verbinden. Er unterstützt die folgenden Argumente:

Argument	Beschreibung
connect	Obligatorisch. Wenn die Argumente --url, --key oder --connectionString nicht angegeben sind, wird die Konfiguration der Orchestratoreinstellungen verwendet, um die Verbindung herzustellen. Beispiel: UiRobot.exe connect
--url <Orchestrator_Server_URL>	Optional. Muss mit dem --key-Argument verwendet werden. Ermöglicht die Angabe der Ziel-Orchestrator-Instanz. Beispiel: UiRobot.exe connect --url https://demo.uipath.com/ --key 1122AAB3C-DD44-EE55-FF66-7788GG99HH00
--key <Machine_Key>	Optional. Muss mit dem --url-Argument verwendet werden. Ermöglicht die Angabe des Maschinenschlüssels, der zum Herstellen einer Verbindung mit Orchestrator verwendet wird. Beispiel: UiRobot.exe connect --url https://demo.uipath.com/ --key 1122AAB3C-DD44-EE55-FF66-7788GG99HH00
--connectionString	Optional. Ermöglicht es Ihnen, eine Verbindung mit Orchestrator über die Verbindungszeichenfolge herzustellen. Beispiel: UiRobot.exe connect --connectionString https://demo.uipath.com/api/robotsservice/GetConnectionData?tenantId=1

Der Disconnect-Befehl

• UiRobot.exe disconnect

Dieser Befehl wird verwendet, um den Roboter von der aktuellen Orchestrator-Instanz zu trennen.

Der Trace-Befehl

• UiRobot.exe trace --enableLowLevel | --disableLowLevel

Dieser Befehl wird verwendet, um Nachverfolgung auf niedriger Stufe (ausführlich) für den Roboter zu aktivieren oder zu deaktivieren. Er unterstützt die folgenden Argumente:

Argument	Beschreibung
--enableLowLevel	Ablaufverfolgung auf niedriger Ebene aktivieren. Aktiviert die Nachverfolgung auf niedriger Stufe. Eine .etl-Datei wird generiert, die in der Ereignisanzeige geöffnet werden kann, um Sie bei der Fehlersuche und -behebung von Abstürzen und Fehlern zu unterstützen. Damit wird die ausführliche Nachverfolgung für den Robot Executor und -Dienst in der Ereignisanzeige aktiviert. Beispiel: UiRobot.exe trace --enableLowLevel
--disableLowLevel	Ablaufverfolgung auf niedriger Ebene deaktivieren Nach dem Anhalten wird auf dem Desktop eine .etl-Datei generiert. Diese Datei kann in der Ereignisanzeige geöffnet werden, um Sie bei der Fehlersuche und -behebung von Abstürzen und Fehlern zu unterstützen. Beispiel: UiRobot.exe trace --disableLowLevel

Der BiB-Befehl

Ermöglicht das Aktivieren oder Deaktivieren der Bild-in-Bild-Funktion der Maschine. Diese Einstellung wird auf der lokalen Maschine angewendet und betrifft alle Benutzer und wird zum Ändern vorhandener Installationen verwendet.

Zur Durchführung dieser Anweisungen sind Administratorrechte erforderlich.

Befehl	Beschreibung
PiP --enable	Aktiviert die Bild-in-Bild-Funktion der Maschine.
PiP --disable	Deaktiviert die Bild-in-Bild-Funktion der Maschine.

Der Befehl ENABLE_PIP

Ermöglicht es Ihnen, die Bild-in-Bild-Funktion der Maschine während der Installation per UiPath-Befehlszeile zu aktivieren.

Befehl	Beschreibung
ENABLE_PIP=1	Aktiviert die Bild-in-Bild-Funktion der Maschine.
ENABLE_PIP=0	Aktiviert nicht die Bild-in-Bild-Funktion der Maschine.

Verschiedene Befehle

Die folgenden Befehle sind rein informativ und haben keinerlei Auswirkungen auf Ihre Automatisierungsprojekte:

Argument	Beschreibung
--version	Zeigt Informationen zur Roboterversion an.
--help	Zeigt die Liste der unterstützten Befehle sowie die entsprechenden Informationen und Beispiele an.
logs --flush	Sendet alle ausstehenden Protokolle an den Orchestrator.