Миграция между клиентами

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

Перед началом игры

Прежде чем приступить к миграции между арендаторами, ознакомьтесь со следующими примечаниями.

• Поддерживаемые типы сред: только рабочая среда и песочница.
• Не поддерживаемые типы сред: среда по умолчанию, среда разработчика, пробная среда и среда Teams не поддерживаются. Переход от облака сообщества для государственных организаций (GCC) к общедоступным облакам и наоборот не поддерживается.
• К неподдерживаемым компонентам относятся Dynamics 365 Customer Voice, Многоканальное взаимодействие для Customer Service, библиотека компонентов, Dynamics 365 Customer Insights - Journeys и Dynamics 365 Customer Insights - Data.
• Существуют определенные действия, необходимые для Power Apps, Power Automate, Power Pages и Microsoft Copilot Studio, вызываемые на шагах до и после миграции.
• Организация Dataverse, связанная с организацией по управлению финансами и операциями, не может быть перенесена в другой арендатор.
• После миграции между клиентами может потребоваться переконфигурировать некоторые приложения и параметры, например Microsoft Dynamics 365 for Outlook, синхронизацию на стороне сервера, SharePoint и другое.
• После создания и настройки пользователей необходимо создать файл сопоставления пользователей, который описан далее в этой статье.
• Если у сопоставленного пользователя есть почтовый ящик в целевом клиенте, то почтовый ящик автоматически настраивается во время миграции. Для всех остальных пользователей вам потребуется перенастроить почтовый ящик.
• Если тот же почтовый ящик используется в целевом арендаторе — test@microsoft.com — то этот почтовый ящик будет использоваться по умолчанию. Перед миграцией между арендаторами клиентам необходимо перенести/настроить свои почтовые ящики в целевом арендаторе.
• Если вы используете домен onmicrosoft по умолчанию — test@sourcecompanyname.onmicrosoft.com — доменное имя после миграции будет изменено на test@targetcompanyname.onmicrosoft.com. Клиентам необходимо перенастроить почтовый ящик. Узнайте больше о настройке почтового ящика в разделе Подключение к Exchange Online.

Предварительные требования

Прежде чем начать процесс миграции, убедитесь, что вы выполнили следующие предварительные требования.

• Создайте пользователей в целевом арендаторе, в том числе:
  • Создание пользователей в Microsoft 365 и Microsoft Entra ID.
  • Назначьте лицензии.
• Для выполнения миграции у вас должны быть права администратора Power Platform или администратора Dynamics 365.
• Модуль "PowerShell для администраторов Power Platform" — это рекомендуемый модуль PowerShell для взаимодействия с функциями администратора. Для получения дополнительной информации см. разделы Начало работы с PowerShell для администраторов Power Platform.

Процесс подготовки

Выполните следующие процедуры для Power Automate, Power Apps, Copilot Studio и Power Pages перед миграцией. Кроме того, необходимо создать файл сопоставления пользователей.

Подготовка Power Automate

Если потоки уже определены в Dataverse, дополнительная работа не требуется.

Для всех потоков Power Automate, подлежащих переносу, их определения должны быть добавлены в решения Dataverse в исходной среде. Дополнительные сведения: Добавление существующего облачного потока в решение. Это можно сделать массово, выполнив командлет Add-AdminFlowsToSolution.

Подготовка Power Apps

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

Для приложений, которые поддерживают решения:

1. Для приложений, поддерживающих решения, перейдите к Power Apps, затем перейдите на страницу Решения и экспортируйте все приложения и решения. Вы можете экспортировать их по отдельности или сгруппировать в одном решении, если они еще не в одном решении.

2. Удалите эти приложения с поддержкой решений в среде после их экспорта.

3. Приложения, принадлежащие управляемым решениям, можно удалить, только удалив само решение.

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

   Внимание!

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

Для приложений, которые не поддерживают решения:

1. Перейдите к Power Apps, а затем выберите Приложения.

2. Для каждого приложения, которое вы хотите переместить, выберите Дополнительные команды, а затем выберите Экспорт пакета (предварительная версия).

3. Введите данные, необходимые для экспорта приложения, а затем выберите Экспорт. После завершения экспорта должна начаться загрузка.

   Полученный файл содержит выбранный пакет приложения.

4. Повторяйте эти шаги, пока все приложения не будут экспортированы.

5. Удалите эти приложения, не поддерживающие решения, из среды

Администратор также может просматривать или удалять приложения на основе холста из списка на портале администрирования, выполнив следующие действия.

1. Перейдите в центр администрирования Power Platform и выберите среду в разделе Управление.
2. В разделе действия Ресурсы выберите Power Apps, чтобы просмотреть и удалить их.

Подготовка Copilot Studio

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

