已知问题

备注

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

2507 CU2 中的已知问题

• 在基于 MMC 的 Studio 中刷新许可证时，如果 DDC 配置为许可证激活服务 (LAS)，则 V6 许可证文件详细信息会短暂显示不正确。这会暂时影响 MMC Studio 中许可证信息的准确呈现。要缓解此问题，请关闭并重新打开 MMC Studio。

2507 初始版本中的已知问题

通用

• 在 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 文档手动重建适用于 Windows Server 2008 64 位或 Windows Server 2008 R2 系统的性能计数器。
• 如果您启动应用栏，然后在适用于 Windows 的 Citrix Workspace™ 应用程序中打开“连接中心”菜单，则应用栏不会显示在其托管服务器下。
• 在运行 Windows Server 2022、Windows 10 Enterprise 多会话和 Windows 11 Enterprise 多会话的会话主机中，多会话 VDA 的会话限制设置不起作用。
• 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 并单击确定。
• 在已安装 Citrix VDA 的计算机上进行就地 Windows 升级后，打印可能会失败 进行就地 Windows 升级后，Citrix 打印提供程序可能不再被调用，这可能导致打印失败。出现此问题的原因是 Windows 升级过程会重置打印提供程序执行顺序，并且不会保留 Citrix 注册的提供程序。Microsoft 已确认这是 Windows 的行为，并且目前在升级期间不会保留执行顺序中的提供程序注册。

• 如果 uberAgent® 服务是独立于 VDA 安装的（而不是通过 VDA MetaInstaller 安装的），则在卸载 VDA 时不得卸载 uberAgent 服务。
• 发布使用 App-V 打包的应用程序时，用户可能无法移动或调整应用程序的大小。作为一种解决方法，请设置以下注册表值：HKLM\SYSTEM\CurrentControlSet\Control\Citrix\wfshell\TWI\SeamlessSwclFlags(DWORD) = 2。此项只能用于解决此特定问题，并且可能会导致调整窗口大小和移动窗口的用户体验下降。
• 在 Citrix Virtual Apps and Desktops 会话期间，如果支持音频播放的客户端显示器断电重启（先关闭再打开），VDA 的声音控制面板 (mmsys.cpl) 中显示器的音频播放设备名称会从其正确的特定名称更改为“Citrix HDX Audio”。这是一个间歇性问题。作为一种解决方法，请关闭 VDA 的声音控制面板 (mmsys.cpl) 窗口，然后重新启动它。
• 在 NAPS2 8.x 版本中创建新配置文件并立即启动基于进纸器的扫描时，应用程序可能会崩溃。此问题在 NAPS2 8.1.4 版本中尤其明显。
• 尝试从发布在 Windows Server 2019 Virtual Delivery Agent (VDA) 上的某些应用程序中添加新打印机时，会发生错误，导致打印机无法列出或添加。具体来说，会出现一条错误消息，指示无法访问 rundll32.exe。
  作为一种解决方法，请使用应用程序中已可见的打印机，或者添加打印机以使其在当前会话中可用。
• 如果在会话处于活动状态时更改了客户端计算机上的设备名称，则新名称不会立即反映在会话设置中。此行为会影响播放设备和录制设备。
  作为一种解决方法，要查看更新的设备名称，您必须断开会话连接，然后重新连接。或者，注销会话并重新登录也可以解决此问题。
• 当多个 Chrome 浏览器选项卡（包括那些配置了浏览器内容重定向 (BCR) 的选项卡）同时从一个 Chrome 窗口拖放到另一个窗口时，重定向的内容可能会出现意外行为。
• 如果将包含视频内容的选项卡移动到新窗口，播放可能会停止或视频可能不会显示。
• 将浏览器内容重定向与浏览器配置文件共享结合使用时，不支持具有多个配置文件的 SSO 持久性。
• Windows 11 具有一项新的 UI 功能，可将窗口吸附到桌面。当用户拖动窗口时，桌面上方会出现一个特殊的工具栏。因此，多媒体叠加剪裁逻辑会剪裁顶部/中心区域，这可能是因为此功能使用了新的不可见/透明窗口。
  作为一种解决方法，
  • 有关详细信息，请参阅 Snap your windows section。
  • 请参阅 如何禁用“贴靠窗口”功能。
