Extension for Microsoft Remote Desktop and Apps

Installing the extension

By installing the UiPath Extension for Microsoft Remote Desktop and Apps 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 UiPath 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.
5. The UiPath Extension for Windows Remote Desktop is now installed and is located at C:\Program Files (x86)\Common Files\UiPath\UiPath.Common\.

From the Command Prompt

1. Select 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 (x86)\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.
6. The UiPath Extension for Windows Remote Desktop is now installed.

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 can be downloaded from:

• Product Downloads in the UiPath Customer Portal
• Resource Center in the UiPath Automation Cloud. To access Resource Center, log in to your Automation Cloud Organization and click the Help button on the navigation bar.

How to

For instructions on additional operations you might need to perform while installing or configuring the UiPath Extension for Microsoft Remote Desktop and Apps, see the following:

• Configure the UiPath Remote Plugin for custom remote applications
• Configure the Workspot Client for remote automation

Configure the Workspot Client for remote automation

The Workspot Unified Digital Workplace Platform can be configured to use the same Remote Desktop Protocol (RDP) plugins usually used by the UiPath Remote Desktop client. This documentation page explains the step-by-step process to get the Workspot Client working with the existing UiPath Extension for Microsoft Remote Desktop and Apps.

Prerequisites

Before you begin, make sure to:

• Install the UiPath Extension for Microsoft Remote Desktop and Apps on the client.
• Install the UiPath Remote Runtime on your Virtual Desktop Infrastructure (VDI).

Locate and copy the RDP Registry keys

You need to navigate to your Registry Editor to find and copy the RDP Registry keys.

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Terminal Server Client\Default\AddIns\UiPathPluginRdp]
"Name"="C:\Program Files (x86)\Common Files\UiPath\UiPath.Common\24.10.92.62643\UiPathPluginRdp_x64.dll"

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Terminal Server Client\Default\AddIns\UiPathPluginRdp32]
"Name"="C:\Program Files (x86)\Common Files\UiPath\UiPath.Common\24.10.92.62643\UiPathPluginRdp.dll"

You can get to these keys by typing regedit into the Run command (Windows Key + R) to open the Registry Editor. Navigate to the RDP Registry keys using the paths above, and copy these keys.

Note: the UiPath driver version, 24.10.92.62643, may differ in your case. Make sure to copy the exact value you find in the Registry Editor.

Paste the keys into the Workspot Registry

Finally, navigate to the Workspot registry and paste the keys (UiPathPluginRdp, UiPathPluginRdp32) you have copied. The paths where you need to copy these values for Workspot are:

[HKEY_LOCAL_MACHINE\SOFTWARE\Workspot\Client\PersistentSettings\VDIPlugins\UiPathPluginRdp]
"Name"="C:\Program Files (x86)\Common Files\UiPath\UiPath.Common\24.10.92.62643\UiPathPluginRdp_x64.dll"

[HKEY_LOCAL_MACHINE\SOFTWARE\Workspot\Client\PersistentSettings\VDIPlugins\UiPathPluginRdp32]
"Name"="C:\Program Files (x86)\Common Files\UiPath\UiPath.Common\24.10.92.62643\UiPathPluginRdp.dll"

By pasting these registry keys, you are essentially directing Workspot to the location of the RDP extensions allowing it to use them.