产品文档
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
查看 PDF

已知问题

March 25, 2026
投稿者: 
C C

Citrix Virtual Apps and Desktops™ 7 2511 包含以下已知问题：

注意事项

  • 如果已知问题有解决方法，则会在问题描述后提供。

  • 以下警告适用于任何建议更改注册表项的解决方法：

    警告：

    不正确地编辑注册表可能导致严重问题，可能需要重新安装操作系统。Citrix® 无法保证能够解决因不正确使用注册表编辑器而导致的问题。请自行承担使用注册表编辑器的风险。编辑注册表之前，请务必备份注册表。

一般

  • 在 Windows 10 (22H2) 和 Windows Server 2022 平台上安装 Citrix VDA 期间，您可能会遇到以下错误。

    lcm-23228 错误

    此外，在代理程序 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
 <!--NeedCopy-->

    要解决此问题，请关闭安装程序，重建 Windows 性能计数器，重新启动计算机，然后再次执行安装。有关详细信息，请参阅 Microsoft 文档 手动重建适用于 Windows Server 2008 64 位或 Windows Server 2008 R2 系统的性能计数器。[LCM-23228]

  • 如果在适用于 Windows 的 Citrix Workspace™ 应用程序中启动应用程序栏，然后打开“连接中心”菜单，则应用程序栏不会显示在其托管服务器下。[HDX-27504]

  • 在运行 Windows Server 2022、Windows 10 企业版多会话和 Windows 11 企业版多会话的会话主机中，多会话 VDA 的会话限制设置被拒绝。[HDX-47001]

  • 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，然后单击确定。

    [HDX-66953] [HDX-66904]

  • 在 Citrix Virtual Apps and Desktops 会话期间，如果支持音频播放的客户端显示器断电重启（先关闭再打开），则 VDA 的“声音控制面板”(mmsys.cpl) 中显示器的音频播放设备名称会从其正确、特定的名称更改为“Citrix HDX Audio”。这是一个间歇性问题。作为解决方法，请关闭 VDA 的“声音控制面板”(mmsys.cpl) 窗口，然后重新启动它。[HDX-87080]

  • 尝试从发布在 Windows Server 2019 虚拟投递代理 (VDA) 上的某些应用程序中添加新打印机时，会发生错误，导致无法列出或添加打印机。具体来说，会出现一条错误消息，指示无法访问 rundll32.exe。

    作为解决方法，请使用应用程序中已可见的打印机，或者添加打印机以使其在当前会话中可用。[HDX-86440]

  • 如果在会话处于活动状态时更改了客户端计算机上的设备名称，则新名称不会立即反映在会话设置中。此行为会影响播放设备和录音设备。

    作为解决方法，要查看更新后的设备名称，您必须断开会话连接，然后重新连接。或者，注销会话并重新登录也可以解决此问题。[HDX-86327]

  • 当多个 Chrome 浏览器选项卡（包括那些配置了浏览器内容重定向 (BCR) 的选项卡）同时从一个 Chrome 窗口拖放到另一个 Chrome 窗口时，重定向的内容可能会出现意外行为。[HDX-81501]
  • 如果将包含视频内容的选项卡移动到新窗口，则播放可能会停止或视频可能不会显示。[HDX-92343]
  • 当将浏览器内容重定向与浏览器配置文件共享结合使用时，不支持具有多个配置文件的 SSO 持久性。[HDX-85325]

  • Windows 11 具有一项新的 UI 功能，可将窗口吸附到桌面。当用户拖动窗口时，桌面顶部会出现一个特殊的工具栏。因此，多媒体叠加剪裁逻辑会剪裁顶部/中心区域，这可能是因为此功能使用了新的不可见/透明窗口。

    作为解决方法，请参阅：

    [HDX-91532]

  • [第三方] 在已安装 Citrix VDA 的计算机上进行就地 Windows 升级后，打印可能会失败

    在就地 Windows 升级后，Citrix 打印提供程序可能不再被调用，这可能导致打印失败。发生此问题的原因是 Windows 升级过程会重置打印提供程序的执行顺序，并且不会保留 Citrix 注册的提供程序。Microsoft 已确认这是 Windows 的行为，并且目前在升级期间不会保留执行顺序中的提供程序注册。[HDX-85359]

