迁移评估扫描:长 OneDrive URL

了解如何解决迁移期间 OneDrive URL 较长的问题。

概述

将 OneDrive 网站从源环境移动到目标环境时,OneDrive URL 会更改格式。 在源平台上,OneDrive 网站的格式 https://onedrive.contoso.com/personal/domain_user为 。 在目标平台上,URL 的Domain_User部分将更改为使用用户的 UPN。 这类似于 https://onedrive.contoso.com/personal/user_contoso_com

示例:

如果使用此文件:

https://OneDrive.contoto.com/personal/contoso_bobsmith/Documents/Folder1/Folder2/ProjectA.docx

文件的目录名称为:

Personal/contoso_bobsmith/Documents/Folder1/Folder2

注意

指向 SharePoint 文件的目录路径限制为 400 个字符。

迁移后的文件路径如下所示。

Personal/bobsmith_contoso_com/Documents/Folder1/Folder2

请注意,URL 现在比以前长了四个字符。 根据贵公司 UPN 的构成方式,长度变化可能更明显。

如果源环境中的上一个文件是 255 个字符,则迁移后的长度是 259 个字符。

我们确定了四个不同的位置,其中可能会由于 URL 较长而发生故障。 因此,我们有四个有关长 URL 的不同报告。 扫描结果报告部分涵盖每个报表,并列出需进行的修正。

数据迁移

导致 URL 较长的源内容的迁移失败。 这会导致迁移作业失败,这会不必要地延长迁移项目。

重要

[!重要说明] 系统将跳过 SharePoint 中配置为"无访问"(已锁定)的任何网站。 若要查看锁定网站集的列表,请参阅锁定网站扫描输出。

准备迁移

查看报表,并按照针对各报表推荐的补救措施操作。 修正通常涉及到将内容移到距离网站集的根更近的位置。

迁移后

验证内容是否已迁移。

扫描结果报告

此扫描将生成四个输出文件。 每个文件针对一个会导致迁移失败的特定的 URL 较长问题。 LongODBUrl-AllDocs-detail.csv 对于指向给定文件的路径的长度,具有两个限制:

  • 包含文件的文件夹的服务器相对路径最多包含 400 个字符。 使用下面的示例文件:

    https://OneDrive.contoto.com/Personal/contoso_bobsmith/Documents/Folder1/Folder2/ProjectA.docx

    目录名称将如下所示:Personal/contoso_bobsmith/Documents/Folder1/Folder2

    迁移后的文件路径如下所示。 请注意,现在的 URL 比以前长:Personal/bobsmith_contoso_com/Documents/Folder1/Folder2

  • 文件或文件夹的服务器相对路径总共最多 400 个字符。 使用下面的示例文件:

    https://OneDrive.contoto.com/Personal/contoso_bobsmith/Documents/Folder1/Folder2/ProjectA.docx

    文件的服务器相对路径如下所示:Personal/contoso_bobsmith/Documents/Folder1/Folder2/ProjectA.docx

如果此报表中列出了文件,则所有者需要将文件移动到较短的路径或删除文件。 例如,他们可以将 ProjectA.docx 直接移动到“文档”下的文件夹,或者如果不再需要该文件,也可以删除该文件。

说明
SiteId 受影响网站集的唯一标识符。
SiteURL 受影响网站集的 URL。
SiteOwner 网站集所有者。
SiteAdmins 列为网站集管理员的人员列表。
SiteSizeInMB 网站集大小(以 MB 为单位)
NumOfWebs 网站集中存在的 Web 数。
ContentDBName 托管网站集的内容数据库的名称。
ContentDBServerName 托管内容数据库的 SQL Server。
ContentDBSizeInMB 托管网站集的内容数据库的大小。
LastContentModifiedDate 网站集修改了内容的日期/时间。
TotalItemCount 在网站集中找到的项目总数。
提示 为网站集记录的请求数。 取决于使用情况日志记录服务中的数据。 如果禁用使用情况日志记录服务,则此行将显示“不适用”。
DistinctUsers 已访问网站集的不同用户数。 取决于使用情况日志记录服务中的数据。 如果禁用使用情况日志记录服务,则此行将显示“不适用”。
DaysOfUsageData 使用情况日志记录服务保留数据的天数。 它为 Hits 和 DistinctUser 提供上下文。 例如,如果此列为 14 天,则 Hits 和 DistinctUsers 列为过去 14 天的数据。
UPN UPN that was used to determine the difference in the URL length. 如果 UPN 为“****”,则指示所有者在其 SharePoint 配置文件中未设置 UserPrincipalName。 As a result, the average length of the UserPrincipalName values in the SharePoint profile store was used.
URLLengthDifference 重命名网站时 URL 增长的量。
文件 需要修正的文件。
ScanID 分配给 SharePoint 迁移评估工具特定执行的唯一标识符。

LongODBUrl-NavNodes-detail.csv 导航节点具有 260 个字符的 URL 长度限制。 这会导致 URL 字段超出最大长度。

