排查迁移管理器文件迁移问题

本文介绍如何解决使用迁移管理器进行文件共享迁移时可能会遇到的问题和错误。

• 检查先决条件和设置
• 代理错误消息
• 目标网站 URL 问题
• 常见错误消息
• 代理安装失败
• 代理已断开连接
• 任务卡在“已排队”状态
• 无法下载任务报告
• 任务报告中的迁移错误
• Google 迁移错误报告包含 HTML
• 错误代码
• 地理位置管理员无法访问迁移管理器的完整功能
• 组继承 SharePoint 管理员无法访问迁移管理器的完整功能
• 无法创建或更新网站集“XXXX”
• 扫描任务停滞在“已排队”状态

检查先决条件和设置

请确保已满足代理安装的先决条件，并已检查所需的终结点。 政府云客户应确认他们已正确设置其配置。

• 代理安装先决条件

• 所需的终结点

• 政府云设置

• 预预配 OneDrive 帐户 如果要迁移到 OneDrive 帐户，请确保在迁移之前预先预配了帐户。 你可以使用脚本，如此处所示：为组织内用户预配置 OndDrive。

代理错误消息

邮件	操作
无法安装迁移代理。 关闭设置，然后重试。	你可以使用了过期版本的代理安装程序文件来安装代理。 请参阅下面的代理安装故障，了解详细信息。
当前用户无权访问源文件共享	请确保源文件共享是网络文件共享。 确认与代理关联的 Windows 帐户对要迁移的文件共享具有读取权限。
源文件共享不存在	请确保源文件共享是现有的网络文件共享。 确认与代理关联的 Windows 帐户对要迁移的文件共享具有读取权限。

目标网站 URL 问题

邮件	建议的操作
目标网站或 Web 不存在	确认目标网站或子网站存在。 如果是 OneDrive 帐户，请确保它已预配置。
未能检查网站或 Web 是否存在。	确认目标网站或子网站存在。

常见的错误消息

邮件	建议的操作
无效的源文件夹	确认输入的路径正确，并遵循正确的格式 确认你对文件夹具有读取访问权限。
无法创建或更新网站	确保你有权创建网站，并且 URL 有效 如果网站存在，请确认你是网站集管理员 如果网站仍然失败，请手动创建网站并将迁移工具指向此新创建的网站。
扫描文件失败: 文件夹名称无效	请参阅 OneDrive 和 SharePoint 中的无效文件名和文件类型
扫描文件失败：目标路径太长	请参阅 OneDrive 和 SharePoint 中的文件名和文件类型无效 整个路径（包括文件名）对于 OneDrive 和 SharePoint，必须包含少于 400 个字符。
扫描文件失败: 磁盘空间不足，无法打包文件	可用于迁移工作文件夹的磁盘空间对于源文件大小而言太小。 增大工作文件夹的大小，然后重试。
打包失败：无法打开文件	由于源不存在，打包失败。 检查是否可以访问源根文件夹。
已创建重复任务。	用于执行批量迁移的 CSV 文件不能包含重复条目。 删除重复的行，然后重试。
未迁移父文件夹	父文件夹未迁移，因此文件夹下的所有项目都无法迁移。 检查父文件夹，然后重试迁移。

代理安装失败

问题：使用旧版本的代理安装文件安装代理时，迁移代理安装失败。

诊断/调查:

该问题可能是由过期的 clientsetup.exe 文件导致的。

补救措施:

1. 转到 SharePoint 管理中心内的迁移中心，并使用具有组织的管理员权限的帐户登录。
2. 选择“下载代理安装文件”。
3. 在要安装代理的计算机或虚拟机上运行 clientsetup.exe 文件。 按照说明完成代理安装。

问题： 迁移代理未成功安装，或者无法打开 clientsetup.exe。

示例：

诊断/调查:

如果 无法打开clientsetup.exe ：

• 以管理员身份登录 Windows，或在打开应用程序时提供管理员用户名和密码。 应已将管理员帐户添加到域中。

如果安装过程中出现错误：

