Оценочная проверка миграции: длинные URL-адреса OneDriveMigration Assessment Scan: Long OneDrive URLs

Узнайте, как устранить проблемы с длинными URL-адресами OneDrive в ходе миграции.Learn how to fix issues with long OneDrive URLs during migration.

Общие сведенияOverview

При перемещении сайта OneDrive из источника в целевую среду изменится формат URL-адреса OneDrive. На исходной платформе URL-адреса сайтов OneDrive имеют формат https://onedrive.contoso.com/personal/domain_user. На целевой платформе часть Domain_User URL-адреса будет изменена на имя участника-пользователя (UPN). URL-адрес будет выглядеть примерно так: https://onedrive.contoso.com/personal/user_contoso_com.When you're moving a OneDrive site from your source to the target environment, the OneDrive URL will change formats. On the source platform the OneDrive sites are in the format of https://onedrive.contoso.com/personal/domain_user. On the target platform, the Domain_User portion of the URL will change to use the UPN for the user. This will look similar to https://onedrive.contoso.com/personal/user_contoso_com.

Пример:Example:

Если вы использовали файл:If you used this file:

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

Имя каталога файла будет выглядеть так:The directory name of the file would be:

  • Personal/contoso_glebseleznyov/Documents/Folder1/Folder2Personal/contoso_bobsmith/Documents/Folder1/Folder2

Примечание

Путь к каталогу файла в SharePoint должен содержать не больше 400 символов.There is a 400-character limit on the directory path to a file in SharePoint.

После миграции путь к файлу будет выглядеть следующим образом:After the migration, the file path will look like the following.

Personal/glebseleznyov_contoso_com/Documents/Folder1/Folder2Personal/bobsmith_contoso_com/Documents/Folder1/Folder2

Обратите внимание, что теперь URL-адрес содержит на 4 символа больше, чем раньше. В зависимости от того, как формируются имена участников-пользователей в вашей организации, длина URL-адреса может измениться еще больше.Notice the URL is now 4 characters longer than it was before. Depending on how the UPNs are formed at your company, the change in length may be larger.

Если в исходной среде предыдущий файл содержал 255 символов, его длина после миграции будет составлять 259 символов.If the previous file in the source environment was 255 characters, the length after migration would be 259 characters.

Мы определили 4 разных расположения, в которых сбои, скорее всего, возникают из-за длинных URL-адресов. В результате мы имеем 4 различных отчета о длинных URL-адресах. В разделе "Отчеты о результатах проверки" приведены все отчеты вместе со сведениями о необходимых исправлениях.We have identified 4 different locations in which failures are likely to occur due to long URLs. As a result, we have 4 different reports concerning long URLs. The Scan Result Reports section covers each report along with the remediation that needs to occur.

Перенос данныхData Migration

Перенос содержимого из источника с образованием длинных URL-адресов завершится ошибкой. В результате произойдет сбой заданий миграции, что приведет к нежелательному увеличению продолжительности проекта миграции.The migration of the source content resulting in the long URLs will fail. This will cause migration jobs to fail, which will prolong the migration project unnecessarily.

Важно!

Любой сайт с параметром "Нет доступа" (заблокированный) будет пропускаться в SharePoint. Список заблокированных семейств веб-сайтов см. в результатах проверки "Заблокированные сайты".Any site that is configured as "No Access" (locked), in SharePoint will be skipped. To see a list of locked site collections see the Locked Sites scan output.

Подготовка к миграцииPreparing for Migration

Ознакомьтесь с отчетами и выполните исправления, рекомендуемые в каждом из них. Как правило, исправления состоит в переносе содержимого ближе в корню семейства веб-сайтов.Review the reports and follow the remediation recommended for each report. In general, the remediation involves moving the content closer to the root of the site collection.

Действия после переносаPost Migration

Убедитесь в успешном переносе содержимого.Validate that your content has been migrated.

Отчеты о результатах сканированияScan Result Reports

