M365Con 2027 – bezpłatna konferencja online · 11–22 Jan 2027 · 120 sessions→ m365con.net

Blog · Mirko Peters

Przycinanie wersji plików w SharePoint z limitami liczby: co naprawdę oznacza MajorWithMinorVersionsLimit

By ·

Zadanie przycinania z parametrami -MajorVersionLimit 100 i -MajorWithMinorVersionsLimit 5 pozostawiło wszystkie wersje pomocnicze. Oto, jak Microsoft opisuje oba limity, jak bezpiecznie uruchomić przycinanie i co pozostaje niejasne.

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

Administrator SharePoint chciał zmniejszyć zużycie miejsca, przycinając wersje plików we wszystkich witrynach. Uruchomił skrypt, który odczytywał adresy URL witryn z pliku CSV i wywoływał New-SPOSiteFileVersionBatchDeleteJob z parametrami -MajorVersionLimit 100 i -MajorWithMinorVersionsLimit 5. Oczekiwanie było takie: zachować ostatnie 100 wersji głównych oraz ostatnie 5 wersji pomocniczych każdej wersji głównej. Efekt był inny: wersje główne zostały przycięte, ale wszystkie wersje pomocnicze pozostałych wersji głównych zostały na miejscu.

Najważniejsze wnioski

  • Microsoft Learn opisuje parametr -MajorWithMinorVersionsLimit jako liczbę wersji głównych, dla których zachowywane są wszystkie wersje pomocnicze, a nie jako limit liczby wersji pomocniczych.
  • Oba parametry liczbowe trzeba podać razem. Samouczek Learn używa -MajorWithMinorVersionsLimit 0, gdy mają być liczone wyłącznie wersje główne.
  • Przycięte wersje są usuwane trwale i omijają kosz, dlatego najpierw uruchom analizę typu what-if i przetestuj działanie na jednej witrynie.
  • Zadania przycinania działają w tle, partiami, w ciągu kolejnych dni. Możesz je sprawdzać lub anulować za pomocą poleceń do sprawdzania postępu oraz poleceń Remove.
  • Learn nie wyjaśnia, jak traktowane są pliki mające wyłącznie wersje pomocnicze (na przykład 0.192), dlatego tę sytuację warto sprawdzić na testowej bibliotece.

To pytanie zostało zadane w Microsoft Community Hub w lutym 2026 roku i nie ma na nie odpowiedzi. Ten artykuł nie twierdzi, że je rozwiązuje. Pokazuje, co Microsoft Learn mówi o obu parametrach, podaje ostrożny sposób uruchomienia przycinania i wskazuje miejsca, w których dokumentacja oraz wątek pozostawiają lukę. Nie jest to oficjalna procedura Microsoft.

Co według dokumentacji robią oba parametry

Strona Learn „Trim existing versions” podaje polecenie z limitem liczby wersji w następującej postaci: New-SPOSiteFileVersionBatchDeleteJob -Identity $siteUrl -MajorVersionLimit <n> -MajorWithMinorVersionsLimit <n>. Symbol zastępczy drugiego parametru opisuje go jako „liczbę wersji głównych, dla których zostaną zachowane wszystkie wersje pomocnicze”. Strona Learn o limitach wersji bibliotek używa niemal tych samych sformułowań dla polecenia Set-SPOListVersionPolicy: liczba wersji głównych, dla których zachowywane są wszystkie wersje pomocnicze.

Strona podaje także, że ręczny tryb limitu liczby wersji usuwa najstarsze wersje przekraczające określony limit.

Trzy dodatkowe szczegóły z dokumentacji:

  1. W dokumentacji polecenia składnia limitu liczby wersji wymaga zarówno -MajorVersionLimit, jak i -MajorWithMinorVersionsLimit. Każda ze stron mówi, że potrzebny jest także drugi z tych parametrów.
  2. Samouczek Learn „Queue a trim job” pokazuje -MajorVersionLimit 100 -MajorWithMinorVersionsLimit 0 i opisuje to jako zachowanie 100 wersji głównych.
  3. Przykład w dokumentacji polecenia używa -MajorVersionLimit 30 -MajorWithMinorVersionsLimit 10.

