升级配置文件管理

Last published : Nov 13, 2026
本文提供了使用 Active Directory 升级配置文件管理部署的指导。
重要提示： 务必按照此升级过程中的步骤顺序进行操作。仅在将新的 .adm 或 .admx 文件添加到组策略后，才能升级所有计算机上的软件。如果提前升级，日志文件可能会存储在两个位置。一个包含旧版本的日志文件，另一个包含新版本的文件。此注意事项尤其会影响 Citrix virtual desktops™ 部署。
同样重要的是，要在计划的维护期间进行升级。或者在 Active Directory 复制允许更改在部署中传播时进行升级。通常，升级可能需要长达 24 小时。
升级过程包括：
  1. 创建组策略对象 (GPO) 并将新的 .adm 或 .admx 文件添加到新的 GPO
    \- 或 -
    升级现有 .adm 或 .admx 文件，如本文后面所述。
  2. 升级所有计算机上的 .msi 文件，如本文后面所述。
  3. 应用 GPO。
Related information
https://docs.citrix.com/us/en/profile-management/2212/upgrade-and-migrate.html

升级现有 .adm 文件

如果组策略中存在任何早期版本的配置文件管理 .adm 文件，您可以使用以下过程进行升级。升级时，早期版本中的所有策略设置都将保留。
  1. 在域控制器上，执行以下操作之一：
    • 导入现有 .adm 文件。该文件位于下载包中的 GPO\_Templates 文件夹中。
    • 将下载包中 GPO\_Templates 文件夹中的 .admx 文件复制到 C:\Windows\PolicyDefinitions 文件夹，并将 .adml 文件复制到 C:\Windows\PolicyDefinitions\<localized 文件夹\>。例如，在英语操作系统上，\&lt;localized folder\> 为 en-US。
  2. 在用于配置 Profile Management 的计算机上，打开组策略对象编辑器。
  3. 在组策略对象编辑器中，右键单击 管理模板，然后选择 添加/删除模板。
  4. 选择现有版本的 Profile Management .adm 文件（例如，ctxprofile5.4.1），单击 删除，然后单击 关闭。Administrative Templates\\Citrix 文件夹将被删除。
  5. 再次右键单击 管理模板，然后选择 添加/删除模板。
  6. 单击 添加，浏览到新版本 .adm 或 .admx 文件的位置（例如，ctxprofile5.5.0），选择该文件，然后单击 关闭。新文件已导入，但旧设置将保留。

升级 .msi 文件

建议您在所有用户设备上安装相同版本的 Profile Management，并将该相同版本的 .adm 或 .admx 文件添加到所有域控制器上的每个组策略对象。这样做可以防止配置文件数据损坏，因为不同版本的用户存储结构可能导致数据损坏。
建议您在启用任何新设置之前，将所有计算机升级到最新版本的 Profile Management。要检查您正在使用的版本中某个设置是否为新设置，请参阅 Profile Management 策略。
  1. 确保所有用户已从要升级的计算机注销。
  2. 通过在每台计算机上运行 .msi 文件，将新版本的 Profile Management 安装到现有版本之上。有关详细信息，请参阅 安装和设置。

升级 .ini 文件

您在早期版本的 Profile Management 中编辑了 .ini 文件，并升级到较新版本。软件可以检测到该文件已被编辑，并且默认情况下不会覆盖它。要保留您的 .ini 文件设置并使用较新版本中的新设置，您必须执行以下操作之一：
  • 将较新版本 .ini 文件中的新设置手动添加到您现有的已编辑 .ini 文件中。
  • 保存现有已编辑版本 .ini 文件的副本。使用 OVERWRITEINIFILES=yes 命令行选项强制在升级期间覆盖该文件。将您保存的设置添加到已升级的 .ini 文件中。例如：
    msiexec /i <path to the MSI file\> /quiet [INSTALLDIR=<installation directory>] [OVERWRITEINIFILES=yes] [INSTALLPOLICYINIFILES=no]
注意
要通过 HDX™ 配置 Profile Management 策略，您必须：
  • 升级您的 Delivery Controllers。原因是 HDX 从 XenApp 和 XenDesktop 布局中存在的 UserProfileManager\_PowerShellSnapIn.msi 文件读取 Profile Management 策略设置 image-full\x64\Citrix Desktop Delivery Controller。
  • 升级您的 VDA 以获取最新版本的 Profile Management。
更多资源
  • 配置文件管理策略
  • 安装和设置