配置Ukey_无影终端(WUYING Terminal)-阿里云帮助中心

如需在云电脑中正常使用Ukey类外设，请管理员按照本文说明在控制台配置相关外设策略，并由终端用户在无影终端和云电脑上完成相关配置。

获取外设信息

对于USB类型的外设，需要用到的信息是VID（供应商识别码）和PID（产品识别码），后续在配置外设策略时将会用到。VID和PID的格式均为十六进制字符，例如0xa12c，其中0x前缀通常可以省略不写。您可以通过多种方式查询已经连接的USB外设的VID和PID。

重要

外接设备在云电脑中的可用性受到诸多因素制约，例如无影终端的类型及版本、云电脑镜像类型及版本、运行无影软件客户端的本地设备的类型及版本、外接设备的品牌及型号等。您可以在浏览器中访问无影外设兼容性查询页面并查询云电脑对具体外接设备的兼容性，该页面数据是在实验室条件下获得的，具体以实际情况为准。

在无影终端中获取

打开并登录无影客户端。
在客户端右上角点击图标，并选择设置。
在设置窗口的左侧导航栏中点击外设，并在本地USB外设面板上查看USB外设的VID和PID信息。

在电脑中手动查询

您可以在电脑的设备管理信息中查询到外设的VID和PID。

Windows

在开始菜单中搜索并打开设备管理器。
在设备管理器窗口中选择您的硬件名称 > 通用串行总线控制器，并双击要查询的USB设备。
在属性弹窗的详细信息页签上，从属性下拉列表中选择硬件Id，即可在下方文本框中查看VID和PID。

macOS

在系统任务栏中选择 > 关于本机，并在弹窗中点击更多信息。
在关于本机面板底部点击系统报告。
在新窗口左侧导航栏中选择硬件 > USB，并在右侧面板上选择要查询的USB设备，即可在下方查看VID和PID。

使用第三方工具查询

您可以使用USB Device Tree Viewer工具查看外设信息，该工具仅支持Windows操作系统。

下载工具：https://www.uwe-sieber.de/usbtreeview_e.html#download。
解压下载好的安装包，双击打开UsbTreeView.exe。
在工具的左侧目录树中选择要查询的USB设备，并在右侧面板的Device ID区域查看该设备的VID和PID。

无影硬件终端

通过无影硬件终端（例如无影魔方AS05、无影魔方Pro AS06、无影23.8寸一体机US01等）使用云电脑时，请管理员和终端用户按照以下步骤配置外设接入。

管理员配置外设策略

外设管控策略包含在云电脑策略中，需要由管理员在控制台上创建和维护。

说明

下文以无影云电脑企业版控制台为例。关于商业版的具体操作步骤，请参见管理策略。

新建或修改外设策略的通用操作步骤

新建自定义策略并绑定至云电脑

默认情况下，创建好的云电脑会绑定系统自动生成的默认策略，但默认策略无法修改，需要由管理员在控制台上创建一条自定义云电脑策略，并为云电脑绑定该策略。

登录无影云电脑企业版控制台。
在左侧导航栏，选择运维管理 > 策略。
在策略页面上单击创建策略。
在创建策略页面上按照页面提示填写策略名称，根据需要修改策略配置，并单击确定。
策略创建完成后，您可以在策略页面的列表中查看新建的策略。
在左侧导航栏，选择资源管理 > 云电脑企业版。
在云电脑企业版页面上，按需选择以下一种操作：
- 单一操作：找到目标云电脑，在操作列中单击 ⋮ 图标，然后选择更改策略。
- 批量操作：选择一台或多台云电脑，在页面底部选择更多 > 更改策略。
在更改策略面板的必选策略页签上单击更改策略，然后选择新建的自定义策略，并单击确定。
说明
如果云电脑所属的资源组已有关联策略，则无法在此处直接更换云电脑的关联策略。您可以直接更换资源组的关联策略，或者先将云电脑移出资源组再更换云电脑的关联策略。
在更改策略面板底部单击确定，并单击确认修改策略。

修改已绑定云电脑的自定义策略

如果云电脑已经绑定自定义策略，则管理员可以在控制台直接修改该策略，无需重新绑定。

