Extension for Amazon WorkSpaces

Installing the extension

By installing the UiPath Extension for Amazon WorkSpaces you are capable of automating Amazon WorkSpaces virtual desktops natively. The extension can be installed from UiPath Studio or the Command Prompt.

Prerequisites

Before installing the extension, make sure to install the Amazon WorkSpaces client. The Install button is active only if Amazon WorkSpaces client is installed and only for the installation type that matches the Amazon Workspaces installation type.

You can choose to install the extension either for the current user or for all users. It is required to match the installation types, namely the extension installation type must correspond with the Amazon WorkSpaces client installation type. If the installation types do not match, the extension installation will fail.

Note: Amazon WorkSpaces supports configuration with either the WSP (WorkSpaces Streaming Protocol) or PCoIP (PC-over-IP) protocols. However, automation is currently available only for PCoIP. Therefore, please select a PCoIP bundle when creating a workspace.

From UiPath Studio

1. Open UiPath Studio.
2. Navigate to Home > Tools > UiPath Extensions.
3. Under Amazon WorkSpaces, select the preferred installation type from the drop-down menu:
   • All Users to install the extension for all users of this machine. For this installation type, you must have local Administrator privileges and the Amazon WorkSpaces client needs to be installed for all users.
   • Current User to install the extension for the current user. For this installation type, you do not need local Administrator privileges, but Amazon WorkSpace client needs to be installed per user.
4. Select Install. A confirmation dialog box is displayed.
5. Restart your Amazon WorkSpaces client for the changes to take effect.
6. The UiPath Extension for Amazon WorkSpaces 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\UiPath\Studio\UiPath for per-machine Studio installations.
   • cd %localappdata%\Programs\UiPath\Studio\UiPath for per-user Studio installations.
4. Use the SetupExtensions.exe /amazon-workspaces-client command to install the extension per user or SetupExtensions.exe /amazon-workspaces-client-global to install it for all users (per machine). A confirmation dialog box is displayed.
5. Restart your Amazon Workspaces client for the changes to take effect.
6. The UiPath Extension for Amazon WorkSpaces is now installed.

To generate native selectors for Amazon WorkSpaces technologies, you also need to deploy the UiPath Remote Runtime component on all your Amazon WorkSpaces virtual desktops, 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, click the Help button on the navigation bar and choose the Downloads option.

Uninstalling the extension

From UiPath Studio

1. Close your running Amazon WorkSpaces client.
2. Open UiPath Studio.
3. Navigate to Home > Tools > UiPath Extensions.
4. Select Amazon WorkSpaces > Uninstall, and confirm your choice.
5. The extension is uninstalled for the selected installation type (All Users or Current User).

From the Command Prompt

1. Close all your running Amazon WorkSpaces virtual desktops.
2. Select the Windows Start button and type cmd in the search field.
3. Right-click on Command Prompt and run it as administrator.
4. Change the directory to the UiPath installation folder:
   • cd C:\Program Files\UiPath\Studio\UiPath for per-machine Studio installations.
   • cd %localappdata%\Programs\UiPath\Studio\UiPath for per-user Studio installations.
5. Use the SetupExtensions.exe /amazon-workspaces-client /uninstall command to uninstall the extension for the current user or SetupExtensions.exe /amazon-workspaces-client-global /uninstall to uninstall it for all users (per machine). A confirmation dialog box is displayed.
6. The UiPath Extension for Amazon WorkSpaces is now uninstalled.