Шаг 5. Сопоставление удостоверений

Это шаг 5 в решении, предназначенном для завершения миграции OneDrive между клиентами. Дополнительные сведения см. в статье Общие сведения о миграции OneDrive для нескольких клиентов.

Создание файла сопоставления удостоверений

На этом этапе процесса миграции между клиентами вы создадите один CSV-файл (значения, разделенные запятыми), который содержит сопоставление пользователей и групп в исходном клиенте с соответствующими пользователями и группами в целевом клиенте.

Рекомендуется уделить время проверке сопоставлений, убедившись, что они точны перед началом миграции в целевой клиент.

В файле сопоставления удостоверений есть связь "один к одному". Нельзя сопоставить одного пользователя с несколькими пользователями в целевом клиенте. Например, если у вас есть экземпляры, где администратор является владельцем нескольких учетных записей OneDrive, необходимо изменить владельца в соответствии с соответствующим пользователем, который вы хотите перенести с исходного на целевое. В противном случае эти файлы учетных записей не будут перенесены.

Примере: В этом примере администратор владеет несколькими учетными записями OneDrive.

Владелец исходного клиента Целевой пользователь клиента
admin@source.com new.userA@target.com
admin@source.com new.userB@target.com
admin@source.com new.userC@target.com

Миграция между клиентами поддерживает следующий сценарий:

Пример.

Владелец исходного клиента Целевой пользователь клиента
userA@source.com new.userA@target.com
userB@source.com new.userB@target.com
userC@source.com new.userC@target.com

Создание CSV-файла

В CSV-файле требуется шесть столбцов. Первые три являются исходными значениями, каждое из которых предоставляет подробные сведения о расположении данных в данный момент. Оставшиеся три столбца являются соответствующими сведениями о целевом клиенте. Все шесть столбцов должны быть учтены в файле. Создайте файл в Excel и сохраните его как файл .csv.

Пользователи и группы включаются в один файл. В зависимости от того, является ли это пользователь или группа, то, что вы вводите в столбце, отличается. В каждом из столбцов введите значения, как показано в примерах. Не включайте заголовки столбцов.

Столбец Пользователь Группа
1 Пользователь Группа
2 SourceTenantCompanyID SourceTenantCompanyID
3 SourceUserUpn SourceGroupObjectID
4 TargetUserUpn TargetGroupObjectID
5 TargetUserEmail GroupName
6 UserType GroupType

Важно!

Не включайте заголовки столбцов в CSV-файл. В приведенных ниже примерах мы включаем их только в иллюстративных целях.

Пользователи. Введите значения, как показано в этом примере для параметра Пользователи:

формат, используемый для сопоставления пользователей

Пример csv-файла для пользователей

Группы. Введите значения, как показано в этом примере для параметра Группы:
формат CSV-файла для групп

Пример.

Пример добавления групп в CSV-файл

Гостевые пользователи. Гостевые учетные записи в исходном клиенте можно сопоставить с учетными записями участников в целевом клиенте. Вы также можете сопоставить учетную запись гостя в источнике с гостевой учетной записью в целевом объекте, если гость был создан ранее. Введите значения, как показано в этом примере для гостей:

Пример csv при сопоставлении гостя с участником

Пример csv при сопоставлении гостя с гостем

Несколько пользователей и групп в CSV-файле:

Пример:

Пример пользователей и групп в файле сопоставления

Получение идентификатора компании исходного клиента

Чтобы получить идентификатор компании исходного клиента, выполните приведенные далее действия.

  1. Войдите в портал Azure как Администратор
  2. Выберите или найдите идентификатор Microsoft Entra.
  3. Прокрутите вниз на левой панели и выберите Свойства.
  4. Найдите поле идентификатора клиента. Требуемый идентификатор клиента будет находиться в этом поле.

получение исходного идентификатора клиента

Чтобы получить идентификатор объекта исходной группы, выполните приведенные далее действия.

  1. Войдите в исходный клиент как Администратор в Группы Azure.
  2. Найдите необходимые группы.
  3. Выберите требуемый экземпляр Group и выберите Копировать в буфер обмена. Вставьте это значение в столбец sourceGroupObjectId CSV-файла сопоставления.
  4. Если у вас есть несколько групп для сопоставления, повторите эти действия для каждой группы.

