Mengimpor dan mengekspor pengaturan konfigurasi Microsoft Entra Connect

Penyebaran Microsoft Entra Connect bervariasi mulai dari instalasi mode Ekspres untuk satu forest hingga penyebaran kompleks yang disinkronkan di beberapa forest menggunakan aturan sinkronisasi kustom. Karena banyaknya opsi dan mekanisme konfigurasi, penting untuk memahami pengaturan apa yang berlaku dan dapat dengan cepat menyebarkan server dengan konfigurasi yang identik. Fitur ini memperkenalkan kemampuan untuk membuat katalog konfigurasi server sinkronisasi tertentu dan mengimpor pengaturan ke penyebaran baru. Anda dapat membandingkan rekam jepret pengaturan sinkronisasi yang berbeda untuk dengan mudah memvisualisasikan perbedaan antara dua server atau server yang sama dari waktu ke waktu.

Setiap kali konfigurasi diubah dari wizard Microsoft Entra Connect, file pengaturan JSON bertanda waktu baru secara otomatis diekspor ke %ProgramData%\AADConnect. Nama file pengaturan adalah formulir Applied-SynchronizationPolicy-*.JSON, di mana bagian terakhir dari nama file adalah stempel waktu.

Penting

Hanya perubahan yang dibuat oleh Microsoft Entra Connect yang diekspor secara otomatis. Setiap perubahan yang dilakukan dengan menggunakan PowerShell, Synchronization Service Manager, atau Synchronization Rules Editor harus diekspor sesuai permintaan jika diperlukan untuk mempertahankan salinan terbaru. Anda juga dapat menggunakan ekspor sesuai permintaan untuk menempatkan salinan pengaturan di lokasi yang aman untuk tujuan pemulihan bencana.

Anda tidak dapat menggunakan fitur ini jika penginstalan Microsoft Entra Connect dimodifikasi untuk menyertakan konektor G-SQL atau konektor G-LDAP. Anda juga tidak dapat menggabungkan fitur ini saat menggunakan database Sinkronisasi Microsoft Entra Connect yang sudah ada. Penggunaan konfigurasi impor/ekspor dan menggunakan database yang ada saling eksklusif.

Mengekspor pengaturan Microsoft Entra Connect

Untuk melihat ringkasan pengaturan konfigurasi Anda, buka alat Microsoft Entra Connect, dan pilih tugas bernama Tampilkan atau Ekspor Konfigurasi Saat Ini. Ringkasan singkat pengaturan Anda diperlihatkan bersama dengan kemampuan untuk mengekspor konfigurasi penuh server Anda.

Secara default, pengaturan diekspor ke %ProgramData%\AADConnect. Anda juga dapat memilih untuk menyimpan pengaturan ke lokasi yang dilindungi untuk memastikan ketersediaan jika bencana terjadi. Pengaturan diekspor dengan menggunakan format file JSON dan tidak boleh dibuat atau diedit dengan tangan untuk memastikan konsistensi logis. Mengimpor file yang dibuat dengan tangan atau diedit tidak didukung dan mungkin menyebabkan hasil yang tidak terduga.

Mengimpor pengaturan Microsoft Entra Connect

Untuk mengimpor pengaturan yang diekspor sebelumnya:

Instal Microsoft Entra Connect di server baru.
Setelah halaman Selamat Datang , pilih opsi Kustomisasi .
Pilih Mengimpor pengaturan sinkronisasi. Telusuri file pengaturan JSON yang diekspor sebelumnya.
Pilih Instal.

Ambil alih pengaturan pada halaman ini seperti penggunaan SQL Server alih-alih LocalDB atau penggunaan akun layanan yang ada alih-alih akun layanan virtual default. Pengaturan ini tidak diimpor dari file pengaturan konfigurasi. Mereka ada di sana untuk tujuan informasi dan perbandingan.

Mengubah file JSON yang diekspor untuk mengubah konfigurasi tidak didukung.

Pengalaman instalasi impor

