已知问题

备注

• 如果已知问题有变通方法，则会在问题描述之后提供。
• 以下警告适用于任何建议更改注册表项的变通方法：
  警告：
  不正确地编辑注册表可能会导致严重问题，可能需要重新安装操作系统。Citrix® 无法保证可以解决因不正确使用注册表编辑器而导致的问题。请自行承担使用注册表编辑器的风险。在编辑注册表之前，请务必备份注册表。

常规

• 在 Windows 10 (22H2) 和 Windows Server 2022 平台上安装 Citrix VDA 期间，您可能会遇到以下错误。
  
  此外，在 broker agent msi 日志中，您可能会看到以下错误消息：
  MSI (s) (04:D8) [09:46:08:426]: Note: 1: 1722 2: CA_RunInstallAgent 3: C:\Program Files\Citrix\Virtual Desktop Agent\BrokerAgent.exe 4: -install
CustomAction CA_RunInstallAgent returned actual error code 1701 (note this may not be 100% accurate if translation happened inside sandbox)
MSI (s) (04:D8) [09:46:08:427]: Product: Citrix Virtual Desktop Agent - x64 -- Error 1722. There is a problem with this Windows Installer package. A program run as part of the setup did not finish as expected. Contact your support personnel or package vendor. Action CA_RunInstallAgent, location: C:\Program Files\Citrix\Virtual Desktop Agent\BrokerAgent.exe, command: -install
  要解决此问题，请关闭安装程序，重建 Windows 性能计数器，重新启动计算机，然后再次执行安装。有关信息，请参阅 Microsoft 文档 Manually rebuild performance counters for Windows Server 2008 64 bit or Windows Server 2008 R2 systems。
• 如果您启动应用程序栏，然后在适用于 Windows 的 Citrix Workspace™ 应用程序中打开“连接中心”菜单，则应用程序栏不会显示在其托管服务器下方。
• 对于多会话 VDA，会话限制设置在运行 Windows Server 2022、Windows 10 企业版多会话和 Windows 11 企业版多会话的会话主机中不适用。
• Microsoft 确认，在使用现代打印对话框时，打印作业之间保留打印设置存在问题，他们正在努力解决。他们目前的预计是 2025 年上半年。现代打印对话框在较新的操作系统版本（例如 Windows 11 和 Windows Server 2025）中默认启用。可以通过执行以下操作将操作系统配置为使用传统打印对话框：
  1. 打开注册表编辑器。
  2. 转到 HKEY_CURRENT_USER\Software\Microsoft\Print\UnifiedPrintDialog
  3. 右键单击并选择新建 > DWORD (32 位) 值
  4. 将值重命名为 PreferLegacyPrintDialog。
  5. 右键单击 PreferLegacyPrintDialog 并选择修改。
  6. 将值数据设置为 1 并单击确定。
• 通过 RDP 重新连接到单会话 VDA 时，客户端打印机未被清除。
  在单会话计算机上，当用户使用 RDP 重新连接到同一台计算机时，来自先前 ICA 会话的重定向客户端打印机不会被删除。因此，过时的客户端打印机在会话中仍然可见，但不再起作用。这不影响多会话 VDA。
• 在 Citrix Virtual Apps and Desktops 会话期间，如果支持音频播放的客户端显示器断电重启（先关闭再打开），VDA 的声音控制面板 (mmsys.cpl) 中显示器的音频播放设备名称会从其正确的特定名称更改为“Citrix HDX Audio”。这是一个间歇性问题。作为一种解决方法，请关闭 VDA 的声音控制面板 (mmsys.cpl) 窗口，然后重新启动它。
• 尝试从发布在 Windows Server 2019 Virtual Delivery Agent (VDA) 上的某些应用程序中添加新打印机时，会发生错误，导致打印机无法列出或添加。具体来说，会出现一条错误消息，指示无法访问 rundll32.exe。
  作为一种变通方法，请使用应用程序中已可见的打印机，或添加打印机使其在当前会话中可用。
• 如果在会话处于活动状态时更改了客户端计算机上的设备名称，则新名称不会立即反映在会话设置中。此行为会影响播放设备和录制设备。
  作为一种变通方法，要查看更新的设备名称，您必须断开会话连接，然后重新连接。或者，注销会话并重新登录也可以解决此问题。
• 当多个 Chrome 浏览器选项卡（包括那些配置了浏览器内容重定向 (BCR) 的选项卡）同时从一个 Chrome 窗口拖放到另一个窗口时，重定向的内容可能会出现意外行为。
• 如果将包含视频内容的选项卡移动到新窗口，播放可能会停止或视频可能不会显示。
• 将浏览器内容重定向与浏览器配置文件共享结合使用时，不支持具有多个配置文件的 SSO 持久性。
• Windows 11 具有一项新的 UI 功能，可将窗口吸附到桌面。当用户拖动窗口时，桌面上方会出现一个特殊的工具栏。因此，多媒体叠加剪裁逻辑会剪裁顶部/中心区域，这可能是因为此功能使用了新的不可见/透明窗口。
  作为一种变通方法，请参阅：
  • “贴靠窗口”部分。
  • 如何禁用“贴靠窗口”功能
