Bagikan melalui

Migrasi antarpenyewa

  • Artikel

Fitur migrasi penyewa ke penyewa memungkinkan Anda mentransfer lingkungan dari satu penyewa ke penyewa lainnya. Fitur ini mendukung skenario seperti menggabungkan beberapa penyewa menjadi satu dan memfasilitasi akuisisi perusahaan. Lingkungan tidak benar-benar bergerak, melainkan terkait dengan penyewa lain. Lingkungan masih ada tetapi bukan bagian dari penyewa sumber lagi. Ini dapat diakses dan dikelola di bawah penyewa tujuan. Tidak ada perubahan antarmuka pengguna atau versi sebagai bagian dari langkah ini.

Persiapan

Perhatikan catatan berikut sebelum Anda memulai migrasi penyewa-ke-penyewa.

  • Jenis lingkungan yang didukung: Hanya produksi dan kotak pagar.
  • Jenis lingkungan yang tidak didukung: Jenis lingkungan default, pengembang, uji coba, dan Teams tidak didukung. Government Community Cloud (GCC) ke cloud publik dan sebaliknya tidak didukung.
  • Komponen yang tidak didukung meliputi Dynamics 365 Customer Voice, Multisaluran untuk Customer Service, pustaka komponen, Dynamics 365 Customer Insights - Journeys dan Dynamics 365 Customer Insights - Data.
  • Ada langkah-langkah khusus yang diperlukan untuk Power Apps,, Power Automate, Power Pages dan Microsoft Copilot studio yang dipanggil dalam langkah-langkah pramigrasi dan pasca-migrasi.
  • Organisasi yang Dataverse ditautkan ke organisasi keuangan dan operasi tidak dapat dimigrasikan ke penyewa yang berbeda.
  • Anda mungkin perlu mengonfigurasi ulang beberapa aplikasi dan pengaturan setelah migrasi penyewa ke penyewa, seperti Microsoft Dynamics 365 for Outlook, sinkronisasi sisi server, SharePoint dan lainnya.
  • Setelah pengguna dibuat dan dikonfigurasi, Anda harus membuat file pemetaan pengguna, yang dijelaskan nanti dalam artikel ini.
  • Jika pengguna yang dipetakan memiliki kotak pesan di penyewa tujuan, maka kotak pesan secara otomatis dikonfigurasi selama migrasi. Untuk semua pengguna lain, Anda perlu mengonfigurasi ulang kotak pesan.
  • Jika kotak pesan yang sama digunakan di penyewa target, test@microsoft.com maka kotak pesan digunakan secara default. Sebelum migrasi penyewa ke penyewa, pelanggan perlu memigrasikan dan mengonfigurasi kotak pesan mereka pada penyewa target.
  • Jika Anda menggunakan default onmicrosoft domain, test@sourcecompanyname.onmicrosoft.com, nama domain pasca-migrasi diubah menjadi test@targetcompanyname.onmicrosoft.com. Pelanggan harus mengkonfigurasi ulang kotak pesan. Pelajari selengkapnya tentang mengonfigurasi kotak pesan di Sambungkan ke. Exchange Online

Prasyarat

Pastikan Anda menyelesaikan prasyarat berikut sebelum memulai proses migrasi.

  • Buat pengguna di penyewa target, termasuk:
    • Buat pengguna di dan Microsoft 365 ID Microsoft Entra .
    • Menetapkan lisensi.
  • Anda harus memiliki hak istimewa admin Power platform atau admin Dynamics 365 untuk melakukan migrasi.
  • Modul PowerShell untuk Power Platform Administrator adalah modul PowerShell yang direkomendasikan untuk berinteraksi dengan kemampuan admin. Pelajari selengkapnya di Mulai menggunakan PowerShell untuk Power Platform Administrator.

Proses persiapan

Selesaikan prosedur berikut untuk Power Automate,, Power Apps, Copilot Studio dan Power Pages sebelum migrasi. Anda juga harus membuat file pemetaan pengguna.

Mempersiapkan Power Automate

Jika alur Anda sudah ditentukan Dataverse, maka tidak ada pekerjaan tambahan yang diperlukan.

Setiap Power Automate alur yang harus dimigrasikan harus ditambahkan definisinya ke dalam Dataverse solusi di lingkungan sumber. Pelajari selengkapnya di Menambahkan alur cloud yang ada ke dalam solusi. Ini dapat dilakukan secara massal dengan menjalankan cmdlet Add-AdminFlowsToSolution .

Mempersiapkan Power Apps

