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

Blog · Mirko Peters

SharePoint-bestandsversies inperken met aantallimieten: wat MajorWithMinorVersionsLimit echt betekent

By ·

Een opschoontaak met -MajorVersionLimit 100 en -MajorWithMinorVersionsLimit 5 liet elke secundaire versie staan. Hier lees je hoe Microsoft de twee limieten beschrijft, hoe je veilig opschoont en wat nog onduidelijk is.

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

Een SharePoint-beheerder wilde de opslag verminderen door bestandsversies op alle sites op te schonen. Hij draaide een script dat site-URL's uit een CSV-bestand las en New-SPOSiteFileVersionBatchDeleteJob aanriep met -MajorVersionLimit 100 en -MajorWithMinorVersionsLimit 5. De verwachting was: de laatste 100 hoofdversies behouden en per hoofdversie de laatste 5 secundaire versies. Wat er gebeurde: de hoofdversies werden opgeschoond, maar alle secundaire versies van de overgebleven hoofdversies bleven staan.

Belangrijkste punten

  • Microsoft Learn beschrijft -MajorWithMinorVersionsLimit als het aantal hoofdversies waarvoor alle secundaire versies behouden blijven, niet als een maximum aantal secundaire versies.
  • Beide aantalparameters moeten samen worden opgegeven. De Learn-tutorial gebruikt -MajorWithMinorVersionsLimit 0 wanneer alleen hoofdversies geteld moeten worden.
  • Opgeschoonde versies worden permanent verwijderd en omzeilen de prullenbak. Voer daarom eerst de what-if-analyse uit en test op één site.
  • Opschoontaken draaien op de achtergrond, in batches over de komende dagen. Je kunt ze controleren of annuleren met de voortgangs- en Remove-cmdlets.
  • Learn zegt niet hoe bestanden die alleen secundaire versies hebben (bijvoorbeeld 0.192) worden behandeld. Controleer dat geval daarom in een testbibliotheek.

Die vraag is in februari 2026 gesteld in de Microsoft Community Hub. Er is geen antwoord op gekomen. Dit artikel beweert niet dat het oplossing biedt. Het laat zien wat Microsoft Learn zegt over de twee parameters, geeft je een zorgvuldige manier om op te schonen en markeert de punten waar de documentatie en de discussie een gat laten. Het is geen officiële Microsoft-procedure.

Wat de twee parameters volgens de documentatie doen

De Learn-pagina "Bestaande versies opschonen" toont de opdracht met aantallimiet als volgt: New-SPOSiteFileVersionBatchDeleteJob -Identity $siteUrl -MajorVersionLimit <n> -MajorWithMinorVersionsLimit <n>. De plaatsaanduidingstekst voor de tweede parameter luidt "aantal hoofdversies waarvoor alle secundaire versies behouden blijven". De Learn-pagina over versielimieten van bibliotheken gebruikt bijna dezelfde woorden voor Set-SPOListVersionPolicy: het aantal hoofdversies waarvoor alle secundaire versies behouden blijven.

De pagina zegt ook dat de handmatige aantallimietmodus de oudste versies verwijdert die de opgegeven limiet overschrijden.

Nog drie details uit de documentatie:

  1. In de cmdletreferentie vereist de syntaxis met aantallimiet zowel -MajorVersionLimit als -MajorWithMinorVersionsLimit. Elke pagina zegt dat je ook de andere parameter nodig hebt.
  2. De Learn-tutorial "Een opschoontaak in de wachtrij zetten" toont -MajorVersionLimit 100 -MajorWithMinorVersionsLimit 0 en noemt dat het 100 hoofdversies behoudt.
  3. Het voorbeeld in de cmdletreferentie gebruikt -MajorVersionLimit 30 -MajorWithMinorVersionsLimit 10.

Volgens mij is de tweede waarde niet "hoeveel minor-versies je bewaart". Het komt dichter in de buurt van "voor hoeveel major-versies wil je elke minor-versie bewaren". Die lezing wijkt af van wat de poster verwachtte. Ze verklaart ook het resultaat van de poster niet volledig. Bij een waarde van 5 zou je verwachten dat alle minor-versies slechts een beperkt aantal major-versies overleven, en niet bij elke bewaarde major-versie. Microsoft beschrijft het precieze patroon niet, dus ik kan niet zeggen of de poster een vertraging zag, een andere regel of een bug. Dat blijft open.