Pengalaman penginstalan impor sengaja dibuat sederhana dengan masukan minimal dari pengguna untuk menyediakan kemampuan reproduksi server yang ada dengan mudah.

Bagian berikut menunjukkan perubahan yang dapat Anda buat selama pengalaman penginstalan. Semua perubahan lain harus dilakukan setelah penginstalan dari wizard Microsoft Entra Connect:

Kredensial Microsoft Entra: Nama akun untuk administrator yang digunakan untuk mengonfigurasi server asli disarankan secara default. Ini harus diubah jika Anda ingin menyinkronkan informasi ke direktori baru.
Masuk pengguna: Opsi masuk yang dikonfigurasi untuk server asli Anda dipilih secara default dan secara otomatis meminta informasi masuk atau informasi lain yang diperlukan selama konfigurasi. Dalam kasus yang jarang terjadi, Anda mungkin perlu menyiapkan server dengan opsi yang berbeda untuk menghindari perubahan perilaku server aktif. Jika tidak, pilih Berikutnya untuk menggunakan pengaturan yang sama.
Kredensial direktori lokal: Untuk setiap direktori lokal yang disertakan dalam pengaturan sinkronisasi, Anda harus memberikan kredensial untuk membuat akun sinkronisasi atau menyediakan akun sinkronisasi kustom yang dibuat sebelumnya. Prosedur ini identik dengan pengalaman penginstalan bersih dengan pengecualian bahwa Anda tidak dapat menambah atau menghapus direktori.
Opsi konfigurasi: Seperti halnya penginstalan bersih, Anda dapat memilih untuk mengonfigurasi pengaturan awal apakah akan memulai sinkronisasi otomatis atau mengaktifkan Mode Penahapan. Perbedaan utamanya adalah bahwa mode Penahapan sengaja diaktifkan secara default untuk memungkinkan perbandingan konfigurasi dan hasil sinkronisasi sebelum secara aktif mengekspor hasilnya ke ID Microsoft Entra.

Cuplikan layar yang memperlihatkan layar Sambungkan direktori Anda.

Hanya satu server sinkronisasi yang dapat berada dalam peran utama dan secara aktif mengekspor perubahan konfigurasi ke ID Microsoft Entra. Semua server lain harus ditempatkan dalam mode Staging.

Melakukan migrasi pengaturan dari server yang ada

Jika server yang ada tidak mendukung manajemen pengaturan, Anda dapat memilih untuk memutakhirkan server di tempat atau memigrasikan pengaturan untuk digunakan di server penahapan baru.

Migrasi memerlukan menjalankan skrip PowerShell yang mengekstrak pengaturan yang ada untuk digunakan dalam penginstalan baru. Gunakan metode ini untuk menganalogikan pengaturan server Anda yang ada lalu terapkan ke server penahapan yang baru dipasang. Membandingkan pengaturan untuk server asli dengan server yang baru dibuat dengan cepat memvisualisasikan perubahan antar server. Seperti biasa, ikuti proses sertifikasi organisasi Anda untuk memastikan bahwa tidak ada konfigurasi lain yang diperlukan.

Proses migrasi

Untuk memigrasikan pengaturan:

Mulai AzureADConnect.msi di server penahapan baru, dan berhenti di halaman Selamat Datang Microsoft Entra Connect.
Salin MigrateSettings.ps1 dari direktori Microsoft Entra Connect\Tools ke lokasi di server yang ada. Contohnya adalah C:\setup, yang merupakan direktori yang dibuat di server yang ada.

Jika Anda melihat kesalahan Message: A positional parameter cannot be found that accepts argument 'True'.:

Kemudian edit MigrateSettings.ps1 file dan hapus $true dan jalankan skrip:
Jalankan skrip seperti yang ditunjukkan pada cuplikan layar berikut, dan simpan seluruh direktori konfigurasi server downlevel. Salin direktori ini ke server penahapan baru. Anda harus menyalin seluruh Exported-ServerConfiguration-* folder ke server baru.
Mulai Microsoft Entra Connect dengan mengklik dua kali ikon di desktop. Terima Syarat Lisensi Perangkat Lunak Microsoft, dan pada halaman berikutnya, pilih Kustomisasi.
Pilih kotak centang Impor pengaturan sinkronisasi . Pilih Telusuri untuk menelusuri folder yang disalin Exported-ServerConfiguration-* . Pilih MigratedPolicy.json untuk mengimpor pengaturan yang dimigrasikan.

