UiPath Remote Runtime

Installieren und konfigurieren Sie UiPath Remote Runtime, um die Kommunikation zwischen Remote-Desktops oder Citrix-Apps und UiPath-Erweiterungen zu ermöglichen.

Über UiPath Remote Runtime

UiPath Remote Runtime ist eine Komponente, die die Kommunikation zwischen einem Remote-Desktop oder Anwendungen (etwa Citrix Virtual Apps) und bestimmten UiPath-Erweiterungen ermöglicht.

Dazu gehört die UiPath-Erweiterung für Citrix, für Windows Remote Desktop und Apps, für VMware Horizon und für Amazon WorkSpaces. Sie sammelt Informationen über UI-Zielelemente von Remote-Anwendungen und leitet diese Daten an die entsprechende Erweiterung weiter. Dies ermöglicht die native Generierung von Selektoren im UI-Explorer.

Hinweis:

Ab Citrix Virtual Apps und Desktops 7 2109 werden alle benutzerdefinierten virtuellen Kanäle standardmäßig blockiert. Dadurch kann die UiPath Remote Runtime nicht ordnungsgemäß funktionieren. Um dieses Problem zu beheben, muss der virtuelle UiPath-Kanal zur Richtlinie für die Zulassungsliste hinzugefügt werden: UIPCTX,C:\Program Files (x86)\UiPath\RemoteRuntime\UiPathRemoteRuntime.exe

Die Remote Runtime-Komponente wurde mit einer Citrix Ready-Zertifizierung ausgezeichnet, was sie zu einer vertrauenswürdigen, effektiven Lösung für die Arbeit mit Citrix-Technologien macht.

Je nach dem Typ der Umgebung, auf der Sie Ihre Automationsprojekte aufbauen möchten, kann die Komponente UiPath Remote Runtime folgendermaßen installiert werden:

• Auf Citrix-Anwendungsservern – Kommuniziert mit der UiPath-Erweiterung für Citrix.
• Auf virtuellen VMware Horizon-Maschinen – Kommuniziert mit der UiPath-Erweiterung für VMware Horizon.
• Auf Windows-Remotedesktop-Maschinen – Kommuniziert mit der UiPath-Erweiterung für Windows Remote Desktop und Apps.
• Auf Amazon WorkSpaces-Maschinen – Kommuniziert mit der UiPath-Erweiterung für Amazon WorkSpaces.
  Hinweis:

  Amazon WorkSpaces unterstützt die Konfiguration entweder mit den Protokollen DCV (Desktop Cloud Visualization) oder PCoIP (PC-over-IP).

  • Für die Automatisierung von Amazon WorkSpaces mithilfe von PCoIP sind UiPath.UIAutomation.Activities, UiPath Studio und UiPath Remote Runtime v24.10 oder höher erforderlich.
  • Für die Automatisierung von Amazon WorkSpaces mithilfe von DCV sind UiPath.UIAutomation.Activities, UiPath Studio und UiPath Remote Runtime v25.2 oder höher erfoderlich.

Bitte beachten Sie, dass die entsprechenden UiPath-Erweiterungen auf der Client-Maschine installiert werden müssen.

Das UiPathRemoteRuntime.msi-Installationsprogramm kann heruntergeladen werden von:

• Produktdownloads im UiPath Customer Portal.
• Ressourcenzentrum in der UiPath Automation Cloud. Um auf das Ressourcenzentrum zuzugreifen, müssen Sie sich bei Ihrer Automation Cloud-Organisation anmelden und auf die Hilfe-Schaltfläche in der linken Navigationsleiste klicken.

Sobald die Komponente UiPath Remote Runtime installiert ist, registriert sie eine Aufgabe im Taskplaner, sodass der UiPathRemoteRuntime.exe-Prozess bei jeder Benutzeranmeldung für jeden Benutzer gestartet wird, der beim Remoteserver angemeldet ist.

Die Komponente UiPath Remote Runtime ist erforderlich, um die Verbindung zwischen einer Anwendung oder dem Desktop-Server und einer entsprechenden auf einem Client-Computer installierten UiPath-Erweiterung herzustellen. Auf diese Weise werden Selektoren nativ auf dem Client-Computer generiert, auf dem Studio installiert ist, ohne dass Sie auf OCR- und Bilderkennungsaktivitäten zurückgreifen müssen.

