M365Con 2027 – konferensi online gratis · 11–22 Jan 2027 · 120 sessions→ m365con.net

Blog · Mirko Peters

Cara Membuat Laporan Grup Peran Microsoft Purview dengan PowerShell

By · · Updated

Gunakan PowerShell untuk membuat laporan izin grup peran Microsoft Purview Anda. Audit kepatuhan, ediscovery, & Microsoft 365 dengan panduan ini.

Automatically translated with AI from the original post. Read the English original

Mengelola grup peran di Purview sangat penting untuk menjaga keamanan dan kepatuhan di dalam organisasi Anda. Anda dapat menyederhanakan proses ini dengan memanfaatkan PowerShell, yang mengotomatiskan tugas dan menghemat waktu. Dengan PowerShell, Anda dapat dengan mudah membuat laporan yang merinci keanggotaan grup peran di Purview. Panduan ini akan memandu Anda melalui langkah-langkah yang diperlukan untuk terhubung ke Purview dan membuat laporan Anda secara efektif.

Poin Penting

7 Fakta Mengejutkan tentang Laporan Grup Peran Microsoft Purview

Prasyarat untuk PowerShell

Prerequisites for PowerShell

Izin yang Diperlukan

Sebelum Anda mulai menggunakan PowerShell untuk membuat laporan di Purview, pastikan Anda memiliki izin yang diperlukan. Anda harus memiliki akses administratif ke Purview. Akses ini memungkinkan Anda melihat dan mengelola grup peran secara efektif. Tanpa izin ini, Anda mungkin mengalami kesalahan saat menjalankan skrip atau mengambil data.

Instalasi PowerShell

Untuk menjalankan skrip PowerShell, Anda harus memiliki PowerShell terinstal di komputer Anda. Versi minimum yang diperlukan adalah 5.1. Jika belum terinstal, Anda dapat mengunduhnya dari situs resmi Microsoft. Selain itu, Anda memerlukan modul tertentu untuk terhubung ke Microsoft Purview. Modul yang diperlukan adalah CAMP dan AIPService.

Berikut daftar periksa singkat untuk memastikan Anda memenuhi prasyarat:

Dengan memenuhi prasyarat ini, Anda siap menghasilkan laporan grup peran Purview dengan lancar.

Ringkasan Langkah

  1. Verifikasi versi PowerShell Anda.
  2. Instal modul yang diperlukan.
  3. Pastikan akses administratif Anda di Purview.

Dengan mengikuti langkah-langkah ini, Anda siap menggunakan PowerShell secara efektif untuk kebutuhan pelaporan Anda.

Hubungkan ke Microsoft Purview

Siapkan Koneksi

Untuk terhubung ke Microsoft Purview menggunakan PowerShell, ikuti langkah-langkah berikut:

  1. Pastikan Anda memiliki langganan Azure: Anda memerlukan langganan Azure yang valid dan penyewa Microsoft Entra yang tertaut dengannya.
  2. Masuk ke portal Azure: Gunakan kredensial akun Azure Anda untuk mengakses portal.
  3. Instal Azure PowerShell atau Azure CLI: Pastikan alat yang diperlukan sudah terpasang di komputer klien Anda.
  4. Buat grup sumber daya: Jika Anda belum memilikinya, jalankan perintah berikut:
    New-AzResourceGroup -Name myResourceGroup -Location 'East US'
    
  5. Buat atau terapkan akun Microsoft Purview: Gunakan perintah ini untuk menyiapkan akun Purview Anda:
    New-AzPurviewAccount
    

Dengan mengikuti langkah-langkah ini, Anda dapat membangun koneksi yang aman ke Microsoft Purview.

Autentikasi Kredensial

Setelah menyiapkan koneksi, Anda perlu mengautentikasi kredensial Anda. Berikut caranya:

  1. Buka PowerShell: Jalankan PowerShell di komputer Anda.
  2. Jalankan perintah login: Gunakan perintah berikut untuk masuk:
    Connect-AzAccount
    
    Perintah ini akan meminta Anda memasukkan kredensial akun Azure Anda.
  3. Verifikasi koneksi Anda: Setelah masuk, periksa apakah Anda memiliki akses ke akun Purview dengan menjalankan:
    Get-AzPurviewAccount
    

Jika Anda menemui masalah selama proses koneksi, perhatikan kesalahan umum berikut:

Dengan mengikuti langkah-langkah ini, Anda dapat berhasil terhubung ke Microsoft Purview dan mengautentikasi kredensial Anda, sehingga siap untuk menghasilkan laporan grup peran Anda.