Verifikasi pasca penginstalan

Membandingkan file pengaturan yang awalnya diimpor dengan file pengaturan yang diekspor dari server yang baru diterapkan adalah langkah penting dalam memahami perbedaan antara penyebaran yang dimaksudkan versus yang dihasilkan. Menggunakan aplikasi perbandingan teks berdampingan favorit Anda menghasilkan visualisasi instan yang dengan cepat menyoroti perubahan yang diinginkan atau tidak disengaja.

Meskipun banyak langkah konfigurasi yang sebelumnya manual sekarang dihilangkan, Anda masih harus mengikuti proses sertifikasi organisasi Anda untuk memastikan bahwa tidak ada konfigurasi lain yang diperlukan. Konfigurasi ini mungkin terjadi jika Anda menggunakan pengaturan tingkat lanjut, yang saat ini tidak diambil dalam rilis manajemen pengaturan ini.

Batasan berikut diketahui:

Aturan sinkronisasi: Prioritas aturan kustom harus dalam rentang 0 hingga 99 yang dicadangkan untuk menghindari konflik dengan aturan standar Microsoft. Menempatkan aturan kustom di luar rentang yang telah dipesan dapat menyebabkan aturan kustom Anda dipindahkan saat aturan standar ditambahkan ke dalam konfigurasi. Masalah serupa terjadi jika konfigurasi Anda berisi aturan standar yang dimodifikasi. Memodifikasi aturan standar tidak disarankan, dan penempatan aturan kemungkinan besar salah.
Penulisan ulang perangkat: Pengaturan ini dikatalogkan. Saat ini tidak digunakan selama konfigurasi. Jika fitur tulis balik perangkat diaktifkan untuk server asli, Anda harus mengonfigurasi fitur tersebut secara manual pada server baru yang diterapkan.
Jenis objek yang disinkronkan: Meskipun dimungkinkan untuk membatasi daftar jenis objek yang disinkronkan (seperti pengguna, kontak, dan grup) dengan menggunakan Synchronization Service Manager, fitur ini saat ini tidak didukung melalui pengaturan sinkronisasi. Setelah menyelesaikan penginstalan, Anda harus menerapkan kembali konfigurasi tingkat lanjut secara manual.
Atribut yang dipilih: Meskipun dimungkinkan untuk membatasi daftar atribut yang disinkronkan (seperti atribut ekstensi) dengan menggunakan Synchronization Service Manager, fitur ini saat ini tidak didukung melalui pengaturan sinkronisasi. Setelah menyelesaikan penginstalan, Anda harus menerapkan kembali konfigurasi tingkat lanjut secara manual.
Profil yang dijalankan kustom: Meskipun Anda dapat mengubah kumpulan profil jalankan default dengan menggunakan Synchronization Service Manager, fitur ini saat ini tidak didukung melalui pengaturan sinkronisasi. Setelah menyelesaikan penginstalan, Anda harus menerapkan kembali konfigurasi tingkat lanjut secara manual.
Mengonfigurasi hierarki provisi: Fitur tingkat lanjut dari Synchronization Service Manager ini tidak didukung melalui pengaturan sinkronisasi. Ini harus dikonfigurasi ulang secara manual setelah Anda menyelesaikan penyebaran awal.
Layanan Federasi Direktori Aktif dan autentikasi PingFederate: Metode masuk yang terkait dengan fitur autentikasi ini secara otomatis dipilih sebelumnya. Anda harus secara interaktif menyediakan semua parameter konfigurasi lain yang diperlukan.

Saran dan Komentar

Apakah halaman ini membantu?

Terakhir diperbarui pada 2025-06-25