Menambahkan anggota grup secara massal di ID Microsoft Entra

Ikhtisar

Anda dapat menambahkan beberapa anggota ke grup dengan menggunakan file nilai yang dipisahkan koma (CSV) untuk mengimpor anggota grup secara massal di portal Microsoft Entra ID.

Memahami templat CSV

Unduh dan isi templat CSV unggahan massal untuk berhasil menambahkan anggota grup Microsoft Entra secara massal. Gunakan templat yang Anda unduh untuk operasi impor anggota grup. Templat anggota grup saat ini dimulai dengan tajuk kolom, bukan dengan baris version:v1.0.

Struktur templat CSV

Baris dalam templat CSV yang diunduh adalah:

• Tajuk kolom: Pertahankan tajuk kolom lengkap yang diunduh tetap sama persis. Nama properti dalam tanda kurung hanyalah salah satu bagian dari tajuk, jadi jangan mengganti seluruh tajuk hanya dengan memberObjectIdOrUpn. Header impor anggota grup saat ini adalah Member object ID or user principal name [memberObjectIdOrUpn] Required. Untuk perubahan keanggotaan grup, Anda dapat menggunakan ID objek anggota atau nama prinsipal pengguna (UPN) di baris di bawah header ini.
• Contoh baris: Jika templat menyertakan baris nilai contoh, seperti Example: 9832aad8-e4fe-496b-a604-95c6eF01ae75, hapus baris contoh dan ganti dengan entri Anda sendiri.

Catatan

Format templat CSV bervariasi menurut operasi. Beberapa templat, seperti membuat atau menghapus pengguna secara massal, termasuk version:v1.0 sebagai baris pertama. Templat lain, seperti operasi anggota grup, diawali dengan tajuk kolom. Unduh templat untuk operasi spesifik Anda dari portal. Jangan tambahkan baris versi atau baris lain yang tidak ada dalam templat yang diunduh. Pertahankan baris versi dan baris header kolom apa pun tidak berubah.

Panduan lainnya

• Pertahankan baris versi dan baris header kolom apa pun di templat unggahan persis seperti yang diunduh, atau unggahan tidak dapat diproses.
• Kolom yang wajib diisi dicantumkan terlebih dahulu.
• Kami tidak menyarankan untuk menambahkan kolom baru ke templat. Kolom tambahan apa pun yang Anda tambahkan diabaikan dan tidak diproses.
• Kami menyarankan agar Anda mengunduh template CSV versi terbaru sesering mungkin.

• Tambahkan setidaknya dua UPN atau ID objek agar berhasil mengunggah file.
• Masukkan satu anggota per baris. Jangan gunakan titik koma atau pemisah lain untuk memisahkan beberapa anggota dalam satu baris.

Contoh file CSV

Berikut adalah contoh file CSV lengkap yang siap diunggah, cocok dengan format templat impor anggota grup saat ini. Contoh ini menggunakan nama prinsipal pengguna (UPN):

Member object ID or user principal name [memberObjectIdOrUpn] Required
alain@contoso.com
isabella@contoso.com
joseph@contoso.com
chaya@contoso.com

Atau, Anda dapat menggunakan ID objek alih-alih UPN:

Member object ID or user principal name [memberObjectIdOrUpn] Required
00aa00aa-bb11-cc22-dd33-44ee44ee44ee
11bb11bb-cc22-dd33-ee44-55ff55ff55ff
22cc22cc-dd33-ee44-ff55-66aa66aa66aa

Tip

Untuk menemukan ID objek pengguna, bukaPengguna>Identitas>Semua pengguna, pilih pengguna, dan salin ID Objek dari halaman profil pengguna.

Mengimpor anggota grup secara massal

1. Masuk ke pusat admin Microsoft Entra sebagai minimal seorang Administrator Grup.

2. Navigasikan ke Identitas.

   Catatan

   Pemilik grup juga dapat mengimpor anggota grup yang mereka miliki secara massal.