解决方法是将打印提供程序添加回相应的注册表位置。

  1. 打开注册表编辑器。
  2. 导航到 HKEY_LOCAL_MACHINE\CurrentControlSet\Control\Print\Providers
  3. 右键单击 order，然后选择修改。
  4. 在任何其他提供程序上方添加值 Universal Printer 和 Client Printer。
  5. 重新启动 VDA。

音频

  • 当音频设备（例如耳机）使用 USB 重定向通用重定向到 Windows Server Virtual Delivery Agent (VDA)（例如 Windows Server 2019 或 2022），并且同一 VDA 上有多个用户会话同时处于活动状态时，单击任务栏右下角的音量图标调整设置可能会导致 Windows ShellExperienceHost.exe 进程意外崩溃。此问题主要发生在音频设备未主动重定向，但同一 VDA 上的另一个会话正在使用通用 USB 音频重定向的会话中。

    解决方法是，通过任务管理器在受影响的会话中重新启动 Windows Explorer 进程 (explorer.exe)。这可能允许音量图标正常运行而不会崩溃。[HDX-80937]

Machine Creation Services™

  • 当您使用已安装并载入 Azure Connected Machine agent 1.61 或更高版本的 Azure 本地 VM 准备主映像时，由于删除代理配置文件时访问被拒绝，MCS 中的目录创建在映像准备过程中失败。解决方法是，在创建主映像时执行以下操作：导航到 C:\ProgramData\AzureConnectedMachineAgent\Config\agentconfig.json，右键单击该文件，选择属性，然后清除只读属性复选框。[PMCS-59003]
  • 使用 Nutanix AHV Prism Central 主机连接将大量 VM 添加到 MCS 目录时，可能会因 OutOfMemory 错误而失败。为避免此问题，请减少单批次中创建的 VM 数量。我们建议一次最多添加 10 个 VM。[PMCS-58254]
  • 将现有 VDA 升级到版本 2511 后，MachineGuid 会更改为计算机的唯一值。任何依赖 MachineGuid 进行许可的软件可能需要重新注册。[PMCS-58288]

  • 如果环境依赖于从主映像继承的通配符证书，则 VDA 2511 版本上的 TLS 加密会中断。

    解决方法是，对于单会话计算机，可以使用每台计算机证书。有关详细信息，请参阅在 VDA 上启用 TLS/DTLS。[PMCS-58287]

  • 在 Red Hat OpenShift 环境中，不支持将使用 InstanceType 创建的 VM 用作主映像。[PMCS-54272]
  • 在 Red Hat OpenShift 虚拟化环境中创建 MCS 计算机目录时，不能使用具有不同操作系统类型的主映像和计算机配置文件。这是因为 Red Hat OpenShift 管理每种操作系统类型的方式。因此，不支持将 Windows VM 用作主映像，而将非 Windows（例如 Linux）VM 用作计算机配置文件，反之亦然。[PMCS-54009]
  • 在 Red Hat OpenShift 环境中，当主映像加入域时，在用于目录创建后，它可能会失去域信任。由于 OpenShift 环境中的限制，此问题会影响 Citrix Virtual Apps™ and Desktops 2503 及更高版本。解决方法是不在主映像中加入域。Citrix 正在与 Red Hat 合作以增强网络隔离功能。[PMCS-53794]
  • 在 AWS 上托管的 VMware 环境中，如果主映像启用了 vTPM，则 MCS 计算机目录创建会失败。此问题会影响所有 Citrix Virtual Apps and Desktops 版本，并且是由于 VMware 环境中的问题。如需帮助，请联系 VMware 支持。[PMCS-38514]

Web Studio

  • 将 Web Studio 从 早于 2511 的版本升级到 2511 后，如果早期版本安装在 非默认 目录而不是默认的 C:\Program Files\Citrix 中，则 Web Studio 将无法打开。

    解决方法是，使用 StudioConfig.exe 手动配置 Web Studio 清单文件中的 Delivery Controller 地址。[STUD-39667]

  • 当您从 Web Studio 对 VDA 运行运行状况检查时，“登录持续时间”检查会在报告中显示以下警告。[XASUP-7865]

    XASUP-7865

Profile Management

Citrix Virtual Delivery Agent for macOS

Linux VDA

Session Recording

Workspace Environment Management™

Citrix Provisioning™

Federated Authentication Service

已知问题
March 25, 2026
投稿者: 
C C
March 25, 2026
投稿者: 
C C

在本文中

站点反馈 | Your privacy choices footer link您的隐私选择 | 隐私和法律条款 | Cookie 首选项 | 同意设置 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.