Stap 1: Bepaal welke trimmodus je nodig hebt

Learn beschrijft drie trimmodi voor bestaande versies:

  • Leeftijd: -DeleteBeforeDays <dagen> verwijdert versies die ouder zijn dan het aantal dagen dat je opgeeft.
  • Aantalslimiet: -MajorVersionLimit en -MajorWithMinorVersionsLimit, zoals hierboven.
  • Automatisch: -Automatic past de logica van de instelling Automatische versies toe op bestaande versies.

De Learn-pagina over limieten voor de versiegeschiedenis raadt de instelling Automatisch aan voor geoptimaliseerde versieopslag. Volgens die pagina combineert de instelling Automatisch de herstelwaarde van de versiegeschiedenis met een lager opslaggebruik, zonder dat je aantal- of leeftijdslimieten hoeft te raden. De pagina over versieopslag van het abonnement zegt dat Automatisch de versies bewaart die in de eerste 30 dagen zijn gemaakt (binnen een limiet van 500 versies) en ze daarna naarmate ze ouder worden uitdunt tot uurlijkse, dagelijkse en wekelijkse versies.

Bij trimmen op basis van leeftijd noemt Learn twee beperkingen. De taak verwijdert geen versies die in de afgelopen 30 dagen zijn gemaakt, dus de invoer moet minstens 30 dagen zijn. Ook verwijdert de taak altijd alle versies die vóór 1 januari 2023 zijn gemaakt, dus het aantal dagen dat je kiest moet een datum opleveren die later ligt dan die datum. Controleer de actuele pagina voordat je op deze twee punten vertrouwt.

Stap 2: Genereer het rapport en voer de what-if-analyse uit

De trimpagina van Learn raadt aan een what-if-analyse uit te voeren voordat je gaat trimmen (de zelfstudie over een taak in de wachtrij noemt deze stap optioneel). De zelfstudies beschrijven een rapport over het opslaggebruik van versies voor de site of bibliotheek, dat je downloadt als CSV-bestand. Vervolgens voer je een script uit op basis van dat rapport met PowerShell 7. Voor het geval met een aantalslimiet neemt het what-if-script uit de zelfstudie -ImportPath, -ExportPath en -MajorVersionLimit als parameters. Er is geen limiet voor minor-versies. Het what-if-resultaat voor aantalslimieten modelleert dus alleen de limiet voor major-versies.

De zelfstudiepagina's noemen de cmdlet die het rapport maakt niet, dus volg voor deze stap de Learn-zelfstudie. Learn zegt dat een trimtaak afhankelijk van de grootte van de bibliotheek enkele dagen kan duren. De what-if-zelfstudie geeft geen duur.

Stap 3: Zet de taak eerst voor één site in de wachtrij

Meld je aan als SharePoint-beheerder met de actuele SharePoint Online Management Shell en zet daarna een taak in de wachtrij voor één testsite:

``powershell New-SPOSiteFileVersionBatchDeleteJob -Identity https://contoso.sharepoint.com/sites/site1 -MajorVersionLimit 100 -MajorWithMinorVersionsLimit 0 ``

Gebruik voor één bibliotheek de variant voor bibliotheken:

``powershell New-SPOListFileVersionBatchDeleteJob -Site https://contoso.sharepoint.com/sites/site1 -List "Documents" -MajorVersionLimit 100 -MajorWithMinorVersionsLimit 0 ``

Learn waarschuwt dat versies die zo worden verwijderd definitief zijn en niet in de prullenbak terechtkomen. De cmdletreferentie vermeldt ook -WhatIf en -Confirm als parameters. De referentie beschrijft -WhatIf alleen als het tonen van wat er zou gebeuren als de cmdlet wordt uitgevoerd, zonder details over de uitvoer ervan voor deze cmdlets. Gebruik het dus niet als vervanging voor de what-if-analyse op basis van het rapport.

