外设
USB 设备重定向
适用于 ChromeOS 的 Citrix Workspace 应用程序支持各种 USB 外设。借助此新增功能,您可以创建 Google 策略以识别设备的 PID/VID,从而在 Citrix Workspace 中启用其使用。此支持也适用于新的 USB 设备。
重要提示:
通过 USB 重定向后,YubiKey 无法在 Citrix 会话中使用。 有关详细信息,请参阅合作伙伴工单。 由于适用于 ChromeOS 的 Citrix Workspace 应用程序不支持 FIDO2 重定向,用户可以使用 USB 重定向作为替代方法来访问会话中的 YubiKey。要启用此功能,请确保 DDC 中的 FIDO2 Redirection 策略设置为 Prohibited。 注意: 存在一个已知问题 ([HDX-92219]),可能会导致 YubiKey 在通过 USB 重定向到 Server OS VDA 时无法按预期运行。 [RFHTMCRM-16502]
如何配置
有关配置 USB 设备的信息,请参阅知识中心文章 CTX200825。
Kiosk 模式下 USB 设备的自动重定向
在 kiosk 模式下,USB 设备会在会话中自动重定向,无需任何手动干预。在用户和公共模式下,首次使用时,您必须从工具栏或“连接中心”手动将 USB 设备重定向到会话中。此手动 USB 重定向是为了授予 Chrome 操作系统访问 USB 设备的权限。插入 USB 设备后,它会自动重定向到会话中。
重要提示:
- 如果在运行多个会话时插入 USB 设备,则 USB 会重定向到处于焦点的会话中。
- 如果没有会话处于焦点,则 USB 设备不会重定向到任何会话中。
- 如果正在运行单个会话,并且在插入 USB 设备时该会话未处于焦点,则 USB 设备重定向可能会失败。
将 USB 设备重定向到新会话
注意:
要将 USB 设备重定向到新会话,需要从上一个会话中移除 USB 设备。
- 右键单击 Citrix Workspace 图标,然后选择连接中心。此时将显示“连接中心”窗口。
- 选择一个会话或应用程序。
- 单击设备。
-
- 导航到 USB 部分。
-
- 单击全部释放。
双跳
从 2301 版本开始,Citrix Workspace 应用程序支持双跳方案。此功能是对 USB 重定向的增强。
-
有关详细信息,请参阅 Citrix Virtual Apps and Desktops 文档中的双跳。
-
复合 USB 重定向
以前,当复合 USB 设备连接到本地设备时,它只能通过 USB 重定向作为单个设备使用。缺点是音频和视频等接口也通过 USB 重定向,尽管有优化通道。这些接口不是独立的,由于这种局限性,管理员无法决定哪些组件通过 USB 重定向,哪些组件通过优化虚拟通道(如音频接口)重定向以实现最佳性能。
从 2211 版本开始,管理员可以配置设备的某些接口是否通过 USB 重定向到会话。最终用户现在可以通过 USB 重定向选择并将复合 USB 设备的特定组成接口重定向到 Citrix Workspace 应用程序会话。
关于复合 USB 重定向
USB 2.1 及更高版本支持 USB 复合设备的概念,其中许多子设备与同一 USB 总线共享单个连接。此类设备采用单个配置空间和共享总线连接,其中使用唯一的接口编号 00-ff 来标识每个子设备。此类设备也不同于 USB 集线器,USB 集线器为其他独立寻址的 USB 设备提供新的 USB 总线源以进行连接。
客户端端点上的复合设备可以转发到虚拟主机,形式为:
- 单个复合 USB 设备,或
- 一组独立的子设备(拆分设备)
当复合 USB 设备被转发时,整个设备将对本地设备不可用。转发还会阻止本地设备上所有应用程序(包括 Citrix Workspace 应用程序)对设备的本地使用。
考虑一个同时具有音频设备和用于静音及音量控制的 HID 按钮的 USB 耳机设备。如果整个设备使用通用 USB 通道转发,则该设备将无法通过优化的 HDX™ 音频通道进行重定向。但是,与通用通道相比,通过优化的 HDX 音频通道发送音频可以获得更好的性能。
为解决这些问题,Citrix 建议您拆分复合设备,并且仅转发使用通用 USB 通道的子接口。这种机制可确保其他子设备可供本地设备上的应用程序使用,包括提供优化 HDX 体验的 Citrix Workspace 应用程序。此方法允许将所需的设备转发到远程会话并使其可用。
如何启用此功能
您可以通过以下方式启用此功能:
- Configuration.js
- 全局应用程序配置服务
- Google 管理策略
Configuration.js
要使用 configuration.js 文件配置复合 USB 重定向,请执行以下操作:
- 在 ChromeApp root 文件夹中找到 configuration.js 文件。
-
编辑 configuration.js 文件以配置复合 USB 重定向功能。
注意:
- Citrix 建议您在进行更改之前备份 configuration.js 文件。
- Citrix 建议仅在为用户重新打包适用于 ChromeOS 的 Citrix Workspace 应用程序时才编辑 configuration.js 文件。
- 编辑 configuration.js 文件需要管理员级别的凭据。
- 将 enableCompositeDeviceSplit 设置为 true。
以下是 JSON 数据的示例:
```
{
"features": {
"usb": {
"enableCompositeDeviceSplit": true
}
}
}
<!--NeedCopy--> ```
- 保存更改。
注意:
- 要禁用此功能,请将 enableCompositeDeviceSplit 属性设置为 false。
全局应用程序配置服务
在云设置中,管理员可以通过在“全局应用程序配置服务”中将 enableCompositeDeviceSplit 属性设置为 True 来启用复合 USB 重定向功能。
- 有关详细信息,请参阅全局应用程序配置服务文档。
Google 管理策略
在本地部署中,管理员可以使用 Google 管理策略启用复合 USB 重定向功能,如下所示:
- 登录 Google 管理策略。
- 转到设备管理 > Chrome 管理 > 用户设置。
-
在 engine_settings 键下方的 policy.txt 文件中添加以下字符串。以下是 JSON 数据的示例:
{ "features": { "usb": { "enableCompositeDeviceSplit": true } } } <!--NeedCopy--> - 保存更改。
如何配置
先决条件:
- 允许具有 VID:PID 值的 USB 设备列表,并在 Delivery Controller 上启用 USB 设备重定向策略。有关详细信息,请参阅知识中心文章 CTX200825。
- 此功能适用于受管设备,不适用于 BYOD。
要启用 USB 自动检测:
- 转到 Google 管理策略设置。
- 选择WebUSB API 允许的设备选项。
- 输入适用于 ChromeOS 的 Citrix Workspace 应用程序扩展程序 ID。例如,
chrome-extension://haiffjcadagjlijoggckpgfnoeiflnem。 -
按如下方式添加设备的 VID 和 PID:

- 添加 VID 和 PID 值后,Citrix Workspace 应用程序现在可以自动检测会话中的设备。
-
应用 Google 管理策略。有关设备规则和示例 JSON 数据的更多信息,请参阅以下部分。
- 保存更改。
设备规则
Citrix Workspace 应用程序使用设备规则来决定允许或阻止哪些 USB 设备转发到远程会话。
以下是关键字的说明:
- **allow:** 此部分包含可重定向到会话的设备及其子接口列表。
- **deny:** 此部分包含无法重定向到会话的设备及其子接口列表。
-
autoRedirect: 此部分包含可通过 USB 重定向自动重定向到会话的设备及其子接口列表。
注意:
- 每个对象都表示一个设备,其中包含 USB 设备的强制性
vid和pid值。split和interfaceClass值是可选的。
- 每个对象都表示一个设备,其中包含 USB 设备的强制性
- vid, pid(强制性): 表示 USB 设备的供应商 ID (VID) 和产品 ID (PID)。以十六进制格式输入值。
- split(可选): 期望一个布尔值,指示设备是否拆分为子接口。
- interfaceClass(可选): 表示 USB 接口类。允许的值包括音频、视频、HID、打印机、存储等。
以下是 JSON 数据示例:
{
"settings": {
"value": {
- "settings_version": "1.0",
- "device_settings": {
"deviceRules": {
"allow": [
{"vid": "11","pid": "22", "split":true, "interfaceClass":["audio","video"]} //split device and allow redirection of 'audio' & 'video' interfaces.
],
"deny": [
{"vid": "33","pid": "44"}, //deny redirection of this whole device with vid= 33 & pid = 44, including all of its interfaces.
{"vid": "77","pid": "88","split":true,"interfaceClass":["audio"]} //split device and deny the redirection of 'audio' interface only; remaining interfaces(if any) are redirected through USB.
],
"autoRedirect": [
{"vid": "55","pid": "66"}, //auto redirect the device when it's connected.
{"vid": "55","pid": "66","split":true,"interfaceClass":["hid"]} //split device and auto redirect only the 'hid' interface when the device is connected.
]
}
}
}
}
}
<!--NeedCopy-->
如何使用此功能
要使用复合 USB 重定向功能:
-
单击工具栏中的 USB 图标。

