使用迁移管理器迁移文件共享时，首先需要设置一个或多个迁移代理。 可以选择配置) ，可在每台计算机或 VM (虚拟机上运行代理安装程序文件。 还可以通过将特定迁移分配给一组特定的代理，或者根据地理位置在组中分离代理来优化性能，从而对代理进行分组。
运行安装文件时，系统会提示输入两组凭据。 你需要 SharePoint 管理员凭据（具体取决于目标），以及具有源 读取 访问权限的 Windows 凭据。 这些 Windows 凭据必须对你计划迁移的所有文件共享具有 读取 访问权限。 这对凭据建立了与迁移管理器之间的信任。 迁移管理器现在将其视为一个可用的“代理”，可以自动向其分发迁移任务。
配置代理后，有权访问 SharePoint 管理中心 的任何人都可以创建任务。 任务会自动分发到其中一个可用的已配置代理。
重要
请确保下载最新版本的代理安装程序文件。 密码不存储在安装程序中。
计划清单
| 类别 | 指南 |
|---|---|
| 确定所需的代理数。 | 要创建的代理数。 |
| 拥有正确的使用凭证 | 用于迁移目标的 SharePoint 或 OneDrive 管理员，以及有权访问计划迁移的所有网络文件共享的源本地帐户。 确认你拥有 SharePoint 或 OneDrive 管理员凭据，以访问要迁移内容的“目标”。 验证计划用于配置代理的本地凭据是否有权访问计划迁移的所有网络文件共享。 |
| 要使用的虚拟机或计算机。 | 确定你计划用于迁移任务的虚拟机或计算机数量。 在启动之前列出计算机或虚拟机。 |
| 系统要求。 | 请确保计算机满足要求。 验证先决条件 |
| 端点。 | 请确保已配置所需的终结点。 检查所需的终结点 |
| 多地理位置租户。 | 如果有多地理位置租户，请务必了解代理的安装位置。 多地理位置租户。 |
| 预配置 OneDrive 账户 | 如果要迁移到 OneDrive 帐户，请确保在迁移之前预先预配了帐户。 可以通过使用这里所描述的脚本来进行预配置，如此处所示：为组织内用户预配置 OndDrive。 |
| 政府云 | 如果你的租户驻留在政府云中，则在使用迁移管理器之前，你可能还需要执行额外的步骤。 |
提示
创建一个具有管理权限的服务帐户，以便代理在服务器或 VM 上运行。 此帐户应具有对计划迁移的源的 读取 访问权限，并且 SharePoint 或 OneDrive 管理员有权访问专门针对迁移项目的目标。 在运行安装文件之前，使用此帐户登录到每个 VM 或计算机，以确保代理作为服务安装。
注意
目前不支持第三方多重身份验证。
代理和性能注意事项
在迁移中实现最佳性能的一个因素是使用在时间范围内完成迁移所需的最少数量的代理。 使用超过所需代理会增加上传报表时的限制率。
示例：如果在所需的时间段内可以使用 10 个代理以可接受的速度完成迁移，请不要使用 20 个代理。 使用更多代理意味着更高的流量和更高的 API 请求速率。
确定所需的代理数
若要计算用于迁移的最小所需代理数，请执行以下作：
- 使用一个代理运行包含 20 到 30 个任务的测试迁移，以测试每个代理的吞吐量。 记录时间。
- 估计整个迁移的任务数。 取处理一个测试代理所花费的时间长度，并计算迁移的代理数。 将完成迁移项目的总时间考虑在内。
- 如果创建的代理数超过所需，可以通过在迁移管理器中选择代理来禁用它们。
设置代理
- 登录到你选择使用对计划迁移的所有文件共享具有 读取 访问权限的凭据设置代理的计算机或 VM。
- 在 SharePoint 管理中心，选择“ 迁移中心”。 您需要使用对组织具有 SharePoint 管理员权限 的帐户登录。
- 在"对于文件共享"， "开始。
- 选择" 代理 选项卡，然后选择 代理。
- 选择“下载代理安装文件”。 (若要获取最新的 bug 修复、功能改进或新功能，请在“新增功能”) 中找到最新的公共预览版下载链接
- 打开安装文件。 在“欢迎”页上，选择身份验证方法，选择“ 下一步”。
- 如果选择“ 用户凭据身份验证”，请输入要迁移内容的环境的 SharePoint 管理员用户名和密码。 选择 下一步。 如果选择“ 证书身份验证”，请上传证书身份验证配置文件。 选择“下一步”。
- 输入 Windows 帐户的密码，该帐户提供对包含要迁移的内容 的所有 文件共享的访问权限。 选择“安装”。
- 测试代理访问权限（可选）或选择 关闭。 安装完成后，新代理将添加到可分配任务的可用代理中。
注意
多个代理：如果你有一个大型迁移项目，并且需要设置多个代理，我们建议将代理安装文件下载到共享位置。 这样，即可在每台计算机或 VM 上轻松下载安装程序文件。 多个代理允许你根据需要将某些迁移作业批处理到特定组。 例如，可以按数据中心对代理进行分组，以便根据地理位置实现更好的性能。 了解详细信息。
工作文件夹
将为每个代理创建一个名为 %appdata%\Microsoft\SPMigration 的工作文件夹。 保存日志、报告和任何临时文件夹都将保存在这个文件夹。 请确保工作文件夹拥有至少 150 GB 的可用空间。 它可能需要更多，具体取决于计划迁移的数据大小。
使用自定义 Azure 存储
默认情况下，SharePoint 提供的Azure Blob 存储容器在迁移过程中用作内容和清单的临时存储。 还可以在代理配置文件中指定自己的Azure存储。 首先，在租户中创建Azure Blob 存储。 记下存储名称和存储密钥。 然后在安装代理的主机上，在 Windows 凭据管理器中添加访问凭据。
- 打开凭据管理器并导航到“通用凭据”部分
- 选择“添加通用凭据”
Internet 或网络地址：输入名称 (，例如“MyAzureStorage”)
用户名：输入Azure存储名称
密码：输入Azure存储密钥
准备 JSON 配置文件，包括“CostomizedAzureStorage”定义。 将“UseCustomAzureStorage”设置为 true，将“AzureStorageCredentialTargetName”设置为凭据管理器中创建的凭据。
{
"CustomizedAzureStorage”:
{
"UseCustomAzureStorage": true,
"AzureStorageCredentialTargetName": "MyAzureStorage"
}
}
在代理安装期间，选择包含自定义Azure存储设置的配置文件。 安装程序验证对配置文件中定义的Azure存储的访问权限。 如果成功，将显示“已成功验证Azure存储凭据配置”。 如果失败，将显示一条错误消息。
设置多地理位置代理
如果你有多地理位置 SharePoint 租户，则代理安装在 SharePoint 管理中心设置的 地理位置 中。 在安装代理之前，请确认所需的地理位置是在管理中心设置的。 如果需要更改代理的地域位置，请删除并重新安装代理。
了解详细信息： OneDrive 和 Microsoft 365 中的多地理位置功能
要安装代理到不同的地理位置：
下载代理安装文件。
启动安装程序文件并保留在 “欢迎”页上。
打开此文件： %temp%\SPMigrationAgentSetup\SPMigrationAgentSetup\Microsoft.SharePoint.Migration.ClientShared.dll.config
在 appSettings 下，为所需的国家/地区或数据中心添加一个条目，如以下示例所示。 (注意：下面是加拿大的示例。)
<add key="GeoLocation" value="CAN" />可在此处找到国家或地区 GEO 代码 ，Microsoft 365 多地理位置可用性。
重要
迁移到 Teams：如果要迁移到 Teams，目标 Teams 站点必须与租户管理员位于同一 GEO 中。如果它们不同，则当你选择目标时，Teams 频道不会加载。
将代理安装为应用
如果在安装代理时系统检测到你未加入域，则可以将代理安装为 Windows 应用。 如果仍希望将其安装为服务，请退出并使用已加入域的帐户登录。
重要
如果将代理安装为应用，则计算机处于睡眠状态时不会运行代理，从而有效地暂停迁移。
- 选择“安装为应用”。
- 安装代理后，使用 SharePoint 管理员凭据登录。
- 测试代理是否有权访问要迁移的文件共享（可选）。
- “设置”屏幕显示你是否和连接到了哪个租户。 如果要登录到其他租户，请选择“取消链接租户”。
- 只要迁移代理处于活动状态，Microsoft 365 会自动续订访问租户的授权。 如果代理处于非活动状态超过 7 天，则可能需要再次登录。
代理任务分配
迁移管理器会自动将任务分配给可用的代理。 无法手动将任务分配给特定代理。 每个代理最多可在其队列中有 10 个任务。 但是，可以将任务分配给代理组。
暂停任务不会将代理释放到另一个任务。 在任务恢复和完成或者任务被删除之前，代理仍无法接受新的任务。
连接保持活动状态多长时间？
只要计算机仍在运行，并且用于登录代理的 SharePoint 管理员凭据仍然有效，代理（作为服务）与迁移管理器之间的连接就会保持活动状态。
如果代理断开连接，它将令牌保留到迁移管理器长达 7 天。 在此时间之后，需要重新安装代理。