• 错误消息应已包含故障原因，如果可能，请执行相应操作。
• 如果错误未建议要解决的操作，则问题可能是由临时网络故障或其他未知问题引起的。

补救措施:

如果无法打开 clientsetup.exe：

1. 以管理员身份登录 Windows。
2. 重新打开 clientsetup.exe 应用程序，或在打开应用程序时提供管理员用户名和密码。

如果安装过程中出现错误：

• 对于特定规定操作的错误，请执行相应操作，然后重新打开 clientsetup.exe。
• 对于其他非特定错误，请确保管理员帐户已添加到域。 关闭应用程序窗口，然后重试安装。

代理已断开连接

问题：代理卡在“已断开连接”状态，永远不会返回。

诊断/调查:

• 检查安装代理的计算机上的网络运行状况。
• 如果已登录租户管理员帐户的密码发生了更改，或者对租户管理员帐户应用了任何其他类似的，需要重新登录的关键更改，则所有代理均会断开连接，并且需要在所有计算机上重新安装代理。
• 如果代理无法自动升级，则版本可能太旧。 请重新安装代理。
• 令牌过期也可能导致代理断开连接。

补救措施:

• 如果出现网络问题，请进行修复。 应在修复后立即重新连接代理。
• 如果租户管理员帐户发生了需要重新登录的关键更改：请在所有计算机上重新安装代理。
• 如果这两个条件都适用，请先重新安装代理。

任务卡在“已排队”状态

问题：任务停留在“已排队”状态，并且永远不会在代理上安排运行。

诊断/调查:

• 请确保已为此租户安装代理。 已安装的代理应在“代理”列表中列出。
• 检查每个代理的状态。 状态应设置为“已启用”。
• “正在使用”状态表示代理已在处理其他任务。 无法在代理未完成当前任务的情况下为其分配更多任务。
• 如果代理被列为“已禁用”，请启用它们；
• 如果它们看上去“已断开连接”很长时间，请检查代理是否已断开连接。

补救措施:

• 如果列表中有可用的、已启用的代理中，但已经很长时间没有安排：请创建另一个相同的任务。 有时它会修复问题。

无法下载任务报告

问题：无法从任务详细信息面板上的链接下载任务报告。

• “下载任务报告”链接被禁用。
• “下载任务报告”链接显示为可用，但单击后没有任何反应

诊断/调查:

• 在任务完成前，“下载任务报告”链接将被禁用。 报告仅在任务状态变为“完成”或“失败”后可用。 因超时而失败的任务也将具有已禁用的任务报告链接。
• 如果无法为已完成的非超时任务下载任何报告，很可能是在迁移过程中出现了错误，导致向 SharePoint 上传报告的过程中断。 但是，只要报告存在，就可以在本地找到它们。

补救措施:

在完成任务的计算机上，尝试检索报告。

• 在 文件夹 %AppData%\Microsoft\SPMigration\Logs\Migration\MigrationTool[tenant_site]或 < Your-Customized-Working-Folder >\Migration\MigrationTool[tenant_site]中，按修改时间对子文件夹进行排序。 查找修改时间距任务的开始时间最近的子文件夹。 如果任务报告存在，则它们将位于此子文件夹中的“报表”文件夹中。

或

• 如果任务失败，请导航到文件夹 %AppData%\Microsoft\SPMigration\Logs，然后按修改时间对子文件夹进行排序。 查找修改时间距任务的开始时间最近的子文件夹。 错误报告位于此子文件夹中。

任务报告中的迁移错误

问题：由于多种原因导致迁移任务失败，任务报告中进行了详细说明。

诊断/调查:

• 具体的失败原因应已连同建议的解决方案一起写入报告中。

• 如果无法下载任务报告，请参阅 无法下载任务报告

补救措施:

在此处查找特定错误，以了解更多信息：错误代码。

如果收到如下错误： 提交失败未能将作业提交到服务器：提交作业时失败原因未知。0x01610002

