Очистка версий файлов 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 и проверьте работу на одном сайте.
- Задания очистки выполняются в фоновом режиме пакетами в течение следующих дней. Проверить их состояние или отменить можно с помощью командлетов для проверки прогресса и Remove-.
- Learn не говорит, как обрабатываются файлы, в которых есть только промежуточные версии (например, 0.192), поэтому проверьте этот случай на тестовой библиотеке.
Этот вопрос был опубликован в Microsoft Community Hub в феврале 2026 года, ответа на него нет. Эта статья не претендует на его решение. Она показывает, что Microsoft Learn говорит о двух параметрах, предлагает аккуратный способ провести очистку и отмечает места, где документация и обсуждение оставляют пробелы. Это не официальная процедура Microsoft.
Что документировано для двух параметров
На странице Learn «Trim existing versions» команда с ограничением по количеству записана так: New-SPOSiteFileVersionBatchDeleteJob -Identity $siteUrl -MajorVersionLimit <n> -MajorWithMinorVersionsLimit <n>. Текст-заполнитель для второго параметра гласит: «количество основных версий, для которых сохраняются все промежуточные версии». На странице 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. Создайте отчёт и выполните анализ what-if
На странице Learn об очистке рекомендуется выполнить анализ what-if перед очисткой (руководство по постановке задания в очередь называет его необязательным). В руководствах описан отчёт об использовании хранилища версий для сайта или библиотеки, который вы скачиваете в виде файла CSV. Затем вы запускаете скрипт для этого отчёта в PowerShell 7. Для случая с ограничением по количеству скрипт what-if из руководства принимает -ImportPath, -ExportPath и -MajorVersionLimit. Ограничение по минорным версиям он не принимает. Поэтому результат what-if для ограничений по количеству моделирует только ограничение мажорных версий.
На страницах руководств не назван командлет, который создаёт отчёт, поэтому для этого шага следуйте руководству Learn. В Learn сказано, что задание очистки может выполняться несколько дней в зависимости от размера библиотеки. В руководстве по what-if длительность не указана.
Шаг 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 справка указывает только, что он показывает, что произойдёт при запуске командлета, и не раскрывает, как выглядит вывод для этих командлетов. Поэтому не считайте его заменой анализа what-if на основе отчёта.
Шаг 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). Они находятся в публичной предварительной версии, требуют лицензии SharePoint Advanced Management или Copilot и исключают сайты только для чтения, заблокированные и архивные сайты. Одновременно может выполняться только одно задание на уровне клиента. Если вы управляете большим количеством сайтов, сравните этот подход с циклом по CSV-файлу, как в обсуждении.
Что остаётся неясным
- Файлы только с секционными версиями: Автор вопроса спрашивал о файлах, которые никогда не публиковались как основная версия и имеют сотни промежуточных версий, например 0.192. Learn не описывает, как очистка по количеству версий обрабатывает такие файлы. Создайте тестовую библиотеку, добавьте такой файл и запустите небольшое задание, прежде чем трогать рабочую среду.
- Расхождение результатов: Наблюдение автора вопроса, что все промежуточные версии каждой сохранённой основной версии остались, не объясняется страницами, которые я изучил.
- Хранение: На странице Learn об очистке версий есть ссылка на часто задаваемые вопросы о версиях под политиками хранения или удержания 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)