UIP RPA Remote

Syntax und Optionen für „uip rpa remote“, das einen Remote-Orchestrator-Unattended-Roboter konfiguriert und steuert – Zielkonfiguration, UI-Automatisierungssitzungen, Prozessausführung und Dateiübertragung.

uip rpa remote arbeitet auf einem Remote-Orchestrator-Unattended-Roboter: Konfigurieren Sie, welche Maschine/Roboter/Runtime angepeilt werden soll, starten oder beenden Sie eine Remote-UI-Automatisierungsdesignsitzung darauf, führen Sie Shell-Befehle darauf aus und übertragen Sie Dateien auf/von der Datei. Nach der Konfiguration leiten uip rpa run --remote und debug start --remote die Ausführung an diese Maschine weiter, anstatt lokal auszuführen.

Erfordert eine Orchestrator-Anmeldung (uip login) für jedes Verb.

Zusammenfassung

uip rpa remote configure --machine <name> [--folder-path <path>] [--robot <name>] [--runtime <name>] [--live-authoring | --remote-run-only]
uip rpa remote status
uip rpa remote start
uip rpa remote stop
uip rpa remote echo --message <text>
uip rpa remote exec --command <cmd> [--package-id <id> --package-version <v>] [--working-directory <dir>] [--timeout <seconds>]
uip rpa remote upload-file --local-path <path> --remote-path <path>
uip rpa remote download-file --remote-path <path> --local-path <path>

UIP RPA Remote-Konfiguration

Lösen und speichern Sie das Remote-Debugging-Ziel (Ordner → Roboter → Maschine → Runtime) und starten Sie die Remote-UI-Automatisierungsdesignsitzung darauf. remote stop deaktiviert die Sitzung.

Optionen

Long	Wert	Erforderlich	Beschreibung
--machine <name>	string	ja	Name der Orchestrator-Maschine, auf der der Unattended-Roboter ausgeführt werden soll.
--folder-path <path>	string	nein	Vollqualifizierter Orchestrator-Ordner, zu dem der Roboter/die Maschine gehört (z. B Shared/Finance) – Der Roboter, die Maschine und die Runtime werden darin aufgelöst. Standardmäßig der aktuelle Ordner des Backend.
--robot <name>	string	nein	Roboter-/Benutzerkonto, als das ausgeführt werden soll. Standardmäßig die Standardidentität der Maschine.
--runtime <name>	string	nein	Name der verbundenen Runtime (Host/Sitzung). Wird für serverlose Maschinen ignoriert; Legen Sie es so fest, dass es sich um eine bestimmte verbundene Sitzung auf einer klassischen Maschine handelt.
--live-authoring	Markieren	nein	Verwenden Sie das Ziel für die Live-Erstellung: Ein langfristiger Remotesitzungsauftrag bedient jede Remote-Befehls-, Ausführungs- und Debugging-Sitzung; Die Remote-Designsitzung für die UI-Automatisierung wird verfügbar und der Remotebildschirm wird gestreamt. Sich gegenseitig mit --remote-run-only ausschließen. Erforderlich, damit remote echo funktioniert.
--remote-run-only	Markieren	nein	Verwenden Sie das Ziel nur für Remote-Ausführungen: Eine Ausführungs- oder Debugging-Sitzung ist ein eigener Orchestrator-Auftrag ohne Remote-UI-Automatisierungssitzung. Dies ist der Standardwert für ein Ziel, in dem noch nie ein Modus gespeichert wurde. Sich gegenseitig mit --live-authoring ausschließen.

Das Übergeben von --live-authoring sowie --remote-run-only schlägt auf der Clientseite fehl – es sind die beiden Modi einer Verbindung; übergeben höchstens eins. Wenn keiner von beiden übergeben wird, bleibt der gespeicherte Modus unverändert.

Beispiel

uip rpa remote configure --machine BotMachine --folder-path "Shared/Finance"

Datenform (--output json)

Unformatierte Weitergabe der { success, ...resolved-config } -Nutzlast des Backends – enthält den aufgelösten Ordner/Roboter/Maschine/Runtime, sobald sie abgeglichen wurden.

UIP RPA Remote-Status

Zeigt die Remoteverbindung an, die derzeit für den angemeldeten Mandanten konfiguriert ist und für den Orchestrator aufgelöst wurde. Schreibgeschützt – ändert oder startet nichts. Keine Optionen.

Beispiel

uip rpa remote status

UIP-RPA-Remotestart

Remote-UI-Automatisierung starten: Richten Sie eine UIA-Design-Experience-Sitzung auf dem konfigurierten Remote-Agenten ein, sodass uip rpa uia -Befehle mit --remote diese Maschine steuern. Schlägt fehl, wenn kein Ziel konfiguriert ist (zuerst remote configure). Das Starten einer bereits laufenden Sitzung ist ein No-Op; Das Neukonfigurieren zu einem anderen Ziel startet es neu. Keine Optionen.

