# Extension for Amazon WorkSpaces

> The UiPath Extension allows you to automate Amazon WorkSpaces virtual desktops natively. The extension can be installed from UiPath Studio or the Command Prompt.

## Installing the extension

The UiPath Extension allows you to automate 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](https://clients.amazonworkspaces.com/).

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

:::note
Amazon WorkSpaces can be configured with either the **PCoIP** (PC-over-IP) or the **DCV** (Desktop Cloud Visualization) protocol.
* Automating Amazon WorkSpaces using **PCoIP** requires UiPath.UIAutomation.Activities, UiPath Studio, and UiPath Remote Runtime **v24.10** or higher.
* Automating Amazon WorkSpaces using **DCV** requires UiPath.UIAutomation.Activities, UiPath Studio, and UiPath Remote Runtime **v25.2** or higher.
:::

### Configuring the extension for DCV

Amazon Workspaces using the DCV protocol requires DCV extensions to be enabled. Because the support for WorkSpaces extensions is disabled by default, you must set the **Configure extensions setting** to **Server and client – Enable extensions** for both server and client.

To configure the extension for a DCV group policy, refer to [Manage Group Policy settings for DCV](https://docs.aws.amazon.com/workspaces/latest/adminguide/group_policy.html#gp_configurations_dcv) in the Amazon WorkSpace documentation.

  ![docs image](https://dev-assets.cms.uipath.com/assets/images/studio/studio-docs-image-542792-507037bf.webp)

Once you enable the group policy, the following Windows registry keys are written:

```
Windows Registry Editor Version 5.00  

[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Amazon\WSP] "hc_toggle_extensions"=dword:00000001 "hc_toggle_extension_options"=dword:00000000
```

You can also configure extensions from a permissions file, by referencing the following features:

* **`extensions-client`** - Allows you to start the installed extensions on the Amazon DCV client.
* **`extensions-server`** - Allows you to start the installed extensions on the Amazon DCV server.

For more information, refer to [Adding permissions](https://docs.aws.amazon.com/dcv/latest/adminguide/security-authorization-file-create-permission.html) in the Amazon DCV documentation.

### From UiPath Studio

1. Open UiPath Studio.
2. Navigate to **Backstage View** &gt; **Tools** &gt; **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 **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 per-machine (for all users). 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 [UiPath Remote Runtime](https://docs.uipath.com/studio/standalone/2025.10/user-guide/about-uipath-remote-runtime#uipath-remote-runtime).

The `UiPathRemoteRuntime.msi` installer can be downloaded from:

* **Product Downloads** in the [UiPath Customer Portal](https://customerportal.uipath.com/product-downloads?q=UiPath%20Remote%20Runtime).
* **Resource Center** in the [UiPath Automation Cloud](https://cloud.uipath.com/). 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 **Backstage View** &gt; **Tools** &gt; **UiPath Extensions**.
4. Select **Amazon WorkSpaces** &gt; **Uninstall**, and confirm your choice.

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 **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.

The UiPath Extension for Amazon WorkSpaces is uninstalled.
