Rognage des versions de fichiers SharePoint avec limites de nombre : ce que signifie réellement MajorWithMinorVersionsLimit
Par Mirko Peters ·
Une tâche de rognage lancée avec -MajorVersionLimit 100 et -MajorWithMinorVersionsLimit 5 a laissé toutes les versions mineures en place. Voici comment Microsoft décrit les deux limites, comment exécuter un rognage en toute sécurité et ce qui reste flou.
Traduit automatiquement par IA à partir de l'article original. Lire l'original en anglais
Un administrateur SharePoint souhaitait réduire le stockage en rognant les versions de fichiers sur l'ensemble des sites. Il a exécuté un script qui lisait les URL des sites depuis un fichier CSV et appelait New-SPOSiteFileVersionBatchDeleteJob avec -MajorVersionLimit 100 et -MajorWithMinorVersionsLimit 5. Le résultat attendu était de conserver les 100 dernières versions majeures ainsi que les 5 dernières versions mineures de chaque version majeure. Le résultat obtenu : les versions majeures ont bien été rognées, mais toutes les versions mineures des versions majeures restantes ont été conservées.
Points clés
- Microsoft Learn décrit -MajorWithMinorVersionsLimit comme le nombre de versions majeures pour lesquelles toutes les versions mineures sont conservées, et non comme une limite sur le nombre de versions mineures.
- Les deux paramètres de nombre doivent être indiqués ensemble, et le tutoriel Learn utilise -MajorWithMinorVersionsLimit 0 lorsque seules les versions majeures doivent être comptabilisées.
- Les versions rognées sont supprimées définitivement et contournent la corbeille. Exécutez donc d'abord l'analyse what-if et testez sur un seul site.
- Les tâches de rognage s'exécutent en arrière-plan, par lots, au cours des jours suivants ; vous pouvez les contrôler ou les annuler avec les cmdlets de progression et de suppression.
- Learn ne précise pas comment sont traités les fichiers qui ne comportent que des versions mineures (par exemple 0.192). Vérifiez ce cas sur une bibliothèque de test.
Cette question a été publiée sur le Microsoft Community Hub en février 2026 et n'a reçu aucune réponse. Cet article ne prétend pas la résoudre. Il présente ce que Microsoft Learn indique sur les deux paramètres, propose une méthode prudente pour exécuter un rognage et signale les points où la documentation et le fil de discussion laissent une zone d'ombre. Il ne s'agit pas d'une procédure officielle de Microsoft.
Ce que les deux paramètres sont censés faire selon la documentation
La page Learn « Trim existing versions » présente la commande à limite de nombre ainsi : New-SPOSiteFileVersionBatchDeleteJob -Identity $siteUrl -MajorVersionLimit <n> -MajorWithMinorVersionsLimit <n>. Le texte indicatif du second paramètre se lit « nombre de versions majeures pour lesquelles toutes les versions mineures seront conservées ». La page Learn consacrée aux limites de versions des bibliothèques utilise presque les mêmes termes pour Set-SPOListVersionPolicy : le nombre de versions majeures pour lesquelles toutes les versions mineures sont conservées.
La page précise également que le mode manuel à limite de nombre supprime les versions les plus anciennes qui dépassent la limite spécifiée.
Trois autres précisions issues de la documentation :
- Dans la référence des cmdlets, la syntaxe à limite de nombre exige à la fois
-MajorVersionLimitet-MajorWithMinorVersionsLimit. Chaque page indique que l'autre paramètre est également nécessaire. - Le tutoriel Learn « Queue a trim job » présente
-MajorVersionLimit 100 -MajorWithMinorVersionsLimit 0et le décrit comme conservant 100 versions majeures. - L'exemple de la référence des cmdlets utilise
-MajorVersionLimit 30 -MajorWithMinorVersionsLimit 10.
D'après moi, cette formulation ne signifie pas « combien de versions mineures conserver ». Elle s'en rapproche davantage de : « pour combien de versions majeures souhaitez-vous conserver chaque version mineure ». Cette lecture diffère de ce que le posteur attendait et n'explique pas non plus entièrement le résultat qu'il a obtenu. Avec une valeur de 5, on s'attendrait à ce que les versions mineures ne survivent que pendant un nombre limité de versions majeures, et non pour chaque version majeure conservée. Les pages de Microsoft ne décrivent pas le schéma exact. Je ne peux donc pas dire si le posteur a observé un délai, une règle différente ou un bogue. Je laisse ce point ouvert.
Étape 1 : déterminer le mode de nettoyage nécessaire
La documentation Learn décrit trois modes de nettoyage pour les versions existantes :
- Ancienneté :
-DeleteBeforeDays <days>supprime les versions plus anciennes que le nombre de jours indiqué. - Limite de nombre :
-MajorVersionLimitet-MajorWithMinorVersionsLimit, comme décrit précédemment. - Automatique :
-Automaticapplique la logique du paramètre Automatique aux versions existantes.
La page Learn sur les limites de l’historique des versions recommande le paramètre Automatique pour un stockage optimisé des versions. Elle indique que ce paramètre combine la valeur de récupération de l’historique des versions avec une consommation de stockage réduite, sans que vous ayez à deviner des limites de nombre ou d’ancienneté. La page sur le stockage des versions dans les plans précise qu’Automatique conserve les versions créées au cours des 30 premiers jours (dans la limite de 500 versions), puis les réduit progressivement à des versions horaires, quotidiennes puis hebdomadaires à mesure qu’elles vieillissent.
Pour le nettoyage fondé sur l’ancienneté, Learn mentionne deux limites. La tâche ne supprime pas les versions créées au cours des 30 derniers jours : la valeur saisie doit donc être d’au moins 30 jours. Elle supprime également systématiquement toutes les versions créées avant le 1er janvier 2023 : le nombre de jours choisi doit donc produire une date postérieure à cette date. Vérifiez la page actuelle avant de vous appuyer sur ces deux points.
Étape 2 : générer le rapport et exécuter l’analyse what-if
La page Learn sur le nettoyage recommande d’exécuter une analyse what-if avant le nettoyage (le tutoriel « queue-a-job » la présente comme facultative). Les tutoriels décrivent un rapport d’utilisation du stockage des versions pour le site ou la bibliothèque, que vous téléchargez au format CSV. Vous exécutez ensuite un script sur ce rapport avec PowerShell 7. Dans le cas de la limite de nombre, le script what-if du tutoriel prend -ImportPath, -ExportPath et -MajorVersionLimit. Il ne prend pas de limite de versions mineures. Le résultat de l’analyse what-if pour les limites de nombre ne modélise donc que la limite de versions majeures.
Les tutoriels ne nomment pas l’applet de commande qui crée le rapport. Suivez donc le tutoriel Learn pour cette étape. Learn indique qu’une tâche de nettoyage peut durer quelques jours, selon la taille de la bibliothèque. Le tutoriel what-if ne précise pas de durée.
Étape 3 : planifier la tâche sur un premier site
Connectez-vous en tant qu’administrateur SharePoint avec le SharePoint Online Management Shell actuel, puis planifiez une tâche pour un site de test :
``powershell New-SPOSiteFileVersionBatchDeleteJob -Identity https://contoso.sharepoint.com/sites/site1 -MajorVersionLimit 100 -MajorWithMinorVersionsLimit 0 ``
Pour une seule bibliothèque, utilisez la variante dédiée aux bibliothèques :
``powershell New-SPOListFileVersionBatchDeleteJob -Site https://contoso.sharepoint.com/sites/site1 -List "Documents" -MajorVersionLimit 100 -MajorWithMinorVersionsLimit 0 ``
Learn avertit que les versions supprimées de cette façon sont définitivement supprimées et ne passent pas par la corbeille. La référence des applets de commande mentionne également -WhatIf et -Confirm comme paramètres. Elle décrit -WhatIf uniquement comme l’affichage de ce qui se produirait si l’applet de commande était exécutée, sans précision sur sa sortie pour ces applets. Ne le considérez donc pas comme un remplacement de l’analyse what-if fondée sur le rapport.
Étape 4 : suivre la tâche
Les tâches de nettoyage sont asynchrones. Selon Learn, la suppression s’effectue par lots au cours des jours suivants, et le volume, l’état du service et la charge de la ferme SharePoint influent sur le calendrier. Pour vérifier une tâche au niveau du site, utilisez :
``powershell Get-SPOSiteFileVersionBatchDeleteJobProgress -Identity https://contoso.sharepoint.com/sites/site1 ``
Pour une tâche sur une bibliothèque, la page Learn sur le nettoyage indique Get-SPOListFileVersionBatchDeleteJobProgress -Site <url> -List <name>. Pour arrêter une tâche, utilisez Remove-SPOSiteFileVersionBatchDeleteJob ou Remove-SPOListFileVersionBatchDeleteJob. L’annulation arrête les suppressions en cours, mais ne restaure pas les versions déjà supprimées.
Ne vous attendez pas à ce que le rapport de stockage change immédiatement. La page Microsoft Learn sur les limites de stockage des sites indique que l’utilisation du stockage n’intègre pas les modifications effectuées au cours des 24 à 48 dernières heures.
Étape 5 : définir des limites pour les nouvelles versions
Une tâche de suppression de versions ne traite que les versions existantes. Pour contrôler les versions futures, définissez la stratégie de version sur le site ou la bibliothèque :
- Site :
Set-SPOSite -Identity <url> -EnableAutoExpirationVersionTrim $truepour les limites automatiques. Microsoft Learn indique que-ApplyToNewDocumentLibrarieset-ApplyToExistingDocumentLibrariespermettent de choisir l’étendue d’application. - Bibliothèque :
Set-SPOListVersionPolicy -Site <url> -List <name> -EnableAutoExpirationVersionTrim $true.
Définir une stratégie sur un site ou une bibliothèque ne supprime pas les versions déjà existantes ; il faut donc planifier une tâche de suppression pour celles-ci. Les modifications apportées aux bibliothèques existantes sont traitées dans une tâche en arrière-plan qui, selon Microsoft Learn, peut durer jusqu’à 24 heures. Microsoft Learn précise également que lorsque vous abaissez le nombre limite de versions d’une bibliothèque, les versions existantes au-delà de la nouvelle limite sont supprimées progressivement, à raison de 20 au maximum par nouvelle version créée. L’interface du centre d’administration n’accepte pas moins de 100 versions principales ni une durée d’expiration inférieure à 30 jours. Microsoft Learn indique que des valeurs plus basses sont possibles via les API publiques, mais déconseillées, car elles peuvent entraîner une perte de données involontaire.
Étape 6 : suppression des versions à l’échelle du locataire
Microsoft Learn répertorie des applets de commande de niveau locataire, telles que New-SPOTenantApplyFileVersionPolicyJob (avec -CollectVersionData, -TrimVersions et -SetVersionPolicy). Elles sont en préversion publique, nécessitent une licence SharePoint Advanced Management ou une licence Copilot, et excluent les sites en lecture seule, verrouillés et archivés. Une seule tâche à l’échelle du locataire peut s’exécuter à la fois. Si vous gérez de nombreux sites, comparez cette approche avec une boucle sur un fichier CSV, comme celle présentée dans le fil de discussion.
Ce qui reste flou
- Fichiers à versions mineures uniquement : l’auteur de la question évoquait des fichiers qui n’ont jamais été publiés en tant que version principale et qui comptent des centaines de versions mineures, comme 0.192. Microsoft Learn ne précise pas comment la limitation par nombre de versions les traite. Créez une bibliothèque de test, ajoutez-y un fichier de ce type et exécutez une petite tâche avant de toucher à la production.
- Incohérence des résultats : la constatation de l’auteur, selon laquelle toutes les versions mineures de chaque version principale conservée ont été maintenues, n’est pas expliquée par les pages que j’ai consultées.
- Rétention : la page Microsoft Learn sur la suppression des versions renvoie à une FAQ concernant les versions soumises à une stratégie de rétention ou à une conservation eDiscovery. Elle ne décrit pas ce comportement dans la page elle-même.
Ressources associées
- SharePoint
- Gestion intelligente des versions
- Bibliothèques de documents SharePoint
- SharePoint Advanced Management
Sources
- Microsoft Learn : supprimer les versions existantes d’un site, d’une bibliothèque ou de OneDrive
- Microsoft Learn : planifier une tâche de suppression de versions pour un site ou une bibliothèque de documents
- Microsoft Learn : exécuter une analyse hypothétique
- Microsoft Learn : New-SPOSiteFileVersionBatchDeleteJob
- Microsoft Learn : définir les limites de version pour une bibliothèque de documents individuelle
- Microsoft Learn : définir les limites de version pour un site
- Microsoft Learn : gérer les limites de stockage des sites
- Microsoft Learn : présentation des limites de l’historique des versions
- Microsoft Learn : Planifier le stockage des versions sur les bibliothèques de documents
- Microsoft Community Hub : Réduction de l’historique des versions SharePoint – Versions mineures (février 2026)