3. Pilih Grup>Semua grup.

4. Buka grup tempat Anda menambahkan anggota, lalu pilih Anggota.

5. Pada halaman Anggota, pilih Operasi massal kemudian pilih Impor anggota.

6. Di halaman Impor massal anggota grup, pilih Unduh untuk mendapatkan templat file CSV dengan properti anggota grup yang diperlukan.

   

7. Buka file CSV dan tambahkan baris untuk setiap anggota grup yang ingin Anda impor ke dalam grup. Untuk setiap anggota, masukkan Nama prinsipal pengguna (UPN, seperti user@contoso.com) atau ID Objek mereka (GUID seperti aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb). Masukkan satu anggota per baris. Kemudian simpan file tersebut.

8. Di halaman Impor massal anggota grup, pada bagian Unggah file csv Anda, pilih file tersebut. Saat Anda memilih file, validasi file .csv dimulai.

9. Saat konten file divalidasi, halaman impor massal menampilkan File yang berhasil diunggah. Jika ada kesalahan, Anda harus memperbaikinya sebelum dapat mengirimkan pekerjaan tersebut.

10. Saat file Anda melewati validasi, pilih Kirim untuk memulai operasi massal yang mengimpor anggota grup ke grup.

11. Ketika operasi impor selesai, pemberitahuan menyatakan bahwa operasi massal berhasil.

Jika Anda mengalami kesalahan, Anda dapat mengunduh dan melihat file hasil di halaman Hasil operasi massal. File berisi alasan untuk setiap kesalahan. Pengiriman file harus sesuai dengan templat yang disediakan dan menyertakan nama kolom yang tepat.

Untuk informasi selengkapnya tentang batasan operasi massal, lihat Batas layanan impor massal.

Memeriksa status impor

Anda dapat melihat status semua permintaan massal yang tertunda di halaman Hasil operasi massal .

1. Arahkan ke Identitas>Pengguna>Hasil operasi massal.

2. Temukan operasi massal Anda dalam daftar. Kolom Status memperlihatkan apakah operasi Sedang Berlangsung, Berhasil, atau Gagal.

   

Untuk mengetahui detail tentang setiap item baris dalam operasi massal, pilih nilai di bagian kolom # Berhasil, # Gagal, atau Permintaan Total. Jika kegagalan terjadi, alasan kegagalan dicantumkan.

Mengunduh file hasil

Untuk mengunduh hasil terperinci:

1. Pada halaman Hasil operasi massal , pilih operasi yang ingin Anda tinjau.
2. Pilih Unduh untuk mendapatkan file CSV yang berisi status setiap baris dari unggahan asli Anda.
3. Buka file CSV untuk melihat anggota mana yang berhasil ditambahkan dan mana yang gagal, bersama dengan pesan kesalahan tertentu.

Kesalahan umum meliputi:

• Anggota tidak ditemukan: UPN atau ID objek tidak ada di direktori Anda.
• Anggota sudah ada: Pengguna sudah menjadi anggota grup.
• Format tidak valid: Format UPN atau ID objek salah.

Batas layanan impor massal

Catatan

Saat melakukan operasi massal, seperti mengimpor atau membuat, Anda dapat mengalami masalah jika operasi massal tidak selesai dalam satu jam. Untuk mengatasi masalah ini, sebaiknya pisahkan jumlah rekaman yang diproses per batch. Misalnya, sebelum memulai ekspor, Anda dapat membatasi hasil yang ditetapkan dengan memfilter jenis grup atau nama pengguna untuk mengurangi ukuran hasil. Dengan menyempurnakan filter Anda, pada dasarnya Anda membatasi data yang dikembalikan oleh operasi besar-besaran. Untuk informasi selengkapnya, lihat Batasan layanan operasi massal.

Langkah berikutnya

• Menghapus anggota grup secara massal
• Mengunduh anggota grup
• Mengunduh daftar semua grup