Apa pun Power Apps harus diekspor secara manual. Kami tidak mendukung migrasi konektor, koneksi, atau gateway pelanggan. Jika Anda memiliki salah satu komponen tersebut, maka komponen tersebut harus dikonfigurasi ulang secara manual setelah migrasi.

Untuk aplikasi sadar solusi:

  1. Untuk aplikasi yang sadar solusi, buka Power Apps, navigasikan ke halaman Solusi , dan ekspor semua aplikasi dan solusi. Anda dapat mengekspornya satu per satu atau mengelompokkannya dalam satu solusi, jika belum.

  2. Hapus aplikasi sadar solusi ini di lingkungan setelah mengekspornya.

  3. Aplikasi milik solusi terkelola hanya dapat dihapus dengan menghapus solusi.

  4. Aplikasi yang berada dalam solusi tidak dikelola dapat dihapus dengan menggunakan opsi Hapus dari lingkungan ini.

    Penting

    Aplikasi kanvas sadar solusi, halaman kustom, atau pustaka komponen yang tidak Anda hapus dari lingkungan sebelum migrasi, tidak akan berfungsi setelah migrasi selesai.

Untuk aplikasi yang tidak sadar solusi:

  1. Buka Power Apps, lalu pilih Aplikasi.

  2. Untuk setiap aplikasi yang ingin Anda pindahkan, pilih Perintah Lainnya lalu pilih Ekspor paket (pratinjau).

  3. Masukkan detail yang diperlukan untuk melakukan ekspor aplikasi, lalu pilih Ekspor. Setelah ekspor selesai, unduhan dimulai.

    File yang dihasilkan berisi paket aplikasi yang dipilih.

  4. Ulangi langkah ini hingga semua aplikasi diekspor.

  5. Hapus aplikasi yang tidak sadar solusi ini dari lingkungan

Admin juga dapat melihat atau menghapus aplikasi kanvas dari daftar di portal admin dengan menyelesaikan langkah-langkah berikut.

  1. Buka Power Platform pusat admin, lalu pilih lingkungan dari Kelola.
  2. Di bawah tindakan Sumber Daya , pilih Power Apps untuk melihat dan menghapusnya.

Mempersiapkan Copilot Studio

Setiap Copilot Studio chatbot harus diekspor secara manual. Beberapa komponen gantungan chatbot harus dikonfigurasi ulang secara manual selama atau setelah migrasi. Misalnya, koneksi, variabel lingkungan, dan konektor kustom harus dikonfigurasi ulang secara manual selama atau setelah migrasi.

Chatbot sadar solusi. Buka, Power Apps navigasikan ke halaman Solusi , dan ekspor semua solusi chatbot, baik secara individual atau kelompokkan bersama-sama dalam satu solusi. Pelajari selengkapnya di Mengekspor dan mengimpor bot menggunakan solusi.

Mempersiapkan Power Pages

Langkah-langkah berikut harus dilakukan untuk setiap situs web di suatu lingkungan.

  1. Masuk ke lingkungan.
  2. Buka pusat admin.
  3. Hapus situs web.

Membuat file pemetaan pengguna

Buat file pemetaan pengguna untuk lingkungan sumber yang akan ditransfer ke lingkungan target. Penting untuk dicatat bahwa setiap lingkungan memerlukan file pemetaan individual. Pastikan bahwa pengguna hadir dan diotorisasi di penyewa asal dan tujuan, karena ini diperlukan untuk migrasi yang berhasil. Domain pengguna dapat bervariasi antara sumber dan target, asalkan mereka aktif.

  1. Buat file pemetaan pengguna bernama usermapping.csv.

    Catatan

    Nama file adalah huruf besar/kecil. Pastikan catatan dipisahkan dengan koma, bukan titik koma.

  2. Catat detail pengguna secara akurat, termasuk ID email sumber dan tujuan mereka. Pastikan tidak ada ruang ekstra sebelum dan sesudah header. File pemetaan Anda harus melihat contoh berikut:

    Sumber Lokasi Tujuan
    SourceUser@sourcetenant.com DestinationUser@targettenant.com

