迁移门户配置

项目
03/16/2023

备注

从 2022 年 10 月 12 日起，Power Apps 门户更名为 Power Pages。详细信息请参阅：Microsoft Power Pages 现已正式发布（博客）
不久后我们将迁移 Power Apps 门户文档并将其与 Power Pages 文档合并在一起。

门户开发涉及多个配置和自定义来实现所需的门户最终用户体验。

在完成了您的门户实例的开发或配置后，您可能想要将您最新的门户配置从开发环境中迁移到测试或生产环境中。

迁移涉及从源 Microsoft Dataverse 环境中导出您现有的配置，然后再将其导入目标 Dataverse 环境。

准备目标环境

备注

准备目标环境是一个一次性过程。您需要预配一个新门户，来在 Dataverse 上安装托管门户解决方案并配置门户 Web 应用程序。此过程还会安装默认门户元数据，这些元数据将被源环境中的门户元数据替换。
确保目标环境的最大附件大小设置为与源环境相同或更大的大小。
最大文件大小由环境系统设置对话框中系统设置电子邮件选项卡中的最大文件大小设置确定。

在您的目标环境中预配新门户。使用您在源环境中预配的同一个门户模板。例如，如果您在源环境中预配了 Dynamics 365 客户自助服务门户，则也在目标环境中预配 Dynamics 365 客户自助服务门户。
在目标环境中，使用门户管理应用删除新创建的网站记录。这将从目标环境中删除默认门户配置数据。
在目标环境中，删除门户应用。这将删除当前被配置为呈现默认门户的门户应用。

备注

请勿删除门户管理应用！
使用 Power Platform CLI 或配置迁移工具从源环境转移门户元数据。
在目标环境中，使用现有门户网站选项预配新门户。此过程将使用您从源环境转移的门户配置来配置门户。
来自源环境的门户更新应会反映在这个新目标环境中。接下来，您应该能够通过转移门户配置数据将配置从源环境转移到目标环境。

备注

使用 Power Platform CLI 转移门户配置

Microsoft Power Platform CLI 提供了很多专门用于门户的功能。这些命令允许您从源环境下载门户配置并将其转移到目标环境。这些命令也可以合并到 ALM 流程中。

创建 Power Platform CLI 身份验证配置文件以连接到您的源环境和目标环境。您可以为它们命名来轻松识别目标和源环境。
```
pac auth create --name [name] --url [environment url]
```
示例
```
pac auth create --name PORTALDEV --url https://contoso-org.crm.dynamics.com
```
创建身份验证配置文件后，它们将具有可使用 list 命令确定的关联索引。
```
pac auth list
```
选择连接到源环境的 Power Platform CLI 身份验证配置文件。
```
pac auth select --index [source environment index]
```
示例
```
pac auth select --index 1
```
确定源门户的网站 ID。
```
pac paportal list
```
将门户配置数据下载到本地工作站。如果您之前已将门户配置下载到同一路径，则使用设置为 true 的 --overwrite 选项。
```
pac paportal download --path [path] --webSiteId [website id]
```
示例
```
pac paportal download --path c:\paportals\ --webSiteId db9db518-ea5c-ec11-8f8f-00224804e6cd
```
选择连接到目标环境的 Power Platform CLI 身份验证配置文件。
```
pac auth select --index [target environment index]
```
示例
```
pac auth select --index 2
```

将门户配置数据上载到目标环境。

pac paportal upload --path [path]

示例

pac paportal upload --path "C:\paportals\portaldev"

备注

Power Platform CLI 工具不能迁移表或表架构。当配置数据与所选架构不匹配时，迁移可能会因缺少表和字段等元素而失败。在导入期间，请确保目标环境包含与任何其他自定义项（例如作为解决方案单独导入的表、字段、表单或视图）一起安装的相同门户类型。

备注

使用配置迁移工具转移门户配置

备注

首选方法是使用 Power Platform CLI 转移门户元数据。

若要导出配置数据，您需要使用配置迁移工具和门户特定的配置架构文件。有关此工具的详细信息，请参阅管理配置数据。

备注

建议您使用配置迁移工具的最新版本。可以从 NuGet 下载配置迁移工具。有关下载工具的更多信息：从 NuGet 下载工具。
用于配置迁移的架构文件支持的门户的最低解决方案版本为 8.4.0.275。但是，建议您使用解决方案的最新版本。
源和目标组织的默认语言必须相同，迁移才会成功。

架构文件可用于以下门户类型：