Moim zdaniem to sformułowanie oznacza, że druga liczba nie określa „ile wersji pomocniczych zachować”. Bliżej jej do: „dla ilu wersji głównych chcesz zachować każdą wersję pomocniczą”. Takie odczytanie różni się od tego, czego spodziewał się autor pytania, i nie wyjaśnia w pełni jego wyniku. Przy wartości 5 należałoby oczekiwać, że wszystkie wersje pomocnicze przetrwają tylko przez ograniczoną liczbę wersji głównych, a nie przez każdą zachowaną wersję główną. Strony Microsoftu nie opisują dokładnego schematu, więc nie mogę stwierdzić, czy autor zauważył opóźnienie, inną regułę czy błąd. Traktuję to jako kwestię otwartą.

Krok 1: Wybierz tryb przycinania, którego potrzebujesz

Dokumentacja Learn opisuje trzy tryby przycinania istniejących wersji:

  • Wiek: -DeleteBeforeDays <days> usuwa wersje starsze niż podana liczba dni.
  • Limit liczby: -MajorVersionLimit i -MajorWithMinorVersionsLimit, jak wyżej.
  • Automatyczny: -Automatic stosuje logikę ustawienia Automatic do istniejących wersji.

Strona Learn o limitach historii wersji zaleca ustawienie Automatic w celu zoptymalizowanego przechowywania wersji. Według niej ustawienie Automatic łączy wartość odzyskiwania historii wersji z mniejszym zużyciem miejsca, bez konieczności zgadywania limitów liczby lub wieku. Strona o przechowywaniu wersji w planie mówi, że Automatic zachowuje wersje utworzone w ciągu pierwszych 30 dni (w ramach limitu 500 wersji), a następnie z czasem stopniowo je przerzedza do wersji godzinowych, dziennych i tygodniowych.

W przypadku przycinania opartego na wieku Learn podaje dwa ograniczenia. Zadanie nie usuwa wersji utworzonych w ciągu ostatnich 30 dni, więc wartość wejściowa musi wynosić co najmniej 30 dni. Zawsze usuwa też wszystkie wersje utworzone przed 1 stycznia 2023 r., więc wybrana liczba dni musi dawać datę późniejszą niż ta. Przed poleganiem na tych dwóch punktach sprawdź aktualną stronę.

Krok 2: Wygeneruj raport i uruchom analizę typu what-if

Strona Learn o przycinaniu zaleca uruchomienie analizy what-if przed przycinaniem (samouczek o kolejkowaniu zadania określa ją jako opcjonalną). Samouczki opisują raport wykorzystania magazynu wersji dla witryny lub biblioteki, który pobierasz jako plik CSV. Następnie uruchamiasz skrypt na podstawie tego raportu w PowerShell 7. W przypadku limitu liczby skrypt what-if z samouczka przyjmuje parametry -ImportPath, -ExportPath i -MajorVersionLimit. Nie przyjmuje limitu wersji pomocniczych, więc wynik what-if dla limitów liczby modeluje tylko limit wersji głównych.

Strony samouczków nie podają nazwy polecenia cmdlet, które tworzy raport, więc w tym kroku postępuj zgodnie z samouczkiem Learn. Learn podaje, że zadanie przycinania może potrwać kilka dni, w zależności od rozmiaru biblioteki. Samouczek what-if nie podaje czasu trwania.

Krok 3: Najpierw zakolejkuj zadanie dla jednej witryny

Połącz się jako administrator SharePoint, używając aktualnej powłoki SharePoint Online Management Shell, a następnie zakolejkuj zadanie dla jednej witryny testowej:

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

W przypadku jednej biblioteki użyj wariantu dla biblioteki:

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

Learn ostrzega, że wersje usunięte w ten sposób są trwale usuwane i nie trafiają do kosza. Dokumentacja polecenia cmdlet wymienia też parametry -WhatIf i -Confirm. Opisuje -WhatIf wyłącznie jako pokazanie, co wykonałoby polecenie cmdlet po uruchomieniu, i nie podaje szczegółów dotyczących jego wyniku dla tych poleceń, więc nie traktuj go jako zamiennika analizy what-if opartej na raporcie.

Krok 4: Monitoruj zadanie

