已知问题
App Layering 升级
App Layering 2511
-
对于 Google Cloud Platform 连接器,当前存在打包层和发布分层映像的问题。任务在等待合成引擎启动后失败,并显示错误消息,其中包含 The resource ‘citrix-ce/’ of type ‘Guest Attribute’ was not found. [404]。此问题将在未来的更新或版本中解决。[UNI-92996]
-
映像可移植性服务功能目前不支持配置了 NVMe 磁盘控制器的 Azure 映像。计划在未来版本中提供支持。
App Layering 2409
-
在 Citrix App Layering 中,迁移完成后,代理失败时可能会遇到不正确的消息。该消息指出:“迁移已成功完成,但我们无法将以下 App Layering 代理注册到目标设备:System.Collections.Generic.List`1[System.String]。”[UNI-91339]
-
迁移到目标弹性层管理器 (ELM) 后,系统不会提示您设置 root 和控制台管理员密码。如果这些密码在迁移之前未设置,它们将默认为出厂设置。
解决方法:
如果密码在迁移之前未设置,请以 root 身份登录到目标 ELM 控制台,并使用以下命令手动更改密码:
-
更改 root 密码:
passwd系统将提示您为 root 设置密码。
-
更改管理员密码:
passwd administrator系统将提示您为管理员设置密码,请使用小写字母“a”。[UNI-91472]
-
-
当您使用非 root 用户连接到新的 ELM 时,可能会收到一条不明确的错误消息,指出“Cannot convert undefined or null to object”。您应该会收到一条特定消息,指示用户不正确。[UNI-91330]
-
您应避免在 ELM 上的默认管理员密码中使用特殊字符,例如 &、< 和 >,因为这可能会导致通过导入脚本创建操作系统层失败。[UNI-87311]
-
迁移后,目标弹性层管理器 (ELM) 上的管理控制台管理员密码将被源 ELM 的密码覆盖。作为解决方法,您可以以具有管理员权限的用户身份登录到目标 ELM,并更改默认管理员密码。[UNI-91451]
-
迁移后,目标 ELM 上的“映像”、“连接器”、“目录服务”和“用户层存储”边栏选项卡不会自动刷新。您可能会注意到这些边栏选项卡显示为空,即使“层”边栏选项卡显示数据。要显示正确的信息,请手动刷新浏览器或选项卡。[UNI-91374]
-
执行复制迁移后,当创建新的网络共享时,您无法在目标弹性层管理器 (ELM) 发布的映像上启动弹性分配的应用程序层。
原因
新的网络共享不包含以前分配并同步到源 ELM 上的原始网络共享的任何应用程序层。
解决方法
解决方法 1: 执行以下命令:
mono /usr/local/unitools/MAService.exe -fire SyncRevisionsToShareEvent解决方法 2: 将所有应用程序层从源 ELM 的网络共享手动复制到与目标 ELM 关联的新网络共享。
解决方法 3: 取消分配然后重新分配应用程序层。此操作将触发层同步到新的网络共享。[UNI-91377]
App Layering 2312
升级到 App Layering 2312 可能会失败,并返回错误“A failure occurred while upgrading the appliance. Try the upgrade again after reverting from a clean snapshot.”我们知道某些从以前版本升级的设备存在问题。在这种情况下,由于存在旧版升级程序组件,升级可能会失败。我们正在为 App Layering 2306 开发一个修补版本,其中包含此问题的永久修复。
要解决此问题,需要通过在分层设备中进行以下更改来删除旧版模块:
- 使用 root 登录名和密码登录到设备控制台。
- 运行命令“yum remove mod_http2”。该命令可能需要几分钟才能运行。
- 命令完成后,使用 Web 浏览器重新登录到设备并重新运行升级。
- 升级可能需要 30 分钟或更长时间才能完成,但现在必须成功。
App Layering 2005
- App Layering 2005 升级包足够大,以至于旧设备无法自动下载。如果您运行的是 2001 或更早版本,请从下载站点手动下载该软件包。
-
我们建议从安全 HTTP (HTTPS) 中的管理控制台运行升级。如果您在 HTTP 中升级,消息将不会显示在浏览器中。如果发生这种情况,请在 20 分钟后刷新浏览器。(刷新不会导致问题,尽管消息说不要刷新。)如果升级仍在运行,您会收到“服务不可用错误”。可以安全地忽略该消息,并每隔几分钟刷新浏览器,直到出现登录页面。
- 如果您的网络文件共享中不同文件夹中有两个同名升级包,选择其中一个包会导致两个包都被选中。如果两个包的版本相同,则升级成功。如果它们具有不同的版本,系统会选择较低的版本号。这发生在企业层管理器 (ELM) 版本 22.2 中。
App Layering 设备和管理控制台
- 在新 UI 中,无法编辑平台类型。“编辑平台类型”在旧 UI 中仍然正常运行。(UNI-86856)
- 安装 App Layering 设备时,您必须使用默认 CPU 设置 4 个 CPU。
- 如果您在复杂的 Active Directory 环境中使用角色并且登录速度缓慢,请将所有角色分配给显式用户而不是组。
App Layering 文档链接
管理控制台中的文档链接在 Internet Explorer 11 中打开为空白页。要解决此问题,请将链接粘贴到另一个浏览器中。文档将正确显示。
App Layering 代理
默认情况下,Citrix App Layering™ 代理在 Hyper-V 服务器上的“本地系统”帐户下运行。如果您将帐户更改为“本地系统”以外的任何其他帐户,代理将无法在设备之间传输磁盘。
App Layering 操作系统计算机工具
-
(仅限版本 19.5)从 19.3(或更早版本)升级到 19.5(或更高版本)后,请务必更新 KMS Office 激活以使用 Office 2019。准备用于分层的操作系统映像时,请下载并运行新的 App Layering 操作系统计算机工具。
-
(仅限版本 19.1)准备用于分层的操作系统映像时,请确保在桌面启动时触发 KMS Office 激活。仅在此版本中,请从 Release 18.12 下载并运行 App Layering 操作系统计算机工具。
Microsoft Teams 2.x
- 有关 Microsoft Teams 2.x 的详细信息,请参阅适用于 App Layering 或用户个性化层 (UPL) 的新 Teams 部署指南。
弹性分层
- Microsoft Office 无法进行_弹性_分层,因为其许可证与 Windows 应用商店集成的方式。Office 应用程序层必须包含在分层映像中。
- 当您启用具有弹性分层的映像时,用户可能能够在 Windows 资源管理器中查看其他会话中的文件和目录。在其他会话中浏览的目录可能会创建对所有有权浏览该目录的会话可见的文件夹。
- 如果您将弹性层分配与 Windows Server 2008 或 Windows 7 结合使用,请创建扇区大小为 512 的文件共享。有关此问题和相关操作系统更新的详细信息,请参阅以下内容:
用户层
- 升级后登录会启动 Windows 首次登录屏幕:在升级到 4.10 或更高版本后登录时,通常的 Windows 首次登录 会使用操作系统版本更新用户层。此过程会保留用户层文件。
Windows 10 支持
- Windows 10 版本 20H2 升级。如果您将操作系统层从早期版本升级到 Windows 10 20H2,请直接升级到内部版本 19042.630 或更高版本。从 2020 年 11 月 16 日之前发布的 Windows 10 20H2 内部版本升级可能会导致映像部署不一致。例如,如果您使用选择了“脱机通用化”的模板发布映像,则发布的映像可能无法正常工作。
- 升级到新的 Windows 10 主要版本需要额外的步骤:在升级过程中,Windows 10 可能会在与操作系统层版本相同的磁盘上创建恢复卷。在完成操作系统层版本之前,请务必删除此卷。否则,恢复卷可能会导致桌面无法正常启动。有关详细信息,请参阅 Windows 10 v2004、20H2、21H1 和 21H2 - Citrix 已知问题 中的问题 9。
- 如果您已生成
Optimizations.cmd脚本并将其应用于 Windows 10 1909 操作系统层,则“开始”菜单上的“搜索”选项可能无法按预期工作。为避免此问题,请向操作系统层添加一个版本,然后运行程序c:\windows\setup\scripts\Optimize.hta。要构建新的Optimizations.cmd脚本以应用于新的层版本,请取消选择“禁用平板电脑输入服务(第 6 节,选项 M)”并选择“保存文件”。在完成操作系统层之前,运行命令Powershell Set-Service TabletInputService -startuptype manual以撤消任何以前可能已禁用该服务的Optimizations.cmd的影响。
连接器
- 使用 Azure Deployments 连接器时,如果您删除所有模板并编辑连接器以选择新模板,则会出现已删除的模板版本。然后,当您单击“保存”时,会出现错误。作为解决方法,请在单击“保存”之前重新选择一个有效的模板版本。(UNI-88412)
- 使用 Windows 迷你启动磁盘选项时,您可以为任何给定的应用程序层指定最多四个必备层。如果一个应用程序在安装过程中需要四个以上的其他应用程序,请在一个层中安装多个应用程序。(UNI-69524)
- 在 Windows 7 64 位上创建层(应用程序、操作系统或平台)时,如果您在连接器配置中选择“卸载合成”,则在向层添加版本时可能会出现问题。会发生错误,并且不会创建打包计算机。当连接器配置中未选择“卸载合成”时,会创建打包计算机。(UNI-82545)
- 从 Azure 收到 503 错误,“服务器繁忙问题”。如果您持续收到此错误,请按照 CTX310868 中的步骤操作。此问题偶有发生,目前正在测试解决方案。(ALHELP-1383)
- 如果您尝试为连接器输入一个名称,并且该名称已存在,您将收到系统发出的通用错误消息,而不是正确的错误消息。此问题发生在 Azure Deployments、用于 Azure Deployments 的计算机创建、VMware vSphere 和 用于 vSphere 的计算机创建 连接器中。(UNI-89218)
Citrix Provisioning™
- 创建映像模板时,目标设备硬件设置必须与 Windows 操作系统和平台层设置匹配。确保目标设备上的硬件设置与操作系统和平台层硬件设置匹配,尤其是 CPU 数量。如果设置不匹配,则在启动已发布映像时可能会收到“需要重新启动”消息。(UNI-50799)
- 如果您使用 Provisioning Services,则必须在操作系统层中禁用 IPv6,而不是在平台层中禁用。(UNI-53600)
- 将从 App Layering 发布到 PVS 磁盘存储的 VHDX 文件导入时,有时会收到无效磁盘消息。通过更改已发布文件名日期和时间中的句点 (.) 字符来消除错误。有效文件名仅包含一个句点作为 VHDX 文件名扩展名。(UNI-75902)
- 当连接器配置中选择了“卸载合成”时:
- 如果 Citrix Provisioning Store 的路径包含空格,则验证失败。将空格替换为 %20 以使名称有效。(UNI-84868)
- 如果文件共享路径以反斜杠 (\) 结尾,则发布作业失败。(UNI-85045)
- 如果域用户对文件共享路径没有读取和写入权限,则发布作业会因 ComponentActivator 错误消息而失败。(UNI-85020)
- 当您为卸载合成配置选择 Hyper-V 连接器,并且操作系统层为 Gen 2 时,您必须创建另一个版本的操作系统层,然后从该操作系统版本创建平台层。否则,目标将无法启动。(UNI-85044)
- 当 Hyper-V 连接器配置设置为 Gen 2 (UEFI) 和 VHDX 的卸载合成时,允许选择 VHD 作为 Citrix Provisioning 连接器配置中的“磁盘格式”,但不支持此配置。
- 在 Hyper-V 中配置弹性分层时,您必须使用_非托管_ RDS 池 (UNI-53545)
-
创建应用程序层时,如果在应用程序层设置中指定了平台层,则会收到错误。请勿将平台层与 App Layering 的缓存功能一起使用。(UNI-71868, UNI-67743)

-
在 Hyper-V Server 2019 上创建操作系统层可能会导致此错误:
‘Failed to create VHD. Make sure that there is enough space on the share specified in the connector configuration.’
此错误是由于 Microsoft PowerShell New-VHD cmdlet 的问题。我们正在关注 Microsoft 的修复。在此期间,请使用以下解决方法来解决此错误:
- 确保黄金 VM 没有检查点。
- 确保黄金 VM 磁盘位于连接器配置中配置的相同目录路径中。示例:
本地路径为 D:\Brock
黄金 VM 磁盘存储在 D:\Brock\WIn10Gold\Win10GoldDisk.vhdx
-
如果 Hyper-V 连接器配置中的存储路径包含反引号 (`),则 App Layering 无法创建应用程序/平台层。例如:
mystoragename` <!--NeedCopy-->
打印
对于配置了完整用户层的 App Layering 映像,您可以直接安装自己的打印机设备。但是,当您注销并重新登录时,“打印机和扫描仪”不再显示自行安装的打印机设备。
作为解决方法,您可以从应用程序中访问或选择打印机。
网络
包含网络组件的应用程序在安装到应用程序层中并包含在已发布映像中时可能无法正常运行。此类应用程序需要安装到操作系统层或平台层中,以确保映像中网络相关注册表信息的正确合并。