Чат-боты поддерживают решения. Перейдите в раздел Power Apps, выберите страницу Решения и экспортируйте все решения чат-ботов — по отдельности или сгруппируйте их вместе в одном решении. Подробнее: Экспорт и импорт ботов с использованием решений.

Подготовка Power Pages

Следующие действия необходимо выполнить для каждого веб-сайта в среде.

1. Выполните вход в среду.
2. Откройте центр администрирования.
3. Удалите веб-сайт.

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

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

1. Создайте файл сопоставления пользователей с именем usermapping.csv.

   Заметка

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

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

   Оригинал	Назначение
   SourceUser@sourcetenant.com	DestinationUser@targettenant.com

Для пользователей с полным доступом:

1. Получите доступ к исходной среде.

2. Используйте Расширенный поиск для поиска пользователей.

3. Выберите Использовать сохраненное представление > Пользователи с полным доступом, а затем выберите Изменить столбцы.

4. Удалите все столбцы, кроме столбца Полное имя.

5. Выберите Добавить столбцы > Windows Live ID.

6. Выберите ОК > Результаты, чтобы увидеть список пользователей с полным доступом.

7. Выделите все записи, выберите Экспорт пользователей на ленте, а затем выберите Статический лист.

8. Выполните шаги 1–7 выше для целевого клиента, если возможно. Теперь у вас должно быть два отдельных листа Excel: один для источника и один для целевого арендатора.

9. Откройте файлы Excel для редактирования.

10. Начиная с исходного листа Excel, скопируйте записи в столбце Windows Live ID в Блокнот. Не копируйте заголовок.

11. Сохраните файл блокнота.

12. Введите идентификатор назначения Windows Live ID (имя участника-пользователя) в том же документе Блокнота справа от соответствующего исходного имени участника-пользователя. Обязательно разделяйте исходные и целевые имена участников-пользователей запятой (,).

    Пример:

    • user001@source.com, user001@destination.com
    • user002@source.com, user002@destination.com
    • user003@source.com, user003@destination.com

13. Сохраните файл в формате CSV.

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

1. Получите доступ к исходной среде.
2. Используйте Расширенный поиск для поиска пользователей.
3. Выберите Использовать сохраненное представление > Пользователи с административным доступом, а затем выберите Результаты, чтобы увидеть список пользователей с административным доступом.
4. Если вы решите не включать ни одного из этих пользователей, пропустите следующие шаги. В противном случае, чтобы включить этих пользователей в файл сопоставления, выполните следующие действия:
   1. Найдите соответствующих пользователей в целевом клиенте.
   2. Убедитесь, что действующая лицензия назначена целевому пользователю в целевом арендаторе.

      Заметка

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

   3. Сохраните файл CSV, в котором сопоставлены как пользователи с полным доступом, так и пользователи с административным доступом.

Перенос

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

Установка PowerShell для администраторов Power Platform (как для администраторов источника, так и цели)

Модуль "PowerShell для администраторов Power Platform" — это рекомендуемый модуль PowerShell для взаимодействия с функциями администратора. Инструкции, которые помогут вам начать работу с PowerShell для администраторов Power Platform, см. в разделах Начало работы с PowerShell для администраторов Power Platform и Установка PowerShell для администраторов Power Platform.

Установите или обновите необходимый модуль с помощью одной из следующих команд:

Install-Module -Name Microsoft.PowerApps.Administration.PowerShell
Update-Module -Name Microsoft.PowerApps.Administration.PowerShell

Установка Azure PowerShell в Windows (как для исходного, так и для целевого администраторов)

Модуль Azure PowerShell является свертываемым модулем. При установке модуля Azure PowerShell загружаются общедоступные модули и их командлеты становятся доступными для использования. Дополнительные сведения см. в статье Установка Azure PowerShell в Windows.

Используйте командлет Install-Module для установки модуля Azure PowerShell:

Install-Module -Name Az -Repository PSGallery -Force

Войдите в Microsoft Power Platform (как администратор источника, так и цели)

Войдите в Microsoft Power Platform. Этот шаг позволяет администраторам пройти проверку подлинности и получить доступ к среде Power Platform.

Add-PowerAppsAccount

Отправка запроса на миграцию (администратор источника)

Чтобы инициировать миграцию между арендаторами, Dynamics 365 или администратор Power Platform исходного арендатора должен отправить запрос целевому арендатору с помощью следующей команды и указать идентификатор имени среды и идентификатор арендатора.

Для выполнения этого шага у вас должны быть учетные данные администратора Power Platform или администратора Dynamics 365.

TenantToTenant-SubmitMigrationRequest –EnvironmentName {EnvironmentId} -TargetTenantID {TenantID}

Состояние и MigrationID можно просмотреть с помощью следующей команды.

TenantToTenant-ViewMigrationRequest

Заметка