Hasilkan Laporan Grup Peran Purview

Generate Purview Role Group Report

Skrip PowerShell untuk Laporan Keanggotaan

Untuk menghasilkan laporan grup peran Purview, Anda dapat menggunakan skrip PowerShell berikut. Skrip ini terhubung ke Microsoft Graph dan mengambil keanggotaan grup peran. Ikuti langkah-langkah berikut untuk membuat laporan Anda:

  1. Hubungkan ke Microsoft Graph: Gunakan cakupan (scope) yang diperlukan untuk mengakses data yang dibutuhkan.
  2. Hubungkan ke Exchange Online: Pastikan Anda memiliki akses ke endpoint keamanan dan kepatuhan.
  3. Ambil Grup Peran: Jalankan cmdlet Get-RoleGroup untuk menemukan semua grup peran di penyewa Anda.
  4. Hitung Keanggotaan: Untuk setiap grup peran, identifikasi keanggotaan saat ini. Bedakan antara berbagai jenis objek Entra ID.
  5. Perbarui Daftar PowerShell: Buat daftar untuk menyimpan detail setiap penugasan peran dan keanggotaan grup peran.
  6. Identifikasi Pengenal Unik: Temukan pengenal unik yang memiliki penugasan peran, seperti pengguna atau service principal.
  7. Kumpulkan Detail Objek: Untuk setiap pengenal unik, kumpulkan detail tambahan seperti departemen dan negara.
  8. Urutkan Informasi: Atur informasi penugasan pengguna berdasarkan jenis objek dan nama agar lebih mudah dilaporkan.
  9. Hasilkan Laporan HTML: Buat laporan HTML yang mencakup detail setiap grup peran aktif beserta keanggotaannya.

Berikut contoh skrip PowerShell yang menerapkan langkah-langkah tersebut:

# Connect to Microsoft Graph
Connect-MgGraph -Scopes "Group.Read.All"

# Get role groups
$roleGroups = Get-RoleGroup

# Initialize lists
$roleGroupMemberships = @()

foreach ($group in $roleGroups) {
    $members = Get-RbacGroupMember -GroupId $group.Id
    foreach ($member in $members) {
        $roleGroupMemberships += [PSCustomObject]@{
            RoleGroupName = $group.DisplayName
            MemberName    = $member.DisplayName
            MemberType    = $member.ObjectType
        }
    }
}

# Generate HTML report
$roleGroupMemberships | ConvertTo-Html -Property RoleGroupName, MemberName, MemberType -Title "Purview Role Group Membership Report" | Out-File "PurviewRoleGroupReport.html"

Skrip ini akan membantu Anda menghasilkan laporan komprehensif tentang keanggotaan grup peran di Purview.

Memahami Data Output

Setelah menjalankan skrip PowerShell, Anda akan menerima laporan HTML yang merinci keanggotaan grup peran. Berikut cara membaca data output tersebut:

Dengan menganalisis data ini, Anda dapat memperoleh wawasan tentang keanggotaan grup peran di dalam organisasi Anda. Informasi ini sangat penting untuk memastikan kontrol akses berbasis peran (RBAC) berjalan dengan benar dan menjaga kepatuhan keamanan.

Perlu diingat bahwa keakuratan keanggotaan yang ditampilkan dalam laporan bergantung pada kondisi terkini lingkungan Purview Anda. Memperbarui skrip dan laporan secara berkala akan membantu Anda tetap mengetahui setiap perubahan pada keanggotaan grup peran.

Praktik Terbaik untuk Pelaporan

Jadwalkan Laporan Rutin

Untuk menjaga kepatuhan dan keamanan, Anda sebaiknya menjadwalkan laporan rutin tentang grup peran Purview. Pelaporan rutin membantu Anda tetap mengetahui siapa yang memegang peran kepatuhan dan memastikan organisasi Anda mematuhi kebijakan keamanan. Berikut beberapa langkah untuk menjadwalkan laporan ini secara efektif:

  1. Gunakan Cmdlet PowerShell: Manfaatkan cmdlet PowerShell untuk mengotomatiskan proses pembuatan laporan. Anda dapat membuat skrip yang berjalan pada interval tertentu.
  2. Atur Task Scheduler: Gunakan Windows Task Scheduler untuk menjalankan skrip PowerShell Anda secara otomatis. Dengan cara ini, Anda menerima laporan terbaru tanpa intervensi manual.
  3. Pilih Format Laporan: Simpan laporan Anda dalam format yang aman, seperti .PDF. Format ini melindungi informasi sensitif dan memudahkan pembagian kepada pengguna yang berwenang.