Stap 4: Houd de taak in de gaten

Trimtaken werken asynchroon. Volgens Learn gebeurt het verwijderen in batches over de komende dagen, en het volume, de servicestatus en de werkbelasting van de farm bepalen de timing. Controleer een taak op siteniveau met:

``powershell Get-SPOSiteFileVersionBatchDeleteJobProgress -Identity https://contoso.sharepoint.com/sites/site1 ``

Voor een taak op bibliotheekniveau vermeldt de trimpagina van Learn Get-SPOListFileVersionBatchDeleteJobProgress -Site <url> -List <naam>. Om een taak te stoppen gebruik je Remove-SPOSiteFileVersionBatchDeleteJob of Remove-SPOListFileVersionBatchDeleteJob. Annuleren stopt verdere verwijdering, maar herstelt geen versies die al zijn verwijderd.

Verwacht niet dat het opslagrapport meteen verandert. De Learn-pagina over opslaglimieten van sites zegt dat het opslaggebruik wijzigingen van de afgelopen 24 tot 48 uur niet meeneemt.

Stap 5: Stel limieten in voor nieuwe versies

Een opschoontaak verwerkt alleen versies die er nu al zijn. Om toekomstige versies te beheersen, stel je het versiebeleid in op de site of bibliotheek:

  • Site: Set-SPOSite -Identity <url> -EnableAutoExpirationVersionTrim $true voor automatische limieten. Learn noemt -ApplyToNewDocumentLibraries en -ApplyToExistingDocumentLibraries om het bereik te kiezen.
  • Bibliotheek: Set-SPOListVersionPolicy -Site <url> -List <name> -EnableAutoExpirationVersionTrim $true.

Een beleid instellen op een site of bibliotheek verwijdert geen versies die al bestaan, dus zet hiervoor een opschoontaak in de wachtrij. Wijzigingen in bestaande bibliotheken worden verwerkt in een achtergrondtaak die volgens Learn tot 24 uur kan duren. Learn voegt toe dat wanneer je een maximumaantal op een bibliotheek verlaagt, bestaande versies boven de nieuwe limiet geleidelijk worden opgeschoond, met maximaal 20 per nieuw aangemaakte versie. De interface van het beheercentrum accepteert geen minder dan 100 hoofdversies en geen vervaldatum korter dan 30 dagen. Learn zegt dat lagere waarden via publieke API's mogelijk zijn, maar niet aanbevolen, omdat ze onbedoeld gegevensverlies kunnen veroorzaken.

Stap 6: Opschonen voor de hele tenant

Learn noemt cmdlets op tenantniveau, zoals New-SPOTenantApplyFileVersionPolicyJob (met -CollectVersionData, -TrimVersions en -SetVersionPolicy). Ze zijn beschikbaar in openbare preview, vereisen een licentie voor SharePoint Advanced Management of een Copilot-licentie, en sluiten alleen-lezen, vergrendelde en gearchiveerde sites uit. Er kan maar één taak op tenantniveau tegelijk draaien. Als je veel sites beheert, vergelijk deze route dan met een CSV-loop zoals in de thread.

Wat onduidelijk blijft

  • Alleen minor-bestanden: De vraagsteller vroeg naar bestanden die nooit als hoofdversie zijn gepubliceerd en honderden minor-versies hebben, zoals 0.192. Learn zegt niet hoe het opschonen op basis van een maximumaantal hiermee omgaat. Maak een testbibliotheek, voeg zo’n bestand toe en draai een kleine taak voordat je aan productie begint.
  • Afwijkend resultaat: De observatie van de vraagsteller dat alle minor-versies van elke bewaarde hoofdversie zijn blijven staan, wordt niet verklaard door de pagina’s die ik heb gelezen.
  • Bewaring: De Learn-pagina over opschonen verwijst voor versies onder een bewaarbeleid of eDiscovery-blokkering naar een FAQ. Het gedrag zelf beschrijft de pagina niet.

Gerelateerd

Bronnen

Entities in this article

SharePoint Intelligent versioning (SharePoint) SharePoint document libraries SharePoint Advanced Management

Related articles

RSS