Perbaiki izin SharePoint secara massal dari laporan, bukan satu per satu
Disclosure: Cognillo sponsors M365.FM. This page describes the company factually; paid partnerships and links are labelled as advertising.
By Mirko Peters · · Updated
Perbaiki izin SharePoint secara massal: ekspor laporan, beri tanda setiap baris dengan "keep", "remove", atau "reset", uji skrip PnP PowerShell di satu situs terlebih dahulu, lalu verifikasi hasilnya.
Automatically translated with AI from the original post. Read the English original
Untuk memperbaiki izin SharePoint secara massal, Anda mengekspor laporan tentang siapa saja yang memiliki akses, menandai setiap baris sebagai keep, remove, atau reset, lalu menjalankan skrip yang membaca keputusan Anda. Panduan ini ditujukan bagi admin SharePoint yang menghadapi ratusan item dengan izin unik dan tidak ingin mengkliknya satu per satu. Anda akan melihat cara menyusun daftar keputusan, cmdlet PnP PowerShell mana yang melakukan pekerjaan tersebut, apa yang tidak tercakup dalam laporan Microsoft, serta cara menguji, mencatat, dan memeriksa hasil eksekusi. Sebuah contoh dengan angka fiktif memperlihatkan siklus lengkapnya.
Poin Penting
- Untuk memperbaiki izin SharePoint secara massal, mulailah dari laporan: setiap perubahan dalam skrip harus dapat ditelusuri kembali ke satu baris yang telah ditandai keep, remove, atau reset oleh seseorang.
- Laporan berbagi situs dari Microsoft mencantumkan setiap file, pengguna, izin, dan tautan unik, tetapi tidak menyertakan tautan Anyone maupun orang perorangan di dalam grup SharePoint.
- Tiga cmdlet PnP PowerShell mencakup sebagian besar perbaikan massal: Remove-PnPGroupMember, Set-PnPListItemPermission, dan Remove-PnPSiteCollectionAdmin.
- Mengembalikan item agar mewarisi izin dari daftarnya akan menghapus izin unik pada item tersebut, dan sering kali ini menjadi solusi paling rapi untuk permission creep.
- Uji skrip di satu situs, simpan catatan setiap perubahan, lalu jalankan laporan kedua setelahnya untuk membuktikan bahwa masalahnya sudah hilang.
Mengapa memperbaiki item satu per satu gagal
Sebagian besar masalah izin SharePoint menumpuk perlahan. Seseorang membagikan satu file kepada rekannya. Orang lain memutuskan untuk memutus pewarisan izin pada sebuah folder untuk proyek yang sudah lama berakhir. Setelah beberapa tahun, sejumlah pustaka dokumen memiliki ratusan item dengan izin unik, dan tidak seorang pun tahu mana yang masih relevan.
Memperbaikinya satu per satu memiliki tiga masalah. Prosesnya lambat. Item mudah terlewat. Dan tidak ada catatan tentang apa yang Anda ubah, sehingga Anda tidak bisa membatalkan kesalahan maupun menjawab auditor.
Perbaikan massal membalik urutannya. Pertama, Anda mengumpulkan fakta dalam laporan. Kemudian seseorang memutuskan. Baru setelah itu skrip bekerja, dan hanya pada baris yang sudah memiliki keputusan. Dengan cara ini, kecepatan otomasi tetap terjaga dan ketelitian tinjauan manual juga tetap terjaga.
Cara memperbaiki izin SharePoint secara massal: lima langkah
Ikuti langkah-langkah berikut secara berurutan.
- Ekspor faktanya. Buat laporan untuk situs tersebut. Panduan Microsoft tentang laporan berbagi file dan folder menyebutkan bahwa admin situs menjalankannya dari Settings, Site usage, di bagian Shared with external users, dengan Run report. Anda memilih lokasi penyimpanan CSV, dan Anda akan menerima email setelah proses selesai.
- Tambahkan kolom keputusan. Buka CSV di Excel dan tambahkan kolom dengan tiga nilai yang diizinkan: keep, remove, reset. Tambahkan kolom kedua untuk alasannya. Mintalah pemilik situs meninjau baris-baris yang tidak dapat Anda putuskan sendiri.
- Tulis skrip berdasarkan keputusan tersebut. Baca file dengan
Import-Csv, lakukan perulangan pada setiap baris, dan jalankan satu cmdlet untuk setiap jenis keputusan. Lewati setiap baris yang tidak memiliki keputusan. - Uji coba pada satu situs, lalu satu pustaka. Jalankan skrip pada situs uji atau satu pustaka terlebih dahulu. Bandingkan hasilnya dengan yang Anda harapkan.
- Periksa dengan laporan kedua. Setelah menjalankan skrip sungguhan, buat laporan lagi. Baris yang Anda hapus seharusnya sudah tidak ada, dan baris yang Anda pertahankan seharusnya tidak berubah.
Jangan lewati langkah 2. Keamanan skrip hanya sebaik daftar yang dibacanya.
Cara kerja pewarisan izin sebelum Anda mengatur ulang apa pun
Halaman dukungan Microsoft tentang menyesuaikan izin untuk daftar atau pustaka SharePoint menjelaskan bahwa folder, daftar, dan dokumen biasanya mewarisi izin dari situs yang memuatnya. Untuk memberi daftar atau pustaka izinnya sendiri, pemilik memilih Stop Inheriting Permissions, lalu item di bawahnya mewarisi pengaturan baru tersebut. Untuk kembali, tab Permissions menyediakan Delete unique permissions, yang menghapus izin khusus yang Anda atur.
Tiga peringatan dari halaman yang sama penting untuk pekerjaan massal:
- Batas 100.000 item. Anda tidak dapat memutus atau memulihkan pewarisan pada daftar, pustaka, atau folder yang memuat lebih dari 100.000 item. Satu file di pustaka besar tetap dapat diputus pewarisannya.
- Menghapus pengguna berdampak pada item turunan. Menghapus pengguna atau grup juga menghapus mereka dari item turunan, termasuk item dengan pewarisan yang sudah diputus, dan memulihkannya tidak dimungkinkan. Baca log Anda sebelum menjalankan penghapusan.
- Akses terbatas tetap ada. Orang yang hanya dibagikan satu item mendapatkan akses terbatas ke situs, dan membatalkan berbagi item tidak menghapus akses tersebut.
Microsoft merekomendasikan grup SharePoint dan menyebut izin tingkat item didukung dalam penggunaan yang wajar. Aturan praktis kami sendiri adalah memberikan akses melalui grup, bukan kepada pengguna individual, agar izin situs tetap mudah dibaca dan lebih sedikit izin khusus yang perlu diperbaiki.
Cmdlet mana yang memperbaiki masalah yang mana?
PnP PowerShell memiliki cmdlet untuk sebagian besar perbaikan massal. Ketiga cmdlet berikut paling sering muncul.
Hapus seseorang dari grup SharePoint. Referensi untuk Remove-PnPGroupMember menunjukkan sintaksnya: Remove-PnPGroupMember -LoginName user@company.com -Group 'Marketing Site Members'. Gunakan untuk masalah keanggotaan grup, misalnya karyawan yang sudah keluar tetapi masih ada di grup Members.
Ubah atau atur ulang izin pada item. Referensi untuk Set-PnPListItemPermission mencantumkan opsi berikut:
-AddRoledan-RemoveRolemenambahkan atau menghapus tingkat izin untuk pengguna atau grup pada satu item. GunakanGet-PnPRoleDefinitionuntuk melihat peran yang tersedia.-ClearExistingmenghapus semua izin yang ada pada item sebelum peran baru ditambahkan.-InheritPermissionsmengatur ulang item agar mewarisi izin dari daftarnya dan menghapus izin khusus yang dimilikinya.-SystemUpdatemengubah izin tanpa membuat versi baru atau memicu Power Automate.
Mengatur ulang sering menjadi perbaikan paling bersih. Jika sebuah item hanya memiliki izin khusus karena seseorang pernah membagikannya sekali, pengaturan ulang akan mengembalikannya ke aturan pustaka.
Hapus administrator koleksi situs. Referensi untuk Remove-PnPSiteCollectionAdmin menunjukkan Remove-PnPSiteCollectionAdmin -Owners "user@contoso.onmicrosoft.com". Administrator yang tidak Anda sebutkan tetap mempertahankan aksesnya. Daftar pengguna juga dapat diteruskan.
Untuk mengganti satu pengguna dengan pengguna lain, jalankan dua langkah: tambahkan orang baru di tempat orang lama memiliki akses, lalu hapus orang lama. Lakukan penambahan terlebih dahulu agar tidak ada yang kehilangan akses di antara keduanya.
Yang tidak ditampilkan laporan
Laporan hanyalah awal, bukan gambaran lengkap. Halaman laporan berbagi Microsoft menyatakan apa yang dikecualikan dari CSV:
- Pengguna individual di dalam grup SharePoint. Grup tersebut muncul, tetapi anggotanya tidak.
- Tautan yang dikirim lewat email tetapi tidak pernah diklik.
- Tautan anonim (anyone).
Ini memiliki konsekuensi nyata. Jika tujuan Anda adalah mengetahui di mana seseorang memiliki akses, laporan hanya akan menampilkan grup, sehingga Anda harus memeriksa anggota grup tersebut secara terpisah. Jika tujuan Anda adalah menghapus berbagi publik, laporan tidak akan mencantumkan tautan Anyone sama sekali, sehingga Anda memerlukan sumber lain, misalnya laporan Data access governance di pusat admin SharePoint. Menurut Microsoft, laporan tersebut memerlukan SharePoint Advanced Management.
Untuk satu situs SharePoint di SharePoint Online, tinjau juga izin situs dan tingkat izin yang digunakan di bawah Site settings sebelum Anda mengubah item apa pun. Kemudian periksa opsi SharePoint reporting untuk seluruh penyewa, bukan hanya satu situs. CSV per situs tidak akan efektif untuk ratusan situs.
Untuk situs yang terhubung dengan grup Microsoft 365, keanggotaan grup dikelola melalui grup, bukan melalui grup milik situs itu sendiri. Skrip yang mengubah grup situs tidak akan memperbaiki izin seseorang yang berada di grup Microsoft 365.
Pastikan skrip aman dijalankan
Skrip massal dapat menimbulkan kerusakan besar dalam waktu singkat. Terapkan perlindungan berikut sebelum eksekusi sungguhan pertama:
- Tambahkan sakelar dry-run. Skrip Anda dapat menerima parameter
-DryRunyang menampilkan setiap tindakan yang direncanakan tanpa mengubah apa pun. Tinjau keluaran tersebut bersama pemilik situs. - Catat sebelum mengubah. Untuk setiap baris, tulis status lama ke log terlebih dahulu: jalur item, pengguna, dan tingkat izin, seperti Full Control, Edit, atau Read. Log itu adalah cara Anda untuk kembali ke kondisi semula.
- Kerjakan dalam batch. Jalankan 50 item, periksa hasilnya, lalu jalankan 500 item berikutnya. Batch pertama yang kecil membantu menangkap asumsi yang keliru sejak dini.
- Simpan laporan asli. Simpan CSV beserta keputusan Anda dan log di folder yang hanya dapat dibuka oleh pemilik situs. Microsoft menyarankan hal yang sama untuk laporan itu sendiri, karena laporan tersebut mencantumkan siapa yang memiliki akses ke apa.
- Ubah keanggotaan grup dalam eksekusi terpisah. Perbaiki izin item dalam satu eksekusi dan keanggotaan grup dalam eksekusi lain, sehingga Anda dapat memeriksa setiap jenis perubahan secara terpisah.
Contoh: membersihkan satu pustaka dokumen
Angka-angka berikut bersifat fiktif.
Sebuah situs proyek memiliki satu pustaka dokumen. Laporan berisi 620 baris. Setelah diurutkan, seorang admin dan pemilik situs memberi tanda pada baris-baris tersebut:
- 410 baris: pertahankan. Ini adalah izin normal berbasis grup.
- 150 baris: atur ulang. Ini adalah file tunggal dengan izin unik dari berbagi lama.
- 40 baris: hapus. Baris ini memberikan akses langsung kepada mantan kontraktor.
- 20 baris: tidak jelas. Baris ini dikembalikan kepada pemilik dengan pertanyaan.
Admin menulis skrip dengan dua cabang. Cabang reset menjalankan Set-PnPListItemPermission dengan -InheritPermissions untuk setiap file. Cabang hapus menjalankan Remove-PnPGroupMember untuk kontraktor tersebut di grup tempat ia muncul. Skrip menulis satu baris log untuk setiap tindakan: tanggal, item, status lama, dan status baru.
Pertama, admin menjalankan skrip pada salinan pustaka dengan 20 baris. Hasilnya sesuai dengan rencana. Eksekusi penuh memakan waktu satu malam. Laporan kedua menunjukkan 410 ditambah 20 baris, sesuai dengan yang diharapkan admin. Log disimpan di samping laporan, sehingga siapa pun dapat melihat apa yang terjadi.
Kesalahan umum
- Menjalankan skrip tanpa daftar keputusan. Anda tidak akan dapat menjelaskan nanti mengapa sebuah item berubah.
- Mengatur ulang pewarisan pada pustaka yang memang dimaksudkan memiliki izin unik. Beberapa folder sengaja dibatasi. Tandai sebagai pertahankan.
- Mempercayai laporan sebagai data yang lengkap. Laporan ini tidak mencantumkan tautan Anyone maupun anggota grup SharePoint.
- Menghapus sebelum menambahkan. Saat Anda mengganti satu pengguna dengan pengguna lain, tambahkan izin baru terlebih dahulu.
- Memberikan akses satu per satu. Tetapkan izin melalui grup, bukan kepada satu pengguna per item, sehingga tinjauan berikutnya lebih singkat.
- Melupakan grup Microsoft 365. Seseorang dapat tetap memiliki akses melalui keanggotaan grup meskipun Anda sudah membersihkan situsnya.
- Tanpa log dan tanpa laporan kedua. Tanpa keduanya, Anda tidak dapat membuktikan perbaikan atau membatalkannya.
Bagaimana perangkat lunak dapat membantu
Mulailah dengan alat yang sudah Anda miliki. Laporan berbagi situs dan laporan di pusat admin memberikan fakta yang Anda butuhkan. PnP PowerShell melakukan perubahan, dan spreadsheet menyimpan keputusan serta log.
Beberapa alat pihak ketiga menggabungkan pelaporan dan perbaikan dalam satu layar. Salah satu contohnya adalah SharePoint Essentials Toolkit dari Cognillo. Menurut halaman produk vendor, alat ini menawarkan laporan izin untuk situs, folder, dan item, menampilkan semua yang dapat diakses oleh satu orang, mengganti satu pengguna dengan pengguna lain, serta memperbaiki izin dan tautan berbagi berdasarkan laporan. Vendor juga menyatakan bahwa laporan dan tugas dapat dijadwalkan serta diekspor. Ini adalah pernyataan vendor dan belum diuji oleh M365.FM. Cara manual di atas berfungsi tanpa alat-alat tersebut.
Pengungkapan: Cognillo mensponsori M365.FM.
Langkah berikutnya
Pilih satu situs dengan masalah izin yang sudah diketahui, jalankan laporan berbagi, dan tambahkan kolom keputusan ke CSV. Kemudian gunakan daftar tersebut untuk memperbaiki izin SharePoint secara massal, mulai dari pustaka uji terlebih dahulu, dan simpan log-nya.