Zadania przycinania są asynchroniczne. Według Learn usuwanie odbywa się partiami w ciągu nadchodzących dni, a na czas wpływają wielkość danych, stan usługi i obciążenie farmy. Zadanie na poziomie witryny sprawdzisz poleceniem:

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

W przypadku zadania dla biblioteki strona Learn o przycinaniu podaje Get-SPOListFileVersionBatchDeleteJobProgress -Site <url> -List <name>. Aby zatrzymać zadanie, użyj Remove-SPOSiteFileVersionBatchDeleteJob lub Remove-SPOListFileVersionBatchDeleteJob. Anulowanie zatrzymuje dalsze usuwanie, ale nie przywraca wersji, które zostały już usunięte.

Nie spodziewaj się, że raport o wykorzystaniu magazynu zmieni się od razu. Strona Microsoft Learn o limitach magazynu witryn mówi, że wykorzystanie magazynu nie uwzględnia zmian z ostatnich 24–48 godzin.

Krok 5: Ustaw limity dla nowych wersji

Zadanie przycinania obejmuje wyłącznie wersje, które istnieją obecnie. Aby kontrolować przyszłe wersje, ustaw zasady wersjonowania na poziomie witryny lub biblioteki:

  • Witryna: Set-SPOSite -Identity <url> -EnableAutoExpirationVersionTrim $true dla automatycznych limitów. Microsoft Learn wymienia parametry -ApplyToNewDocumentLibraries i -ApplyToExistingDocumentLibraries, za pomocą których wybierasz zakres.
  • Biblioteka: Set-SPOListVersionPolicy -Site <url> -List <name> -EnableAutoExpirationVersionTrim $true.

Ustawienie zasad dla witryny lub biblioteki nie przycina wersji, które już istnieją, dlatego dla nich trzeba zlecić zadanie przycinania. Zmiany w istniejących bibliotekach są przetwarzane w zadaniu w tle, które — według Microsoft Learn — może trwać do 24 godzin. Dokumentacja dodaje, że po obniżeniu limitu liczby wersji w bibliotece istniejące wersje powyżej nowego limitu są przycinane stopniowo, najwyżej po 20 przy każdej nowo utworzonej wersji. Centrum administracyjne nie przyjmuje wartości niższych niż 100 wersji głównych ani wygaśnięcia krótszego niż 30 dni. Microsoft Learn podaje, że niższe wartości są możliwe przez publiczne interfejsy API, ale nie są zalecane, ponieważ mogą prowadzić do niezamierzonej utraty danych.

Krok 6: Przycinanie w skali całej dzierżawy

Microsoft Learn wymienia cmdlety na poziomie dzierżawy, takie jak New-SPOTenantApplyFileVersionPolicyJob (z parametrami -CollectVersionData, -TrimVersions i -SetVersionPolicy). Są one w publicznej wersji zapoznawczej, wymagają licencji SharePoint Advanced Management lub licencji Copilot i wykluczają witryny tylko do odczytu, zablokowane oraz zarchiwizowane. Jednocześnie może działać tylko jedno zadanie dla dzierżawy. Jeśli zarządzasz wieloma witrynami, porównaj tę metodę z pętlą CSV, podobną do tej z omawianego wątku.

Czego nadal nie wiadomo

  • Pliki zawierające wyłącznie wersje pomocnicze: Autor pytania dotyczył plików, które nigdy nie zostały opublikowane jako wersja główna i mają setki wersji pomocniczych, np. 0.192. Microsoft Learn nie opisuje, jak przycinanie według liczby wersji je traktuje. Utwórz bibliotekę testową, dodaj taki plik i uruchom małe zadanie, zanim zmienisz cokolwiek na środowisku produkcyjnym.
  • Niezgodność wyników: Obserwacja autora, że zachowały się wszystkie wersje pomocnicze każdej zachowanej wersji głównej, nie jest wyjaśniona na stronach, które przeczytałem.
  • Retencja: Strona Microsoft Learn o przycinaniu odsyła do często zadawanych pytań dotyczących wersji objętych zasadami przechowywania lub wstrzymaniami eDiscovery. Sama strona nie opisuje tego zachowania.

Powiązane

Źródła

Entities in this article

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

Related articles

RSS