步骤 1: 设置迁移管理器代理

项目
10/12/2023

使用迁移管理器迁移文件共享时，首先需要设置一个或多个迁移代理。这可以通过在选择配置的每台计算机或 VM 上运行安装程序文件来完成。还可以通过将特定迁移分配给一组特定的代理，或者根据地理位置在组中分离代理来优化性能，从而对代理进行分组。

运行安装文件时，系统将提示你输入两组凭据。你需要全局或 SharePoint 管理员凭据（具体取决于目标），以及具有源读取访问权限的 Windows 凭据。这些 Windows 凭据必须对你计划迁移的所有文件共享具有读取访问权限。这对凭据建立了与迁移管理器之间的信任。迁移管理器现在将其视为一个可用的“代理”，可以自动向其分发迁移任务。

配置代理后，有权访问 SharePoint 管理中心的任何人都可以创建任务。任务会自动分发到其中一个可用的已配置代理。

重要

请确保下载最新版本的代理安装程序文件。密码未存储在安装程序中。

计划清单

类别	指南
确定所需的代理数	要创建的代理数
拥有正确的使用凭证	用于迁移目标的 SharePoint 或 OneDrive 管理员，以及有权访问计划迁移的所有网络文件共享的源本地帐户。确认你拥有 SharePoint 或 OneDrive 管理员凭据来访问要迁移内容的“目标”。验证计划用于配置代理的本地凭据是否有权访问计划迁移的所有网络文件共享。
要使用的虚拟机或计算机：	确定你计划用于迁移任务的虚拟机或计算机数量。在启动之前列出计算机或虚拟机。
验证先决条件	请确保计算机满足要求。
检查所需的终结点	验证是否已配置所需的终结点。
多地理位置租户	如果有多地理位置租户，请务必了解代理的安装位置。
预配置 OneDrive 账户	如果你正在迁移到 OneDrive 账户，确保迁移前预配置账户。必须向迁移帐户授予每个 OneDrive 网站的网站集管理员权限。可以通过使用这里所描述的脚本来进行预配置，如此处所示：为组织内用户预配置 OndDrive。
政府云	如果租户驻留在政府云中，在使用迁移管理器之前，可能需要执行额外的步骤。

提示

创建一个具有管理权限的服务帐户，以便代理在服务器或 VM 上运行。此帐户应具有对计划迁移的源的读取访问权限，以及 SharePoint 或 OneDrive 管理员对迁移项目目标的访问权限。在运行安装程序文件之前，使用此帐户登录到每个 VM 或计算机，以确保代理作为服务进行安装。

注意

目前不支持第三方多重身份验证。

代理和性能注意事项

在迁移中实现最佳性能的一个因素是使用在时间范围内完成迁移所需的最少数量的代理。使用超过所需代理会增加上传报表时的限制率。

示例：如果在所需的时间段内可以使用 10 个代理以可接受的速度完成迁移，请不要使用 20 个代理。使用更多代理意味着更高的流量和更高的 API 请求速率。

确定所需的代理数

若要计算用于迁移的最小所需代理数，请执行以下操作：

使用一个代理运行包含 20 到 30 个任务的测试迁移，以测试每个代理的吞吐量。记录时间。
估计整个迁移的任务数。取处理一个测试代理所花费的时间长度，并计算迁移的代理数。将完成迁移项目的总时间考虑在内。
如果已创建的代理数超过所需，则可以通过在迁移管理器中选择代理来禁用它们。

设置代理

使用对计划迁移的所有文件共享具有读取访问权限的凭据登录到你选择设置代理的计算机或 VM。
在 SharePoint 管理中心，选择“ 迁移中心”。您需要使用对组织具有 SharePoint 管理员权限的帐户登录。
在"对于文件共享"， "开始。
选择" 代理选项卡，然后选择代理。
选择“下载代理安装文件”。 (还可以下载代理 v2.0 版本，目前为公共预览版。有关更多详细信息和下载链接，检查“新增功能”页面)
打开安装文件。在“欢迎”页上，选择“下一步”。
输入要迁移内容的环境的 SharePoint 管理员用户名和密码。选择“下一步”。
输入 Windows 帐户的密码，该帐户提供对包含要迁移的内容 的所有 文件共享的访问权限。选择“安装”。
测试代理访问权限（可选）或选择关闭。完成设置后，新代理将被添加到可分配任务的可用代理。