登录无影云电脑企业版控制台。
在左侧导航栏，选择运维管理 > 策略。
在策略页面上找到要修改配置的自定义策略，并在操作列单击修改策略。
在修改策略页面上按需修改策略配置，并单击确定。

外设策略配置说明

开启本地磁盘映射（条件步骤）

对于带有CD-ROM存储的Ukey设备，如果开启USB重定向时使用的是方式1（即全局开启），则还需要开启本地磁盘映射；如果使用的是方式2（即通过白名单规则定向开启），则不需要执行此步骤。

配置项位置：外设管控 > 本地磁盘映射 > 本地磁盘映射。
配置要求：将本地磁盘映射设置为读写或只读。

开启USB重定向

方式1：全局开启
- 配置项位置：外设管控 > 外设重定向 > USB重定向开关。
- 配置要求：打开USB重定向开关。
方式2：通过白名单规则定向开启
全局开启USB重定向后，所有USB设备均可连接。若不希望如此，可以选择不打开该开关，而是通过为特定USB设备添加白名单规则来定向开启。
- 配置项位置：外设管控 > 外设黑白名单 > 添加规则。
- 配置要求：输入设备名称、VID、PID，并将黑白名单类型设置为白名单。

配置自定义外设规则（可选步骤）

为防止终端用户在客户端上配置错误，管理员可以在云电脑策略中创建自定义外设规则，该规则优先级高于终端用户在客户端上的自定义配置。关于不同维度外设策略的优先级，请参见策略优先级。

配置项位置：外设管控 > 外设管理规则 > 新增自定义外设规则。
配置要求：将设备类型设置为Ukey，输入设备名称、VID、PID，并将重定向模式设置为USB重定向。

终端用户配置和使用外设

连接外设

将外设连接到无影硬件终端上。

首次连接外设时，云电脑桌面右下角将弹出连接配置弹窗，您可以选择设备类型，设置是否自动连接，并选择是否记住当前配置。

panel_peripheral_detected_ukey

安装驱动

外设连接成功后，一般无法直接使用，必须先安装驱动，有多种驱动安装方法可供选择。

自动扫描并安装

首次连接外设时，系统将自动检测驱动，如果驱动库中有相应的驱动，则弹出安装驱动弹窗。您可以选择立即安装。

db_install_driver

要使用上述功能，必须同时符合以下条件：

云电脑镜像：操作系统为Windows，镜像版本不低于V2.5.0。
无影终端：
- 无影魔方AS05：版本不低于V7.5。
- 无影魔方Pro AS06：版本不低于V7.5。
- 无影方舟NE01：版本不低于V7.5。
- 无影方舟Pro NS01：版本不低于V7.5。

通过无影管家安装

无影管家是云电脑内置的一款软件，具备丰富的云电脑管理能力。

选择以下的一种方式打开无影管家：
- 在云电脑桌面上双击无影管家快捷方式图标。
- 在云电脑桌面上单击悬浮球，并单击无影管家。
在无影管家首页单击外接设备服务。
在外接设备管理界面上找到状态为驱动缺失的外设，单击修复。
- 若无影驱动库中检测到外设的驱动，则在弹窗中单击下载并安装驱动。待安装完毕后，单击关闭。
- 若无影驱动库中暂无该外设的驱动，但检测到您的本地设备已安装该驱动，则在弹窗中单击上传并安装本地驱动。待安装完毕后，单击关闭。
- 若无影驱动库和您的本地设备上均无该外设的驱动，则请在云电脑上自行访问该外设品牌的官方网站，并下载安装对应的驱动。
若外设状态为已连接，则说明驱动安装成功，外设可正常使用。

通过无影应用中心安装

无影应用中心是管理员统一分发和管理应用的工具，内含无影提供的应用和管理员自行上传的应用，您可以在这里管理应用和安装驱动。

连接云电脑。在云电脑桌面双击图标，打开无影应用中心。
在AppCenter的左侧导航栏单击驱动精灵。
说明
仅镜像版本不低于V2.10.0的Windows云电脑中的无影应用中心支持该功能。
在无影驱动库或企业名下驱动库页签上，根据设备类型或品牌搜索，并在目标外设的卡片上单击下载并安装。

手动安装

如果前述方法均无法使用，您可以在云电脑中访问外设品牌的官方网站，并下载安装官方驱动程序。