Untuk Pengguna Akses Penuh:

  1. Nilai lingkungan sumber Anda.

  2. Gunakan Pencarian Lanjutan untuk mencari pengguna.

  3. Pilih Gunakan Pengguna Akses > Penuh TampilanTersimpan, lalu pilih Edit Kolom.

  4. Hapus semua kolom kecuali kolom Nama Lengkap.

  5. Pilih Tambahkan Kolom Windows > Live ID.

  6. Pilih OK > Hasil untuk melihat daftar pengguna akses penuh.

  7. Pilih semua rekaman, pilih Ekspor Pengguna pada pita, lalu pilih Lembar Kerja Statis.

  8. Ikuti langkah 1-7 di atas untuk penyewa tujuan, jika memungkinkan. Anda sekarang harus memiliki dua lembar Excel terpisah: satu untuk sumber dan satu untuk penyewa target.

  9. Buka file Excel untuk diedit.

  10. Dimulai dengan lembar Excel sumber, salin rekaman di dalam kolom Windows Live ID ke Notepad. Jangan menyalin header.

  11. Simpan file Notepad.

  12. Masukkan Windows Live ID (UPN) tujuan dalam dokumen Notepad yang sama di sebelah kanan UPN sumber yang sesuai. Pastikan untuk memisahkan UPN sumber dan tujuan dengan koma (,).

    Contoh:

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

  13. Simpan file sebagai CSV.

Untuk pengguna akses Administratif:

  1. Nilai lingkungan sumber Anda.
  2. Gunakan Pencarian Lanjutan untuk mencari pengguna.
  3. Pilih Gunakan Pengguna > Akses Administratif TampilanTersimpan, lalu pilih Hasil untuk melihat daftar pengguna akses administratif.
  4. Jika Anda memutuskan untuk tidak menyertakan salah satu pengguna ini, abaikan langkah-langkah berikut. Jika tidak, untuk menyertakan pengguna ini dalam file pemetaan, lakukan hal berikut:
    1. Temukan pengguna terkait di penyewa tujuan.
    2. Pastikan lisensi yang valid ditetapkan ke pengguna tujuan di penyewa tujuan.

      Catatan

      Jika pengguna tujuan tidak diberi lisensi apa pun, migrasi akan gagal.

    3. Simpan file CSV yang memiliki pengguna akses penuh dan pengguna akses administratif yang dipetakan.

Migrasi

Sebelum melanjutkan migrasi, pastikan Anda telah meninjau dan menyelesaikan proses persiapan. Setelah Anda menyelesaikan proses persiapan, selesaikan bagian berikut untuk bermigrasi.

Menginstal PowerShell untuk Power Platform administrator (admin sumber dan target)

Modul PowerShell untuk Power Platform Administrator adalah modul PowerShell yang direkomendasikan untuk berinteraksi dengan kemampuan admin. Untuk informasi yang membantu Anda memulai modul PowerShell untuk Power Platform Administrator, buka Mulai menggunakan PowerShell untuk Power Platform Administrator dan Menginstal PowerShell untuk Power Platform Administrator.

Instal atau perbarui modul yang diperlukan dengan menggunakan salah satu perintah berikut:

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

Menginstal Azure PowerShell di Windows (admin sumber dan target)

Modul Azure PowerShell adalah modul rollup. Menginstal modul Azure PowerShell mengunduh modul yang tersedia secara umum dan membuat cmdlet mereka tersedia untuk digunakan. Pelajari selengkapnya di Instal Azure PowerShell di Windows.

Gunakan cmdlet Install-Module untuk menginstal modul Azure PowerShell:

Install-Module -Name Az -Repository PSGallery -Force

Masuk ke ( Microsoft Power Platform baik admin sumber dan target)

Masuk ke dalamnya Microsoft Power Platform. Langkah ini memungkinkan administrator untuk mengautentikasi dan mengakses Power Platform lingkungan.

Add-PowerAppsAccount

Kirim permintaan migrasi (admin sumber)

Untuk memulai migrasi penyewa-ke-penyewa, Dynamics 365 atau Power Platform administrator penyewa sumber harus mengirimkan permintaan ke penyewa target menggunakan perintah berikut dan memberikan ID nama lingkungan dan ID penyewa.

Anda harus memiliki Power Platform kredensial administrator atau administrator Dynamics 365 untuk menyelesaikan langkah ini.

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

Anda dapat melihat status dan MigrationID menggunakan perintah berikut.

TenantToTenant-ViewMigrationRequest

Catatan

Catat MigrationID, yang digunakan dalam perintah migrasi lebih lanjut. MigrationID Penyewa Sumber berbeda dari MigrationID Penyewa Tujuan

Melihat dan menyetujui permintaan migrasi (admin target)

Admin penyewa tujuan harus menjalankan perintah berikut untuk melihat semua permintaan dan status migrasi. Admin dapat meninjau semua permintaan migrasi dan opsi untuk menyetujui atau menolak.

Add-PowerAppsAccount

TenantToTenant-ViewApprovalRequest

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