• 当您使用 Citrix Workspace 应用程序访问启用了 Unicode 输入模式的 VDA，并且“Unicode 键盘布局映射”或“自动键盘显示”组策略已开启时，在 Microsoft Excel 中滚动大型页面时，您可能会注意到性能下降。出现此问题是因为 UIAutomation API 与 Excel 不兼容。
• 当使用增强型域直通进行单点登录 (SSO) 时，用户首次连接时，会话内的应用程序 SSO 按预期工作。但是，如果用户断开连接并稍后重新连接到同一会话，则会话内的 SSO 可能会停止工作。这是由于 2025 年 3 月和 4 月发布的 Windows 更新引入的回归。遇到此问题的客户应向 Microsoft 提交支持案例，并参考跟踪 ID 2410230030007977。
• 当您在不支持会话共享的设备上启动应用程序时，可能会发生 TokenNotFoundException。这会阻止应用程序启动。
• 当您更新 Virtual Delivery Agent (VDA) 时，安装过程可能无法按预期恢复。出现此问题是由于检查 CitrixVirtualDesktopAgent.xml 文件失败，并影响 CU2 和 CU4 等累积更新上的 VDA 更新。
• 当您在运行 2507 CU2（内部版本 B755 或更高版本）且启用了 WIA 重定向的 VDA 上，在 mspaint.exe 中执行 WIA 扫描时，mspaint.exe 会崩溃。这会阻止成功的图像扫描操作。
  • 解决方法： 将 C:\Program Files\Citrix\HDX\bin 中的 WIARedirection.dll 文件替换为 2507 CU1 VDA 中的版本。
• 通过 StoreFront™ 启动 Citrix RDP 会话时，如果 VDA 版本为 2507 CU2 B1 或更高版本，则身份验证会失败。系统会显示“用户名或密码不正确”错误，阻止用户访问远程 RDP 会话。
  • 解决方法： 将 VDA 上的 HKLM\Software\Citrix\UsePasswordFromClientData 设置为 DWORD 1。
• 当您将 Delivery Controller™ (DDC) 升级到版本 2507 时，Web Studio 会错误地报告“您的软件维护已过期”。VDA 会话显示“您的企业 Citrix 环境目前不受支持”，即使许可证有效也是如此。
• 当您将包含更新命名空间（例如 uap3）的较新应用程序包分配给 Web Studio 中的交付组时，应用程序发现会失败。这会阻止应用程序出现在 Web Studio 中以分配给交付组。
• 首次启动 App-V 应用程序时，程序包同步期间的时序冲突会阻止应用程序成功启动。
  • 解决方法： 尝试重新启动应用程序。
• 由于 CVAD 2311 中新增了与 App-V 相关的功能，App-V 功能现在仅在 Web Studio 中完全受支持。将 MMC Studio 用于 App-V 可能会导致问题。
  1. 现有 App-V 应用程序可能停止工作
     将 Delivery Controller (DDC) 升级到：2402 LTSR CU3 或更早的 2402 LTSR 版本，或 2507 RTM 后， 以前使用 MMC Studio 创建的 App-V 应用程序可能无法按预期运行。解决方法如下： 对于 2507 RTM，在 siteDB 中运行 sql：
     -- Convert Broker Apps which are Packaged Apps to be explicitly labeled as such.