Beispiel

uip rpa remote start

UIP RPA Remote Stopp

Trennen Sie die aktuelle Remote-UIA-Sitzung und geben Sie den Agent frei. Idempotent – ist auch dann erfolgreich, wenn keine Sitzung ausgeführt wird oder das Ziel nicht mehr konfiguriert ist. Ein späterer uia --remote -Aufruf startet automatisch eine neue Sitzung. Keine Optionen.

Beispiel

uip rpa remote stop

UIP-RPA-Remotee jetzt

Senden Sie eine Nachricht von dem RemoteSessionAgent, der auf dem konfigurierten Remote-Agenten ausgeführt wird, und geben Sie die Antwort aus – eine Konnektivitätsprüfung. Nur Live-Erstellung (remote configure --live-authoring); Nur Remoteausführung hat keinen Agent, der antwortet. Startet den Agent bei der ersten Verwendung; Jedes Echo breitet sich auf einem eigenen privaten Kanal aus, sodass gleichzeitige Aufrufer immer nur ihre eigene Antwort sehen.

Optionen

Long	Wert	Erforderlich	Beschreibung
--message <text>	string	ja	Text, den der RemoteSessionAgent als Echo zurückgibt – nützlich, um die Antworten gleichzeitiger Anrufer unterscheiden.

Beispiel

uip rpa remote echo --message "ping"

UIP RPA Remote-Execute

Führen Sie einen Shell-Befehl auf dem konfigurierten Remote-Agent aus (cmd.exe /c unter Windows, andernfalls /bin/sh -c) und streamen Sie die Ausgabe wieder live. Es gibt keinen lokalen Modus – dieser wird immer auf der Remotemaschine ausgeführt.

Optionen

Long	Wert	Erforderlich	Beschreibung
--command <cmd>	string	ja	Shell-Befehlszeile für die Remoteausführung (z. B. dir, ls -la). Wenn ein Paket wiederhergestellt wird (siehe unten), kann ein Pfad relativ zum Paketordner sein.
--package-id <id>	string	bedingt	NuGet-Paket, das auf der Remotemaschine wiederhergestellt werden soll, bevor der Befehl ausgeführt wird. Erfordert --package-version zusammen.
--package-version <v>	string	bedingt	Version von wiederherzustellenden --package-id. Erforderlich, wenn --package-id festgelegt ist – das Übergeben einer ohne die andere schlägt auf der Clientseite fehl.
--working-directory <dir>	string	nein	Arbeitsverzeichnis für den Befehl. Standardmäßig wird der wiederhergestellte Paketordner verwendet, wenn ein Paket wiederhergestellt wird, andernfalls das aktuelle Verzeichnis der Remotemaschine.
--timeout <seconds>	Nummer	nein	Beenden Sie den Befehl nach diesen vielen Sekunden. Ohne Zeitüberschreitung auslassen.

Beispiel

uip rpa remote exec --command "dir" --timeout 30

UIP-RPA Remote-Upload-Datei

Laden Sie eine lokale Datei in den konfigurierten Remote-Agent hoch, die über einen temporären Orchestrator-Speicher-Bucket übertragen wird (automatisch erstellt und gelöscht).

Optionen

Long	Wert	Erforderlich	Beschreibung
--local-path <path>	string	ja	Pfad zur hochzuladenden lokalen Datei.
--remote-path <path>	string	ja	Zielpfad auf der Remotemaschine. Übergeordnete Verzeichnisse werden erstellt.

Beispiel

uip rpa remote upload-file --local-path ./data.csv --remote-path "C:\Bots\data.csv"

UIP RPA Remote Download-Datei

Laden Sie eine Datei vom konfigurierten Remote-Agenten auf einen lokalen Pfad herunter, der über einen temporären Orchestrator-Speicher-Bucket übertragen wird.

Optionen

Long	Wert	Erforderlich	Beschreibung
--remote-path <path>	string	ja	Pfad der herunterzuladenden Datei auf der Remotemaschine.
--local-path <path>	string	ja	Zielpfad lokal. Übergeordnete Verzeichnisse werden erstellt.

Beispiel

uip rpa remote download-file --remote-path "C:\Bots\output.log" --local-path ./output.log

Zugehörig

• uip rpa run/debug – Das --remote -Flag wird vom Ziel dieser Gruppe konfiguriert.
• uip rpa uia – remote gesteuert, sobald remote start aktiv ist.

Siehe auch

• Übersicht über das RPA-Tool
• Globale Optionen
• Exitcodes