注意

多个代理：如果你有一个大型迁移项目，并且需要设置多个代理，我们建议将代理安装文件下载到共享位置。这样，即可在每台计算机或 VM 上轻松下载安装程序文件。多个代理允许你根据需要将某些迁移作业批处理到特定组。例如，可以按数据中心对代理进行分组，以便根据地理位置实现更好的性能。

示例：你要将 10,000 个用户从两个数据中心的本地共享迁移到 OneDrive。 2,000 个用户的数据存储在加州数据中心，8,000 个用户的数据存储在佛蒙特州数据中心。你在加州数据中心安装了两个代理，在佛蒙特州数据中心安装了六个代理。通过按地理位置对代理进行分组，可以将源数据位于加州的批量迁移到加州代理组，将佛蒙特州数据批量迁移到佛蒙特州代理组。地理分组可提供性能优势。如果没有地理分组，所有数据中心都将位于默认组中，你将无法控制使用哪些代理。这可能会导致加州代理迁移佛蒙特州数据，而佛蒙特州代理迁移加州数据。虽然这在技术上迁移文件，但性能可能会受到影响。

工作文件夹

将为每个代理创建一个名为 %appdata%\Microsoft\SPMigration 的工作文件夹。保存日志、报告和任何临时文件夹都将保存在这个文件夹。请确保工作文件夹拥有至少 150 GB 的可用空间。它可能需要更多，具体取决于计划迁移的数据大小。

设置多地理位置代理

如果你有多地理位置 SharePoint 租户，则代理安装在 SharePoint 管理中心设置的地理位置中。在安装代理之前，请确认所需的地理位置是在管理中心设置的。如果需要更改代理的地域位置，请删除并重新安装代理。

有关详细信息，请参阅 OneDrive 和 SharePoint Online 的 Multi-Geo 功能。

要安装代理到不同的地理位置：

下载代理安装文件。
启动安装程序文件并保留在 “欢迎”页上。
打开此文件： %temp%\SPMigrationAgentSetup\SPMigrationAgentSetup\Microsoft.SharePoint.Migration.ClientShared.dll.config
在 appSettings 下，为所需的国家/地区或数据中心添加一个条目，如以下示例所示。（注意：此为加拿大的一个示例。）
```
<add key="GeoLocation" value="CAN" />
```
可在 Microsoft 365 多地理位置可用性中找到国家或地区 GEO 代码。

重要

迁移到 Teams：如果要迁移到 Teams，目标 Teams 站点必须与租户管理员位于同一 GEO 中。如果它们不同，则当你选择目标时，Teams 频道将不会加载。

将代理安装为应用

如果在安装代理时系统检测到你未加入域，则可以将代理安装为 Windows 应用。如果仍希望将其安装为服务，请退出并使用已加入域的帐户登录。

重要

如果将代理安装为应用，则在计算机处于睡眠状态时它不会运行，从而有效地暂停迁移。

选择“安装为应用”。
安装代理后，使用 SharePoint 管理员凭据登录。
测试代理是否有权访问要迁移的文件共享（可选）。
“设置”屏幕显示你是否和连接到了哪个租户。如果要登录到其他租户，请选择“取消链接租户”。
只要迁移代理处于活动状态，Microsoft 365 会自动续订访问租户的授权。如果代理处于非活动状态超过 7 天，则可能需要再次登录。

代理任务分配

迁移管理器会自动将任务分配给可用的代理。无法手动将任务分配给特定代理。每个代理最多可在其队列中有 10 个任务。但是，可以将任务分配给代理组。

暂停任务不会将代理释放到另一个任务。在任务恢复和完成或者任务被删除之前，代理仍无法接受新的任务。

连接保持活动状态多长时间？

只要计算机仍在运行，并且用于登录代理的 SharePoint 管理员凭据仍然有效，代理（作为服务）与迁移管理器之间的连接就会保持活动状态。

如果代理断开连接，它将令牌保留到迁移管理器长达 7 天。在那之后，将需要重新安装代理。