Amazon WorkSpaces 扩展程序

安装扩展程序

UiPath 扩展程序允许您以原生方式自动化 Amazon WorkSpaces 虚拟桌面。您可通过 UiPath Studio 或命令提示符安装扩展程序。

先决条件

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

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

备注：

Amazon WorkSpaces 可以配置为使用PCoIP (PC-over-IP) 或DCV （桌面云可视化）协议。

• 使用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 扩展程序

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.

要为 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

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

从命令提示符中

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

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

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

从命令提示符中

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

已卸载适用于 Amazon WorkSpaces 的 UiPath 扩展程序。