Поделиться через


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

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

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

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

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

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

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

Владелец исходного клиента Целевой пользователь клиента
[email protected] [email protected]
[email protected] [email protected]
[email protected] [email protected]

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

Пример.

Владелец исходного клиента Целевой пользователь клиента
[email protected] [email protected]
[email protected] [email protected]
[email protected] [email protected]

Создание 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 ID.
  3. Прокрутите вниз на левой панели и выберите Свойства.
  4. Найдите поле идентификатора клиента. В этом поле указан обязательный идентификатор клиента.

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

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

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

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

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

  1. Войдите в целевой клиент как Администратор в группы Azure
  2. Найдите необходимые группы.
  3. Выберите необходимый экземпляр группы и выберите Копировать в буфер обмена. Вставьте это значение в столбец targetGroupObjectId CSV-файла сопоставления.
  4. Если у вас есть несколько групп для сопоставления, повторите этот процесс, чтобы получить эти конкретные targetGroupObjectIds.
  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 и Значением в качестве имени участника-пользователя, который вы перемещаете.

Пример:

get-spoTenantIdentityMappingUser -Field SourceUserKey -Value [email protected]

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

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

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

Get-SPOCrossTenantCompatibilityStatus -PartnerCrossTenantHostURL [Target tenant hostname]

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

Примечание.

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

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

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