App Layering

查看 PDF

已知问题

September 8, 2025

投稿者:

C C

App Layering 升级

App Layering 2409

在 Citrix App Layering 中，迁移完成后，如果代理失败，您可能会遇到不正确的消息。该消息显示：“迁移已成功完成，但我们无法将以下 App Layering 代理注册到目标设备：System.Collections.Generic.List`1[System.String]。” [UNI-91339]
迁移到目标 Elastic Layer Manager (ELM) 后，系统不会提示您设置 root 和控制台管理员密码。如果这些密码在迁移之前未设置，它们将默认为出厂设置。

解决方法：

如果密码在迁移之前未设置，请以 root 身份登录到目标 ELM 控制台，并使用以下命令手动更改密码：
- 更改 root 密码：
  
  passwd
  
  系统将提示您为 root 设置密码。
- 更改管理员密码：
  
  passwd administrator
  
  系统将提示您为 administrator 设置密码，请使用小写字母“a”。[UNI-91472]
当您使用非 root 用户连接到新的 ELM 时，可能会收到一条不明确的错误消息，显示“无法将 undefined 或 null 转换为对象。” 您应该会收到一条明确指示用户不正确的特定消息。 [UNI-91330]
您应避免在 ELM 上的默认管理员密码中使用特殊字符，例如 &、< 和 >，因为这可能导致通过导入脚本创建 OS 层失败。 [UNI-87311]
迁移后，目标 Elastic Layer Manager (ELM) 上的管理控制台管理员密码将被源 ELM 的密码覆盖。作为解决方法，您可以以具有管理员权限的用户身份登录到目标 ELM，并更改默认管理员密码。 [UNI-91451]
迁移后，目标 ELM 上的“Images”、“Connectors”、“Directory Services”和“User Layer Storage”选项卡不会自动刷新。您可能会注意到这些选项卡显示为空，即使“Layers”选项卡显示了数据。要显示正确的信息，请手动刷新您的浏览器或选项卡。[UNI-91374]
执行复制迁移后，当创建新的网络共享时，您无法在目标 Elastic Layer Manager (ELM) 发布的映像上启动弹性分配的应用程序层。

原因

新的网络共享不包含任何以前分配并同步到源 ELM 上原始网络共享的应用程序层。

解决方法

解决方法 1：执行以下命令： mono /usr/local/unitools/MAService.exe -fire SyncRevisionsToShareEvent

解决方法 2：手动将所有应用程序层从源 ELM 的网络共享复制到与目标 ELM 关联的新网络共享。

解决方法 3：取消分配然后重新分配应用程序层给您。此操作将触发层同步到新的网络共享。[UNI-91377]

App Layering 2312

升级到 App Layering 2312 可能会失败，并返回错误“升级设备时发生故障。请从干净的快照恢复后重试升级。” 我们已知某些从早期版本升级的设备存在问题。在这种情况下，由于存在旧版升级程序组件，升级可能会失败。我们正在为 App Layering 2306 开发一个修补版本，其中包含此问题的永久修复。

要解决此问题，需要通过在 Layering 设备中进行以下更改来删除旧模块：

使用 root 登录名和密码登录到设备控制台。
运行命令“yum remove mod_http2”。该命令可能需要几分钟才能运行完成。
命令完成后，使用 Web 浏览器重新登录到设备并重新运行升级。
升级可能需要 30 分钟或更长时间才能完成，但现在必须成功。

App Layering 2005

App Layering 2005 升级包足够大，以至于旧设备无法自动下载。如果您运行的是 2001 或更早版本，请从下载站点手动下载该软件包。
我们建议从安全 HTTP (HTTPS) 的管理控制台运行升级。如果您在 HTTP 中升级，消息不会在浏览器中显示。如果发生这种情况，请在 20 分钟后刷新浏览器。（尽管有消息提示不要刷新，但刷新不会导致问题。）如果升级仍在运行，您会收到“服务不可用错误”。可以安全地忽略该消息，并每隔几分钟刷新浏览器，直到出现登录页面。
如果您的网络文件共享中不同文件夹中有两个同名升级包，选择其中一个包会导致两个包都被选中。如果两个包版本相同，则升级成功。如果版本不同，系统会选择较低的版本号。这发生在 Enterprise Layer Manager (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 服务器上的 Local System 帐户下运行。如果您将帐户更改为 Local System 以外的任何内容，代理将无法在设备之间传输磁盘。

App Layering OS 机器工具

（仅限版本 19.5）从 19.3（或更早版本）升级到 19.5（或更高版本）后，请务必更新 KMS Office 激活以使用 Office 2019。准备 OS 映像以进行分层时，请下载并运行新的 App Layering OS 机器工具。
（仅限版本 19.1）准备 OS 映像以进行分层时，请确保在桌面启动时触发 KMS Office 激活。仅在此版本中，请从 版本 18.12 下载并运行 App Layering OS 机器工具。

Microsoft Teams 2.x

有关 Microsoft Teams 2.x 的详细信息，请参阅适用于 App Layering 或用户个性化层 (UPL) 的新 Teams 部署指南。

弹性分层

Microsoft Office 无法进行弹性分层，因为其许可证与 Windows 应用商店集成的方式。Office 应用程序层必须包含在分层映像中。
当您启用具有弹性分层的映像时，用户可能能够在 Windows 资源管理器中查看来自其他会话的文件和目录。在其他会话中浏览的目录可能会创建对所有有权浏览该目录的会话可见的文件夹。
如果您将弹性层分配与 Windows Server 2008 或 Windows 7 结合使用，请使用 512 扇区大小创建文件共享。有关此问题和相关操作系统更新的详细信息，请参阅以下内容：
- Microsoft 对 Windows 中 4K 扇区硬盘的支持策略
- 改进 Win 7 和 Win Server 2008 R2 与高级格式磁盘兼容性的更新 (UNI-48984)

用户层

升级后登录会启动 Windows 首次登录屏幕： 升级到 4.10 或更高版本后登录时，通常的 Windows 首次登录 会使用户层与 OS 版本保持最新。此过程会保留用户层文件。

Windows 10 支持

Windows 10 版本 20H2 升级。 如果您将 OS 层从早期版本升级到 Windows 10 20H2，请直接升级到 Build 19042.630 或更高版本。从 2020 年 11 月 16 日之前发布的 Windows 10 20H2 版本进行升级可能会导致映像部署不一致。例如，如果您使用选择了“脱机通用化”的模板发布映像，则发布的映像可能无法正常工作。
升级到新的 Windows 10 主要版本需要额外步骤： 在升级过程中，Windows 10 可以在与 OS 层版本相同的磁盘上创建恢复卷。在最终确定 OS 层版本之前，请务必删除此卷。否则，恢复卷可能导致桌面无法正常启动。有关更多信息，请参阅 Windows 10 v2004、20H2、21H1 和 21H2 - Citrix 已知问题下的问题 9。
如果您已生成并将 App Layering Optimizations.cmd 脚本应用于 Windows 10 1909 OS 层，则“开始”菜单上的“搜索”选项可能无法按预期工作。为避免此问题，请向 OS 层添加一个版本，并运行程序 c:\windows\setup\scripts\Optimize.hta。要构建一个新的 Optimizations.cmd 脚本以应用于新的层版本，请取消选择“禁用平板电脑输入服务（第 6 节，选项 M）”并选择“保存文件”。在最终确定 OS 层之前，运行命令 Powershell Set-Service TabletInputService -startuptype manual 以撤消任何可能已禁用该服务的先前 Optimizations.cmd 的影响。

连接器

使用“Azure 部署”连接器时，如果您删除所有模板并编辑连接器以选择新模板，则会出现已删除的模板版本。然后，当您单击“保存”时，会出现错误。作为解决方法，请在单击“保存”之前重新选择一个有效的模板版本。(UNI-88412)
使用 Windows 迷你启动磁盘选项时，您可以为任何给定的应用程序层指定最多四个必备层。如果应用程序在安装过程中需要四个以上其他应用程序，请将多个应用程序安装在一个层中。(UNI-69524)
在 Windows 7 64 位上创建层（应用程序、OS 或平台）时，如果在连接器配置中选择了“卸载合成”，则在向层添加版本时可能会出现问题。会发生错误，并且不会创建打包计算机。当连接器配置中未选择“卸载合成”时，会创建打包计算机。(UNI-82545)
从 Azure 收到 503 错误，“服务器繁忙问题”。如果您持续收到此错误，请按照 CTX310868 中的步骤操作。此问题偶发，正在测试解决方案。(ALHELP-1383)
如果您尝试为连接器输入一个名称，并且该名称已存在，则系统会返回一个通用错误消息，而不是正确的错误消息。此问题发生在“Azure 部署”、“用于 Azure 部署的计算机创建”、“VMware vSphere”和“用于 vSphere 的计算机创建”连接器中。(UNI-89218)

Citrix Provisioning™

创建映像模板时，目标设备的硬件设置必须与 Windows 操作系统和平台层设置匹配。确保目标设备上的硬件设置与操作系统和平台层硬件设置匹配，尤其是 CPU 数量。如果设置不匹配，启动已发布的映像时可能会收到“需要重新启动”消息。(UNI-50799)
如果您使用 Provisioning Services，则必须在 OS 层中禁用 IPv6，而不能在平台层中禁用。(UNI-53600)
将从 App Layering 发布到 PVS 磁盘存储的 VHDX 文件导入时，有时会收到无效磁盘消息。通过更改已发布文件名日期和时间中的句点 (.) 字符来消除错误。有效文件名仅包含一个句点作为 VHDX 文件扩展名。(UNI-75902)
当连接器配置中选择了“卸载合成”时：
- 如果 Citrix Provisioning Store 的路径包含空格，则无法验证。将空格替换为 %20 以使名称有效。(UNI-84868)
- 如果文件共享路径以反斜杠 (\) 结尾，则发布作业将失败。(UNI-85045)
- 如果域用户对文件共享路径没有读取和写入权限，则发布作业将因 ComponentActivator 错误消息而失败。(UNI-85020)
当您为卸载合成配置选择 Hyper-V 连接器，并且 OS 层是 Gen 2 时，您必须创建 OS 层的另一个版本，然后从该 OS 版本创建平台层。否则，目标将无法启动。(UNI-85044)
设置连接器的合成文件共享路径时，不会验证合成引擎与 Citrix Provisioning Store 之间的连接。如果存储路径未映射到文件共享路径，您会收到类似以下内容的错误：
- 错误：“发生意外系统错误。请重试操作或联系技术支持。异常消息：响应状态代码未指示成功：404 (Not Found)。[异常详细信息] (UNI-85045), (UNI-85020)

XenServer®

准备操作系统映像以在 XenServer 中使用时，必须打开端口 5900 以允许控制台访问。(UNI-50846)
始终将 Citrix App Layering 连接器配置设置为指向主节点。(UNI-52454)
必备层：
- 如果计算机在启动时挂起并且选择了必备层，则其中一个层磁盘可能未连接。确保 Citrix Guest Tools 包含在 OS 或平台层中。
- 如果您使用必备层创建 OS 或平台层，则必须存在 Citrix Tools。如果没有这些工具，打包计算机将失败并出现蓝屏。XenServer 无法看到 DVD 驱动器之后连接的任何设备。DVD 驱动器始终位于第三个插槽中。 (UNI-67741)

Citrix Virtual Apps and Desktops™ (CVAD)

将 Citrix Virtual Apps and Desktops 更新到版本 7.15 CU4 时，您必须首先在新版本的 OS 层上安装 .NET Framework 4.7.1，而不是在平台层上。在 OS 层上安装 .NET Framework 4.7.1 可确保所有应用程序层、平台层和映像正常工作。最新的 Windows 更新已将 .NET Framework 4.7.1 作为更新的一部分包含在内。(ALHELP-588, UNI-75108)

Google Cloud

从其他平台导入层时，您必须向 OS 层添加一个版本，然后从那时起切换到使用新的层版本。否则，打包计算机和已发布的映像很可能因蓝屏而失败。
Google Cloud 连接器配置。“检查凭据”验证服务帐户用户角色。如果 Google Cloud 连接器配置“服务帐户 JSON 密钥文件”中指定的服务帐户与您选择的“实例模板”关联的服务帐户不同，则配置中的服务帐户必须具有“服务帐户用户角色”。如果它没有，则在使用该连接器配置部署计算机时会收到错误。(UNI-82082)

Nutanix Acropolis

应用程序层创建期间的以下消息表示应用程序层设置指定了平台层。请勿将平台层与应用程序层的性能增强缓存功能一起使用。(UNI-67742)

VMware vSphere

使用“创建 OS 层向导”创建 OS 层时，会列出统一可扩展固件接口 (UEFI) 虚拟机。但是，您无法使用该向导创建 UEFI 计算机。相反，请使用新的 ImportOsLayer.ps1 脚本将 OS 导入到新的 OS 层计算机上。
当使用 VMware Cloud 和 vSAN 7.0 Update 2（或更高版本）数据存储的 vSphere 连接器配置时，必须选择“卸载合成”。(UNI-85216)
在 AL 23.4 中使用新的 VMware vSphere 连接器时，如果您在创建或编辑连接器时选择不透明网络，则连接器会失败。作为解决方法，请选择非不透明网络。在 AL 23.4 之前创建的使用不透明网络的现有连接器配置将继续正常运行。(UNI-89439)

Microsoft Azure

App Layering 不支持 Azure 文件存储。对于 Azure 中的存储，请创建 SMB 文件共享或网络文件共享。(UNI-42272)
托管磁盘仅支持 OS 导入。打包应用程序层和发布映像仅生成非托管磁盘。在 Azure 中创建虚拟机时，请选择“无托管磁盘”。

Microsoft Hyper-V

当为卸载合成选择 Hyper-V 连接器配置且 OS 层是 Gen 2 时，该层必须至少有一个版本（除了原始版本）。此外，安装了 Citrix Provisioning 目标设备软件的平台层必须使用新的 OS 层版本创建。(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 上创建 OS 层可能会导致以下错误：

“创建 VHD 失败。请确保连接器配置中指定的共享上有足够的空间。”

此错误是由于 Microsoft PowerShell New-VHD cmdlet 的问题。我们正在关注 Microsoft 的修复。同时，请使用以下解决方法：
1. 确保 Gold VM 没有检查点。
2. 确保 Gold VM 磁盘位于连接器配置中配置的相同目录路径中。例如：本地路径为 D:\Brock
  Gold VM 磁盘存储在 D:\Brock\WIn10Gold\Win10GoldDisk.vhdx
如果 Hyper-V 连接器配置中的存储路径包含反引号 (`)，App Layering 将无法创建应用程序/平台层。例如：
```
 mystoragename`
 
```

打印

对于配置了完整用户层的 App Layering 映像，您可以直接安装自己的打印机设备。但是，当您注销并重新登录时，“打印机和扫描仪”不再显示自行安装的打印机设备。

作为解决方法，您可以从应用程序内部访问或选择打印机。

网络

包含网络组件的应用程序在安装到应用程序层并包含在已发布的映像中时可能无法正常运行。此类应用程序需要安装到 OS 层或平台层中，以确保映像中网络相关注册表信息的正确合并。