В результате проверки создаются 4 выходных файла. Каждый файл относится к определенной проблеме длинного URL-адреса, которая приведет к сбою миграции. LongODBUrl-AllDocs-detail.csv. Существует два ограничения, относящихся к длине пути к этому файлу:This scan results in 4 output files. Each file is for a specific long URL issue that will result in migration failures. LongODBUrl-AllDocs-detail.csv There are two limitations related to the length of the path to a given file:

  • Относительный путь сервера к папке с файлом содержит не более 400 символов. Пример файла:The server relative path to the folder containing the file has a maximum of 400 characters. Using the following example file:

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

    Имя каталога будет таким: Personal/contoso_bobsmith/Documents/Folder1/Folder2The directory name would be the following: Personal/contoso_bobsmith/Documents/Folder1/Folder2

    После миграции путь к файлу будет выглядеть примерно так, как показано ниже. Обратите внимание, что URL-адрес стал длиннее, чем раньше: Personal/bobsmith_contoso_com/Documents/Folder1/Folder2After the migration, the file path will look like the following. Notice the URL is now longer than it was before: Personal/bobsmith_contoso_com/Documents/Folder1/Folder2

  • Относительный путь сервера к файлу или папке содержит не более 400 символов. Пример файла:The server relative path to a file or folder has a total maximum of 400 characters. Using the following example file:

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

    Путь к файлу относительно сервера будет выглядеть примерно так: Personal/contoso_bobsmith/Documents/Folder1/Folder2/ProjectA.docxThe server relative path to the file will look similar to the following: Personal/contoso_bobsmith/Documents/Folder1/Folder2/ProjectA.docx

Если в этом отчете указаны определенные файлы, владельцам потребуется переместить их по более короткому пути или удалить. Например, можно переместить документ ProjectA.docx прямо в папку "Документы" или удалить этот файл, если он больше не нужен.If there are files listed in this report, the owners will need to move the files to shorter paths or delete the files. For example, they could move ProjectA.docx up to a folder directly under Documents, or they could delete the file if it is no longer needed.

СтолбецColumn ОписаниеDescription
SiteIdSiteId
Уникальный идентификатор затронутого семейства веб-сайтов.Unique identifier of the impacted site collection.
SiteURLSiteURL
URL-адрес затронутого семейства веб-сайтов.URL to the impacted site collection.
SiteOwnerSiteOwner
Владелец семейства веб-сайтов.Owner of the site collection.
SiteAdminsSiteAdmins
Список администраторов семейства веб-сайтов.List of people listed as site collection administrators.
SiteSizeInMBSiteSizeInMB
Размер (в мегабайтах) семейства веб-сайтов.Size of the size collection in megabytes [MB]
NumOfWebsNumOfWebs
Количество сетей в семействе веб-сайтов.Number of webs that exist in the site collection.
ContentDBNameContentDBName
Имя базы данных контента, в которой хранится семейство веб-сайтов.Name of the content database hosting the site collection.
ContentDBServerNameContentDBServerName
SQL Server, на котором размещена база данных контента.SQL Server hosting the content database.
ContentDBSizeInMBContentDBSizeInMB
Размер базы данных контента, в которой хранится семейство веб-сайтов.Size of the content database hosting the site collection.
LastContentModifiedDateLastContentModifiedDate
Дата и время изменения контента семейства веб-сайтов.Date/Time the site collection had content modified.
TotalItemCountTotalItemCount
Общее количество элементов в семействе веб-сайтов.Total number of items found in the site collection.
ОбращенияHits
Количество запросов, зарегистрированных для семейства веб-сайтов. Основано на данных службы ведения журнала использования. Если служба ведения журнала использования отключена, в этой строке будет указано "Н/Д".Number of requests logged for the site collection. Relies on data from the usage logging service. If the usage logging service is disabled this row will show N/A.
DistinctUsersDistinctUsers
Количество отдельных пользователей, обращавшихся к семейству веб-сайтов. Основано на данных службы ведения журнала использования. Если служба ведения журнала использования отключена, в этой строке будет указано "Н/Д".Number of distinct users that have accessed the site collection. Relies on data from the usage logging service. If the usage logging service is disabled this row will show N/A.
DaysOfUsageDataDaysOfUsageData
Количество дней, в течение которых данные хранятся в службе ведения журнала использования. Обеспечивает контекст для значений Hits и DistinctUsers. Например, если в этом столбце указано 14 дней, в столбцах Hits и DistinctUsers отображаются данные за последние 14 дней.Number of days the usage logging service retains data. This provides context for Hits and DistinctUsers. For example, if this is 14 days, the Hits and DistinctUsers data is for the last 14 days.
Имя участника-пользователяUPN
Имя участника-пользователя, определявшее разницу в длине URL-адреса. Если имя участника-пользователя "****", это значит, что владелец не задал значение параметра UserPrincipalName в своем профиле SharePoint. В результате была использована средняя длина значений UserPrincipalName в хранилище профилей SharePoint.UPN that was used to determine the difference in the URL length. If the UPN is "****" that indicates the owner did not have a UserPrincipalName set in their SharePoint profile. As a result, the average length of the UserPrincipalName values in the SharePoint profile store was used.
URLLengthDifferenceURLLengthDifference
Число символов, на которое увеличится URL-адрес после переименования сайта.Amount the URL will grow when the site is renamed.
ФайлFile
Файл, который необходимо исправить.File that needs to be remediated.
ScanIDScanID
Уникальный идентификатор, назначаемый определенному выполнению средства SharePoint Migration Assessment Tool.Unique identifier assigned to a specific execution of the SharePoint Migration Assessment Tool.