• 在已安装 Citrix VDA 的计算机上进行就地 Windows 升级后，打印可能会失败 进行就地 Windows 升级后，Citrix 打印提供程序可能不再被调用，这可能导致打印失败。出现此问题的原因是 Windows 升级过程会重置打印提供程序执行顺序，并且不会保留 Citrix 注册的提供程序。Microsoft 已确认这是 Windows 的行为，并且目前在升级期间不会保留执行顺序中的提供程序注册。

• 任何使用 MCSIO 写入缓存进行存储优化的目录，请务必在 VDA 安装和升级过程中安装 Citrix MCS I/O 驱动程序。有关详细信息，请参阅 Storage shared by hypervisors 和 Configure cache for temporary data。VDA 上缺少 MCS I/O 驱动程序可能会在更新目录时导致问题。
• 当您尝试使用 Citrix 工具栏从锁定的 Windows 会话注销时，操作失败。此问题在适用于 Linux 的 Citrix Workspace 应用程序 (CWA) 和适用于 Windows 的 CWA 上均会发生。

音频

• 当音频设备（例如耳机）通过 USB 重定向通用重定向到 Windows Server 虚拟投递代理 (VDA)（例如 Windows Server 2019 或 2022），并且同一 VDA 上有多个用户会话同时处于活动状态时，单击任务栏右下角的音量图标以调整设置可能会导致 Windows ShellExperienceHost.exe 进程意外崩溃。此问题主要发生在音频设备未主动重定向，但同一 VDA 上的另一个会话正在使用通用 USB 音频重定向的会话中。
  作为一种变通方法，通过任务管理器在受影响的会话中重新启动 Windows 资源管理器进程 (explorer.exe)。这可能允许音量图标正常工作而不会崩溃。

机器创建服务™

• 当使用具有多个启用了加速网络的网络接口卡 (NIC) 的计算机配置文件时，请确保所选的 VM 大小支持所有 NIC 上的加速网络。某些 Azure VM 大小（例如 Standard_D2ads_v5）将加速网络限制为单个 NIC。如果计算机配置文件在超出 VM 大小允许的 NIC 数量上启用了加速网络，则计算机将无法开机并显示错误 VmSizeRestrictedToSingleNicWithAcceleratedNetworkingEnable。要解决此问题，请选择支持多个 NIC 上的加速网络的 VM 大小，或更新计算机配置文件以仅在一个 NIC 上启用加速网络。
• 如果环境依赖于从主映像继承的通配符证书，则 VDA 版本 2511 上的 TLS 加密会中断。
  作为单会话计算机的解决方法，可以使用每台计算机证书代替。有关详细信息，请参阅 在 VDA 上启用 TLS / DTLS。
• 使用 InstanceType 创建的 VM 不支持作为 Red Hat OpenShift 环境中的主映像。
• 在 Red Hat OpenShift 虚拟化环境中创建 MCS 计算机目录时，不能使用具有不同操作系统类型的主映像和计算机配置文件。这是由于 Red Hat OpenShift 管理每种操作系统类型的方式所致。因此，不支持将 Windows VM 用作主映像，而将非 Windows（例如 Linux）VM 用作计算机配置文件，反之亦然。
• 在 AWS 上托管的 VMware 环境中，如果主映像启用了 vTPM，则 MCS 计算机目录创建会失败。此问题影响所有 Citrix Virtual Apps and Desktops 版本，并且是由于 VMware 环境中的问题引起的。如需帮助，请联系 VMware 支持。
• 当将 Machine Creation Services I/O (MCSIO) 与运行 VDA 2607 的 Windows Server 2019 VDA 结合使用时，写入缓存磁盘已成功附加到预配的虚拟机，但仍为空，并且未按预期使用。
  仅在以下情况下观察到此问题：
  • VDA 操作系统为 Windows Server 2019
  • 已安装 VDA 2607
  • 计算机目录是使用 MCSIO 预配的
  解决方法
  在预配计算机之前，在主映像上配置所需的 CVhdFilter 注册表设置。 注册表位置：HKLM\SYSTEM\CurrentControlSet\Services\CVhdFilter
  解决步骤
  1. 在 Windows Server 2019 主映像上，打开注册表编辑器 (regedit.exe)。
  2. 导航到：HKLM\SYSTEM\CurrentControlSet\Services\CVhdFilter
  3. 右键单击 CVhdFilter 并创建一个新的空键“Parameters”。
  4. 重新封装或关闭主映像。
  5. 创建主映像的新快照。
  6. 更新 MCSIO 计算机目录以使用新快照。
  7. 重启已预配的虚拟机。
  8. 验证回写缓存 (WBC) 磁盘在正常用户会话活动期间是否已填充。
  受影响的版本
  • Citrix 虚拟投递代理 (VDA) 2607
  • Windows 服务器 2019
  • 计算机创建服务 I/O (MCSIO)

配置文件管理

• Profile Management 2607 LTSR 文档 提供了有关此版本中更新的具体信息。

适用于 macOS 的 Citrix 虚拟投递代理

• 适用于 macOS 的 Citrix Virtual Delivery Agent 2607 LTSR 文档

会话录制

• Session Recording 2607 LTSR 文档 提供了有关此版本中更新的具体信息。

工作区环境管理™

• Workspace Environment Management 2607 文档 提供了有关此版本中更新的具体信息。

Citrix 预配™

• Citrix Provisioning 2607 LTSR 文档 提供了有关此版本中更新的具体信息。

联合身份验证服务

• Federated Authentication Service 2607 LTSR 文档 提供了有关此版本中更新的具体信息。