已知问题

Last published : Nov 13, 2026
Citrix Virtual Apps and Desktops™ 7 2603 包含以下已知问题:

备注

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

常规

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

<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/whats-new/known-issues.md 此外,在 broker agent msi 日志中,您可能会看到以下错误消息:

此外,在代理程序 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](https://learn.microsoft.com/zh-cn/troubleshoot/windows-server/performance/manually-rebuild-performance-counters)。 [LCM-23228]
  • 如果您启动应用程序栏,然后在适用于 Windows 的 Citrix Workspace™ 应用程序中打开“连接中心”菜单,则应用程序栏不会显示在其托管服务器下方。
<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/whats-new/known-issues.md
  • 对于多会话 VDA,会话限制设置在运行 Windows Server 2022、Windows 10 企业版多会话和 Windows 11 企业版多会话的会话主机中不适用。
1.  打开注册表编辑器。
1.  转到 `HKEY_CURRENT_USER\Software\Microsoft\Print\UnifiedPrintDialog`
1.  右键单击并选择**新建 > DWORD (32 位) 值**
1.  将值重命名为 **PreferLegacyPrintDialog**。
1.  右键单击 **PreferLegacyPrintDialog** 并选择**修改**。
1.  将值数据设置为 `1` 并单击**确定**。

[HDX-66953] [HDX-66904]
  • 通过 RDP 重新连接到单会话 VDA 时,客户端打印机未被清除。
<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/whats-new/known-issues.md 在单会话计算机上,当用户使用 RDP 重新连接到同一台计算机时,来自先前 ICA 会话的重定向客户端打印机不会被删除。因此,过时的客户端打印机在会话中仍然可见,但不再起作用。这不影响多会话 VDA。
  • 尝试从发布在 Windows Server 2019 Virtual Delivery Agent (VDA) 上的某些应用程序中添加新打印机时,会发生错误,导致打印机无法列出或添加。具体来说,会出现一条错误消息,指示无法访问 rundll32.exe。
<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/whats-new/known-issues.md 作为一种变通方法,请使用应用程序中已可见的打印机,或添加打印机使其在当前会话中可用。
  • 如果在会话处于活动状态时更改了客户端计算机上的设备名称,则新名称不会立即反映在会话设置中。此行为会影响播放设备和录制设备。
  • 当多个 Chrome 浏览器选项卡(包括那些配置了浏览器内容重定向 (BCR) 的选项卡)同时从一个 Chrome 窗口拖放到另一个窗口时,重定向的内容可能会出现意外行为。
  • 如果将包含视频内容的选项卡移动到新窗口,播放可能会停止或视频可能不会显示。
  • 将浏览器内容重定向与浏览器配置文件共享结合使用时,不支持具有多个配置文件的 SSO 持久性。 <<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/whats-new/known-issues.md
作为一种解决方法,请参阅:

-  [“贴靠窗口”部分](https://support.microsoft.com/zh-cn/windows/snap-your-windows-885a9b1e-a983-a3b1-16cd-c531795e6241)。

-  [如何禁用“贴靠窗口”功能](https://answers.microsoft.com/zh-cn/windows/forum/all/stopping-snap-and-getting-my-full-screen-back-all/d0a65569-d785-4642-ad4d-a847137231a5)

[HDX-91532]
  • 在已安装 Citrix VDA 的计算机上进行就地 Windows 升级后,打印可能会失败 <<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/whats-new/known-issues.md 进行就地 Windows 升级后,Citrix 打印提供程序可能不再被调用,这可能导致打印失败。出现此问题的原因是 Windows 升级过程会重置打印提供程序执行顺序,并且不会保留 Citrix 注册的提供程序。Microsoft 已确认这是 Windows 的行为,并且目前在升级期间不会保留执行顺序中的提供程序注册。

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

在就地 Windows 升级后,Citrix 打印提供程序可能不再被调用,这可能导致打印失败。出现此问题的原因是 Windows 升级过程会重置打印提供程序执行顺序,并且不保留 Citrix 注册的提供程序。Microsoft 已确认这是 Windows 的行为,并且目前在升级期间不会保留执行顺序中的提供程序注册。
解决方法是将打印提供程序重新添加回适当的注册表位置。
1.  Open the Registry Editor.
1.  Go to `HKEY_LOCAL_MACHINE\CurrentControlSet\Control\Print\Providers`
1.  Right-click **order** and select **Modify**.
1.  Add the values `Universal Printer` and `Client Printer` above any other providers.
1.  Reboot the VDA.
<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/whats-new/known-issues.md
  • 当您尝试使用 Citrix 工具栏从锁定的 Windows 会话注销时,操作失败。此问题在适用于 Linux 的 Citrix Workspace 应用程序 (CWA) 和适用于 Windows 的 CWA 上均会发生。

<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/whats-new/known-issues.md 作为一种变通方法,请确保在尝试断开连接或注销之前 Windows 会话已解锁。如果会话已解锁,断开连接和注销功能将正常工作。

作为一种解决方法,请确保在尝试断开连接或注销之前,Windows 会话已解锁。如果会话已解锁,则断开连接和注销功能将正常工作。

音频

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

<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/whats-new/known-issues.md 作为一种变通方法,通过任务管理器在受影响的会话中重新启动 Windows 资源管理器进程 (explorer.exe)。这可能允许音量图标正常工作而不会崩溃。

作为一种解决方法,请通过任务管理器在受影响的会话中重新启动 Windows 资源管理器进程 (explorer.exe)。这可能允许音量图标正常工作而不会崩溃。[HDX-80937]

Citrix 始终开启追踪

当 Citrix Gateway 与 StoreFront 2603 结合使用时,Citrix Workspace 应用程序 (CWA) 日志不会转发到 AOT 日志服务器。因此,在此配置的部署中,CWA 日志无法用于故障排除。
此问题仅影响将 Citrix Gateway 与 StoreFront 2603 结合使用的部署。其他 AOT 日志源(例如 Virtual Delivery Agent (VDA))会继续成功上传日志。作为一种解决方法,请使用以下 StoreFront 版本之一:
  • StoreFront 2507 CU1
  • StoreFront 2511
这些版本在与 Citrix Gateway 结合部署时,可正确支持将 CWA 日志转发到 AOT 日志服务器。
注意:
此问题不影响用户在没有 Citrix Gateway 的情况下直接连接到 StoreFront 的部署。

计算机创建服务™

<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/whats-new/known-issues.md
  • 通过 Nutanix AHV Prism Central 连接更新 MCS 非持久性计算机目录的启用 vTPM 的主映像会触发 VM 重新创建,这可能会使 DNS 预留失效,并需要重新注册利用 MAC 地址进行许可的软件。
  • 当使用具有多个启用了加速网络的网络接口卡 (NIC) 的计算机配置文件时,请确保所选的 VM 大小支持所有 NIC 上的加速网络。某些 Azure VM 大小(例如 Standard_D2ads_v5)将加速网络限制为单个 NIC。如果计算机配置文件在超出 VM 大小允许的 NIC 数量上启用了加速网络,则计算机将无法开机并显示错误 VmSizeRestrictedToSingleNicWithAcceleratedNetworkingEnable。要解决此问题,请选择支持多个 NIC 上的加速网络的 VM 大小,或更新计算机配置文件以仅在一个 NIC 上启用加速网络。
  • 当您使用已安装并载入 Azure Connected Machine 代理版本 1.61 或更高版本的 Azure 本地 VM 准备主映像时,由于删除代理配置文件时访问被拒绝,MCS 中的目录创建在映像准备过程中失败。作为一种解决方法,在创建主映像时执行以下操作:导航到 C:\ProgramData\AzureConnectedMachineAgent\Config\agentconfig.json,右键单击该文件,选择“属性”,然后清除“只读”属性复选框。
  • 使用 Nutanix AHV Prism Central 主机连接向 MCS 目录添加大量 VM 可能会失败并显示 OutOfMemory 错误。为避免此问题,请减少单批次创建的 VM 数量。我们建议一次最多添加 10 个 VM。
  • 将现有 VDA 升级到版本 2511 后,MachineGuid 会更改为计算机的唯一值。任何依赖 MachineGuid 进行许可的软件可能需要重新注册。
  • 如果环境依赖于从主映像继承的通配符证书,则 VDA 版本 2511 上的 TLS 加密会中断。

作为单会话计算机的解决方法,可以使用每台计算机证书代替。有关详细信息,请参阅 。

配置文件管理

适用于 macOS 的 Citrix 虚拟交付代理

Linux 虚拟投递代理

会话录制

工作区环境管理™

Citrix 预配™

联合身份验证服务