Мигрирания от един клиент към друг
Бележка
Новият и подобрен Power Platform център за администриране вече е в публичен преглед! Проектирахме новия център за администриране така, че да бъде по-лесен за използване, с ориентирана към задачите навигация, която ви помага да постигате конкретни резултати по-бързо. Ще публикуваме нова и актуализирана документация, когато новият Power Platform център за администриране премине към обща наличност.
Функцията за мигриране от клиент към клиент ви позволява да прехвърляте среда от един клиент на друг. Тази функция поддържа сценарии като сливане на множество наематели в един и улесняване на придобиването на компании. Средата всъщност не се движи, а по-скоро е свързана с друг наемател. Средата все още съществува, но вече не е част от изходния клиент. Той е достъпен и управляван под наемателя на местоназначението. Няма промени на потребителския интерфейс или версията като част от това преместване.
Преди да започнете
Имайте предвид следното, преди да започнете миграция от клиент към клиент.
Бележка
Миграциите от клиент към клиент ще се поддържат в управлявани среди в бъдеще.
- Поддържани типове среди: Само производствена и ограничителна среда.
- Неподдържани типове среда: Типовете среда по подразбиране, разработчици, пробна версия и Teams не се поддържат. Не се поддържа облак на правителствената общност (GCC) към публични облаци и обратно.
- Компонентите, които не се поддържат, включват Dynamics 365 Customer Voice Омниканал за обслужване на клиенти, библиотека Dynamics 365 Customer Insights - Journeys с компоненти и Dynamics 365 Customer Insights - Data.
- Специфични стъпки, необходими за Power Apps, Power Automate Power Pages, и Microsoft Copilot Studio се посочват в стъпките преди и след миграцията.
- Организация Dataverse , свързана с финансова и оперативна организация, не може да бъде мигрирана към друг клиент.
- Може да се наложи да преконфигурирате някои приложения и настройки след мигриране от клиент към клиент, като например 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 трябва да бъде експортиран ръчно. Ние не поддържаме миграцията на клиентски конектори, връзки или шлюзове. Ако сте настроили някой от тези компоненти, те трябва да бъдат ръчно преконфигурирани след миграцията.
За приложения, съобразени с решения
За приложения, които са запознати с решенията, отидете на, Power Apps отидете до страницата Решения и експортирайте всички приложения и решения. Можете да ги експортирате поотделно или да ги групирате заедно в едно решение, ако все още не са.
Изтрийте тези приложения, съобразени с решенията, в средата, след като ги експортирате.
Приложенията, принадлежащи към управлявани решения, могат да бъдат изтрити само чрез изтриване на решението.
Приложенията, които са в незавършено решение, могат да бъдат изтрити с помощта на опцията Изтриване от тази среда .
Важно
Приложенията за платно с възможност за решение, персонализираните страници или библиотеките с компоненти, които не изтривате от среда преди мигрирането, няма да работят след приключване на миграцията.
За приложения, които не са запознати с решението
Отидете на Power Apps и след това изберете Приложения.
За всяко приложение, което искате да преместите, изберете Още команди и след това изберете Експортиране на пакет (визуализация).
Въведете данните, необходими за извършване на експортирането на приложението, и след това изберете Експортиране. След като експортирането завърши, започва изтегляне.
Полученият файл съдържа избрания пакет от приложения.
Повторете тези стъпки, докато всички приложения бъдат експортирани.
Изтрийте тези приложения, които не са съобразени с решението, от средата.
Администраторът може също да преглежда или изтрива приложения за платно от списъка в портала за администриране, като изпълни следните стъпки:
- Отидете в центъра за администриране Power Platform и след това изберете средата от Управление .
- Под действието Ресурси изберете Power Apps , за да ги прегледате и изтриете.
Приготвям Copilot Studio
Всички Copilot Studio чатботове трябва да бъдат експортирани ръчно. Някои зависими компоненти на чатботовете трябва да бъдат ръчно преконфигурирани по време или след миграцията. Например връзките, променливите на средата и персонализираните конектори трябва да бъдат ръчно преконфигурирани по време или след миграцията.
Чатботовете са наясно с решенията. Отидете Power Apps, отидете до страницата Решения и експортирайте всички решения за чатботове, поотделно или групирани заедно в едно решение. Научете повече в Експортиране и импортиране на ботове с помощта на решения.
Приготвям Power Pages
Следните стъпки трябва да бъдат направени за всеки уебсайт в среда:
- Вход в средата.
- Отворете центъра за администриране.
- Изтрийте уебсайта.
Създаване на файл за съпоставяне на потребители
Създайте файл за съпоставяне на потребителя за средата източник, която да бъде прехвърлена в целевата среда. Важно е да се отбележи, че всяка среда изисква индивидуален файл за картографиране. Уверете се, че потребителите присъстват и са упълномощени както в първоначалния, така и в целевия клиент, тъй като това е необходимо за успешна миграция. Домейните на потребителите може да варират в зависимост от източника и целевия, при условие че са активни.
Създайте файл за съпоставяне на потребители с име usermapping.csv.
Бележка
Името на файла е чувствително към малки и големи букви. Уверете се, че записите са разделени със запетая, а не с точка и запетая.
Записвайте точно подробностите за потребителите, включително техните имейл идентификатори на източника и местоназначението. Уверете се, че няма допълнителни интервали преди и след заглавката. Вашият файл за съпоставяне трябва да изглежда по следния пример:
Източник Местоназначение SourceUser@sourcetenant.com
DestinationUser@targettenant.com
За потребители с пълен достъп
Достъп до изходната среда.
Използвайте разширено търсене , за да търсите потребители.
Изберете Използване на запазен изглед>Потребители с пълен достъп и след това изберете Редактиране на колони.
Премахнете всички колони с изключение на колоната Пълно име .
Изберете Добавяне на колони>Windows Live ID.
Изберете OK>Резултати за да видите списъка с потребители с пълен достъп.
Изберете всички записи, изберете Експортиране на потребители в лентата и след това изберете Статичен работен лист.
Следвайте стъпки 1-7 по-горе за наемателя на местоназначение, ако е възможно. Сега трябва да имате два отделни листа на Excel: един за източника и един за целевия клиент.
Отворете файловете на Excel за редактиране.
Започвайки с изходния лист на Excel, копирайте записите под колоната Windows Live ID в Notepad. Не копирайте заглавката.
Запазете файла в Notepad.
Въведете целевия Windows Live ID (UPN) в същия документ на бележника вдясно от съответния UPN източник. Не забравяйте да разделите UPN на източника и местоназначението със запетая (,).
Пример:
-
user001@source.com
,user001@destination.com
-
user002@source.com
,user002@destination.com
-
user003@source.com
,user003@destination.com
-
Запишете като CSV файл.
За потребители с административен достъп
- Достъп до изходната среда.
- Използвайте разширено търсене , за да търсите потребители.
- Изберете Използване на запазен изглед>Потребители с административен достъп и след това изберете Резултати за да видите списък с потребители с административен достъп.
- Ако решите да не включите нито един от тези потребители, пропуснете следните стъпки. В противен случай, за да включите тези потребители във файла за съпоставяне, направете следното:
Намерете съответните потребители в целевия клиент.
Уверете се, че на целевия потребител в целевия клиент е присвоен валиден лиценз.
Бележка
Ако на целевия потребител не е присвоен лиценз, миграцията е неуспешна.
Запазете 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) (администратор на източника)
Тази стъпка включва създаване на SAS URL адрес, който се използва по-късно за качване на файла за съпоставяне на потребителя. Изпълнете следната команда на 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}
Качване на файла за съпоставяне на потребителя (администратор на източника)
Следващата стъпка включва прехвърляне на файла за съпоставяне на потребителя към предварително установения SAS URL адрес. За да постигнете това, изпълнете следните команди в Windows PowerShell ISE, като се уверите, че параметрите SASUri и FileToUpload съдържат подходящата информация за вашата среда. Тази стъпка е от решаващо значение за точното качване на картографирането на потребителите в системата.
Бележка
Инсталирането на модула Azure е необходимо, за да стартирате споменатия скрипт. Изпълнете следните стъпки с Windows PowerShell ISE.
$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
. - Target on line '{linenumber}' е същото като source emailId: Уверете се, че целевият имейл е различен от изходния имейл.
- Всеки ред трябва да има точно две колони: "{номера} на редове": Уверете се, че всеки ред има само две колони: изходната и целевата графа. Премахнете всички допълнителни запетаи.
След като коригирате грешките при съпоставяне на потребители, трябва да качите отново файла за съпоставяне на потребителя, като използвате същия SAS URI.
Изтегляне на отчета за грешка (администратор на източника)
Ако има грешки във файла за съпоставяне на потребителите, има опция за изтегляне на отчет за грешка. Това може да стане чрез директно копиране и поставяне на SasURL адреса, предоставен в командата Tenant-To-Tenant-GetMigrationStatus , или чрез използване на следните команди, които използват SAS URI от предишната стъпка, за да проверят състоянието и желаното местоположение за изтегляне на отчета за грешка.
Изпълнете стъпките по-долу:
Изпълнете следната команда с 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
Коригирайте проблемите във файла за съпоставяне на потребители.
Качете отново файла, като използвате стъпките в Качване на файла за съпоставяне на потребителя (администратор на източника).
След като завършите успешно мигрирането на средата (администратор на източника), можете да продължите с процедурата Мигриране на средата (администратор на източника), за да мигрирате средата. Извършете миграцията в рамките на следващите седем дни. Ако не завършите мигрирането през следващите седем дни, трябва да стартирате отново процедурата Подготовка на мигрирането на среда (администратор на източника).
Мигриране на средата (администратор на източника)
MigrationId може да се види с помощта на командата TenantToTenant-ViewMigrationRequest в клиента източник.
TenantToTenant-MigratePowerAppEnvironment
-MigrationId {MigrationId}
-TargetTenantId {TargetTenantId}
Получаване на състояние (администратор на източника)
TenantToTenant-GetMigrationStatus -MigrationId {MigrationId}
Примерен изход
- Среда за мигриране: Изпълнява се
- Мигриране на среда: Успешно
Бележка
Ако срещнете някакви проблеми при изпълнението на горните команди, изпратете заявка за поддръжка, за да получите помощ.
Процес след миграцията
След преместване на среди към друг клиент:
- URL адресът на средата, ИД на организацията (OrgID) и името не се променят.
- Изходната среда няма. Dataverse
- Потребителите, които не са включени във файла за съпоставяне, няма да бъдат мигрирани и картографирани след миграцията.
Изпълнете следните процедури за Power Automate, Power Apps, Copilot Studio, и Power Pages.
Процес след миграция за Power Automate
След като миграцията приключи, преминете през секцията Преглед на компонентите като контролен списък, за да коригирате и активирате потоци и други компоненти. Основните стъпки са:
- Създайте връзки за всички препратки към връзката.
- Стартиране на всички потоци, включително стартиране на дъщерни потоци преди родителските потоци.
- За всички потоци, задействани от HTTP, извлечете новия URL адрес и го поставете във всички приложения или потоци за повикване, за да обновите тези препратки.
Процес след миграция за Power Apps
За приложения, съобразени с решения
- Изберете новата среда и Power Apps отидете до страницата Решения .
- Изберете Импортиране и използвайте селектора на файлове, за да изберете експортираните пакети от горната стъпка.
- Потвърдете, че импортирането е завършено успешно, като проверите съдържанието на решението на мигрираната среда.
За приложения, които не са запознати с решението
- Отидете на Power Apps.
- Изберете новата среда от падащия списък на средата.
- Изберете Приложения.
- Изберете Импортиране на приложение за платно.
- Качете файла с пакета на приложението.
- Завършете избора на всички опции за импортиране и след това изберете Импортиране.
- Повтаряйте тези стъпки, докато импортирате всички приложения.
Процес след миграция за Copilot Studio
- Изберете новата среда и Power Apps отидете до страницата Решения .
- Изберете Импортиране и използвайте селектора на файлове, за да изберете експортираните пакети от горната стъпка.
- Потвърдете, че импортирането е завършено успешно, като проверите съдържанието на решението на мигрираната среда.
Процес след миграция за Power Pages
Следните стъпки трябва да бъдат изпълнени за всеки уебсайт в средата.
- Вход в средата.
- Отворете центъра за администриране.
- Осигурете уебсайта със същия тип и език на портала.
След като изпълните всички горепосочени стъпки и мигрирането, можете да потвърдите средата в целевия клиент. По-късно можете да изтриете средата източник в центъра за администриране Power Platform .
Често задавани въпроси
Активирани ли са фоновите операции по време на мигриране от клиент към клиент?
Режимът на администриране е активиран по време на миграция от клиент към клиент, поради което операциите на заден план не се изпълняват. Научете повече в режим на администриране.
Можем ли да мигрираме всички потребители на Dataverse организацията?
Можем да мигрираме всички потребители на организацията Dataverse само ако потребителите съществуват в целевия клиент. Например:
user001@source.com
, user001@destination.com
user002@source.com
, user002@destination.com