-- this is detected by the presence of ctxAppVLauncher.exe on the command line
-- The application record in the Applibrary and the related Package and Library denote which packaging technology was used.

    update chb_Config.Applications
    set ApplicationType = 4, --$ATPackagedApplication
        --NB: The AppLibrary's LibaryUid and the Broker's PackagedApplicationType have the same value
        PackagedApplicationType = case
                                    when TRY_CONVERT(uniqueidentifier, A.CommandLineArguments) is null then 2 --Dual Admin
                                    else 1 -- Single Admin.
                                            -- This is a bug with legacy MMC Studio not understanding the new Broker App format. But only App-V apps can be affected
                                end,
        PackagedApplicationId = case
                                    when TRY_CONVERT(uniqueidentifier, A.CommandLineArguments) is null then REPLACE(A.CommandLineArguments, N'"','')
                                    else CONVERT(char(36), CONVERT(uniqueIdentifier,  A.CommandLineArguments))
                                end,
        PackagedApplicationVisibility = 3 -- WorkspaceAndDesktop
    from chb_Config.Applications A
        inner join chb_Config.ApplicationsMetadata AMD on A.Uid = AMD.ApplicationUid
    where A.CommandLineExecutable like N'%ctxAppVLauncher.exe'
        and A.ApplicationType = 0 --$ATHostedOnDesktop
        and AMD.Name = 'Citrix_DesktopStudio_SequenceLocation'
        and right(AMD.Value, 5) = '.appv'
  2. 在 MMC Studio 中创建新的 App-V 应用程序
  在 2402 LTSR 和 2507 LTSR 中，通过 MMC Studio 创建新的 App-V 应用程序可能无法正常运行。建议使用 Web Studio 创建新的 App-V 应用程序。
• 将单会话 VDA 从任何旧版本升级到 2507 LTSR CU1 时，升级操作会失败。
  作为一种解决方法，请参阅时区控制策略设置中的重要说明。
  此问题已在 Citrix Virtual Apps and Desktops 2507 CU1 Update 4 中解决

音频

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

机器创建服务™

• 使用 Nutanix AHV Prism Central 主机连接向 MCS 目录添加大量 VM 可能会失败并显示 OutOfMemory 错误。为避免此问题，请减少单批次创建的 VM 数量。我们建议一次最多添加 10 个 VM。
• 使用 InstanceType 创建的 VM 不支持作为 Red Hat OpenShift 环境中的主映像。
• 在 Red Hat OpenShift 虚拟化环境中创建 MCS 计算机目录时，不能使用具有不同操作系统类型的主映像和计算机配置文件。这是由于 Red Hat OpenShift 管理每种操作系统类型的方式所致。因此，不支持将 Windows VM 用作主映像，而将非 Windows（例如 Linux）VM 用作计算机配置文件，反之亦然。
• 在 Red Hat OpenShift 环境中，当主映像加入域时，在用于目录创建后可能会失去域信任。由于 OpenShift 环境的限制，此问题会影响 Citrix Virtual Apps and Desktops 2503 及更高版本。解决方法是不在主映像中加入域。Citrix 正在与 Red Hat 合作以增强网络隔离功能。
• 在 AWS 上托管的 VMware 环境中，如果主映像启用了 vTPM，则 MCS 计算机目录创建会失败。此问题会影响所有 Citrix Virtual Apps and Desktops 版本，并且是由于 VMware 环境中的问题所致。如需帮助，请联系 VMware 支持。

配置文件管理

• 有关已知问题的信息，请参阅其文档中的已知问题文章。

Linux 虚拟投递代理

• 有关已知问题的信息，请参阅其自己的文档中的 已知问题 文章。

会话录制

• 有关已知问题的信息，请参阅其自己的文档中的 已知问题 文章。

工作区环境管理™

• 有关已知问题的信息，请参阅其自己的文档中的 已知问题 文章。

Citrix 预配™

• 有关已知问题的信息，请参阅其自己的文档中的 已知问题 文章。

联合身份验证服务

• 有关已知问题的信息，请参阅其自己的文档中的 已知问题 文章。