Setelah permintaan disetujui, admin penyewa tujuan dapat memberi tahu admin penyewa sumber untuk melanjutkan langkah migrasi berikutnya.

Membuat URL tanda tangan akses bersama (SAS) (admin sumber)

Langkah ini melibatkan pembuatan URL SAS, yang kemudian digunakan untuk mengunggah file pemetaan pengguna. Jalankan perintah PowerShell berikut, ganti EnvironmentId dengan ID lingkungan yang sebenarnya.

GenerateResourceStorage-PowerAppEnvironment –EnvironmentName {EnvironmentId}

Penting

Pastikan lingkungan tidak dalamMode Admin dan pengguna memiliki peran Pengguna Dasar yang ditetapkan di lingkungan.

Contoh keluaran

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

Unggah file pemetaan pengguna (admin sumber)

Langkah selanjutnya melibatkan transfer file pemetaan pengguna ke URL SAS yang dibuat sebelumnya. Untuk mencapai ini, jalankan perintah berikut di Windows PowerShell ISE, memastikan bahwa parameter SASUri dan FileToUpload berisi informasi yang sesuai tentang lingkungan Anda. Langkah ini sangat penting untuk mengunggah pemetaan pengguna secara akurat dalam sistem.

Catatan

Penginstalan modul Azure diperlukan untuk menjalankan skrip yang disebutkan. Selesaikan langkah-langkah berikut dengan 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

Menyiapkan migrasi lingkungan (admin sumber)

Langkah berikut melibatkan melakukan validasi komprehensif untuk memastikan bahwa setiap pengguna yang tercantum dalam file pemetaan pengguna diverifikasi dan saat ini aktif dalam penyewa target.

MigrationId dapat dilihat menggunakan perintah "TenantToTenant-ViewMigrationRequest" di penyewa sumber.

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

Catatan

Saat meneruskan nilai SASUri , Anda harus memberikan parameter seperti ini: https://dynamics.blob.core.windows.net/20240604t000000z73e18df430fe40059290dsddc25d783.

Contoh keluaran

Code        : 202
Description : Accepted

Durasi langkah ini bervariasi tergantung pada jumlah pengguna dalam file pemetaan pengguna. Anda dapat memantau kemajuan langkah ini dengan menggunakan perintah TenantToTenant-GetStatus , yang disediakan di bawah ini.

Periksa status (admin sumber)

TenantToTenant-GetMigrationStatus -MigrationId {MigrationId}

Contoh keluaran

  • Memvalidasi Migrasi Penyewa Ke Penyewa: Berjalan
  • Memvalidasi Migrasi Penyewa Ke Penyewa: Berhasil
  • Validasi Gagal, Kesalahan diperbarui pada blob di sini: SASURI

Kesalahan dan cara mengatasinya

  • Jika Anda menerima kesalahan yang mengatakan,File pemetaan pengguna yang disediakan untuk migrasi Penyewa Ke Penyewa tidak valid, periksa apakah nama file pemetaan pengguna sudah benar dan file pemetaan pengguna memiliki koma untuk memisahkan nilai.
  • Baris 'nomor{} baris' memiliki ''{emailID} yang sama: Pastikan tidak ada entri duplikat.
  • Format Email Tidak Valid '{emailid}': Pastikan format email sudah benar testuser@tenantdomain.com.
  • Target online '{linenumber}' sama dengan email sumberId: Pastikan Email Tujuan berbeda dengan Email Sumber.
  • Setiap baris harus memiliki tepat dua kolom: 'nomor{} baris': Pastikan setiap baris hanya memiliki dua kolom: kolom sumber dan tujuan. Hapus koma tambahan, jika ada.

Setelah memperbaiki kesalahan pemetaan pengguna, Anda perlu mengunggah ulang file pemetaan pengguna menggunakan URI SAS yang sama.

Unduh laporan kesalahan (admin sumber)

Jika ada kesalahan dalam file pemetaan pengguna, ada opsi untuk mengunduh laporan kesalahan. Ini dapat dilakukan dengan langsung menyalin dan menempelkan SasUrl yang disediakan dalam perintah Tenant-To-Tenant-GetMigrationStatus atau dengan menggunakan perintah berikut yang menggunakan URI SAS dari status pemeriksaan langkah sebelumnya dan lokasi yang diinginkan untuk mengunduh laporan kesalahan.

