Memangkas Versi File SharePoint dengan Batas Jumlah: Apa Arti Sebenarnya dari MajorWithMinorVersionsLimit
By Mirko Peters ·
Sebuah tugas pemangkasan dengan -MajorVersionLimit 100 dan -MajorWithMinorVersionsLimit 5 ternyata membiarkan setiap versi minor tetap ada. Berikut cara Microsoft menjelaskan kedua batas tersebut, cara menjalankan pemangkasan yang aman, dan bagian yang masih belum jelas.
Automatically translated with AI from the original post. Read the English original
Seorang administrator SharePoint ingin mengurangi penggunaan penyimpanan dengan memangkas versi file di semua situs. Ia menjalankan skrip yang membaca URL situs dari file CSV dan memanggil New-SPOSiteFileVersionBatchDeleteJob dengan -MajorVersionLimit 100 dan -MajorWithMinorVersionsLimit 5. Harapannya: menyimpan 100 versi mayor terakhir dan 5 versi minor terakhir dari setiap versi mayor. Yang terjadi: versi mayor memang dipangkas, tetapi semua versi minor dari versi mayor yang tersisa tetap ada.
Poin Penting
- Microsoft Learn menjelaskan -MajorWithMinorVersionsLimit sebagai jumlah versi mayor yang semua versi minornya dipertahankan, bukan sebagai batas jumlah versi minor.
- Kedua parameter jumlah harus diisi bersamaan, dan tutorial Learn menggunakan -MajorWithMinorVersionsLimit 0 ketika hanya versi mayor yang ingin dihitung.
- Versi yang dipangkas dihapus secara permanen dan melewati keranjang sampah, jadi jalankan analisis what-if terlebih dahulu dan uji pada satu situs.
- Tugas pemangkasan berjalan di latar belakang secara bertahap selama beberapa hari berikutnya, dan Anda dapat memeriksa atau membatalkannya dengan cmdlet progres dan Remove.
- Learn tidak menjelaskan bagaimana file yang hanya memiliki versi minor (misalnya 0.192) ditangani, jadi verifikasi kasus ini di pustaka uji.
Pertanyaan tersebut diposting di Microsoft Community Hub pada Februari 2026 dan belum mendapat jawaban. Artikel ini tidak mengklaim dapat menyelesaikannya. Artikel ini menunjukkan apa yang dikatakan Microsoft Learn tentang kedua parameter, memberikan cara yang hati-hati untuk menjalankan pemangkasan, dan menandai titik-titik di mana dokumentasi serta utas diskusi menyisakan celah. Ini bukan prosedur resmi Microsoft.
Apa yang didokumentasikan dari kedua parameter
Halaman Learn "Trim existing versions" menampilkan perintah batas jumlah sebagai berikut: New-SPOSiteFileVersionBatchDeleteJob -Identity $siteUrl -MajorVersionLimit <n> -MajorWithMinorVersionsLimit <n>. Teks placeholder untuk parameter kedua berbunyi "number of major versions for which all minor versions will be kept". Halaman Learn untuk batas versi pustaka menggunakan kata-kata yang hampir sama untuk Set-SPOListVersionPolicy: jumlah versi mayor yang semua versi minornya dipertahankan.
Halaman tersebut juga menyebutkan bahwa mode batas jumlah manual menghapus versi terlama yang melebihi batas jumlah yang ditentukan.
Tiga rincian tambahan dari dokumentasi:
- Dalam referensi cmdlet, sintaks batas jumlah mewajibkan
-MajorVersionLimitdan-MajorWithMinorVersionsLimitsekaligus. Setiap halaman menyebutkan bahwa Anda juga memerlukan parameter lainnya. - Tutorial Learn "Queue a trim job" menampilkan
-MajorVersionLimit 100 -MajorWithMinorVersionsLimit 0dan menyebutnya sebagai cara menyimpan 100 versi mayor. - Contoh di referensi cmdlet menggunakan
-MajorVersionLimit 30 -MajorWithMinorVersionsLimit 10.
Menurut saya, makna kalimat ini bukan "berapa versi minor yang disimpan". Maknanya lebih mendekati "untuk berapa versi mayor Anda ingin menyimpan setiap versi minor". Pembacaan itu berbeda dari yang diharapkan si penulis pertanyaan. Pembacaan itu juga tidak sepenuhnya menjelaskan hasil yang ia dapatkan. Dengan nilai 5, Anda akan mengharapkan semua versi minor hanya bertahan untuk sejumlah versi mayor yang terbatas, bukan untuk setiap versi mayor yang dipertahankan. Halaman Microsoft tidak menjelaskan pola pastinya, jadi saya tidak bisa memastikan apakah si penulis melihat penundaan, aturan yang berbeda, atau bug. Anggap hal ini masih terbuka.
Langkah 1: Tentukan mode pemangkasan yang Anda butuhkan
Learn menjelaskan tiga mode pemangkasan untuk versi yang sudah ada:
- Usia:
-DeleteBeforeDays <days>menghapus versi yang lebih tua dari jumlah hari yang Anda tentukan. - Batas jumlah:
-MajorVersionLimitdan-MajorWithMinorVersionsLimit, seperti dijelaskan di atas. - Otomatis:
-Automaticmenerapkan logika dari pengaturan versi Otomatis ke versi yang sudah ada.
Halaman Learn tentang batas riwayat versi merekomendasikan pengaturan Otomatis untuk penyimpanan versi yang dioptimalkan. Disebutkan bahwa pengaturan Otomatis menggabungkan nilai pemulihan dari riwayat versi dengan penggunaan penyimpanan yang lebih rendah, tanpa Anda harus menebak batas jumlah atau usia. Halaman penyimpanan versi untuk paket menyebutkan bahwa Otomatis menyimpan versi yang dibuat dalam 30 hari pertama (dengan batas 500 versi), lalu secara bertahap menguranginya menjadi versi per jam, harian, dan mingguan seiring bertambahnya usia versi.
Untuk pemangkasan berbasis usia, Learn mencantumkan dua batasan. Tugas tersebut tidak menghapus versi yang dibuat dalam 30 hari terakhir, sehingga masukan harus minimal 30 hari. Tugas tersebut juga selalu menghapus semua versi yang dibuat sebelum 1 Januari 2023, sehingga jumlah hari yang Anda pilih harus menghasilkan tanggal setelah tanggal tersebut. Periksa halaman terbaru sebelum Anda mengandalkan dua poin ini.
Langkah 2: Buat laporan dan jalankan analisis what-if
Halaman pemangkasan Learn menyarankan untuk menjalankan analisis what-if sebelum pemangkasan (tutorial antrean tugas menyebutnya opsional). Tutorial menjelaskan laporan penggunaan penyimpanan versi untuk situs atau pustaka, yang Anda unduh sebagai file CSV. Setelah itu, Anda menjalankan skrip terhadap laporan tersebut dengan PowerShell 7. Untuk kasus batas jumlah, skrip what-if dalam tutorial menerima -ImportPath, -ExportPath, dan -MajorVersionLimit. Skrip ini tidak menerima batas versi minor. Jadi, hasil what-if untuk batas jumlah hanya memodelkan batas versi mayor.
Halaman tutorial tidak menyebutkan nama cmdlet yang membuat laporan, jadi ikuti tutorial Learn untuk langkah tersebut. Learn menyatakan bahwa tugas pemangkasan bisa memakan waktu beberapa hari, tergantung ukuran pustaka. Tutorial what-if tidak memberikan perkiraan durasi.
Langkah 3: Antrekan tugas pada satu situs terlebih dahulu
Masuk sebagai SharePoint Administrator menggunakan SharePoint Online Management Shell terbaru, lalu antrekan tugas untuk satu situs uji:
``powershell New-SPOSiteFileVersionBatchDeleteJob -Identity https://contoso.sharepoint.com/sites/site1 -MajorVersionLimit 100 -MajorWithMinorVersionsLimit 0 ``
Untuk satu pustaka, gunakan varian pustaka:
``powershell New-SPOListFileVersionBatchDeleteJob -Site https://contoso.sharepoint.com/sites/site1 -List "Documents" -MajorVersionLimit 100 -MajorWithMinorVersionsLimit 0 ``
Learn memperingatkan bahwa versi yang dihapus dengan cara ini akan terhapus secara permanen dan tidak masuk ke keranjang sampah. Referensi cmdlet juga mencantumkan -WhatIf dan -Confirm sebagai parameter. Referensi tersebut hanya menjelaskan -WhatIf sebagai penampil apa yang akan terjadi jika cmdlet dijalankan, tanpa rincian tentang keluarannya untuk cmdlet ini, jadi jangan menganggapnya sebagai pengganti analisis what-if berbasis laporan.
Langkah 4: Pantau tugas
Tugas pemangkasan bersifat asinkron. Menurut Learn, penghapusan dilakukan secara bertahap dalam beberapa hari ke depan, dan volume, kesehatan layanan, serta beban kerja farm memengaruhi waktunya. Periksa tugas tingkat situs dengan:
``powershell Get-SPOSiteFileVersionBatchDeleteJobProgress -Identity https://contoso.sharepoint.com/sites/site1 ``
Untuk tugas pustaka, halaman pemangkasan Learn mencantumkan Get-SPOListFileVersionBatchDeleteJobProgress -Site <url> -List <name>. Untuk menghentikan tugas, gunakan Remove-SPOSiteFileVersionBatchDeleteJob atau Remove-SPOListFileVersionBatchDeleteJob. Membatalkan tugas menghentikan penghapusan lebih lanjut, tetapi tidak memulihkan versi yang sudah terhapus.
Jangan berharap laporan penyimpanan langsung berubah. Halaman Learn tentang batas penyimpanan situs menyebutkan bahwa penggunaan penyimpanan tidak mencakup perubahan dari 24 hingga 48 jam terakhir.
Langkah 5: Atur batas untuk versi baru
Pekerjaan pemangkasan hanya menangani versi yang ada saat ini. Untuk mengendalikan versi di masa mendatang, atur kebijakan versi pada situs atau pustaka:
- Situs:
Set-SPOSite -Identity <url> -EnableAutoExpirationVersionTrim $trueuntuk batas Otomatis. Learn mencantumkan-ApplyToNewDocumentLibrariesdan-ApplyToExistingDocumentLibrariesuntuk memilih cakupannya. - Pustaka:
Set-SPOListVersionPolicy -Site <url> -List <name> -EnableAutoExpirationVersionTrim $true.
Menetapkan kebijakan situs atau pustaka tidak memangkas versi yang sudah ada, jadi antrekan pekerjaan pemangkasan untuk versi tersebut. Perubahan pada pustaka yang sudah ada diproses dalam pekerjaan latar belakang yang menurut Learn dapat memakan waktu hingga 24 jam. Learn menambahkan bahwa ketika Anda menurunkan batas jumlah pada sebuah pustaka, versi yang ada di atas batas baru akan dipangkas secara bertahap, hingga 20 per versi baru yang dibuat. Pusat admin tidak menerima kurang dari 100 versi utama atau masa kedaluwarsa kurang dari 30 hari. Learn menyebutkan bahwa nilai yang lebih rendah dapat dilakukan melalui API publik, tetapi tidak disarankan karena dapat menyebabkan kehilangan data yang tidak disengaja.
Langkah 6: Pemangkasan di seluruh penyewa
Learn mencantumkan cmdlet tingkat penyewa seperti New-SPOTenantApplyFileVersionPolicyJob (dengan -CollectVersionData, -TrimVersions, dan -SetVersionPolicy). Cmdlet ini berstatus pratinjau publik, memerlukan lisensi SharePoint Advanced Management atau lisensi Copilot, dan mengecualikan situs hanya-baca, situs terkunci, dan situs yang diarsipkan. Hanya satu pekerjaan tingkat penyewa yang dapat berjalan dalam satu waktu. Jika Anda mengelola banyak situs, bandingkan jalur ini dengan perulangan CSV seperti yang ada di utas tersebut.
Yang masih belum jelas
- File hanya-minor: Penanya menanyakan tentang file yang tidak pernah dipublikasikan sebagai versi utama dan memiliki ratusan versi minor, misalnya 0.192. Learn tidak menjelaskan bagaimana pemangkasan berbasis jumlah memperlakukannya. Buat pustaka uji, tambahkan file semacam itu, dan jalankan pekerjaan kecil sebelum Anda menyentuh produksi.
- Ketidaksesuaian hasil: Pengamatan penanya bahwa semua versi minor dari setiap versi utama yang dipertahankan tetap ada tidak dijelaskan oleh halaman yang saya baca.
- Retensi: Halaman pemangkasan Learn merujuk ke FAQ untuk versi di bawah kebijakan retensi atau penahanan eDiscovery. Halaman tersebut tidak menjelaskan perilakunya sendiri.
Terkait
Sumber
- Microsoft Learn: Memangkas versi yang ada dari situs, pustaka, atau OneDrive
- Microsoft Learn: Mengantrekan tugas pemangkasan untuk situs atau pustaka dokumen
- Microsoft Learn: Run a what-if analysis
- Microsoft Learn: New-SPOSiteFileVersionBatchDeleteJob
- Microsoft Learn: Menetapkan batas versi untuk pustaka dokumen tertentu
- Microsoft Learn: Menetapkan batas versi untuk situs
- Microsoft Learn: Manage site storage limits
- Microsoft Learn: Overview of version history limits
- Microsoft Learn: Merencanakan penyimpanan versi pada pustaka dokumen
- Microsoft Community Hub: Memangkas Riwayat Versi SharePoint - Versi Minor (Februari 2026)