使用 Dataverse 在环境中创建的门户
- 自定义门户（空白门户）
- 自定义门户（空白门户）（对于版本 9.2.2103.x）
- 自定义门户（空白门户）（对于版本 9.3.2201.x 或更高版本）
在其中包含 Customer Engagement 应用（如 Dynamics 365 Sales 和 Dynamics 365 Customer Service）的环境中创建的门户
- 自定义门户（空白门户）
- 自定义门户（空白门户）（对于版本 9.2.2103.x）
- 自定义门户（空白门户）（对于版本 9.3.2201.x 或更高版本）
- 社区门户
- 客户自助服务门户
- 合作伙伴门户
- 员工自助服务门户

默认的架构文件包含有关门户表、关系和每个实体唯一性定义的信息。详细信息：导出门户配置数据

导出配置数据后，必须将其导入目标环境。详细信息：导入门户配置数据

备注

配置迁移工具使用架构导出和导入配置数据。该工具不能迁移表或表架构。当配置数据与所选架构不匹配时，迁移可能会因缺少表和字段等元素而失败。

在导出期间，请确保源环境包含配置迁移工具架构文件中指定的门户表。您仍然可以更改架构文件以添加、删除和修改表、属性等，从而迁移配置数据的子集。

在导入期间，请确保目标环境包含与任何其他自定义项（例如作为解决方案单独导入的表、字段、表单或视图）一起安装的相同门户类型。

导出门户配置数据

可以使用门户特定的配置架构文件从源系统中导出门户配置数据。

下载配置迁移工具并提取到所需的文件夹。
使用上方为您的门户类型提供的链接下载门户配置架构。
双击 <your_folder>\Tools\ConfigurationMigration 文件夹中的 DataMigrationUtility.exe 文件运行配置迁移工具，选择主屏幕中的导出数据，然后选择继续。
在登录屏幕上，请提供身份验证详细信息，以便从要导出数据的地方连接到您的 Dataverse 环境。如果您在要导出数据的 Dataverse 环境中有多个组织，请选中显示可用组织的列表复选框，然后选择登录。
如果您有多个组织，并在上一步中选择了显示可用的组织列表复选框，下一个屏幕将让您选择您想连接上的组织。选择要连接的 Dataverse 环境。

备注

如果没有多个组织，此屏幕不会显示。
在架构文件中，浏览并选择要用于数据导出的门户特定配置架构文件。
在保存到数据文件中，指定将导出的数据文件的名称和位置。
选择导出数据。一旦该导出完成，在此屏幕底部显示导出进度状态和导出文件的位置。
选择退出关闭工具。

导入门户配置数据

运行配置迁移工具并在主屏幕中选择导入数据，然后选择继续。
在登录屏幕上，请提供身份验证详细信息，以便从要导出数据的地方连接到您的 Dataverse 环境。如果您在要导出数据的 Dataverse 环境中有多个组织，请选中显示可用组织的列表复选框，然后选择登录。
如果您有多个组织，并在上一步中选择了显示可用的组织列表复选框，下一个屏幕将让您选择您想连接上的组织。选择要连接的 Dataverse 环境。
备注
- 如果没有多个组织，此屏幕不会显示。
- 确保已为您计划要导入配置的组织安装门户解决方案。
下一屏幕提示您提供要导入的数据文件 (.zip)。浏览数据文件，选择该文件，然后选择导入数据。
下一屏幕将显示您的导入状态记录。数据导入分多个步骤完成，首先导入基础数据，同时队列化从属数据，然后在后续步骤中导入从属数据，以处理所有数据的从属或链接。此操作可以确保导入的数据干净且一致。
选择退出关闭工具。

使用迁移的数据创建新门户

如果迁移过程正在更新现有门户，更新现在应在目标环境中可见。如果迁移是针对新门户，您现在可以使用选项使用现有网站记录中的数据为导入的网站记录创建新门户。详细信息：创建门户

租户间迁移

Power Apps 门户不支持租户间迁移。若要将门户从一个租户迁移到另一个租户，您必须执行以下步骤：

在源租户中重置您的门户。
在具有 Dataverse 或其中包含 Customer Engagement 应用的环境中预配新门户。
使用本文前面介绍的步骤迁移门户配置和自定义。

另请参见

跟踪对 Power Apps 门户配置所做的更改。
Microsoft Power Platform CLI 的门户支持。
Power Platform 环境的租户间迁移。
Dynamics 365 中模型驱动应用（如 Sales、Customer Service、Marketing、Field Service 和 Project Service Automation）的租户间迁移。

备注

您能告诉我们您的文档语言首选项吗？进行简短调查。（请注意，此调查是英文版调查）

此调查大约需要七分钟。不会收集个人数据（隐私声明）。