使用 Content Migration Tool 将内容从一个 Dynamics 365 Guides 环境迁移到 Microsoft Dataverse 另一个环境(公开预览版)

适用于 Microsoft Dynamics 365 Guides 的内容迁移工具(公开预览版)是一个 Windows PowerShell 脚本,用于将内容从一个环境复制到另一个环境 Microsoft Dataverse 。 您可以迁移环境中的所有内容,也可以仅迁移特定类型的内容(例如,3D 对象、图像和视频)。 迁移完成后,内容将存在于两个环境中。 源环境中的内容不会以任何方式更改。

该工具可同时连接到两个 Microsoft Dataverse 环境。 它读取源环境中的内容并将其写入目标环境。 这些环境可以属于同一租户,也可以位于不同的租户中。

该工具支持在商业和/或 Microsoft 政府社区云(GCC)环境之间进行迁移。

重要提示

使用 Content Migration Tool(公开预览版), Dynamics 365 Guides即表示您承认并接受使用预览版工具的所有限制。 例如,您接受 Microsoft 商业服务和产品的条款和承诺 Dynamics 365 Guides 不适用于 Content Migration Tool。 您还承担与 Dynamics 365 租户之间迁移数据相关的所有风险。 这些风险包括但不限于不同安全性、合规性和隐私承诺的风险、数据损坏或丢失的风险,以及工具不可用或中断的风险。

该工具支持以下类型的迁移。

迁移类型 迁移的内容
所有内容 存储在活动实例中的所有内容。 (不包括与指南关联的遥测事件。
指南和相关内容 活动参考线,以及与这些参考线相关的任何 3D 对象、图像或视频。 与指南关联的非活动内容也会被迁移。 您可以一次迁移所有现有指南,也可以选择特定指南。 您无法迁移打包指南和非打包指南的组合。
所有 3D 对象、图像和视频 实例中存储的所有活动 3D 对象、图像和视频。
仅 3D 对象 仅限活动 3D 对象。 您可以一次迁移所有现有的 3D 对象、属于三维对象集合的所有3D对象或选择特定的 3D 对象。
仅图像 仅限活动映像。 您可以一次迁移所有现有映像,也可以选择特定映像。
仅限视频 仅限活动视频。 您可以一次迁移所有现有视频,也可以选择特定视频。
仅对象锚点 仅限活动对象锚点。 您可以一次迁移所有现有对象锚点,也可以选择特定的对象锚点。

备注

  • 如果您已在环境中创建文件夹结构, 请使用 Power Platform导出/导入功能迁移它。 先移动文件夹,然后移动内容可确保保留文件夹和内容层次结构。
  • 迁移指南时,将迁移网站和 Power Apps 链接 。 但是,请 Power Apps手动将应用程序导入到新环境中,并在适当的步骤中更新链接。
  • Content Migration Tool 不支持迁移基于 Schema v3 或 v4 的指南。 如果您已将解决方案更新到 Dynamics 365 Guides 最新版本,但仍有基于架构 v3 或 v4 的指南, 请进行手动升级
  • 对于属于三维对象集合3D对象,除非您具有 系统管理员 角色,否则不会迁移父 三维对象。

先决条件

  • 用于运行 Windows PowerShell 脚本的计算机的系统管理员。

  • Windows PowerShell 版本 5.1.18362.752 或更高版本。

  • 源环境和目标环境都使用 Dynamics 365 Guides 解决方案版本 700.0.0.x 或更高版本。

  • 源环境和目标环境具有相同的主要版本号和次要版本号。

  • 用于以 系统管理员 角色(首选)或 操作员/作者 角色(必需)登录到源环境的凭据。

  • 用于以 系统管理员 角色(首选)或 作者 角色(必需)登录到目标环境的凭据。

我们还强烈建议您在 开始迁移过程之前备份这两个环境的内容

下载工具并运行脚本

  1. 下载 Guides 内容迁移工具。 压缩文件夹将下载到您的下载文件夹中。

  2. 在 Windows 文件资源管理器中,选择压缩文件夹,右键单击,然后选择 属性.

  3. 在 Properties(属性) 对话框的 General(常规 )选项卡上,选择 Unblock(取消阻止复选框,然后选择 Apply(应用 )。

    取消阻止复选框和应用按钮

  4. 选择 zip 文件夹并提取内容。

  5. 以管理员 身份运行 Windows PowerShell。 选择 Start(开始),键入 PowerShell,选择 Windows PowerShell,然后选择 Run as administrator(以管理员身份运行)。

  6. 导航到提取的存档中的 ContentMigrationTool_D365GuidesR2_v700>MigrationToolScripts 文件夹。

  7. 在“用户帐户控制 消息框中,选择 “是 ”以允许 Windows PowerShell 对设备进行更改。

  8. 输入 Set-ExecutionPolicy RemoteSigned,然后选择 Y 以接受执行策略的更改。

    Execution Policy Change(执行策略更改)页面。

  9. 输入 \ContentMigrationTool_PublicPreview_Dynamics365Guides.ps1,然后按 选择 Enter

    备注

    请务必在字符串的开头包含句点。

  10. 选择任意键以继续。

  11. 在 PowerShell 交互式登录 对话框中,按照以下步骤连接到源环境:

    1. 在 Deployment Type 字段组中,选择 Microsoft 365 该选项。

    2. 选择Display list of available organizations(显示可用组织 列表)复选框。

    3. 选择Show Advanced 复选框。

    4. 在 Online Region 字段中,为您的环境选择在线区域。 如果您的环境位于 GCC 区域,请选择 北美 2。 如果您不知道区域,请选择 Don't know(不知道)。

    5. 在 User Name (用户名)和 Password 字段中,输入要连接到的 Microsoft Dataverse 环境的用户名和密码。

    6. 选择登录。 如果未选择要连接的组织,则该工具将连接到源环境和目标环境都成功的最后一个组织。 如果租户中只有一个环境,Windows PowerShell 会自动连接到默认环境。 在这种情况下,请跳至步骤 12。

    7. 在“启动登录进程 对话框中,选择要连接到的源环境(组织)。

      在“启动登录进程”对话框中选择的源环境。

    8. 选择登录

  12. 在 PowerShell 交互式登录 对话框中,按照以下步骤连接到目标环境:

    1. 在 Deployment Type 字段组中,选择 Microsoft 365 该选项。

    2. 选择Display list of available organizations(显示可用组织 列表)复选框。

    3. 选择Show Advanced 复选框。

    4. 在 Online Region 字段中,为您的环境选择在线区域。 如果您的环境位于 GCC 区域,请选择 北美 2。 如果您不知道区域,请选择 Don't know(不知道)。

    5. 在 User Name (用户名)和 Password 字段中,输入要连接到的 Microsoft Dataverse 环境的用户名和密码。

    6. 选择登录

    7. 在“启动登录进程 对话框中,选择要连接到的目标环境(组织)。

      在“启动登录进程”对话框中选择的目标环境。

    8. 选择登录

  13. 在 Main Menu 页面上,通过输入与之对应的数字来选择选项,然后选择 Enter

    主菜单页面。

    小费

    在可以选择多个选项的编号列表中(如选择 Guides to Migrate 页面上的 编号列表),用逗号分隔所选选项的数字,然后按 选择 Enter

    在“选择迁移指南”页面上选择多个选项。

  14. 当系统提示您确认选择时,输入 Y,然后选择 Enter。 要取消操作,请输入 N,然后选择 Enter

    确认您的选择。

另请参见