已知问题

备注

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

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

警告：

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

常规

在 Windows 10 版本 22H2 和 Windows Server 2022 平台上安装思杰虚拟投递代理期间，您可能会遇到以下错误。

lcm-23228 error

此外，在代理代理 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]

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

Microsoft 确认在使用现代打印对话框时，打印作业之间保留打印设置存在问题，他们正在努力解决。他们目前的预计是 2025 年上半年。现代打印对话框在 Windows 11 和 Windows Server 2025 等较新的操作系统版本中默认启用。可以通过执行以下操作将操作系统配置为使用旧版打印对话框：

打开注册表编辑器。
转到 HKEY_CURRENT_USER\Software\Microsoft\Print\UnifiedPrintDialog
右键单击并选择 新建 > DWORD (32 位) 值
Rename the value as PreferLegacyPrintDialog.
Right-click PreferLegacyPrintDialog and select Modify.
将值数据设置为 1，然后单击确定。

[HDX-66953] [HDX-66904]

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

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

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.

如果 uberAgent® 服务是独立于 VDA 安装的（而不是通过 VDA MetaInstaller 安装），则在卸载 VDA 时不得卸载 uberAgent 服务。[HDX-92242]

发布使用 App-V 打包的应用程序时，用户可能无法移动或调整应用程序大小。作为一种解决方法，请设置以下注册表值：HKLM\SYSTEM\CurrentControlSet\Control\Citrix\wfshell\TWI\SeamlessSwclFlags(DWORD) = 2。此项只能用于解决此特定问题，并且可能会导致调整窗口大小和移动窗口的用户体验下降。[HDX-91796]

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

在 NAPS2 8.x 版本中创建新配置文件并立即启动基于进纸器的扫描时，应用程序可能会崩溃。此问题特别在 NAPS2 8.1.4 版本中观察到。[HDX-86985]

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

作为一种变通方法，请使用应用程序中已可见的打印机，或者添加打印机使其在当前会话中可用。

[HDX-86440]

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

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

[HDX-86327]

当多个 Chrome 浏览器选项卡（包括那些配置了浏览器内容重定向 (BCR) 的选项卡）同时从一个 Chrome 窗口拖放到另一个窗口时，重定向的内容可能会出现意外行为。[HDX-81501]

如果将包含视频内容的选项卡移动到新窗口，播放可能会停止或视频可能不会显示。[HDX-92343]

将浏览器内容重定向与浏览器配置文件共享结合使用时，不支持具有多个配置文件的 SSO 持久性。[HDX-85325]

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

作为一种变通方法，

有关详细信息，请参阅贴靠窗口部分。
请参阅如何禁用“贴靠窗口”功能。[HDX-91532]

当您使用 Citrix Workspace 应用程序访问启用了 Unicode 输入模式的 VDA，并且“Unicode 键盘布局映射”或“自动键盘显示”组策略已打开时，您可能会发现在 Microsoft Excel 中滚动大型页面时性能下降。出现此问题的原因是 UIAutomation API 与 Excel 不兼容。[HDX-91618]

当使用增强型域直通进行单点登录 (SSO) 时，用户首次连接时，会话内应用程序的 SSO 按预期工作。但是，如果用户断开连接并稍后重新连接到同一会话，则会话内的 SSO 可能会停止工作。这是由于 2025 年 3 月和 4 月发布的 Windows 更新引入的回归问题。遇到此问题的客户应向 Microsoft 提交支持案例，并参考跟踪 ID 2410230030007977。[HDX-66643]

由于 CVAD 2311 中添加了新的 App-V 相关功能，App-V 功能现在仅在 Web Studio 中完全支持。将 MMC Studio 用于 App-V 可能会导致问题。

现有 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'
<!--NeedCopy-->

在 MMC Studio 中创建新的 App-V 应用程序

在 2402 LTSR 和 2507 LTSR 中，通过 MMC Studio 创建新的 App-V 应用程序可能无法正常运行。建议使用 Web Studio 创建新的 App-V 应用程序。[LCM-23481]

音频

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

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

[HDX-80937]

机器创建服务™

使用 Nutanix AHV Prism Central 主机连接向 MCS 目录添加大量 VM 可能会失败并出现 OutOfMemory 错误。为避免此问题，请减少单批次创建的 VM 数量。我们建议一次最多添加 10 个 VM。[PMCS-58254]

使用 InstanceType 创建的 VM 不支持作为 Red Hat OpenShift 环境中的主映像。[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]

这是否有帮助？

已知问题

备注

常规

音频

机器创建服务™

配置文件管理

Linux 虚拟投递代理

会话录制功能

Workspace Environment Management™

思杰预配™

联合身份验证服务

在本文中