Tip: Selalu terapkan prinsip hak akses minimum saat memberikan akses ke laporan. Langkah ini meminimalkan risiko akses tidak sah.

Analisis Data Laporan

Setelah Anda membuat laporan, menganalisis datanya menjadi hal yang sangat penting. Memahami keanggotaan grup peran kepatuhan membantu Anda mengidentifikasi potensi risiko keamanan. Berikut beberapa strategi untuk analisis yang efektif:

Dengan mengikuti praktik terbaik ini, Anda dapat meningkatkan proses pelaporan dan memastikan organisasi Anda tetap patuh terhadap standar kepatuhan Microsoft 365.


Dalam panduan ini, Anda telah mempelajari cara membuat laporan grup peran Purview menggunakan PowerShell. Anda terhubung ke Microsoft Purview, melakukan autentikasi kredensial, dan menjalankan skrip PowerShell untuk mengambil keanggotaan grup peran.

Pelaporan rutin sangat penting untuk menjaga keamanan dan kepatuhan. Pelaporan ini membantu Anda memantau akses dan mengidentifikasi potensi risiko.

Saya mendorong Anda untuk mengintegrasikan proses ini ke dalam alur kerja Anda. Dengan demikian, postur keamanan organisasi Anda akan semakin kuat dan kepatuhan terhadap standar industri tetap terjaga.

Pertanyaan Umum

Apa itu Microsoft Purview?

Microsoft Purview adalah solusi tata kelola data terpadu yang membantu Anda mengelola dan melindungi data di berbagai lingkungan. Solusi ini menyediakan alat untuk penemuan data, klasifikasi, dan kepatuhan.

Mengapa menggunakan PowerShell untuk laporan Purview?

Menggunakan PowerShell mengotomatiskan proses pembuatan laporan, menghemat waktu, dan mengurangi kesalahan manual. Cara ini memungkinkan Anda mengambil dan mengelola keanggotaan grup peran di Purview secara efisien.

Seberapa sering saya harus membuat laporan role group Purview?

Anda sebaiknya membuat laporan role group Purview secara rutin, idealnya setiap bulan atau setiap kuartal. Praktik ini membantu Anda memantau akses dan menjaga kepatuhan terhadap kebijakan keamanan.

Bagaimana jika saya menemui error saat menjalankan skrip PowerShell?

Jika Anda menemui error, periksa izin Anda, pastikan semua modul yang diperlukan sudah terpasang, dan verifikasi koneksi Anda ke Microsoft Purview. Tinjau pesan error untuk mendapatkan panduan yang lebih spesifik.

Bisakah saya menyesuaikan format laporan?

Bisa. Anda dapat menyesuaikan format laporan dengan mengubah skrip PowerShell agar menghasilkan output dalam format lain, misalnya file CSV atau PDF, sesuai kebutuhan Anda.

portal purview dan purview compliance

Pertanyaan Umum ini berfokus pada pembuatan laporan role group Purview dengan PowerShell serta menjelaskan izin terkait, manajemen peran, dan auditing di Microsoft Purview dan Microsoft 365.

modul powershell, izin microsoft purview, dan peran rbac purview

Panduan ini mencakup penggunaan modul PowerShell dan Microsoft Graph PowerShell SDK untuk menampilkan anggota role group, memeriksa definisi peran bawaan, dan membuat laporan untuk skenario kepatuhan serta eDiscovery.

Apa itu laporan role group Purview dengan PowerShell dan mengapa saya perlu membuatnya?

Laporan role group Purview dengan PowerShell adalah daftar hasil generate (CSV atau JSON) yang berisi role group, penetapan peran (peran RBAC Purview dan pemetaan peran bawaan), serta anggota role group di seluruh solusi Microsoft Purview dan layanan Microsoft 365. Anda membuat laporan ini untuk mengaudit izin peran, memastikan siapa yang memiliki akses peran istimewa (peran global administrator atau peran administrator), mendukung tinjauan kepatuhan, kasus eDiscovery, atau untuk diumpankan ke proses change control dan tinjauan izin manajemen risiko insider.

Modul PowerShell mana yang digunakan untuk membuat laporan role group Microsoft Purview?

Gunakan kombinasi modul sesuai lingkungan Anda: Microsoft Graph PowerShell SDK untuk melakukan query terhadap penetapan peran portal Microsoft Purview dan anggota role group, serta Exchange Online Management Module atau modul Security & Compliance untuk beberapa role group khusus Microsoft 365 dan eDiscovery. Microsoft kadang mendokumentasikan contoh di Microsoft Learn untuk tugas-tugas data Purview dan portal compliance Purview.

