M365Con 2027 – die kostenlose Online-Konferenz · 11–22 Jan 2027 · 120 sessions→ m365con.net

Blog · Mirko Peters

Dateiversionen in SharePoint mit Anzahllimits kürzen: Was MajorWithMinorVersionsLimit wirklich bewirkt

Von ·

Ein Trim-Auftrag mit -MajorVersionLimit 100 und -MajorWithMinorVersionsLimit 5 hat alle Nebenversionen beibehalten. Hier erfahren Sie, wie Microsoft die beiden Limits beschreibt, wie Sie einen sicheren Trim ausführen und was offen bleibt.

Automatisch mit KI aus dem Originalbeitrag übersetzt. Englisches Original lesen

Ein SharePoint-Administrator wollte den Speicherbedarf senken, indem er Dateiversionen auf allen Websites kürzt. Er startete ein Skript, das die Website-URLs aus einer CSV-Datei einlas und New-SPOSiteFileVersionBatchDeleteJob mit -MajorVersionLimit 100 und -MajorWithMinorVersionsLimit 5 aufrief. Erwartet wurde Folgendes: Die letzten 100 Hauptversionen bleiben erhalten, dazu die letzten 5 Nebenversionen jeder Hauptversion. Tatsächlich wurden die Hauptversionen gekürzt, alle Nebenversionen der verbleibenden Hauptversionen blieben jedoch bestehen.

Das Wichtigste in Kürze

  • Microsoft Learn beschreibt -MajorWithMinorVersionsLimit als die Anzahl der Hauptversionen, für die alle Nebenversionen erhalten bleiben. Der Parameter begrenzt also nicht die Anzahl der Nebenversionen.
  • Beide Anzahlparameter müssen gemeinsam angegeben werden. Das Learn-Tutorial verwendet -MajorWithMinorVersionsLimit 0, wenn nur Hauptversionen gezählt werden sollen.
  • Gekürzte Versionen werden dauerhaft gelöscht und umgehen den Papierkorb. Führen Sie deshalb zuerst die What-if-Analyse aus und testen Sie auf einer einzelnen Website.
  • Trim-Aufträge laufen im Hintergrund und arbeiten in den folgenden Tagen in Stapeln. Sie können sie mit den Fortschritts-Cmdlets prüfen und mit den Remove-Cmdlets abbrechen.
  • Learn sagt nicht, wie Dateien behandelt werden, die nur Nebenversionen haben (zum Beispiel 0.192). Prüfen Sie diesen Fall deshalb in einer Testbibliothek.

Diese Frage wurde im Februar 2026 im Microsoft Community Hub gestellt. Sie ist bisher unbeantwortet. Dieser Artikel behauptet nicht, sie zu lösen. Er zeigt, was Microsoft Learn zu den beiden Parametern sagt, beschreibt ein sorgfältiges Vorgehen für einen Trim und markiert die Stellen, an denen Dokumentation und Diskussion Lücken lassen. Es handelt sich nicht um ein offizielles Microsoft-Verfahren.

Was die beiden Parameter laut Dokumentation bewirken

Die Learn-Seite „Trim existing versions“ führt den Befehl für das Anzahllimit so auf: New-SPOSiteFileVersionBatchDeleteJob -Identity $siteUrl -MajorVersionLimit <n> -MajorWithMinorVersionsLimit <n>. Der Platzhaltertext für den zweiten Parameter lautet „number of major versions for which all minor versions will be kept“. Die Learn-Seite zu den Versionslimits für Bibliotheken verwendet für Set-SPOListVersionPolicy nahezu dieselben Formulierungen: die Anzahl der Hauptversionen, für die alle Nebenversionen erhalten bleiben.

Laut derselben Seite löscht der manuelle Anzahllimit-Modus die ältesten Versionen, die das angegebene Limit überschreiten.

Drei weitere Details aus der Dokumentation:

  1. In der Cmdlet-Referenz verlangt die Syntax für das Anzahllimit sowohl -MajorVersionLimit als auch -MajorWithMinorVersionsLimit. Auf jeder Seite heißt es, dass Sie auch den jeweils anderen Parameter benötigen.
  2. Das Learn-Tutorial „Queue a trim job“ zeigt -MajorVersionLimit 100 -MajorWithMinorVersionsLimit 0 und beschreibt dies als Erhalt von 100 Hauptversionen.
  3. Das Beispiel in der Cmdlet-Referenz verwendet -MajorVersionLimit 30 -MajorWithMinorVersionsLimit 10.

