Studio
2022.4
false
Banner background image
Studio User Guide
Last updated Mar 1, 2024

Extension for Microsoft Remote Desktop and Apps

By installing the UiPath Extension for Microsoft RemoteApp and Desktop you are capable of natively generating selectors over RDP connections. It can be installed per-user (from Studio or the Command Prompt) or per-system (from the Command Prompt and Studio Installer)

From UiPath Studio

  1. Open Studio.
  2. Navigate to Home > Tools > UiPath Extensions.
  3. Select Microsoft Remote Desktop and Apps > Install. A confirmation dialog box is displayed.
  4. Restart your active RDP connection for the changes to take effect. The UiPath Extension for Microsoft Remote Desktop and Apps is now installed.

From the Command Prompt

  1. Click the Windows Start button and type cmd in the search field.
  2. Right click on Command Prompt and run it as administrator.
  3. Change the directory to the UiPath installation folder (cd C:\Program Files\UiPath\Studio\UiPath).
  4. Use the SetupExtensions /RdpClient command to install the extension per user, or the SetupExtensions /RdpClientGlobal command to install the extension per system. A confirmation dialog box is displayed.
  5. Restart your active RDP connection for the changes to take effect. The UiPath Extension for Windows Remote Desktop is now installed.
    Note: To generate native selectors over RDP connections, you also need to deploy the UiPath Remote Runtime component on the Remote Desktop machine, as explained on this page. The UiPathRemoteRuntime.msi installer is obtained by requesting it here.

Microsoft RemoteApp and Desktop troubleshooting

Note: Automating RemoteApps running on different remote servers at the same time is not supported.

If you are using RemoteApps running on different remote servers (different Remote Desktop Session Hosts), behind the same Remote Desktop Connection Broker, interactive selection generates native selectors only for the applications published from one remote server.

This happens because in the described scenario, RemoteApps from different servers share the same mstsc.exe process on the client machine, and the UiPath extension cannot create virtual channels with each of the remote servers.
To configure the RemoteApps to launch a new mstsc.exe process for each remote server, add the following line in your RDP file:

disableconnectionsharing:i:1

You may need to remove the signature line after this configuration, as the RDP file will be seen as corrupted.

Note: With this configuration, each time you open a new application from a remote server, the mstsc.exe process corresponding to that remote server respawns. To avoid any issues, it is recommended to start all remote applications before interacting with them.

Was this page helpful?

Get The Help You Need
Learning RPA - Automation Courses
UiPath Community Forum
Uipath Logo White
Trust and Security
© 2005-2024 UiPath. All rights reserved.