LongODBUrl-NavNodes-detail.csv Длина URL-адресов узлов навигации не может превышать 260 символов. Из-за этого длина поля URL-адреса может превысить максимальную.LongODBUrl-NavNodes-detail.csv Navigation nodes have a URL length limitation of 260 characters. This can lead to the URL field exceeding the maximum length.

Например, у вас есть сайт OneDrive по адресу https://OneDrive.contoso.com/personal/contoso_bobsmith. На панели быстрого запуска этого сайта есть ссылка "Отчеты" с URL-адресом https://onedrive.contoso.com/personal/contoso_bobsmith/documents/folder1/…folderN/Reports. В процессе миграции SharePoint обновит URL-адрес так, чтобы он указывал на /glebseleznyov_contoso_com /. Увеличение длины URL-адреса может привести к превышению ограничения в 260 символов, что станет причиной сбоя миграции.For example, you have a OneDrive site at https://OneDrive.contoso.com/personal/contoso_bobsmith. That site has a link in the Quick launch named Reports and the URL of the link points to https://onedrive.contoso.com/personal/contoso_bobsmith/documents/folder1/…folderN/Reports. During the migration, SharePoint will update the URL to point to /bobsmith_contoso_com/. The additional length added to the URL may result in the length being over 260 characters, which will cause the migration to fail.

Чтобы исправить эту проблему, необходимо перенести папку отчетов ближе к корню библиотеки /documents/, а затем обновить ссылку быстрого запуска. В качестве альтернативы можно удалять ссылку быстрого запуска.To remediate this issue, you would move the reports folder close to the root of the /documents/ library and then update the quick launch link. Another option would be to remove the quick launch link.

СтолбецColumn ОписаниеDescription
SiteIdSiteId
Уникальный идентификатор затронутого семейства веб-сайтов.Unique identifier of the impacted site collection.
SiteURLSiteURL
URL-адрес затронутого семейства веб-сайтов.URL to the impacted site collection.
SiteOwnerSiteOwner
Владелец семейства веб-сайтов.Owner of the site collection.
SiteAdminsSiteAdmins
Список администраторов семейства веб-сайтов.List of people listed as site collection administrators.
SiteSizeInMBSiteSizeInMB
Размер (в мегабайтах) семейства веб-сайтов.Size of the size collection in megabytes [MB]
NumOfWebsNumOfWebs
Количество сетей в семействе веб-сайтов.Number of webs that exist in the site collection.
ContentDBNameContentDBName
Имя базы данных контента, в которой хранится семейство веб-сайтов.Name of the content database hosting the site collection.
ContentDBServerNameContentDBServerName
SQL Server, на котором размещена база данных контента.SQL Server hosting the content database.
ContentDBSizeInMBContentDBSizeInMB
Размер базы данных контента, в которой хранится семейство веб-сайтов.Size of the content database hosting the site collection.
Имя участника-пользователяUPN
Имя участника-пользователя, определявшее разницу в длине URL-адреса. Если имя участника-пользователя "****", это значит, что владелец не задал значение параметра UserPrincipalName в своем профиле SharePoint. В результате была использована средняя длина значения UserPrincipalName в хранилище профилей SharePoint.UPN that was used to determine the difference in the URL length. If the UPN is "****" that indicates the owner did not have a UserPrincipalName set in their SharePoint profile. As a result, the average length of the UserPrincipalName in the SharePoint profile store was used.
URLLengthDifferenceURLLengthDifference
Число символов, на которое увеличится URL-адрес после переименования сайта.URLLengthDifference Amount the URL will grow when the site is renamed.
WebURLWebURL
URL-адрес сайта, на котором размещен узел навигации.URL to the web that has the navigation node.
NavigationNodeLocationNavigationNodeLocation
Названия узла навигации, показывающие его расположение. У вас может быть несколько уровней узлов навигации, что поможет найти проблемный узел.Navigation Node titles showing where the navigation node lives. You can have multiple levels of navigation nodes, and this will help locate the offending node.
NavigationNodeTitleNavigationNodeTitle
Название затронутого узла навигации.Title of the impacted navigation node.
NavigationNodeURLNavigationNodeURL
URL-адрес, длина которого будет слишком большой после переименования сайта.URL that will be too long after the site rename.
ScanIDScanID
Уникальный идентификатор, назначаемый определенному выполнению средства SharePoint Migration Assessment Tool.Unique identifier assigned to a specific execution of the SharePoint Migration Assessment Tool.