Hard- und Softwareanforderungen

The UiPath Remote Runtime has the same requirements as the UiPath Robot. For the full list of requirements, refer to the Robot guide.

Installieren von UiPath Remote Runtime

Aus dem Installer

1. Führen Sie die Datei UiPathRemoteRuntime.msi aus, um UiPath Remote Runtime zu installieren. Sie muss auf allen Citrix-Anwendungsservern, virtuellen VMware Horizon-Maschinen, Windows Remote Desktop-Maschinen oder den virtuellen Amazon WorkSpaces-Desktops installiert werden, auf denen die Zielanwendungen für die Automatisierung ausgeführt werden.
2. Melden Sie sich vom aktuellen Citrix-Fenster, VMware Horizon-Fenster, der RDP-Sitzung oder dem virtuellen Amazon WorkSpaces-Desktop auf der Clientmaschine ab und wieder an, damit Ihre Änderungen wirksam werden.
3. Installieren Sie entweder die UiPath-Erweiterung für Citrix, für VMware Horizon, für Windows Remote Desktop und Apps oder für Amazon WorkSpaces auf der Maschine des Kunden, je nachdem, auf welcher Technologie Sie Ihre Automatisierungsprojekte erstellen möchten.

Sie können auch die Erweiterung für Java, Chrome, Microsoft Edge, Firefox, Microsoft Remote Desktop und Apps, VMware, Citrix und Amazon WorkSpaces über das Installationsprogramm sowie den Eintrag „Aufgabenplanung“ bereitstellen, indem Sie die entsprechenden Optionen auswählen, wie unten dargestellt:

Der Eintrag „Taskplaner“ für die Remote-Runtime kann jederzeit hinzugefügt oder entfernt werden. Führen Sie einfach das UiPathRemoteRuntime.msi-Installationsprogramm aus und wählen Sie die entsprechende Option aus.

Aus der Eingabeaufforderung

Hinweis:

Die Installation erfordert UiPathRemoteRuntime.msiAdministratorrechte.

1. Wählen Sie die Windows Start-Schaltfläche aus und geben Sie cmd in das Suchfeld ein.
2. Wählen Sie mit der rechten Maustaste Eingabeaufforderung aus, und führen Sie sie als Administrator aus.
3. Ändern Sie das Verzeichnis in den Ordner UiPathRemoteRuntime.msi (Beispiel): cd C:\Tools\Studio).
4. Installieren Sie mit dem Befehl UiPathRemoteRuntime.msi ADDLOCAL=RemoteRuntime,RemoteRuntimeTask die UiPath-Komponente Remote Runtime.
5. Melden Sie sich vom aktuellen Citrix-Fenster, VMware Horizon-Fenster, der RDP-Sitzung oder dem virtuellen Amazon WorkSpaces-Desktop auf der Clientmaschine ab und wieder an, damit Ihre Änderungen wirksam werden.
6. Installieren Sie entweder die UiPath-Erweiterung für Citrix, für VMware Horizon, für Windows Remote Desktop und Apps oder für Amazon WorkSpaces auf der Maschine des Kunden, je nachdem, auf welcher Technologie Sie Ihre Automatisierungsprojekte erstellen möchten.

Darüber hinaus können Sie die folgenden Optionen verwenden, um Erweiterungen zu installieren:

• UiPathRemoteRuntime.msi ADDLOCAL=RemoteRuntime,RemoteRuntimeTask,JavaBridge,ChromeExtension,EdgeChromium,CitrixClient,FirefoxExtension,WindowsRdpExtension,VMwareExtension,AmazonWorkSpacesClient – Installiert die Remote Runtime-Komponente, den Taskplaner-Eintrag und die Erweiterungen für Java, für Chrome, für Microsoft Edge, für Citrix, für Firefox, für Microsoft Remote Desktop und Apps, für VMware Horizon und für Amazon WorkSpaces.

Mit dem Parameter /quiet können Sie die Installation auch im Hintergrund durchführen:

• UiPathRemoteRuntime.msi ADDLOCAL=RemoteRuntime,RemoteRuntimeTask /quiet – Installiert die Remote Runtime-Komponente und den Taskplaner-Eintrag im Hintergrund.

Sie können die UiPath Remote Runtime an einem beliebigen Speicherort mit der Option APPLICATIONFOLDER installieren:

• UiPathRemoteRuntime.msi APPLICATIONFOLDER="D:\UiPathRemoteRuntime" ADDLOCAL=RemoteRuntime,RemoteRuntimeTask /quiet – Installiert die Remote Runtime-Komponente im Hintergrund unter D:\UiPathRemoteRuntime und fügt den Taskplaner-Eintrag hinzu.

Jetzt können Sie Prozesse zum Automatisieren auf Citrix virtuellen Apps und Desktops, VMware Apps, virtuellen Desktops von Amazon WorkSpaces sowie über RDP-Verbindungen genauso wie auf einer Standardmaschine erstellen. Aufgrund der entsprechenden Erweiterungen brauchen die Aktivitäten OCR- und Bilderkennung UI-Elemente nicht mehr ordnungsgemäß zu erkennen. Stattdessen werden die Elemente nativ erkannt und können mit beliebigen Aktivitäten verwendet werden.

Taskplaner

Standardmäßig erstellt die UiPath Remote Runtime-Komponente einen Eintrag im Windows-Taskplaner, der automatisch jedes Mal gestartet wird, wenn sich der entsprechende Benutzer anmeldet. Diese Funktion wird durch die Taskoption UiPathRemoteRuntime starten im UiPathRemoteRuntime.msi-Installationsprogramm dargestellt, das Sie bei Bedarf deaktivieren können.

Der Eintrag Remote Runtime-Aufgabenplaner kann über das Installationsprogramm oder die Eingabeaufforderung hinzugefügt oder entfernt werden, wie in den folgenden Abschnitten erläutert wird. Wenn der Eintrag entfernt wird, müssen Sie den UiPathRemoteRuntime.exe Prozess mit einer anderen Methode starten, z. B. mit einem Startskript.

Der Remote Runtime Task Scheduler-Eintrag kann auch bearbeitet werden, um nur für einen bestimmten Benutzer zu starten, indem Sie auf die Schaltfläche Bearbeiten auf der Registerkarte Trigger klicken. Mehrere Aufgaben können für mehrere Benutzer erstellt werden.

UIAutomation-Abhängigkeit

Die UiPath Remote Runtime ist von der Version des UiPath.UIAutomation.Activities-Pakets abhängig, nicht von der Version von UiPath Studio/Robot.

Die auf einer Remotemaschine installierte Remote Runtime muss über die Version des neuesten UIAutomation-Pakets verfügen, das Sie in Ihren Projekten verwenden möchten, und sie ist mit den vorherigen UIAutomation-Releases kompatibel (abwärtskompatibel).

Versionskompatibilität

Das UiPath.UIAutomation.Activities-Paket und die UiPath Remote Runtime haben die gleiche UiPath-Treiberabhängigkeit. Für jede veröffentlichte Version des UIAutomation-Pakets wird ein Downloadlink für die UiPath Remote Runtime-Komponente mit derselben Versionsnummer bereitgestellt.

For example, for UiPath.UIAutomation.Activities package version 26.10.7, the required UiPath Remote Runtime installer can be downloaded from https://download.uipath.com/versions/26.10.7/UiPathRemoteRuntime.msi.

Sie können das UiPathRemoteRuntime.msi-Installationsprogramm herunterladen von:

• Produktdownloads im UiPath Customer Portal.
• Ressourcenzentrum in der UiPath Automation Cloud. Um auf das Ressourcencenter zuzugreifen, müssen Sie sich bei Ihrer Automation Cloud Organization anmelden, auf die Schaltfläche Hilfe in der Symbolleiste klicken und Ressourcen > Downloads auswählen.
• Oder Sie können es über die Seite Kontakt zum technischen Support anfordern.

Parallele Unterstützung

Die UiPath Remote Runtime-Komponente wird auf dem Citrix-Anwendungsserver, der virtuellen VMware-Maschine oder der Remotedesktopmaschine im Ordner %ProgramFiles(x86)\UiPath installiert. Alle installierten Versionen sind im %ProgramFiles(x86)%\UiPath\RemoteRuntime\packages\uipath-Ordner sichtbar.

