Шаг 5. Сопоставление удостоверений (предварительная версия)
Примечание.
Миграция SharePoint между клиентами в настоящее время находится на этапе разработки частной предварительной версии. Как незавершенный проект, любая информация или доступность могут быть изменены в любое время. Поддержка клиентов с закрытой предварительной версией будет осуществляться по электронной почте. Миграция SharePoint между клиентами распространяется на предварительные версии условий универсального лицензионного соглашения Майкрософт для веб-служб.
Это шаг 5 в решении, предназначенном для завершения миграции SharePoint между клиентами. Дополнительные сведения см. в статье Общие сведения о миграции SharePoint для нескольких клиентов.
- Шаг 1. Подключение к исходному и целевому арендаторам
- Шаг 2. Установление доверия между исходным и целевым клиентом
- Шаг 3. Проверка доверия установлена
- Шаг 4. Предварительное создание пользователей и групп
- Шаг 5 . Подготовка сопоставления удостоверений
- Шаг 6. Запуск миграции SharePoint между клиентами
- Шаг 7. После этапов миграции\n
Создание файла сопоставления удостоверений
На этом этапе процесса миграции между клиентами вы создадите один CSV-файл (значения, разделенные запятыми), который содержит сопоставление пользователей и групп в исходном клиенте с соответствующими пользователями и группами в целевом клиенте.
Рекомендуется уделить время проверке сопоставлений, убедившись, что они точны перед началом миграции в целевой клиент.
В файле сопоставления удостоверений есть связь "один к одному". Нельзя сопоставить одного пользователя с несколькими пользователями в целевом клиенте. Например, если у вас есть экземпляры, в которых администратор является владельцем нескольких учетных записей SharePoint, необходимо изменить владельца в соответствии с соответствующим пользователем, который вы хотите перенести из исходной учетной записи в целевую. В противном случае эти файлы учетных записей не будут перенесены.
Пример: В этом примере администратор владеет несколькими учетными записями SharePoint.
| Владелец исходного клиента | Целевой пользователь клиента |
|---|---|
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.
Пользователи и группы включаются в один файл. В зависимости от того, является ли это пользователь или группа, то, что вы вводите в столбце, отличается. В каждом из столбцов введите значения, как показано в примерах. Не включайте заголовки столбцов.
| Столбец | Пользователь | Группа | Группа Microsoft 365 |
|---|---|---|---|
| 1 | Пользователь | Группа | Группа |
| 2 | SourceTenantCompanyID | SourceTenantCompanyID | SourceTenantCompanyID |
| 3 | SourceUserUpn | SourceGroupObjectID | SourceGroupObjectID |
| 4 | TargetUserUpn | TargetGroupObjectID | TargetGroupObjectID |
| 5 | TargetUserEmail | GroupName | M365GroupAlias |
| 6 | UserType | GroupType | GroupType |
Важно!
При создании сопоставления удостоверений для сайтов, подключенных к группе, URL-адрес целевого сайта должен соответствовать псевдониму новой группы, созданной в целевом клиенте.
Пример:
- Исходный сайт:
https://contoso.sharepoint.com/teams/O365SourceGroup - Новый псевдоним целевой группы = O365TargetGroup
В файле сопоставления удостоверений целевой сайт должен иметь следующий формат: https://fabrikam.sharepoint.com/teams/O365TargetGroup.
Если псевдоним целевого объекта и ЦЕЛЕВОй URL-адрес не выровнены, миграция завершится ошибкой.
Не включайте заголовки столбцов в CSV-файл. В приведенных ниже примерах мы включаем их только в иллюстративных целях.
Пользователи. Введите значения, как показано в этом примере для параметра Пользователи:
Гостевые пользователи. Гостевые учетные записи в исходном клиенте можно сопоставить с учетными записями участников в целевом клиенте. Вы также можете сопоставить учетную запись гостя в источнике с гостевой учетной записью в целевом объекте, если гость был создан ранее. Введите значения, как показано в этом примере для гостей:
Группы. Введите значения, как показано в этом примере для групп: 
Пример.
Группы Microsoft 365. Введите значения, как показано в этом примере для групп Microsoft 365:
Несколько пользователей и групп в CSV-файле:
Пример:
Получение идентификатора компании исходного клиента
Чтобы получить идентификатор компании исходного клиента, выполните приведенные далее действия.
- Войдите в портал Azure как Администратор
- Выберите или найдите Microsoft Entra ID.
- Прокрутите вниз на левой панели и выберите Свойства.
- Найдите поле идентификатора клиента. Требуемый идентификатор клиента будет находиться в этом поле.
Чтобы получить идентификатор объекта исходной группы, выполните приведенные далее действия.
- Войдите в исходный клиент как Администратор в Группы Azure.
- Найдите необходимые группы.
- Выберите требуемый экземпляр Group и выберите Копировать в буфер обмена. Вставьте это значение в столбец sourceGroupObjectId CSV-файла сопоставления.
- Если у вас есть несколько групп для сопоставления, повторите эти действия для каждой группы.
Чтобы получить идентификатор объекта целевой группы, выполните приведенные далее действия.
- Войдите в целевой клиент как Администратор в группы Azure
- Найдите необходимые группы.
- Выберите необходимый экземпляр группы и выберите Копировать в буфер обмена. Вставьте это значение в столбец targetGroupObjectId CSV-файла сопоставления.
- Если у вас есть несколько групп для сопоставления, повторите описанный выше процесс, чтобы получить эти конкретные targetGroupObjectId.
- Для параметра GroupName используйте тот же идентификатор, что и полученный идентификатор TargetGroupObjectId .
Отправка карты удостоверений
После подготовки файла сопоставления удостоверений администратор SharePoint в целевом клиенте отправляет файл в SharePoint. Это позволит автоматически выполнять сопоставление удостоверений в рамках миграции между клиентами.
Важно!
Перед выполнением команды Add-SPOTenantIdentityMap -IdentityMapPath сохраните и закройте файл identitymap.csv на рабочем столе, SharePoint или SharePoint.
Если файл остается открытым, вы получите следующую ошибку. Add-SPOTenantIdentityMap: процесс не может получить доступ к файлу "C:\Users\myuser\Test-Identity-Map.csv", так как он используется другим процессом.
- Чтобы отправить карту удостоверений в целевой клиент, выполните следующую команду. В поле -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 часов. Если ваши клиенты по-прежнему считаются несовместимыми, обратитесь в службу поддержки.
Мы рекомендуем часто выполнять состояние совместимости проверка перед запуском любых экземпляров миграции между клиентами. Если клиенты несовместимы, это может привести к сбою миграции между клиентами.