LongODBUrl-Perms-detail.csv. Разрешения, заданные для объекта в SharePoint, отслеживаются по его URL-адресу. Если задать разрешения для папки, SharePoint сохранит относительный путь к ней. Если задать разрешения для элемента, SharePoint сохранит относительный путь сервера к этому элементу.LongODBUrl-Perms-detail.csv Permissions that are set on an object in SharePoint are tracked by the URL of that object. If you set permissions on a folder, SharePoint will store the relative path to the folder. If you set permissions on an item, SharePoint will store the server relative path to the item.

В результате связанные с этими разрешениями URL-адреса будут обновлены во время миграции. Если новый URL-адрес слишком длинный, это может привести к сбоям.As a result, during a site migration, the URLs associated with permissions will be updated. This may lead to failures if the new URL is too long.

Эту проблему можно исправить, переместив затронутый объект ближе к корню семейства веб-сайтов. Вы также можете удалить уникальные разрешения для элементов в отчете.The remediation for this is to move the affected object closer to the root of the site collection. Another option is to remove the distinct permissions from the items in the report.

СтолбецColumn ОписаниеDescription
SiteIdSiteId
Уникальный идентификатор затронутого семейства веб-сайтов.Unique identifier of the impacted site collection.
SiteURLSiteURL
URL-адрес затронутого семейства веб-сайтов.URL to the impacted site collection.
SiteOwnerSiteOwner
Владелец семейства веб-сайтов.Owner of the site collection.
SiteAdminsSiteAdmins
Список администраторов семейства веб-сайтов.List of people listed as site collection administrators.
SiteSizeInMBSiteSizeInMB
Размер (в мегабайтах) семейства веб-сайтов.Size of the size collection in megabytes [MB]
NumOfWebsNumOfWebs
Количество сетей в семействе веб-сайтов.Number of webs that exist in the site collection.
ContentDBNameContentDBName
Имя базы данных контента, в которой хранится семейство веб-сайтов.Name of the content database hosting the site collection.
ContentDBServerNameContentDBServerName
SQL Server, на котором размещена база данных контента.SQL Server hosting the content database.
ContentDBSizeInMBContentDBSizeInMB
Размер базы данных контента, в которой хранится семейство веб-сайтов.Size of the content database hosting the site collection.
Имя участника-пользователяUPN
Имя участника-пользователя, определявшее разницу в длине URL-адреса. Если имя участника-пользователя "****", это значит, что владелец не задал значение параметра UserPrincipalName в своем профиле SharePoint. В результате была использована средняя длина значения UserPrincipalName в хранилище профилей SharePoint.UPN UserPrincipalName that was used to determine the difference in the URL length. If the UPN is "****" that indicates the owner did not have a UserPrincipalName set in their SharePoint profile. As a result, the average length of the UserPrincipalName in the SharePoint profile store was used.
URLLengthDifferenceURLLengthDifference
Число символов, на которое увеличится URL-адрес после переименования сайта.Amount the URL will grow when the site is renamed.
WebURLWebURL
URL-адрес веб-сайта, на котором размещается защищенный объект.URL to the web hosting the secured object.
SecuredObjectSecuredObject
URL-адрес защищенного объекта, длина которого будет слишком большой после переименования сайта. Если вы задаете разрешения для файла, этот URL-адрес относительный путь сервера к файлу. При задании разрешений для папки этот URL-адрес является относительным путем сервера к папке.This is the URL to the secured object that will be too long after the site rename. If you add permissions to a file, this is the server relative path to the file. If you set permissions on a folder, this is the server relative path to the folder.
ScanIDScanID
Уникальный идентификатор, назначаемый определенному выполнению средства SharePoint Migration Assessment Tool.Unique identifier assigned to a specific execution of the SharePoint Migration Assessment Tool.