如果没有连接 USB 设备,则会出现以下弹出窗口:

-
将 USB 设备连接到本地计算机。 可能会出现以下弹出窗口:

-
- 单击USB 设备以查看和重定向 USB 组件。成功连接后,Citrix Workspace 应用程序会检测到 USB。对于每个 USB 组件接口,您都会看到一个下拉菜单。这两个选项是:
- 会话内和本地计算机访问(优化): 如果要在设备上和会话中访问 USB,请选择此选项。
- 会话内访问(通用): 如果只想在会话中访问 USB,请选择此选项。 为了获得更好的性能,请选择会话内和本地计算机访问(优化)选项。

-
- 选择连接以重定向接口。

成功重定向后,状态将更改为已连接。
注意:
要手动添加 USB 设备,请单击添加设备。此时会出现 Chrome 选择器对话框,其中列出了 USB 设备。您可以从列表中选择设备。
如果 USB 设备连接被拒绝,则会出现以下错误消息:
“您的管理员已阻止新插入的设备。 请联系您的组织管理员寻求帮助。”
如何在会话之间传输 USB 接口
当您单击工具栏中的 USB 图标时,将显示连接到会话的 USB 设备列表。如果 USB 设备已在其他会话中使用,您会看到 USB 组件显示已连接到其他会话状态。
要重定向到当前会话,请选择 USB 组件旁边的连接。状态会相应更改。
复合 USB 自动重定向设置
以前,没有与 USB 自动重定向设置相关的选项来设置最终用户首选项。由于管理员控制这些策略,因此最终用户必须在每次会话启动时手动重定向所需的 USB 设备。
从 2301 版本开始,最终用户可以为虚拟桌面会话中的任何 USB 设备选择自动重定向首选项。Citrix Workspace 应用程序现在提供应用程序级别设置,最终用户可以在其中控制 USB 自动重定向。最终用户可以设置首选项并跨会话启动保存设置。
- 有两个选项:一个在会话启动时,另一个在会话进行中。

注意:
- 此功能支持本地和云部署,并且仅适用于受管 Chrome 用户。
通过 DDC 策略配置复合 USB 重定向
以前,管理员使用 Google 管理策略来配置客户端 USB 重定向。
从 2306 版本开始,您也可以通过 DDC 策略配置 USB 重定向。通过 DDC 策略进行的配置允许管理员以统一和集中的方式定义策略和行为。这些策略适用于托管设备和用户的本地部署和云部署。此功能在 VDA 2212 及更高版本中受支持。
如何配置
您可以通过以下方式之一配置此功能:
- Configuration.js
- Google Admin Policy
注意:
- 策略 enableDDCUSBPolicy 默认设置为 true。
Configuration.js
要使用 configuration.js 文件禁用此功能,请执行以下操作:
- 在 ChromeApp root 文件夹中找到 configuration.js 文件。
-
编辑该文件。
注意:
- Citrix 建议您在进行更改之前备份 configuration.js 文件。
- Citrix 建议仅在为用户重新打包适用于 ChromeOS 的 Citrix Workspace 应用程序时才编辑 configuration.js 文件。
- 编辑 configuration.js 文件需要管理员级别的凭据。
-
将 enableDDCUSBPolicy 的值设置为 false。以下是 JSON 数据示例:
"features" : { "usb" : { "enableDDCUSBPolicy": false } } <!--NeedCopy-->
-
- 保存更改。
Google 管理策略
对于托管设备和用户,管理员可以使用 Google 管理策略禁用此功能,如下所示:
-
登录到 Google 管理策略。
-
转到 Device management > Chrome Management > User Settings。
-
在 engine_settings 键下,将以下字符串添加到 policy.txt 文件中。 以下是 JSON 数据示例:
"features" : { "usb" : { "enableDDCUSBPolicy": false } } <!--NeedCopy--> -
保存更改。
DDC 策略
以下屏幕截图显示了与 USB 重定向相关的 DDC 策略。此功能在 VDA 2212 及更高版本中受支持。