Запишите идентификатор MigrationID, который будет использоваться в дальнейших командах миграции. Идентификатор миграции исходного клиента отличается от идентификатора миграции целевого клиента

Просмотр и утверждение запроса на миграцию (целевой администратор)

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

Add-PowerAppsAccount

TenantToTenant-ViewApprovalRequest

TenantToTenant-ManageMigrationRequest -MigrationId {MigrationId from above command to approve or deny}

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

Создание подписанного URL-адреса (SAS) (администратор источника)

Этот шаг включает в себя создание URL-адреса SAS, который позже будет использоваться для отправки файла сопоставления пользователей. Выполните следующую команду PowerShell, заменив значение EnvironmentId фактическим идентификатором среды.

GenerateResourceStorage-PowerAppEnvironment –EnvironmentName {EnvironmentId}

Внимание!

Убедитесь, что среда не находится в Режиме администратора и пользователю назначена роль Обычный пользователь в среде.

Образец вывода

Code        :
Description :
Headers     :
Error       :
Errors      :
Internal    : @{sharedAccessSignature=https://dynamics.blob.core.windows.net/20240604t000000z73e18df430fe40059290dsddc25d783?sv=2018-03-28&sr=c&si=SASpolicyXXRRRX}

Отправка файла сопоставления пользователей (администрирование источника)

Следующим шагом является перенос файла сопоставления пользователя на ранее установленный URL-адрес SAS. Для этого выполните следующие команды в Windows PowerShell ISE, убедившись, что параметры SASUri и FileToUpload содержат соответствующие сведения о среде. Этот шаг имеет решающее значение для точной загрузки картографирования пользователей в систему.

Заметка

Для запуска упомянутого скрипта требуется установка модуля Azure. Выполните следующие действия с помощью интегрированной среды сценариев Windows PowerShell.

$SASUri ="Update the SAS Uri from previous step”
$Uri = [System.Uri] $SASUri
 
$storageAccountName = $uri.DnsSafeHost.Split(".")[0]
$container = $uri.LocalPath.Substring(1)
$sasToken = $uri.Query
 
# File to upload
# Note that the file name should be usermapping.csv (case sensitive) with comma separated values.
$fileToUpload = 'C:\filelocation\usermapping.csv'
 
# Create a storage context
$storageContext = New-AzStorageContext -StorageAccountName $storageAccountName -SasToken $sasToken
 
# Upload the file to Azure Blob Storage
Set-AzStorageBlobContent -File $fileToUpload -Container $container -Context $storageContext -Force

Подготовка миграции среды (администрирование источника)

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

MigrationId можно просмотреть с помощью команды "TenantToTenant-ViewMigrationRequest" в исходном арендаторе.

TenantToTenant-PrepareMigration 
-MigrationId {MigrationId} 
-TargetTenantId {TargetTenantId} 
-ReadOnlyUserMappingFileContainerUri {SasUri}

Заметка

При передаче значения SASUri необходимо указать параметр следующим образом: https://dynamics.blob.core.windows.net/20240604t000000z73e18df430fe40059290dsddc25d783

Образец вывода

Code        : 202
Description : Accepted

Длительность этого шага зависит от количества пользователей в файле сопоставления пользователей. Ход выполнения этого шага можно отслеживать с помощью команды TenantToTenant-GetStatus, приведенной ниже.

Проверка состояния (администратор источника)

TenantToTenant-GetMigrationStatus -MigrationId {MigrationId}

Образец вывода

• Проверка переноса между арендаторами: выполняется
• Проверка переноса между арендаторами: выполнено успешно
• Сбой проверки, ошибки см. в хранилище BLOB-объектов: SASURI

Ошибки и способы их устранения

• Если вы получаете сообщение об ошибке Файл сопоставления пользователей, предоставленный для переноса данных между арендаторами, является недопустимым, проверьте, правильно ли указано имя файла сопоставления пользователей и что в файле сопоставления пользователей есть запятая для разделения значений.
• Строка '{номера строк}' имеет тот же идентификатор '{emailID}': убедитесь, что нет дублирующихся записей.
• Неверный формат электронной почты '{emailid}': убедитесь, что для testuser@tenantdomain.com формат электронной почты является правильным.
• Цель в строке '{linenumber}' совпадает с идентификатором электронной почты источника: убедитесь, что Адрес электронной почты получателя отличается от Адреса электронной почты источника.
• В каждой строке должно быть ровно два столбца: '{номера строк}': убедитесь, что в каждой строке есть только два столбца: исходный и конечный столбцы. Удалите лишние запятые, если таковые имеются.

После исправления ошибок сопоставления пользователей необходимо повторно отправить файл сопоставления пользователей, используя тот же URI SAS.

Загрузка отчета об ошибках (администратор источника)

Если в файле сопоставления пользователей есть какие-либо ошибки, можно загрузить отчет об ошибках. Это можно сделать путем прямого копирования и вставки значения SasUrl, предоставляемого командой Tenant-To-Tenant-GetMigrationStatus, или за счет использования следующих команд, которые используют URI-адрес SAS из предыдущего шага проверки состояния и нужного расположения для загрузки отчета об ошибке.

Выполните следующие действия.

1. Выполните следующую команду в Windows PowerShell ISE.

   Import-Module Az.Storage 
   # Define the SAS URI of the blob
   $sasUri = " Update the SAS Uri from previous step "
   # Define the path where the blob will be downloaded
   $destinationPath = "C:\Downloads\Failed\"
   # Split the SAS URI on the '?' character to separate the URL and the SAS token
   $url, $sasToken = $sasUri -split '\?', 2
   $containerName = $url.Split('/')[3]
   $storageAccountName = $url.Split('/')[2].Split('.')[0]
   $storageContext = New-AzStorageContext -StorageAccountName $storageAccountName -SasToken $sasToken
   Get-AzStorageBlobContent -Blob "usermapping.csv" -Container $containerName -Destination $destinationPath -Context $storageContext 
   

2. Устраните проблемы в файле сопоставления пользователей.

3. Повторно отправьте файл, выполнив действия, описанные в разделе [Отправка файла сопоставления пользователей (администратор источника)](#upload-the-user-mapping-file-(source-admin).

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

Перенос среды (администрирование источника)

Параметр MigrationId можно просмотреть с помощью команды TenantToTenant-ViewMigrationRequest в исходном арендаторе.

TenantToTenant-MigratePowerAppEnvironment
-MigrationId {MigrationId}
-TargetTenantId {TargetTenantId}

Получить состояние (администратор источника)

TenantToTenant-GetMigrationStatus -EnvironmentName {EnvironmentId}

Образец вывода

• Перенос среды: выполняется
• Миграция среды: успешно

Заметка

Если у вас возникнут какие-либо проблемы с выполнением вышеуказанных команд, отправьте запрос на поддержку, чтобы получить помощь.

Процесс после миграции

После перемещения сред в другой клиент:

• URL-адрес среды, идентификатор организации (OrgID) и имя не меняются.
• Исходная среда не содержит Dataverse.
• Пользователи, не включенные в файл сопоставления, не будут перенесены и сопоставлены после миграции.

Выполните следующие процедуры для Power Automate, Power Apps, Copilot Studio, Power Pages.

Процесс после миграции для Power Automate

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

1. Создайте подключения для всех ссылок на подключение.
2. Запускайте все потоки, включая запуск дочерних потоков перед родительскими потоками.
3. Для всех потоков, инициированных HTTP, извлеките новый URL-адрес и поместите его во все вызывающие приложения или потоки, чтобы обновить эти ссылки.

Процесс после миграции для Power Apps

Для приложений, которые поддерживают решения:

1. Выберите новую среду на сайте Power Apps и перейдите на страницу Решения.
2. Выберите Импорт и используйте селектор файлов, чтобы выбрать пакеты, экспортированные из вышеуказанного шага.
3. Убедитесь, что импорт был успешно завершен, проверив содержимое решения в перенесенной среде.

Для приложений, которые не поддерживают решения:

1. Переход к Power Apps.
2. Выберите новую среду из раскрывающегося списка среды.
3. Выберите Приложения.
4. Выберите Импорт приложения на основе холста.
5. Отправьте файл пакета приложения.
6. Завершите выбор всех вариантов импорта, а затем выберите Импорт.
7. Повторяйте эти шаги, пока все приложения не будут импортированы.

Процесс после миграции для Copilot Studio

1. Выберите новую среду на сайте Power Apps и перейдите на страницу Решения.
2. Выберите Импорт и используйте селектор файлов, чтобы выбрать пакеты, экспортированные из вышеуказанного шага.
3. Убедитесь, что импорт был успешно завершен, проверив содержимое решения в перенесенной среде.

Процесс после миграции для Power Pages

Следующие шаги должны быть выполнены для каждого веб-сайта в среде.

1. Выполните вход в среду.
2. Откройте центр администрирования.
3. Подготовьте веб-сайт с тем же типом портала и языком.

После выполнения всех описанных выше действий и миграции вы можете проверить среду в целевом клиенте, а затем удалить исходную среду в Центре администрирования Power Platform.

Вопросы и ответы

Включены ли фоновые операции во время миграции от клиента к клиенту? Режим администрирования включен во время миграции от клиента к клиенту, поэтому фоновые операции не выполняются. Подробнее: Режим администрирования.

Можем ли мы перенести всех пользователей организации Dataverse? Мы можем перенести всех пользователей организации Dataverse, только если пользователи существуют в целевом клиенте. Например:

user001@source.com, user001@destination.comuser002@source.com, user002@destination.com