LongODBUrl-Deps-detail.csv. Некоторые файлы могут иметь дополнительные зависимости. Эти зависимости отслеживаются по URL-адресу. Если во время миграции сведения о зависимостях имеют слишком большую длину, перенос завершится сбоем.LongODBUrl-Deps-detail.csv Certain files can have additional dependencies. Those dependencies are tracked by the URL. During the migration if the dependency information is too long, the migration will fail.

В этом отчете следует учитывать два ограничения:There are two limitations in this report to be aware of:

  • Ограничение длины для параметра FullURL 260 символов. Это файл с зависимостями. Если значение FullURL слишком длинное, удалите файл или переместите его в расположение ближе в корню семейства веб-сайтов.FullURL has a limit of 260 characters. This is the file with the dependencies. To remediate if the FullURL is too long, either remove the file or move the file to a location closer to the root of the site collection.

  • Ограничение длины для параметра DependencyDescription 270 символов. Это зависимость, связанная с параметром FullURL. Если значение DependencyDescription слишком длинное, удалите файл или переместите его в расположение ближе в корню семейства веб-сайтов.DependencyDescription has a limit of 270 characters. This is the dependency associated with the FullURL. To remediate the DependencyDescription, either remove the dependency or move the dependency closer to the root of the site collection.

СтолбецColumn ОписаниеDescription
SiteIdSiteId
Уникальный идентификатор затронутого семейства веб-сайтов.Unique identifier of the impacted site collection.
SiteURLSiteURL
URL-адрес затронутого семейства веб-сайтов.URL to the impacted site collection.
SiteOwnerSiteOwner
Владелец семейства веб-сайтов.Owner of the site collection.
SiteAdminsSiteAdmins
Список администраторов семейства веб-сайтов.List of people listed as site collection administrators.
SiteSizeInMBSiteSizeInMB
Размер (в мегабайтах) семейства веб-сайтов.Size of the size collection in megabytes [MB]
NumOfWebsNumOfWebs
Количество сетей в семействе веб-сайтов.Number of webs that exist in the site collection.
ContentDBNameContentDBName
Имя базы данных контента, в которой хранится семейство веб-сайтов.Name of the content database hosting the site collection.
ContentDBServerNameContentDBServerName
SQL Server, на котором размещена база данных контента.SQL Server hosting the content database.
ContentDBSizeInMBContentDBSizeInMB
Размер базы данных контента, в которой хранится семейство веб-сайтов.Size of the content database hosting the site collection.
Имя участника-пользователяUPN
Имя участника-пользователя, определявшее разницу в длине URL-адреса. Если имя участника-пользователя "****", это значит, что владелец не задал значение параметра UserPrincipalName в своем профиле SharePoint. В результате была использована средняя длина значения UserPrincipalName в хранилище профилей SharePoint.UPN that was used to determine the difference in the URL length. If the UPN is "****", that indicates the owner did not have a UserPrincipalName set in their SharePoint profile. As a result, the average length of the UserPrincipalName in the SharePoint profile store was used.
URLLengthDifferenceURLLengthDifference
Число символов, на которое увеличится URL-адрес после переименования сайта.Amount the URL will grow when the site is renamed.
FullURLFullURL
URL-адрес файла с зависимостями.URL to the file that has the dependencies
DependencyDescriptionDependencyDescription
Описание, связанное с зависимостью. Это может быть URL-адрес, который переименовывается.DependencyDescription Description associated with the dependency. This may be a URL that is getting renamed.
ScanIDScanID
Уникальный идентификатор, назначаемый определенному выполнению средства SharePoint Migration Assessment Tool.Unique identifier assigned to a specific execution of the SharePoint Migration Assessment Tool.