Meiner Lesart nach bedeutet die zweite Zahl nicht „wie viele Nebenversionen behalten werden“. Sie kommt eher der Bedeutung nahe: „Für wie viele Hauptversionen sollen alle Nebenversionen erhalten bleiben?“ Diese Lesart weicht von dem ab, was der Verfasser des Beitrags erwartet hat. Sie erklärt auch dessen Ergebnis nicht vollständig. Bei einem Wert von 5 würde man erwarten, dass alle Nebenversionen nur für eine begrenzte Anzahl Hauptversionen erhalten bleiben, nicht für jede beibehaltene Hauptversion. Die Microsoft-Seiten beschreiben das genaue Muster nicht. Deshalb kann ich nicht sagen, ob der Verfasser eine Verzögerung, eine andere Regel oder einen Fehler beobachtet hat. Das bleibt offen.

Schritt 1: Legen Sie fest, welchen Bereinigungsmodus Sie benötigen

Learn beschreibt drei Bereinigungsmodi für vorhandene Versionen:

  • Alter: -DeleteBeforeDays <days> löscht Versionen, die älter sind als die angegebene Anzahl Tage.
  • Anzahlbegrenzung: -MajorVersionLimit und -MajorWithMinorVersionsLimit, wie oben beschrieben.
  • Automatisch: -Automatic wendet die Logik der Einstellung „Automatisch“ auf vorhandene Versionen an.

Die Learn-Seite zu den Begrenzungen des Versionsverlaufs empfiehlt die Einstellung „Automatisch“ für eine optimierte Versionsspeicherung. Laut Learn verbindet diese Einstellung den Nutzen des Versionsverlaufs für die Wiederherstellung mit geringerem Speicherbedarf, ohne dass Sie Anzahl- oder Altersgrenzen schätzen müssen. Die Seite zur Versionsspeicherung im Plan besagt, dass „Automatisch“ die in den ersten 30 Tagen erstellten Versionen behält (innerhalb einer Anzahlgrenze von 500) und sie mit zunehmendem Alter stündlich, täglich und wöchentlich ausdünnt.

Für die altersbasierte Bereinigung nennt Learn zwei Grenzen. Der Auftrag löscht keine Versionen, die in den letzten 30 Tagen erstellt wurden. Die Eingabe muss daher mindestens 30 Tage zurückreichen. Außerdem löscht er immer alle Versionen, die vor dem 1. Januar 2023 erstellt wurden. Die gewählte Anzahl Tage muss deshalb ein Datum nach diesem Stichtag ergeben. Prüfen Sie die aktuelle Seite, bevor Sie sich auf diese beiden Punkte verlassen.

Schritt 2: Bericht erstellen und Was-wäre-wenn-Analyse ausführen

Laut der Learn-Seite zur Bereinigung sollten Sie vor der Bereinigung eine Was-wäre-wenn-Analyse ausführen (das Lernprogramm zum Einreihen von Aufträgen bezeichnet sie als optional). Die Lernprogramme beschreiben einen Bericht zur Speichernutzung der Versionen für die Website oder die Bibliothek, den Sie als CSV-Datei herunterladen. Anschließend führen Sie ein Skript mit PowerShell 7 für diesen Bericht aus. Für den Fall der Anzahlbegrenzung nimmt das Was-wäre-wenn-Skript im Lernprogramm -ImportPath, -ExportPath und -MajorVersionLimit entgegen. Eine Begrenzung der Nebenversionen akzeptiert es nicht. Das Ergebnis der Was-wäre-wenn-Analyse für Anzahlbegrenzungen bildet daher nur die Begrenzung der Hauptversionen ab.

Die Lernprogramm-Seiten nennen das Cmdlet nicht, mit dem der Bericht erstellt wird. Folgen Sie für diesen Schritt deshalb dem Learn-Lernprogramm. Laut Learn kann ein Bereinigungsauftrag je nach Bibliotheksgröße einige Tage dauern. Das Lernprogramm zur Was-wäre-wenn-Analyse nennt keine Dauer.

Schritt 3: Auftrag zunächst für eine Website einreihen

Melden Sie sich als SharePoint-Administrator mit der aktuellen SharePoint Online Management Shell an und reihen Sie dann einen Auftrag für eine Testwebsite ein:

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

Verwenden Sie für eine Bibliothek die Bibliotheksvariante:

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

Learn warnt, dass Versionen, die auf diese Weise gelöscht werden, endgültig entfernt werden und nicht in den Papierkorb gelangen. Die Cmdlet-Referenz führt außerdem -WhatIf und -Confirm als Parameter auf. Die Referenz beschreibt -WhatIf nur als Anzeige dessen, was beim Ausführen des Cmdlets passieren würde. Zur Ausgabe dieser Cmdlets macht sie keine Angaben. Betrachten Sie diesen Parameter daher nicht als Ersatz für die berichtsbasierte Was-wäre-wenn-Analyse.