When you build or execute a process, you need to use a UiPath.UIAutomation.Activities package which is compatible with the deployed driver version of the UiPath Remote Runtime.

Die Version der UiPath-Treiberabhängigkeit für das Paket UiPath.UIAutomation.Activities wird in Studio im Abschnitt Projektabhängigkeiten angezeigt.

The same UiPath version must be present on the remote machine, in the %ProgramFiles(x86)%\UiPath\RemoteRuntime\packages\uipath folder.

Jedes UiPathRemoteRuntime.msi Installationsprogramm enthält die neueste UiPath-Abhängigkeit sowie die neuesten unterstützten UiPath-Abhängigkeiten mit langfristigem Support (LTS).Die Versionen des kompatiblen Pakets UiPath.UIAutomation.Activities für ein bestimmtes UiPath Remote Runtime Installationsprogramm können im Eigenschaften Fenster der UiPathRemoteRuntime.msi Datei überprüft werden.

The table below enlists the dependencies between the UiPath.UIAutomation.Activities package and UiPath Remote Runtime:

Aktuelles UI Automation-Paket für die langfristiger Support-Version.	UiPath-Treiberabhängigkeit	UIAutomation-kompatible Versionen für UiPathRemoteRuntime	UiPathRemoteRuntime-Buildnummer
26.10.8	26.10.216.57077	26.10.8 25.10.43 25.10.42 24.10.19 23.10.22 23.10.21	26.10.8
25.10.43	25.10.207.63663	25.10.43 25.10.42 25.10.16 25.10.13 25.10.6 25.10.4 25.10.3 25.10.2 24.10.19 23.10.21 23.4.11	25.10.43
24.10.19	24.10.183.32648	24.10.19 23.10.21 23.4.11 22.10.11 22.4.12 22.4.11 21.10.10	24.10.185.56081
23.10.22	23.10.175.31759	23.10.22 23.10.21 23.4.11 22.10.11 22.4.12 22.4.11 21.10.10 20.10.15	23.10.177.13577
23.4.11	23.4.81.50665	23.10.11 23.4.11 22.10.10 22.4.12 22.4.11 21.10.10 20.10.15	23.10.86.3201
22.10.11	22.10.136.43035	25.10.6 25.10.4 25.10.3 25.10.2 24.10.13 24.10.12 23.10.17 23.4.11 22.10.11 22.4.12 22.4.11 21.10.10 20.10.15	22.10.11
22.4.12	22.4.67.58669	23.4.10 22.10.10 22.4.12 22.4.11 21.10.10 20.10.15	23.4.67.63183
21.10.10	21.10.67.58666	23.4.10 22.10.10 22.4.12 22.4.11 21.10.10 20.10.15	23.4.67.63183
20.10.15	20.10.8676.29744	23.4.10 22.10.10 22.4.12 22.4.11 21.10.10 20.10.15	23.4.67.63183
19.11.5	19.10.7601.15369	22.4.7 21.10.7 20.10.12 19.11.5 18.4.8	22.4.43.27553
18.4.8	10.0.7772.19184	22.4.7 21.10.7 20.10.12 19.11.5 18.4.8	22.4.43.27553

Wenn Sie eine Version des UiPath.UIAutomation.Activities-Pakets mit einer UiPath-Abhängigkeit verwenden, die nicht Teil der installierten UiPath-Abhängigkeiten auf der Remotemaschine ist, werden keine Selektoren generiert und die folgende Ausnahme wird ausgelöst: The UiPath.UIAutomation.Activities package is incompatible with the UiPath Remote Runtime running on the server.

Hinzufügen von Remote-Runtime-Abhängigkeiten

Die interaktive Auswahl in der Zielanwendung erstellt keine korrekten Selektoren, es sei denn, die UiPath.UIAutomation.Activities stimmen mit der UiPath Remote Runtime-Abhängigkeit auf dem Citrix-Anwendungsserver, der virtuellen VMware-Maschine, der Remote-Desktop-Maschine oder dem virtuellen Amazon WorkSpaces-Desktop überein.