Izin apa yang saya butuhkan untuk menjalankan laporan role group Purview dengan PowerShell?

Biasanya Anda memerlukan peran tingkat tinggi, seperti peran global administrator atau peran delegated administrator dengan kemampuan manajemen peran, atau izin khusus Microsoft Purview, seperti peran administratif di portal Purview (peran istimewa atau peran administrator). Untuk beberapa query, Anda mungkin perlu menjadi anggota role group Organization Management atau role group eDiscovery Manager. Pastikan Anda sudah memberikan persetujuan (consent) untuk izin Graph saat menggunakan Microsoft Graph PowerShell SDK guna membaca penetapan peran dan entri audit log.

Bagaimana cara menampilkan anggota role group dan perannya menggunakan Microsoft Graph PowerShell SDK?

Lakukan autentikasi dengan izin delegated atau app yang mencakup roleManagement.read.* dan Directory.Read.All, lalu lakukan query pada roleDefinitions dan roleAssignments untuk memetakan peran RBAC Purview ke role group serta menghitung anggota role group. Ekspor hasilnya ke CSV untuk membuat laporan. Untuk grup khusus Exchange Online, seperti role group eDiscovery Manager, Anda mungkin memerlukan Exchange Online Management Module untuk menampilkan anggota role group dan hak istimewa pencarian konten.

Bisakah saya menyertakan peran eDiscovery dan information protection dalam laporan yang sama?

Bisa. Gabungkan data dari portal Microsoft Purview (untuk solusi Microsoft Purview dan peran Microsoft Purview Data), layanan Microsoft 365 (pencarian konten, kasus eDiscovery, peran eDiscovery Manager, dan role group eDiscovery Manager), serta penetapan Microsoft Information Protection. Gunakan beberapa modul PowerShell atau query Graph untuk mengagregasi izin peran, lalu normalisasi dan ekspor sebagai satu laporan.

Bagaimana cara mengaudit perubahan pada role group dan melacak izin peran dari waktu ke waktu?

Gunakan audit log serta event sign-in dan audit Azure AD (Microsoft Entra / Microsoft Entra ID) yang dapat diakses melalui Microsoft Graph PowerShell SDK atau API auditing di portal compliance Purview. Jadwalkan ekspor berkala atas penetapan peran dan daftar anggota role group untuk mendeteksi perubahan. Menyimpan snapshot historis memungkinkan deteksi drift dan mendukung pengumpulan bukti kepatuhan.

Apa saja batasan peran bawaan yang perlu saya waspadai dalam laporan grup peran Purview?

Definisi peran bawaan bisa sangat luas (misalnya, Global Administrator, Compliance Administrator) dan dapat memberikan akses lintas kepatuhan Purview, operasi purge, atau data istimewa. Laporan sebaiknya menyoroti tumpang tindih peran bawaan, grup peran default, dan penetapan yang secara efektif memberikan akses tingkat tinggi ke data Microsoft Purview, Microsoft Defender XDR, atau Microsoft 365 Copilot. Perlu dicatat bahwa beberapa peran bawaan tidak dapat diubah, tetapi tetap dapat dihitung dan dipantau.

Bagaimana saya mengelola grup peran untuk administrasi terdelegasi dan mengurangi paparan peran istimewa?

Identifikasi anggota grup peran yang ditetapkan ke peran istimewa, lalu terapkan prinsip hak akses minimum: buat peran kustom yang lebih sempit jika memungkinkan, hapus keanggotaan grup peran yang tidak diperlukan, dan gunakan kontrol akses darurat (break-glass) untuk akses saat keadaan darurat. Laporan sebaiknya menandai pengguna di grup peran Manajemen Organisasi, pemegang peran admin, serta service principal yang memiliki penetapan peran, guna meminimalkan risiko peran istimewa.

Di mana saya bisa menemukan contoh dan praktik terbaik untuk membuat dan mengotomatiskan laporan ini?

Rujuk Microsoft Learn dan dokumentasinya untuk contoh PowerShell yang menggunakan Microsoft Graph PowerShell SDK, Exchange Online Management Module, dan API portal kepatuhan. Praktik terbaiknya meliputi otomatisasi ekspor terjadwal, pencatatan entri log audit, mendokumentasikan izin peran sebagai kumpulan izin, serta mengintegrasikan temuan dengan alur kerja tata kelola untuk pengelolaan peran, tinjauan izin peran, dan audit kepatuhan.

Microsoft Purview Compliance

Related articles

RSS