ADManager Plus 自定义模板迁移(单独迁移模板,无需全库恢复)
您完全可以将指定模板(例如用户创建模板)从一台 ADManager Plus 实例迁移到另一台,无需还原整个数据库。ADManager Plus 自带专用命令行工具 TemplateBackupRestore.bat,正是为此场景设计。该工具可将选中的自定义模板导出为 JSON 文件,并导入全新部署环境。工具会自动打包所有关联依赖项,如命名格式、自定义属性和规则,无需单独迁移这些内容。
✅ 前置检查
- 源服务器、目标服务器 内部版本号必须完全一致,否则导入失败。
- 源、目标两台服务器都要先停止 ADManager Plus 服务。
- 目标服务器预先配置好模板关联的域、Microsoft 365 租户、Google Workspace 账号。
📤 源服务器:导出模板
- 停止 ADManager Plus 服务。
- 管理员身份打开命令行,进入安装目录
bin 文件夹。 - 执行
TemplateBackupRestore.bat。 - 输入编号选择 2(导出)。
- 填入模板 ID:查看模板页面的 URL 可获取 ID;多个 ID 逗号分隔。
补充:也可通过数据库查询或浏览器调试获取布局 ID(layout ID)。
- 如果模板包含保存的密码(用户新建 / 修改模板),需要输入加密密钥,密钥取自
customer-config.xml 文件,导入时必须使用同一个密钥。

- 导出成功后,
bin 目录生成 JSON 文件。
文件名称:TemplateBackupRestoreExportedTemplates.json
📥 目标服务器:导入模板
- 将导出的 JSON 文件复制到目标服务器
bin 目录。 - 目标服务器停止 ADManager Plus 服务。
- 运行
TemplateBackupRestore.bat,选择 1(导入)。 - 指定 JSON 文件路径。
- 提示时输入相同加密密钥。
- 启动 ADManager Plus 服务。
⚠️ 重要说明
- 导入是新增模板,不会覆盖原有模板;同名模板会自动在名称后增加数字后缀。
- 系统内置默认模板不能导出,仅支持自定义模板迁移。
- 模板导出会自动携带命名格式、自定义属性、规则等依赖,无需单独迁移。