For example, if you want to build an automation project using the UiPath.UIAutomation.Activities package version 26.10.7, you need to copy the corresponding UiPath dependency from the client machine (where Studio/Robot is installed) on the Citrix Application server, VMware virtual machine, the Remote Desktop machine, or the Amazon WorkSpaces virtual desktop.

Gehen Sie folgendermaßen vor:

1. On the client machine (where Studio is installed), navigate to the %UserProfile%\.nuget\packages\uipath folder. All installed UiPath dependencies are located here.

2. Kopieren Sie den Ordner mit der Version, die dem Paket UiPath.UIAutomation.Activities entspricht, das Sie verwenden möchten. Sie können die Liste der Abhängigkeiten anzeigen, die mit dem Paket UiPath.UIAutomation.Activities geliefert werden, auf der Seite Über UIAutomation-Aktivitäten oder indem Sie die Paketabhängigkeiten wie unter Side-by-Side-Support beschrieben überprüfen.

   

3. Navigieren Sie auf dem Citrix-Anwendungsserver, der virtuellen VMware-Maschine, der Remote Desktop-Maschine oder dem virtuellen Amazon WorkSpaces-Desktop zum Ordner %ProgramFiles(x86)%\UiPath\RemoteRuntime\packages\uipath und fügen Sie die zuvor kopierte UiPath-Abhängigkeitsversion hier ein.

   • For example, for UiPath.UIAutomation.Activities version 26.10.7, the corresponding UiPath dependency is 26.10.212.53849. This is the name of the folder you need to copy from the Studio/Robot machine to the remote machine.

   

Selektoren werden mit der aktuellen Version der UiPath.UIAutomation.Activities korrekt generiert. Änderungen werden wirksam, sobald die Abhängigkeit kopiert ist.

Die oben beschriebenen Remote Runtime-Abhängigkeiten sind sowohl für die Entwurfszeit als auch für die Ausführungszeit erforderlich.

Architektur von Remote Runtime

Wenn Sie einen Prozess starten, sendet der Roboter über einen RPC-Kanal die erforderlichen Befehle an die Erweiterung für Citrix oder an Windows-Remotedesktop. Dieses Informationspaket enthält auch Details über die Version des UIAutomation-Pakets, das für die Erstellung des Prozesses verwendet wurde.

Die entsprechende Erweiterung leitet dann das Informationspaket über einen virtuellen ICA-Kanal an die UiPath Remote Runtime-Komponente weiter, die sich auf den Citrix-Anwendungsservern oder auf der Remotedesktopmaschine befindet.

Abhängig von der Version des UIAutomation-Pakets, mit dem der Prozess erstellt wurde, weist die UiPath Remote Runtime-Komponente den Robot Executor an, welchen Treiber er verwenden soll.

Mehrere ICA-Kanäle

Die Kommunikation zwischen der Remote-Runtime-Komponente und der zugehörigen Erweiterung läuft über einen intern entwickelten ICA-Kanal. Die Verwendung mehrerer ICA-Kanäle ist möglich, aber der Citrix Receiver beispielsweise verwendet bereits mehrere Kanäle, u. a. für die Zwischenablage und Audio.

Überlegungen zu Datenübertragung und Bandbreite

Sobald die Remote-Runtime-Komponente installiert ist, können Sie Ihre Automationsprojekte erstellen, ohne Firewall-Regeln erstellen zu müssen.

Die Datenübertragung zwischen der Remote Runtime und der Erweiterung erfordert nur wenig Bandbreite. Beispielsweise überträgt jede Aktion des Roboters (z. B. eine Click-Aktivität) etwa 3 KB an Daten.

Mehrere Remote-Verbindungen

Wenn Sie durch mehrere Remote-Verbindungen springen (RDP, Citrix oder VMware), um einen bestimmten Remote-Zielcomputer zu erreichen, auf dem die Automatisierung entwickelt wird, müssen Sie Remote Runtime auf jedem zwischengeschalteten Remote-Computer installieren, nicht nur auf dem Zielcomputer. Weitere Informationen finden Sie auf der Seite Konfigurieren einer Multi-Hop-Verbindung.