ADManager Plus 自定义模板迁移(单独迁移模板,无需全库恢复)

ADManager Plus 自定义模板迁移(单独迁移模板,无需全库恢复)

您完全可以将指定模板(例如用户创建模板)从一台 ADManager Plus 实例迁移到另一台,无需还原整个数据库。ADManager Plus 自带专用命令行工具 TemplateBackupRestore.bat,正是为此场景设计。该工具可将选中的自定义模板导出为 JSON 文件,并导入全新部署环境。工具会自动打包所有关联依赖项,如命名格式、自定义属性和规则,无需单独迁移这些内容。

✅ 前置检查

  1. 源服务器、目标服务器 内部版本号必须完全一致,否则导入失败。
  2. 源、目标两台服务器都要先停止 ADManager Plus 服务。
  3. 目标服务器预先配置好模板关联的域、Microsoft 365 租户、Google Workspace 账号。

📤 源服务器:导出模板

  1. 停止 ADManager Plus 服务。
  2. 管理员身份打开命令行,进入安装目录 bin 文件夹。
  3. 执行 TemplateBackupRestore.bat。
  4. 输入编号选择 2(导出)。
  5. 填入模板 ID:查看模板页面的 URL 可获取 ID;多个 ID 逗号分隔。

补充:也可通过数据库查询或浏览器调试获取布局 ID(layout ID)。


  1. 如果模板包含保存的密码(用户新建 / 修改模板),需要输入加密密钥,密钥取自 customer-config.xml 文件,导入时必须使用同一个密钥。
  2. 导出成功后,bin 目录生成 JSON 文件。

文件名称:TemplateBackupRestoreExportedTemplates.json

📥 目标服务器:导入模板

  1. 将导出的 JSON 文件复制到目标服务器 bin 目录。
  2. 目标服务器停止 ADManager Plus 服务。
  3. 运行 TemplateBackupRestore.bat,选择 1(导入)。
  4. 指定 JSON 文件路径。
  5. 提示时输入相同加密密钥。
  6. 启动 ADManager Plus 服务。

⚠️ 重要说明

  1. 导入是新增模板,不会覆盖原有模板;同名模板会自动在名称后增加数字后缀。
  2. 系统内置默认模板不能导出,仅支持自定义模板迁移。
  3. 模板导出会自动携带命名格式、自定义属性、规则等依赖,无需单独迁移。