检查代理计算机上安装的任何防病毒应用程序的设置。 将我们的两个迁移应用程序添加为例外，以使迁移通信不中断：

• microsoft.sharepoint.migration.clientservice.exe
• microsoft.sharepoint.migration.mthost.exe

Google 错误报告在报告中显示 HTML 代码

问题：为 Google 迁移生成的错误报告有时会在报表中嵌入 HTML 代码。

详细信息：

Google API 返回生成的报表中包含的 HTML 错误。 出现 Google 服务器加载错误时，可能会发生这种情况。

补救措施:

运行较少的并发事务。

状态：

这是一个已知问题。 未设置 ETA。

不支持地理位置管理员

迁移管理器当前不支持特定方案的地理位置管理员角色。 对于文件共享迁移，这些用户无法访问扫描选项卡。对于云迁移，这些用户既无法访问扫描，也无法访问迁移选项卡。

解决方法。 为地理位置用户分配 SharePoint 管理员或全局管理员角色。

1. 在管理中心，转到“用户”>“活动用户”页面。
2. 在“活动用户”页面上，选择要更改其管理员角色的用户。 在浮出控件窗格中，在“角色”下，选择“管理角色”。
3. 选择要分配给这些用户的管理员角色。 如果看不到要查找的角色，请选择列表底部的“全部显示”。

组继承 SharePoint 管理员无法访问扫描和迁移选项卡

迁移管理器不完全支持由于加入 Azure 组而创建的 SharePoint 管理员角色。 对于文件共享迁移，这些用户无法访问扫描选项卡。对于云迁移，这些用户既无法访问扫描，也无法访问迁移选项卡。

解决方法。 在解决此问题之前，为用户分配 SharePoint 管理员或全局管理员角色。

1. 在管理中心，转到“用户”>“活动用户”页面。
2. 在“活动用户”页面上，选择要更改其管理员角色的用户。 在浮出控件窗格中，在“角色”下，选择“管理角色”。
3. 选择要分配给这些用户的管理员角色。 如果看不到要查找的角色，请选择列表底部的“全部显示”。

无法创建或更新网站集“XXXX”

引用的用户主体名称 (UPN) 无效。 若要创建或更新 OneDrive 网站集，Microsoft Entra ID 必须包含引用的 UPN。 检查目标 URL 并验证用户是否存在Microsoft Entra ID。

扫描任务停滞在“已排队”状态

问题：文件共享扫描的状态保持为“已排队”，永远不会在代理上计划运行。

诊断/调查

• 检查“代理组”列是否有扫描任务。 只能计划 默认 代理组中的代理。

补救措施

• 如果 默认 代理组中没有代理，请将现有代理组更改为 “默认”。 任何已停滞的扫描任务现在都应移出此状态。

错误代码

错误代码	建议的操作
0x00000000	意外的错误。
0x01110001	未知原因。
0x0111000B	路径太长。
0x0111000F	未迁移父文件夹。 检查失败报告来决定文件，然后重试。
0x01110003	无法访问源文件夹。
0x01110009	无法检索文件元数据。
0x01110010	文件名中存在无效字符。 检查报表中文件名是否为 <>：“？*/，
0x01110011	不支持项“创建时间”或“修改时间”。
0x0201000D	检查列表是否存在，或能否在源网站和目标网站中访问列表。
0x02050008	无法访问本地存储。 请重启迁移。
0x02010023	不支持源列表模板。 添加其他模板。
0x0201000C	先检查凭据，再重新输入用户名和密码。
0x02010017	必须是网站集管理员。
0x02060009	1 - 无法创建网站集，因为 URL 已在使用中或 URL 无效。
	2 - 无法创建网站集，因为 URL 包含无效字符。
	3 - 无法创建或更新网站集。
0x02060007	1 - 无法创建网站集，因为 URL 已在使用中或 URL 无效。
	2 - 无法创建网站集，因为 URL 包含无效字符。