получение идентификатора объекта исходной группы

Чтобы получить идентификатор объекта целевой группы, выполните приведенные далее действия.

  1. Войдите в целевой клиент как Администратор в группы Azure
  2. Найдите необходимые группы.
  3. Выберите необходимый экземпляр группы и выберите Копировать в буфер обмена. Вставьте это значение в столбец targetGroupObjectId CSV-файла сопоставления.
  4. Если у вас есть несколько групп для сопоставления, повторите описанный выше процесс, чтобы получить эти конкретные targetGroupObjectId.
  5. Для параметра GroupName используйте тот же идентификатор, что и полученный идентификатор TargetGroupObjectId .

получение идентификатора целевого объекта

Отправка карты удостоверений

После подготовки файла сопоставления удостоверений администратор SharePoint в целевом клиенте отправляет файл в SharePoint. Это позволит автоматически выполнять сопоставление удостоверений в рамках миграции между клиентами.

Важно!

Перед выполнением команды Add-SPOTenantIdentityMap -IdentityMapPath сохраните и закройте файл identitymap.csv на рабочем столе, в OneDrive или SharePoint. Если файл остается открытым, вы получите следующую ошибку.

Add-SPOTenantIdentityMap: процесс не может получить доступ к файлу "C:\Users\myuser\Test-Identity-Map.csv", так как он используется другим процессом.

  1. Чтобы отправить карту удостоверений в целевой клиент, выполните следующую команду. В поле -IdentityMapPath укажите полный путь и имя файла CSV-файла сопоставления удостоверений.
Add-SPOTenantIdentityMap -IdentityMapPath <identitymap.csv>

Важно!

Если вы вносите какие-либо изменения в карту удостоверений во время жизненного цикла миграции, необходимо выполнять Add-SPOTenantIdentityMap -IdentityMapPath <identitymap.csv> команду каждый раз при внесении изменений, чтобы убедиться, что эти изменения применяются к миграции.

При отправке новой карты удостоверений будет перезаписана текущая карта. Убедитесь, что любая редакция или добавление включает все пользователи и группы для полной миграции. Ваша карта удостоверений всегда должна включать всех пользователей, которые вы хотите перенести.

Чтобы просмотреть записи сопоставления в файле сопоставления удостоверений для конкретного пользователя, используйте команду Get-SPOTenantIdentityMappingUser с полем SourceUserKey и Value в качестве имени участника-пользователя, который вы перемещаете.

Пример:

get-spoTenantIdentityMappingUser -Field SourceUserKey -Value usera@Contoso.onmicrosoft.com

Проверка состояния совместимости между клиентами

Перед началом миграции между клиентами убедитесь, что обе схемы баз данных SharePoint актуальны и совместимы между исходным и целевым объектами.

Чтобы выполнить эту проверка, выполните приведенный ниже командлет в исходном клиенте.

Get-SPOCrossTenantCompatibilityStatus -PartnerCrossTenantHostURL [Target tenant hostname]

Get-SPOCrossTenantCompatibilityStatus -PartnerCrossTenantHostURL https://m365x12395529-my.sharepoint.com
  • Если состояние клиента отображается как Совместимо или Предупреждение, можно перейти к следующему шагу по началу миграции между клиентами.
  • Если состояние клиента отображается как несовместимый, для обеспечения совместимости ваших клиентов потребуется исправить или обновить.
Состояние Может продолжить миграцию
Совместимость Да
Предупреждение Да
Incompatible Нет

Примечание.

Рекомендуется подождать 48 часов. Если ваши клиенты по-прежнему считаются несовместимыми, обратитесь в службу поддержки.

Мы рекомендуем часто выполнять состояние совместимости проверка перед запуском любых экземпляров миграции между клиентами. Если клиенты несовместимы, это может привести к сбою миграции между клиентами.

Шаг 6. Запуск миграции OneDrive между клиентами