Schritt 4: Auftrag überwachen

Bereinigungsaufträge laufen asynchron ab. Laut Learn erfolgt die Löschung in den kommenden Tagen in Stapeln. Umfang, Systemstatus und Serverauslastung beeinflussen den Zeitplan. Prüfen Sie einen Auftrag auf Websiteebene mit:

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

Für einen Bibliotheksauftrag führt die Learn-Seite zur Bereinigung Get-SPOListFileVersionBatchDeleteJobProgress -Site <url> -List <name> auf. Zum Abbrechen eines Auftrags verwenden Sie Remove-SPOSiteFileVersionBatchDeleteJob oder Remove-SPOListFileVersionBatchDeleteJob. Das Abbrechen stoppt die weitere Löschung, stellt aber bereits gelöschte Versionen nicht wieder her.

Erwarten Sie nicht, dass sich der Speicherbericht sofort ändert. Die Microsoft-Learn-Seite zu Speicherlimits für Websites besagt, dass die Speichernutzung Änderungen der letzten 24 bis 48 Stunden nicht enthält.

Schritt 5: Grenzwerte für neue Versionen festlegen

Ein Kürzungsauftrag verarbeitet nur Versionen, die heute existieren. Um künftige Versionen zu steuern, legen Sie die Versionsrichtlinie für die Website oder Bibliothek fest:

  • Website: Set-SPOSite -Identity <url> -EnableAutoExpirationVersionTrim $true für „Automatisch“-Grenzwerte. Laut Microsoft Learn legen Sie mit -ApplyToNewDocumentLibraries und -ApplyToExistingDocumentLibraries den Geltungsbereich fest.
  • Bibliothek: Set-SPOListVersionPolicy -Site <url> -List <name> -EnableAutoExpirationVersionTrim $true.

Eine Richtlinie für eine Website oder Bibliothek kürzt keine bereits vorhandenen Versionen. Stellen Sie dafür einen Kürzungsauftrag in die Warteschlange. Änderungen an bestehenden Bibliotheken werden in einem Hintergrundauftrag verarbeitet, der laut Microsoft Learn bis zu 24 Stunden dauern kann. Microsoft Learn ergänzt, dass beim Senken eines Anzahllimits für eine Bibliothek vorhandene Versionen oberhalb des neuen Limits schrittweise gekürzt werden, und zwar bis zu 20 pro neu erstellter Version. Die Benutzeroberfläche des Admin Centers akzeptiert keine weniger als 100 Hauptversionen und kein Ablaufintervall von weniger als 30 Tagen. Microsoft Learn weist darauf hin, dass niedrigere Werte über öffentliche APIs möglich, aber nicht empfohlen sind, da sie zu einem unbeabsichtigten Datenverlust führen können.

Schritt 6: Mandantenweites Kürzen

Microsoft Learn führt Cmdlets auf Mandantenebene auf, etwa New-SPOTenantApplyFileVersionPolicyJob (mit -CollectVersionData, -TrimVersions und -SetVersionPolicy). Sie befinden sich in der öffentlichen Vorschau, benötigen eine Lizenz für SharePoint Advanced Management oder eine Copilot-Lizenz und schließen schreibgeschützte, gesperrte und archivierte Websites aus. Es kann immer nur ein Mandantenauftrag gleichzeitig laufen. Wenn Sie viele Websites verwalten, vergleichen Sie diesen Weg mit einer CSV-Schleife wie im Thread.

Was unklar bleibt

  • Nur Nebenversionen: Der Fragesteller hat nach Dateien gefragt, die nie als Hauptversion veröffentlicht wurden und Hunderte Nebenversionen haben, etwa 0.192. Microsoft Learn sagt nicht, wie das Kürzen nach Anzahllimit mit ihnen umgeht. Erstellen Sie eine Testbibliothek, fügen Sie eine solche Datei hinzu und führen Sie einen kleinen Auftrag aus, bevor Sie Produktivdaten anfassen.
  • Abweichendes Ergebnis: Die Beobachtung des Fragestellers, dass alle Nebenversionen jeder erhaltenen Hauptversion bestehen blieben, wird auf den Seiten, die ich gelesen habe, nicht erklärt.
  • Aufbewahrung: Die Microsoft-Learn-Seite zum Kürzen verweist für Versionen unter Aufbewahrungsrichtlinien oder eDiscovery-Sperren auf eine FAQ. Das Verhalten beschreibt sie auf der Seite selbst nicht.

Verwandte Themen

Quellen

Entitäten in diesem Artikel

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

Verwandte Artikel

RSS