Studio 用户指南

上次更新日期 2025年9月29日

Amazon WorkSpaces 扩展程序

安装扩展程序

使用 UiPath 扩展程序，您可以原生方式对 Amazon WorkSpaces 虚拟桌面进行自动化。扩展程序可以使用 UiPath Studio 或命令提示符进行安装。

先决条件

在安装扩展程序之前，请确保安装 Amazon WorkSpaces 客户端。

您可以选择为当前用户或所有用户安装扩展程序。安装类型必须匹配，即扩展程序安装类型必须与 Amazon WorkSpaces 客户端安装类型匹配。如果安装类型不匹配，扩展程序安装将失败。

备注：

Amazon WorkSpaces 可以使用 PCoIP (PC-over-IP) 或 DCV (Desktop Cloud Visualization) 协议进行配置。

使用 PCoIP 进行 Amazon WorkSpaces 自动化需要 UiPath.UIAutomation.Activities、UiPath Studio 和 UiPath Remote Runtime v24.10 或更高版本。
使用 DCV 进行 Amazon WorkSpaces 自动化需要 UiPath.UIAutomation.Activities、UiPath Studio 和 UiPath Remote Runtime v25.2 或更高版本。

为 DCV 配置扩展程序

使用 DCV 协议的 Amazon WorkSpaces 需要启用 DCV 扩展程序。由于默认禁用了对 WorkSpaces 扩展程序的支持，因此您必须将服务器和客户端的“配置扩展程序设置”设置为“服务器和客户端 – 启用扩展程序”。

要为 DCV 组策略配置扩展程序，请参阅《Amazon WorkSpace 文档》中的“管理 DCV 的组策略设置”。

启用组策略后，将写入以下 Windows 注册表键：

Windows Registry Editor Version 5.00  

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

您还可以参考以下功能，使用权限文件配置扩展程序：

extensions-client - 可用于在 Amazon DCV 客户端上启动已安装的扩展程序。
extensions-server - 可用于在 Amazon DCV 服务器上启动已安装的扩展程序。

有关更多信息，请参阅《Amazon DCV 文档》中的“添加权限”。

从 UiPath Studio

打开 UiPath Studio。
导航到“后台视图”>“工具”>“UiPath 扩展程序”。
在“Amazon WorkSpaces”下，从下拉菜单中选择首选的安装类型：
- 若选择“所有用户”，系统将为此计算机的所有用户安装扩展程序。对于此安装类型，您必须具有本地管理员权限，并且需要为所有用户安装 Amazon WorkSpaces 客户端。
- 若选择“当前用户”，系统将为当前用户安装扩展程序。对于此安装类型，您不需要本地管理员权限，但需要为每个用户安装 Amazon WorkSpace 客户端。
选择“安装”。系统会显示确认对话框。
重新启动 Amazon WorkSpaces 客户端，以使更改生效。
UiPath Amazon WorkSpaces 扩展程序现已安装，位置在 C:\Program Files (x86)\Common Files\UiPath\UiPath.Common\。

从命令提示符中

选择 Windows 开始按钮，然后在搜索字段中键入 cmd。
右键单击“命令提示符”，然后以管理员身份运行。
将目录更改为 UiPath 安装文件夹：
- 对于 Studio 按计算机安装模式，文件夹为 cd C:\Program Files\UiPath\Studio\UiPath。
- 对于 Studio 按用户安装模式，文件夹为 cd %localappdata%\Programs\UiPath\Studio\UiPath。
使用 SetupExtensions.exe /amazon-workspaces-client 命令按用户安装扩展程序，或使用 SetupExtensions.exe /amazon-workspaces-client-global 按计算机（为所有用户）安装扩展程序。此时将显示一个确认对话框。
重新启动 Amazon WorkSpaces 客户端，以使更改生效。
UiPath Amazon WorkSpaces 扩展程序现已安装。

要为 Amazon WorkSpaces 技术生成原生选取器，您还需要在所有 Amazon WorkSpaces 虚拟桌面上部署 UiPath Remote Runtime 组件，如 "UiPath Remote Runtime" 所述。

可从以下位置下载 UiPathRemoteRuntime.msi 安装程序：

UiPath Customer Portal 中的产品下载。
UiPath Automation Cloud 中的资源中心。要访问资源中心，请登录 Automation Cloud 组织，单击导航栏上的“帮助”按钮，然后选择“下载”选项。

卸载扩展程序

从 UiPath Studio

关闭正在运行的 Amazon WorkSpaces 客户端。
打开 UiPath Studio。
导航到“后台视图”>“工具”>“UiPath 扩展程序”。
选择“Amazon WorkSpaces”>“卸载”，然后确认您的选择。

系统将为所选安装类型（“所有用户”或“当前用户”）卸载扩展程序。

从命令提示符中

关闭所有正在运行的 Amazon WorkSpaces 虚拟桌面。
选择 Windows 开始按钮，然后在搜索字段中键入 cmd。
右键单击“命令提示符”，然后以管理员身份运行。
将目录更改为 UiPath 安装文件夹：
- 对于 Studio 按计算机安装模式，文件夹为 cd C:\Program Files\UiPath\Studio\UiPath。
- 对于 Studio 按用户安装模式，文件夹为 cd %localappdata%\Programs\UiPath\Studio\UiPath。
使用 SetupExtensions.exe /amazon-workspaces-client /uninstall 命令为当前用户卸载扩展程序，或使用 SetupExtensions.exe /amazon-workspaces-client-global /uninstall 为所有用户（按计算机）卸载扩展程序。系统会显示确认对话框。