了解如何解决迁移期间 OneDrive URL 较长的问题。
概述
将 OneDrive 网站从源环境移动到目标环境时,OneDrive URL 会更改格式。 在源平台上,OneDrive 网站的格式 https://onedrive.contoso.com/personal/domain_user为 。 在目标平台上,URL 的Domain_User部分将更改为使用用户的 UPN。 此 URL 类似于 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 为单位 (MB) )。 |
| NumOfWebs | 网站集中存在的 Web 数。 |
| ContentDBName | 托管网站集的内容数据库的名称。 |
| ContentDBServerName | 托管内容数据库的 SQL Server。 |
| ContentDBSizeInMB | 托管网站集的内容数据库的大小。 |
| LastContentModifiedDate | 网站集修改了内容的日期/时间。 |
| TotalItemCount | 在网站集中找到的项目总数。 |
| 提示 | 为网站集记录的请求数。 取决于使用情况日志记录服务中的数据。 如果禁用使用情况日志记录服务,则此行显示不适用。 |
| DistinctUsers | 访问网站集的不同用户数。 取决于使用情况日志记录服务中的数据。 如果禁用使用情况日志记录服务,则此行显示不适用。 |
| DaysOfUsageData | 使用情况日志记录服务保留数据的天数。 此信息提供 Hits 和 DistinctUsers 的上下文。 例如,如果此数字为 14 天,则 Hits 和 DistinctUsers 数据为过去 14 天的数据。 |
| UPN | 用于确定 URL 长度差异的 UPN。 显示为“****”的 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 个字符,从而导致迁移失败。
若要解决此问题,可以将 reports 文件夹移动到 /documents/ 库的根目录附近,然后更新快速启动链接。 另一个选项是删除快速启动链接。
| 列 | 说明 |
|---|---|
| SiteId | 受影响网站集的唯一标识符。 |
| SiteURL | 受影响网站集的 URL。 |
| SiteOwner | 网站集所有者。 |
| SiteAdmins | 列为网站集管理员的人员列表。 |
| SiteSizeInMB | 大小集合的大小(以 MB 为单位 (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 为单位 (MB) )。 |
| NumOfWebs | 网站集中存在的 Web 数。 |
| ContentDBName | 托管网站集的内容数据库的名称。 |
| ContentDBServerName | 托管内容数据库的 SQL Server。 |
| ContentDBSizeInMB | 托管网站集的内容数据库的大小。 |
| UPN | UPN UserPrincipalName 用于确定 URL 长度的差异。 如果 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。 如果向文件添加权限,则该文件是该文件的服务器相对路径。 如果对文件夹设置权限,则它是该文件夹的服务器相对路径。 |
| ScanID | 分配给 SharePoint 迁移评估工具特定执行的唯一标识符。 |
LongODBUrl-Deps-detail.csv 某些文件可以具有其他依赖项。 URL 用于跟踪这些依赖项。 在迁移过程中,如果依赖项信息太长,迁移将失败。
本报告中有两处需注意的限制:
- FullURL 具有 260 个字符的限制。 文件中的此项具有 依赖项。 如果 FullURL 太长,则进行修正,删除文件或将文件移到距离网站集的根更近的位置。
- DependencyDescription 具有 270 个字符的限制。 此条目是与 FullURL 关联的依赖项。 为修正 DependencyDescription,可删除依赖项或将依赖项移到距离网站集的根更近的位置。
| 列 | 说明 |
|---|---|
| SiteId | 受影响网站集的唯一标识符。 |
| SiteURL | 受影响网站集的 URL。 |
| SiteOwner | 网站集所有者。 |
| SiteAdmins | 列为网站集管理员的人员列表。 |
| SiteSizeInMB | 大小集合的大小(以 MB 为单位 (MB) )。 |
| NumOfWebs | 网站集中存在的 Web 数。 |
| ContentDBName | 托管网站集的内容数据库的名称。 |
| ContentDBServerName | 托管内容数据库的 SQL Server。 |
| ContentDBSizeInMB | 托管网站集的内容数据库的大小。 |
| UPN | 用于确定 URL 长度差异的 UPN。 如果 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 迁移评估工具特定执行的唯一标识符。 |