Обрізання версій файлів SharePoint за лімітами кількості: що насправді означає MajorWithMinorVersionsLimit
By Mirko Peters ·
Завдання обрізання з параметрами -MajorVersionLimit 100 та -MajorWithMinorVersionsLimit 5 залишило на місці всі мінорні версії. Ось як Microsoft описує ці два ліміти, як безпечно виконати обрізання та які питання лишаються без відповіді.
Automatically translated with AI from the original post. Read the English original
Адміністратор SharePoint хотів зменшити обсяг сховища, обрізавши версії файлів на всіх сайтах. Він запустив скрипт, який зчитував URL сайтів із CSV-файлу та викликав New-SPOSiteFileVersionBatchDeleteJob з -MajorVersionLimit 100 і -MajorWithMinorVersionsLimit 5. Очікувалося таке: зберегти останні 100 основних версій і останні 5 мінорних версій для кожної основної версії. Результат: основні версії були обрізані, але всі мінорні версії для залишених основних версій лишилися.
Головне
- Microsoft Learn описує -MajorWithMinorVersionsLimit як кількість основних версій, для яких зберігаються всі мінорні версії, а не як обмеження кількості мінорних версій.
- Обидва параметри кількості треба вказувати разом, а навчальний посібник Learn використовує -MajorWithMinorVersionsLimit 0, коли потрібно враховувати лише основні версії.
- Обрізані версії видаляються назавжди й минають кошик, тож спочатку виконайте аналіз what-if і протестуйте на одному сайті.
- Завдання обрізання виконуються у фоновому режимі пакетами протягом наступних днів. Перевірити їх або скасувати можна командлетами для прогресу та видалення.
- Learn не пояснює, як обробляються файли, які мають лише мінорні версії (наприклад, 0.192). Перевірте цей випадок у тестовій бібліотеці.
Це питання опубліковано в Microsoft Community Hub у лютому 2026 року. Відповіді на нього немає. Ця стаття не претендує на його вирішення. Вона показує, що Microsoft Learn каже про два параметри, пропонує обережний спосіб виконання обрізання та позначає місця, де документація і обговорення мають прогалини. Це не офіційна процедура Microsoft.
Що, за документацією, роблять два параметри
На сторінці Learn «Trim existing versions» команда з лімітом кількості подана так: New-SPOSiteFileVersionBatchDeleteJob -Identity $siteUrl -MajorVersionLimit <n> -MajorWithMinorVersionsLimit <n>. Текст-заповнювач для другого параметра звучить як «number of major versions for which all minor versions will be kept» (кількість основних версій, для яких зберігаються всі мінорні версії). На сторінці Learn про ліміти версій бібліотеки для Set-SPOListVersionPolicy майже ті самі слова: кількість основних версій, для яких зберігаються всі мінорні версії.
Сторінка також пояснює, що ручний режим лімітів кількості видаляє найстаріші версії, які перевищують заданий ліміт.
Ще три деталі з документації:
- У довідці з командлетів синтаксис з лімітом кількості вимагає і
-MajorVersionLimit, і-MajorWithMinorVersionsLimit. Кожна сторінка каже, що потрібен і другий параметр. - Навчальний посібник Learn «Queue a trim job» показує
-MajorVersionLimit 100 -MajorWithMinorVersionsLimit 0і позначає це як збереження 100 основних версій. - Приклад у довідці з командлетів використовує
-MajorVersionLimit 30 -MajorWithMinorVersionsLimit 10.
Мені здається, що друге число в цьому формулюванні означає не «скільки другорядних версій зберігати». Ближче за змістом до «для скількох основних версій ви хочете зберігати кожну другорядну версію». Таке прочитання відрізняється від того, чого очікував автор допису. Воно також повністю не пояснює його результат. За значення 5 ви б очікували, що всі другорядні версії збережуться лише для обмеженої кількості основних версій, а не для кожної збереженої основної. Сторінки Microsoft не описують точну схему, тому я не можу сказати, чи автор бачив затримку, інше правило чи помилку. Це питання лишається відкритим.
Крок 1: визначте, який режим обрізання вам потрібен
Learn описує три режими обрізання наявних версій:
- За віком:
-DeleteBeforeDays <days>видаляє версії старші за вказану кількість днів. - За лімітом кількості:
-MajorVersionLimitі-MajorWithMinorVersionsLimit, як описано вище. - Автоматичний:
-Automaticзастосовує логіку параметра «Автоматичні версії» до наявних версій.
На сторінці Learn про обмеження історії версій рекомендовано автоматичний параметр для оптимізованого зберігання версій. Там сказано, що автоматичний параметр поєднує цінність історії версій для відновлення з меншим використанням сховища, без потреби самостійно вгадувати обмеження за кількістю чи віком. На сторінці про сховище версій у плані сказано, що автоматичний режим зберігає версії, створені за перші 30 днів (у межах ліміту 500 версій), а потім з часом їх розріджує до погодинних, щоденних і щотижневих версій.
Для обрізання за віком Learn наводить два обмеження. Завдання не видаляє версії, створені за останні 30 днів, тому вхідні дані мають бути щонайменше 30 днів. Крім того, воно завжди видаляє всі версії, створені до 1 січня 2023 року, тож обрана кількість днів має давати дату пізнішу за цю. Перед тим як покладатися на ці два моменти, перевірте актуальну сторінку.
Крок 2: створіть звіт і виконайте аналіз «що буде, якщо»
Сторінка про обрізання в Learn радить виконати аналіз «що буде, якщо» перед обрізанням (у навчальному посібнику з постановки завдання в чергу його називають необов'язковим). У навчальних посібниках описано звіт про використання сховища версій для сайту або бібліотеки, який ви завантажуєте як файл CSV. Потім запускаєте скрипт для цього звіту в PowerShell 7. Для варіанта з лімітом кількості скрипт «що буде, якщо» з посібника приймає -ImportPath, -ExportPath і -MajorVersionLimit. Ліміт другорядних версій він не приймає. Тож результат аналізу «що буде, якщо» для лімітів кількості моделює лише ліміт основних версій.
На сторінках навчальних посібників не названо командлет, який створює звіт, тож для цього кроку дотримуйтеся посібника Learn. Learn зазначає, що завдання обрізання може тривати кілька днів залежно від розміру бібліотеки. У посібнику з аналізу «що буде, якщо» тривалість не вказана.
Крок 3: спочатку поставте завдання в чергу для одного сайту
Увійдіть як адміністратор SharePoint за допомогою актуальної оболонки SharePoint Online Management Shell, а потім поставте в чергу завдання для одного тестового сайту:
``powershell New-SPOSiteFileVersionBatchDeleteJob -Identity https://contoso.sharepoint.com/sites/site1 -MajorVersionLimit 100 -MajorWithMinorVersionsLimit 0 ``
Для однієї бібліотеки використовуйте варіант для бібліотеки:
``powershell New-SPOListFileVersionBatchDeleteJob -Site https://contoso.sharepoint.com/sites/site1 -List "Documents" -MajorVersionLimit 100 -MajorWithMinorVersionsLimit 0 ``
Learn попереджає, що версії, видалені таким чином, видаляються назавжди і не потрапляють до кошика. Довідка командлетів також перелічує -WhatIf і -Confirm як параметри. Для -WhatIf довідка описує лише те, що показується, якщо командлет буде виконано, без деталей щодо його виводу для цих командлетів, тож не сприймайте його як заміну аналізу «що буде, якщо» на основі звіту.
Крок 4: стежте за завданням
Завдання обрізання виконуються асинхронно. За даними Learn, видалення відбувається пакетами протягом найближчих днів, а на час впливають обсяг, стан служби і навантаження ферми. Перевірити завдання на рівні сайту можна так:
``powershell Get-SPOSiteFileVersionBatchDeleteJobProgress -Identity https://contoso.sharepoint.com/sites/site1 ``
Для завдання на рівні бібліотеки сторінка Learn про обрізання наводить Get-SPOListFileVersionBatchDeleteJobProgress -Site <url> -List <name>. Щоб зупинити завдання, використовуйте Remove-SPOSiteFileVersionBatchDeleteJob або Remove-SPOListFileVersionBatchDeleteJob. Скасування зупиняє подальше видалення, але не відновлює версії, які вже були видалені.
Не очікуйте, що звіт про сховище зміниться одразу. На сторінці Learn про обмеження сховища сайтів сказано, що використання сховища не враховує зміни за останні 24–48 годин.
Крок 5. Встановіть обмеження для нових версій
Завдання очищення обробляє лише ті версії, які існують зараз. Щоб контролювати майбутні версії, встановіть політику версій для сайту або бібліотеки:
- Сайт:
Set-SPOSite -Identity <url> -EnableAutoExpirationVersionTrim $trueдля автоматичних обмежень. Learn згадує-ApplyToNewDocumentLibrariesі-ApplyToExistingDocumentLibraries, щоб вибрати охоплення. - Бібліотека:
Set-SPOListVersionPolicy -Site <url> -List <name> -EnableAutoExpirationVersionTrim $true.
Встановлення політики для сайту або бібліотеки не очищує версії, які вже існують, тому для них поставте завдання очищення в чергу. Зміни для наявних бібліотек обробляються у фоновому завданні, яке, за даними Learn, може тривати до 24 годин. Learn додає, що коли ви знижуєте ліміт кількості для бібліотеки, наявні версії понад новий ліміт очищаються поступово, до 20 на кожну новостворену версію. Центр адміністрування не приймає менше 100 основних версій або термін дії коротший за 30 днів. Learn пише, що менші значення можливі через публічні API, але не рекомендуються, оскільки можуть призвести до випадкової втрати даних.
Крок 6. Очищення на рівні клієнта
Learn перелічує команди на рівні клієнта, як-от New-SPOTenantApplyFileVersionPolicyJob (з -CollectVersionData, -TrimVersions і -SetVersionPolicy). Вони перебувають у публічному preview, потребують ліцензії SharePoint Advanced Management або ліцензії Copilot і виключають сайти лише для читання, заблоковані та архівні сайти. Одночасно може виконуватися лише одне завдання для клієнта. Якщо ви керуєте багатьма сайтами, порівняйте цей шлях із циклом CSV, як у обговоренні.
Що залишається неясним
- Файли лише з проміжними версіями: Автор питання запитав про файли, які ніколи не публікувалися як основна версія і мають сотні проміжних версій, наприклад 0.192. Learn не пояснює, як очищення за лімітом кількості обробляє такі файли. Створіть тестову бібліотеку, додайте такий файл і запустіть невелике завдання, перш ніж чіпати продуктивне середовище.
- Невідповідність результату: Спостереження автора про те, що всі проміжні версії кожної збереженої основної версії залишилися, не пояснюється сторінками, які я прочитав.
- Збереження: Сторінка Learn про очищення посилається на FAQ щодо версій під політиками збереження або утримання для eDiscovery. Поведінку самої сторінки вона не описує.
Пов'язане
Джерела
- Microsoft Learn: Обрізання наявних версій у сайті, бібліотеці або OneDrive
- Microsoft Learn: Постановка завдання обрізання для сайту або бібліотеки документів у чергу
- Microsoft Learn: Запуск аналізу «що, якщо»
- Microsoft Learn: New-SPOSiteFileVersionBatchDeleteJob
- Microsoft Learn: Налаштування обмежень версій для окремої бібліотеки документів
- Microsoft Learn: Налаштування обмежень версій для сайту
- Microsoft Learn: Manage site storage limits
- Microsoft Learn: Огляд обмежень історії версій
- Microsoft Learn: планування зберігання версій у бібліотеках документів
- Microsoft Community Hub: Trimming SharePoint Version History - Minor Versions (February 2026)