有关与 USB 重定向相关的 DDC 策略的更多信息,请参阅 Citrix Virtual Apps and Desktops 文档中的以下文章:
USB 设备的自动重定向
要自动重定向 USB 设备,您必须遵循 USB 设备规则。 您可以通过以下方式配置 USB 设备规则:
复合 USB 设备 UI 的增强功能
从 2306 版本开始,当复合 USB 设备的配置设置为 “split”: true 时,USB 设备 UI 会根据接口编号而不是接口类显示组件。
有关详细信息,请参阅 复合 USB 重定向 文章。
用户界面
- 以下是一个示例:

通过 DDC 策略增强复合 USB 重定向
从 2307 版本开始,您可以确定特定的复合 USB 接口或类是否可以默认重定向到 VDA。如果您的 ChromeOS 设备连接了复合 USB,则配置 enableDefaultAllowPolicy 可帮助您决定是否可以通过 DDC 策略默认允许 USB 重定向。VDA 2212 及更高版本支持此功能。
如何使用
当您将属性 enableDefaultAllowPolicy 设置为 true,并且将特定的接口类或接口编号重定向到 VDA 时,您必须添加策略规则以拒绝重定向其他接口类或编号。您可以通过 DDC 策略 客户端 USB 设备重定向规则(版本 2) 配置此功能。
有关详细信息,请参阅 USB 设备重定向规则(版本 2)。此外,您可以通过 Google 管理策略配置被拒绝的部分,但仅限于接口类级别。
有关详细信息,请参阅 复合 USB 设备 UI 的增强功能。
以下是通过 DDC 策略 客户端 USB 设备重定向规则(版本 2) 进行配置的示例,其中允许接口编号 03 进行重定向。
```
"DENY: vid=1188 pid=A301 split=01 intf=00,01,02"
<!--NeedCopy--> ```
以下是通过 Google 管理策略规则进行配置的示例,您可以在其中允许 HID 接口重定向并拒绝音频接口类。
```
"deny": [
{"vid":"05e9", "pid":"0428", "split":true, "interfaceClass":["audio"]
}
]
<!--NeedCopy--> ```
如何配置
您可以通过以下任一方式配置此功能:
- Configuration.js
- Google 管理策略
注意:
- 默认情况下,策略 enableDefaultAllowPolicy 设置为 true。
Configuration.js
要使用 configuration.js 文件禁用此功能,请执行以下操作:
- 在 ChromeApp root 文件夹中找到 configuration.js 文件。
-
编辑该文件。
注意:
-
Citrix 建议您在进行更改之前备份 configuration.js 文件。
- Citrix 建议仅在为用户重新打包适用于 ChromeOS 的 Citrix Workspace 应用程序时才编辑 configuration.js 文件。
- 编辑 configuration.js 文件需要管理员级别的凭据。
-
-
- 将 enableDefaultAllowPolicy 的值设置为 false。
-
以下是 JSON 数据示例:
- "features" : { "usb" : { - "enableDefaultAllowPolicy": false - } - } <!--NeedCopy-->-
- 保存更改。
-
Google 管理策略
对于托管设备和用户,管理员可以使用 Google 管理策略按如下方式禁用此功能:
- 登录 Google 管理策略。
- 转至设备管理 > Chrome 管理 > 用户设置。
-
在 engine_settings 键下,将以下字符串添加到 policy.txt 文件中。
以下是 JSON 数据示例:
'features' : { 'usb' : { 'enableDefaultAllowPolicy': {"type": "false"} } } <!--NeedCopy--> - 保存更改。
串行 COM 端口重定向
默认情况下,适用于 ChromeOS 的 Citrix Workspace 应用程序将 COM5 映射为首选串行 COM 端口以进行重定向。
已知限制
- 实时输入串行设备(如签名板)可能无法在适用于 ChromeOS 的 Citrix Workspace 应用程序会话中重定向。[CVADHELP-28555]
如何配置
要配置串行 COM 端口重定向,请通过应用 Citrix Virtual Apps and Desktops 和 Citrix DaaS 端口重定向策略设置来启用该功能。有关端口重定向的详细信息,请参阅端口重定向策略设置。
注意:
默认情况下,适用于 ChromeOS 的 Citrix Workspace 应用程序将 COM5 映射为首选串行 COM 端口以进行重定向。
在 VDA 上启用串行 COM 端口重定向策略设置后,使用以下方法之一配置适用于 ChromeOS 的 Citrix Workspace 应用程序:
- Google 管理策略
- configuration.js 文件
- 通过在活动的 ICA® 会话中发出命令来更改默认映射。
使用 Google 管理策略配置 COM 端口重定向
使用此方法通过编辑策略文件重定向串行 COM 端口。
提示:
Citrix 建议您仅在重新打包适用于 ChromeOS 的 Citrix Workspace 应用程序时才使用策略文件配置 COM 端口。
通过包含以下内容编辑 Google 管理策略:
{
"settings": {
"Value": {
"settings_version": "1.0",
"store_settings": {
"rf_web": {
"url": "<http://YourStoreWebURL>"
}
},
"engine_settings":{
"features" : {
"com" : {
"portname" : "<COM4>", where COM4 indicates the port number that is set by the administrator. }
}
}
}
}
}
<!--NeedCopy-->
串行 COM 端口名称选项及其说明列表:
- “portname”:COM(串行)虚拟通道的端口号。默认情况下,值为 COM5。
使用 configuration.js 文件配置 COM 端口重定向
使用此方法通过编辑 configuration.js 文件重定向串行 COM 端口。在 configuration.js 文件中找到 portname 字段并通过更改端口号来编辑该值。
例如:
"com" :{
"portname" : "COM4"
}
<!--NeedCopy-->
注意:
Citrix 建议仅在重新打包并从 StoreFront 重新发布适用于 ChromeOS 的 Citrix Workspace 应用程序时,才使用 configuration.js 文件方法配置串行端口重定向。
在 ICA 会话中发出命令以配置 COM 端口重定向
使用此方法重定向串行 COM 端口。在活动的 ICA 会话中运行以下命令:
net use COM4 : \\Client\COM5
<!--NeedCopy-->
提示:
在上述示例中,COM4 是用于重定向的首选串行端口。
持久性 USB 自动重定向
从 2505 版本开始,USB 设备现在会根据服务器策略首选项自动重定向到首选的虚拟应用程序或桌面。此首选项在后续启动时会保留在首选应用程序或桌面上。此增强功能可确保依赖 USB 外设的用户获得一致且无缝的体验。
注意:
此功能默认处于禁用状态。
优势
以下是其优势:
- 它通过确保您的 USB 设备始终连接到正确的会话来提高工作效率,即使在多任务处理期间或启动其他会话时也是如此。
- USB 重定向是持久性的,因此您无需每次都重新配置设备。
如何配置
此功能默认处于禁用状态。您可以通过以下方式启用此功能。
Google 管理员策略
对于受管设备和用户,管理员可以使用 Google 管理员策略按以下步骤启用此功能:
- 登录 Google 管理员策略。
- 转到 设备管理 > Chrome 管理 > 用户设置。
-
在
engine_settings键下,将以下 JSON 字符串添加到policy.txt文件中。注意: 您也可以将此配置应用于以下项:
- 设备 > Chrome > 应用程序和扩展程序 > 用户和浏览器 > 搜索扩展程序 > 扩展程序策略。
- 设备 > Chrome > 应用程序和扩展程序 > 托管访客会话 > 搜索扩展程序 > 扩展程序策略。
-
确保将属性
alwaysAutoRedirectOnFirstSessionLaunch设置为true。以下是 JSON 数据示例:{ "settings": { "Value": ` "settings_version": "1.0", "engine_settings": { "features": { "usb": { "alwaysAutoRedirectOnFirstSessionLaunch": true } } } } } <!--NeedCopy--> - 保存更改。
扫描仪重定向支持
从 2411 版本开始,您可以将扫描设备连接到本地计算机,并将扫描仪重定向到虚拟会话。此功能使您能够在 Citrix Workspace™ 应用程序会话中访问扫描文件,并轻松将文档上传到可通过 Citrix Workspace 应用程序访问的任何其他应用程序。
从 2411 版本开始,优化的扫描仪重定向功能已正式发布。此功能可提高性能和效率。有关详细信息,请参阅 Citrix Virtual Apps and Desktops 文档中的扫描仪重定向。
注意:
- 从 Citrix Virtual Apps and Desktops™ 2411 版本开始,此功能默认处于启用状态。
- 要为 Citrix Virtual Apps and Desktops 2407 版本启用此功能,请按照先决条件部分中提供的步骤操作。
- 此功能支持 Citrix Virtual Apps and Desktops 2407 及更高版本。
功能支持
目前,您只能连接两款扫描仪,即 Fujitsu (fi-7160) 和 Fujitsu (fi-8170)。
扫描仪重定向先决条件
要在 DDC 中为 Citrix Virtual Apps and Desktops 2407 版本启用 SANE 重定向策略,请执行以下步骤:
- 登录 Desktop Delivery Controller™ (DDC) 计算机,然后打开 Citrix Studio。
-
单击策略 > 创建策略。此时将显示创建策略对话框。

-
搜索 SANE 扫描仪重定向,如所示。

-
选择 SANE 扫描仪重定向选项。此时将显示编辑设置对话框。选择允许选项。

- 单击确定。
此功能的已知限制
- 如果某个会话正在使用扫描仪且正在进行扫描,则尝试从第二个会话使用扫描仪会导致第一个会话的扫描操作突然失败。
- 用于允许在未经用户批准的情况下扫描文档的静默扫描选项在 Google 管理控制台的自助服务终端设置中不可用。有关详细信息,请参阅合作伙伴工单。
- 某些扫描仪功能可能无法按预期运行。例如,页面宽度、页面高度、纸张大小、亮度和对比度。此问题是由于第三方扫描仪 API 中有关选项描述符的错误导致的。[RFHTMCRM-13829]
- 当扫描仪连接到 Chromebook 时,您有时可能会遇到 ChromeOS 错误消息“无法安装扫描仪软件”。之后,扫描操作可能会失败。有关详细信息,请参阅合作伙伴工单。[RFHTMCRM-15966]
技术预览版以来修复的问题
-
当您尝试在 Chromebook 上使用重定向的扫描仪进行扫描时,最终用户可能会间歇性地遇到以下错误,从而阻碍扫描过程: “TWAIN 会话打开错误:失败”。
即使扫描仪已正确连接并且 SANE 重定向策略已启用,也会出现此问题。[HDX-70122]
- 将 VDA 升级到 2407 版本后,Citrix 会话中运行的某些扫描应用程序在打开时会间歇性地无响应。 [HDX-70280]
- 在某些扫描应用程序中,双面扫描(扫描两面)和多页扫描在扫描第一页后失败。例如,前台扫描应用程序。
- 在某些扫描应用程序中,扫描页面时调色板不正确。有关详细信息,请参阅 Google 合作伙伴工单。例如,前台扫描应用程序。
- 间歇性地,在尝试使用空托盘进行扫描后,扫描文档失败。有关详细信息,请参阅 Google 合作伙伴工单。
-
优化的扫描仪重定向功能中修复的问题:
- 双面扫描失败,因为扫描仪应用程序 UI 未正确触发 ADF 双面源选择。
- 多页扫描选项仅扫描一页,因为扫描仪应用程序未正确处理托盘中的多页。
- 在双面扫描期间跳过扫描空白页失败,因为与本机设置相比,扫描仪应用程序不会自动选择此选项。
- 扫描页面的调色板显示不正确,因为扫描仪应用程序无法准确再现颜色。
- 当您使用适用于 ChromeOS 的 Citrix Workspace 应用程序在 Google Cloud Platform (GCP) VDA 服务器上进行扫描时,由于平台特定的连接问题(仅影响连接到 GCP 托管 VDA 的 ChromeOS 端点),会出现持续的延迟或滞后。Citrix Apps and Desktops 2507 CU1 及更高版本提供了修复程序。[CVADHELP-29259]
配置
对于受管用户,为了允许在未经用户批准的情况下扫描文档,管理员可以从 Google 管理控制台启用静默扫描选项。
要启用静默扫描:
- 导航到设备 > Chrome > 应用程序和扩展程序。
- 选择 Citrix Workspace 应用程序 ID。
-
启用右侧面板中提供的静默扫描选项。

- 保存更改。