例如,具有位于 https://OneDrive.contoso.com/personal/contoso_bobsmith 的 OneDrive 网站。 该网站在快速启动中具有名为"报表"的链接和指向 https://onedrive.contoso.com/personal/contoso_bobsmith/documents/folder1/...folderN/Reports 的链接 URL。 在迁移过程中,SharePoint 将 URL 更新为指向 /bobsmith_contoso_com/。 添加到 URL 的额外长度可能会导致长度超过 260 个字符,这将导致迁移失败。

若要解决此问题,请将报表文件夹移到距离 /文档/库的根更近的位置,然后更新快速启动链接。 还可删除快速启动链接。

说明
SiteId 受影响网站集的唯一标识符。
SiteURL 受影响网站集的 URL。
SiteOwner 网站集所有者。
SiteAdmins 列为网站集管理员的人员列表。
SiteSizeInMB 网站集大小(以 MB 为单位)
NumOfWebs 网站集中存在的 Web 数。
ContentDBName 托管网站集的内容数据库的名称。
ContentDBServerName 托管内容数据库的 SQL Server。
ContentDBSizeInMB 托管网站集的内容数据库的大小。
UPN UPN that was used to determine the difference in the URL length. 如果 UPN 为“****”,则指示所有者在其 SharePoint 配置文件中未设置 UserPrincipalName。 As a result, the average length of the UserPrincipalName in the SharePoint profile store was used.
URLLengthDifference URLLengthDifference 网站重命名时 URL 增长的量。
WebURL 指向具有导航节点的 Web 的 URL。
NavigationNodeLocation 导航节点标题,显示导航节点所在的位置。 可具有多个级别的导航节点,这有助于找到有问题的节点。
NavigationNodeTitle 受影响的导航节点的标题。
NavigationNodeURL 网站重命名后太长的 URL。
ScanID 分配给 SharePoint 迁移评估工具特定执行的唯一标识符。

LongODBUrl-Perms-detail.csv 在 SharePoint 中某对象上设置的权限由该对象的 URL 进行跟踪。 如果对文件夹设置权限,SharePoint 将存储该文件夹的相对路径。 如果对项目设置权限,SharePoint 将存储该项的服务器相对路径。

因此,将在网站迁移过程中更新与权限关联的 URL。 如果新的 URL 太长,可能导致失败。

该问题的修正方法是将受影响的对象移到距离网站集的根更近的位置。 还可从报表中的各项目中删除不同权限。

说明
SiteId 受影响网站集的唯一标识符。
SiteURL 受影响网站集的 URL。
SiteOwner 网站集所有者。
SiteAdmins 列为网站集管理员的人员列表。
SiteSizeInMB 网站集大小(以 MB 为单位)
NumOfWebs 网站集中存在的 Web 数。
ContentDBName 托管网站集的内容数据库的名称。
ContentDBServerName 托管内容数据库的 SQL Server。
ContentDBSizeInMB 托管网站集的内容数据库的大小。
UPN UPN UserPrincipalName that was used to determine the difference in the URL length. 如果 UPN 为“****”,则指示所有者在其 SharePoint 配置文件中未设置 UserPrincipalName。 As a result, the average length of the UserPrincipalName in the SharePoint profile store was used.
URLLengthDifference 重命名该网站后,URL 增加的长度。
WebURL 托管受保护对象的 Web 的 URL。
SecuredObject 这是受保护对象的 URL,重命名网站后该 URL 太长。 如果向文件添加权限,则为指向该文件的服务器相对路径。 如果设置文件夹的权限,则为指向该文件夹的服务器相对路径。
ScanID 分配给 SharePoint 迁移评估工具特定执行的唯一标识符。

LongODBUrl-Deps-detail.csv 某些文件可以具有其他依赖项。 这些依赖项由 URL 跟踪。 在迁移期间,如果依赖项信息太长,迁移将失败。

本报告中有两处需注意的限制:

  • FullURL 具有 260 个字符的限制。 这是包含依赖项的文件。 如果 FullURL 太长,则进行修正,删除文件或将文件移到距离网站集的根更近的位置。

  • DependencyDescription 具有 270 个字符的限制。 这是与 FullURL 关联的依赖项。 为修正 DependencyDescription,可删除依赖项或将依赖项移到距离网站集的根更近的位置。

说明
SiteId 受影响网站集的唯一标识符。
SiteURL 受影响网站集的 URL。
SiteOwner 网站集所有者。
SiteAdmins 列为网站集管理员的人员列表。
SiteSizeInMB 网站集大小(以 MB 为单位)
NumOfWebs 网站集中存在的 Web 数。
ContentDBName 托管网站集的内容数据库的名称。
ContentDBServerName 托管内容数据库的 SQL Server。
ContentDBSizeInMB 托管网站集的内容数据库的大小。
UPN UPN that was used to determine the difference in the URL length. 如果 UPN 为“****”,则表示所有者在其 SharePoint 配置文件中未设置 UserPrincipalName。 As a result, the average length of the UserPrincipalName in the SharePoint profile store was used.
URLLengthDifference 重命名该网站后,URL 增加的长度。
FullURL 指向具有依赖项的文件的 URL
DependencyDescription 与依赖项关联的 DependencyDescription 说明。 这可能是要重命名的 URL。
ScanID 分配给 SharePoint 迁移评估工具特定执行的唯一标识符。