迁移评估扫描:长 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 文件的目录路径限制为 256 个字符。

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

Personal/bobsmith_contoso_com/Documents/Folder1/Folder2

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

如果源环境中的上一个文件是 255 个字符,迁移后的长度是 259 个字符,超出数据库支持的限制。这会导致内容迁移失败。

我们已确定由于 URL 较长而可能发生失败的 4 个不同位置。因此,提供 4 个有关长 URL 的不同报表。扫描结果报告部分涵盖每个报表,并列出需进行的修正。

数据迁移

导致出现长 URL 的源内容迁移将失败。这会导致迁移作业失败,从而不必要地推延迁移项目。

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

准备迁移

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

迁移后

验证内容是否已迁移。

扫描结果报告

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

  • 对于指向包含该文件的文件夹的服务器相对路径,字符不可超过 256 个。使用下面的示例文件:

    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

  • 对于指向文件或文件夹的服务器相对路径,字符总数不可超过 260 个。使用下面的示例文件:

    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

在网站集中找到的项目总数。

Hits

为网站集记录的请求数。取决于使用情况日志记录服务中的数据。如果禁用使用情况日志记录服务,此行将显示 N/A。

DistinctUsers

已访问网站集的不同用户数。取决于使用情况日志记录服务中的数据。如果禁用使用情况日志记录服务,此行将显示 N/A。

DaysOfUsageData

使用情况日志记录服务保留数据的天数。它为 Hits 和 DistinctUser 提供上下文。例如,如果此列为 14 天,则 Hits 和 DistinctUsers 列为过去 14 天的数据。

UPN

用于确定 URL 长度之差的 UPN。如果 UPN是“***”,表示所有者未在 SharePoint 配置文件中设置 UserPrincipalName。因此,使用 SharePoint 配置文件存储中各 UserPrincipalName 值的平均长度。

URLLengthDifference

重命名该网站后,URL 增加的长度。

File

需要修正的文件。

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 更新为指向 /bobsmith_contoso_com/ 的 URL。添加到 URL 中的其他长度可能导致长度超过 260 个字符,进而导致迁移失败。

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

说明

SiteId

受影响网站集的唯一标识符。

SiteURL

受影响网站集的 URL。

SiteOwner

网站集所有者。

SiteAdmins

列为网站集管理员的人员列表。

SiteSizeInMB

网站集大小(以 MB 为单位)

NumOfWebs

网站集中存在的 Web 数。

ContentDBName

托管网站集的内容数据库的名称。

ContentDBServerName

托管内容数据库的 SQL Server。

ContentDBSizeInMB

托管网站集的内容数据库的大小。

UPN

用于确定 URL 长度之差的 UPN。如果 UPN是“***”,表示所有者未在 SharePoint 配置文件中设置 UserPrincipalName。因此,使用 SharePoint 配置文件存储中 UserPrincipalName 的平均长度。

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

用于确定 URL 长度之差的 UPN UserPrincipalName。如果 UPN是“***”,表示所有者未在 SharePoint 配置文件中设置 UserPrincipalName。因此,使用 SharePoint 配置文件存储中 UserPrincipalName 的平均长度。

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

用于确定 URL 长度之差的 UPN。如果 UPN是“***”,表示所有者未在 SharePoint 配置文件中设置 UserPrincipalName。因此,使用 SharePoint 配置文件存储中 UserPrincipalName 的平均长度。

URLLengthDifference

重命名该网站后,URL 增加的长度。

FullURL

指向具有依赖项的文件的 URL

DependencyDescription

与依赖项关联的 DependencyDescription 说明。这可能是要重命名的 URL。

ScanID

分配给 SharePoint 迁移评估工具特定执行的唯一标识符。

扩展你的技能
了解培训
抢先获得新功能
加入 Office 预览体验计划

此信息是否有帮助?

谢谢您的反馈!

谢谢你的反馈! 可能需要转接到 Office 支持专员。

×