0x02010018	1 - 先检查凭据，再重试。
	2 - 访问 SharePoint 时出现问题。 请先检查凭据，再重试。
	3 - 无法访问 SharePoint。 请先检查凭据和网络连接，再重试。
	4 - 无法访问 SharePoint。 请先检查凭据和网站 URL 是否正确，再重试。
	5 - 无法访问 SharePoint。 请先检查凭据和 URL 格式， 再重试。
	6 - 无法访问 SharePoint。 请先检查凭据，再重试。 如果此问题一再出现，请创建支持案例。
	7 - 无法访问 SharePoint。 请检查凭据，并尝试在浏览器中打开网站。
0x0204000A	无法创建包文件。 必须关闭迁移管理器工作文件夹 %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorage 中的所有文件和文件夹。 请重启迁移。
0x02030001	1 - 检查凭据， 并重启迁移。
	2 - 检查凭据， 并重启迁移。
	3 - 检查凭据和网络连接， 并重启迁移。
	4 - 检查凭据和网站 URL， 并重启迁移。
	5 - 检查凭据和 URL 格式， 并重启迁移。
	6 - 检查凭据，并重启迁移。 如果此问题一再出现，请创建支持案例。
	7 - 检查凭据，尝试在浏览器中打开网站， 并重启迁移。
0x02010008	确认用户映射文件的路径和格式是否正确，以及你是否有权访问此文件。
0x02050001	必须关闭迁移管理器工作文件夹 %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorage 中的所有文件和文件夹。 请重启迁移。
0x02010002	检查网络状态。 如果可以在浏览器中访问源网站，请创建支持案例。
0x02010010	确保源列表和目标列表的模板相同。
0x0204000D	在迁移过程中必须关闭迁移管理器工作文件夹 %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorage 中的所有文件和文件夹。 请重启迁移。
0x02040012	本地计算机上的临时存储空间太小。 迁移管理器会缓存工作文件夹中的包。 请扩展临时存储空间，然后重试。
0x02030003	具有唯一权限的项过多。 通过减少唯一权限的数目来简化权限列表。 请重试迁移。
0x02050001	本地存储文件已损坏。 迁移过程中触碰或修改过工作文件夹。 请重试迁移。
0x02080001	包中的文件在上传时已更改或遭删除。 必须关闭迁移管理器工作文件夹 %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorage 中的所有文件和文件夹。 请重启迁移。
0x02040009	无法创建包，因为找不到目录。 必须关闭迁移管理器工作文件夹 %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorage 中的所有文件和文件夹。 请重启迁移。
0x02010020	在迁移管理器设置中禁用迁移版本历史记录，或在 SPO 中启用版本控制。
0x0201000E	检查全局设置是否已筛选掉目标路径中的特殊字符，或路径中是否包含不受支持的字符。
0X0201000F	网站 URL 无效。 检查网站 URL 是否有效。 尝试通过浏览器访问 URL。 如果这是 OneDrive 账户，确保迁移前已预配置。
0x0207001	你无权访问任务文件夹。 检查是否可以访问 %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorage。
0x01410010	由于列表项上缺少依赖项而失败。 有关详细信息，请查看 FailureSummaryReport.csv。 检查迁移范围是否已包含依赖项。
0x01510001	无法上传程序包。 如果已自定义 Azure 存储，请检查是否可以访问 Azure 存储，并检查是否可以访问目标网站。 再次尝试迁移。
0x01510001	无法将作业上传到服务器：迁移期间的文件上传失败。
0x02070009	无法上传多个程序包。 暂停任务并检查你的网络连接。
0x01710009	由于作业结束失败而失败；程序包中的某些项目失败。 重新开始迁移。
0x01710009	服务器处理文件时出现错误或超时：包中的部分项目尚未迁移。
0x01610001	Azure 容器已过期。 重试迁移任务。
0x01710006	服务器处理文件时出现错误或超时：作业严重错误。
0x01710004	服务器处理文件时出现错误或超时。 查找文件夹名称失败。 该项目可能存在于同一网站集中的其他列表或网站中。 或项目在回收站中。
0x0131000F	无法读取文件。 文件已签出。