Selesaikan langkah-langkah berikut.

  1. Jalankan perintah berikut dengan 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. Perbaiki masalah dalam file pemetaan pengguna.

  3. Upload ulang file menggunakan langkah-langkah dalam Mengupload [file pemetaan pengguna (admin sumber).](#upload-the-user-mapping-file-(source-admin)

Setelah berhasil menyelesaikan Siapkan migrasi lingkungan (admin sumber), Anda dapat melanjutkan dengan prosedur Memigrasikan lingkungan (admin sumber) untuk memigrasikan lingkungan. Lakukan migrasi dalam tujuh hari ke depan. Jika Anda tidak menyelesaikan migrasi dalam tujuh hari ke depan, Anda harus memulai dengan prosedur Siapkan migrasi lingkungan (admin sumber), lagi.

Memigrasikan lingkungan (admin sumber)

MigrationId dapat dilihat menggunakan perintah TenantToTenant-ViewMigrationRequest di penyewa sumber.

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

Dapatkan status (admin sumber)

TenantToTenant-GetMigrationStatus -EnvironmentName {EnvironmentId}

Contoh keluaran

  • Memigrasikan Lingkungan: Berjalan
  • Migrasi Lingkungan: Berhasil

Catatan

Jika Anda mengalami masalah saat menjalankan perintah di atas, kirimkan permintaan dukungan untuk mendapatkan bantuan.

Proses pasca-migrasi

Setelah memindahkan lingkungan ke penyewa lain:

  • URL lingkungan, ID organisasi (OrgID), dan nama tidak berubah.
  • Lingkungan sumber tidak memilikinya Dataverse.
  • Pengguna yang tidak disertakan dalam file pemetaan tidak akan dimigrasikan dan dipetakan pasca-migrasi.

Selesaikan prosedur berikut untuk Power Automate, Power Apps,, Copilot Studio. Power Pages

Proses pasca-migrasi untuk Power Automate

Setelah migrasi selesai, langkah-langkah melalui bagian Tinjau komponen sebagai daftar periksa untuk menyesuaikan dan mengaktifkan alur dan komponen lainnya. Langkah-langkah kuncinya adalah:

  1. Buat koneksi untuk semua referensi koneksi.
  2. Mulai semua alur, termasuk memulai alur turunan sebelum alur induk.
  3. Untuk alur yang dipicu HTTP, ambil URL baru dan tempatkan di aplikasi atau alur panggilan apa pun untuk menyegarkan referensi tersebut.

Proses pasca-migrasi untuk Power Apps

Untuk aplikasi sadar solusi:

  1. Pilih lingkungan baru dari dan Power Apps navigasikan ke halaman Solusi .
  2. Pilih Impor dan gunakan pemilih file untuk memilih paket yang diekspor dari langkah di atas.
  3. Konfirmasikan bahwa impor berhasil diselesaikan dengan memeriksa konten solusi dari lingkungan yang dimigrasikan.

Untuk aplikasi yang tidak sadar solusi:

  1. Membuka Power Apps.
  2. Pilih lingkungan baru dari daftar dropdown lingkungan.
  3. Pilih Aplikasi.
  4. Pilih impor aplikasi Canvas.
  5. unggah file paket aplikasi.
  6. Lengkapi semua pilihan impor, lalu pilih Impor.
  7. Ulangi langkah ini hingga semua aplikasi diimpor.

Proses pasca-migrasi untuk Copilot Studio

  1. Pilih lingkungan baru dari dan Power Apps navigasikan ke halaman Solusi .
  2. Pilih Impor dan gunakan pemilih file untuk memilih paket yang diekspor dari langkah di atas.
  3. Konfirmasikan bahwa impor berhasil diselesaikan dengan memeriksa konten solusi dari lingkungan yang dimigrasikan.

Proses pasca-migrasi untuk Power Pages

Langkah-langkah berikut harus diselesaikan untuk setiap situs web di lingkungan.

  1. Masuk ke lingkungan.
  2. Buka pusat admin.
  3. Sediakan situs web dengan jenis portal dan bahasa yang sama.

Setelah menyelesaikan semua langkah dan migrasi di atas, Anda dapat memvalidasi lingkungan di penyewa target dan nantinya Anda dapat menghapus lingkungan sumber di pusat admin Power platform.

Tanya jawab

Apakah operasi latar belakang diaktifkan selama migrasi penyewa ke penyewa? Mode administrasi diaktifkan selama migrasi penyewa ke penyewa, oleh karena itu operasi latar belakang tidak berjalan. Pelajari lebih lanjut dalam mode Administrasi.

Bisakah kita memigrasikan semua pengguna Dataverse organisasi? Kami dapat memigrasikan semua pengguna Dataverse organisasi hanya jika pengguna ada di penyewa tujuan. Contoh:

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