SPOVC, SharePoint Version Cleaner

Ce que fait SPOVC

SharePoint Online conserve chaque version d'un fichier modifié, et ces versions comptent dans le stockage du tenant. Le plancher de rétention de SharePoint (souvent 100 versions) laisse sur de nombreux fichiers des dizaines de versions que plus personne n'ouvrira. SPOVC mesure ce volume et le libère, site par site, jusqu'au nombre de versions que vous décidez de garder.

  • Analyser (Scan) compte les versions et chiffre exactement ce qu'un nettoyage supprimerait. Ne supprime rien. Gratuit.
  • Nettoyer (Clean up) supprime les versions au-delà du nombre choisi, en gardant toujours les plus récentes. Couvert par la licence.
  • Gouvernance repère les sites inutilisés, les ouvertures vers l'extérieur et les permissions à risque, et produit un rapport et un classeur de revue. Lecture seule, gratuit.

SPOVC fonctionne sur votre serveur ou votre poste Windows. Il se connecte à votre tenant avec sa propre inscription d'application et un certificat : aucun mot de passe n'est stocké et aucune donnée de vos sites ne quitte votre environnement.

Prérequis

ÉlémentDétail
WindowsWindows 10/11 ou Windows Server 2016 et plus récent. L'interface est une application Windows.
PowerShell 7PowerShell 7.4 ou plus récent (pwsh). L'installeur le vérifie et propose le lien de téléchargement s'il manque.
PnP.PowerShellModule PowerShell utilisé pour parler à SharePoint. L'installeur et l'assistant de configuration proposent de l'installer.
Accès internetVers login.microsoftonline.com, graph.microsoft.com, <tenant>.sharepoint.com et spovc.matissime.eu (licence et mises à jour).
Compte administrateurPour la configuration initiale seulement : un compte pouvant créer une inscription d'application et accorder le consentement administrateur (Administrateur général, ou Administrateur d'application et Administrateur de rôle privilégié).

SPOVC demande trois autorisations d'application, accordées une fois pour tout le tenant :

AutorisationUtilisée pour
Sites.FullControl.All (SharePoint)Lire et supprimer les versions de fichiers, lire les permissions des sites. Indispensable.
Reports.Read.All (Graph)Rapports d'usage pour la gouvernance, et nombre d'utilisateurs actifs pour vérifier l'offre de la licence.
Group.Read.All (Graph)Activité des groupes Microsoft 365 et des Teams pour la gouvernance.

Installation

  1. Téléchargez l'installeur avec le bouton Télécharger SPOVC de l'e-mail de votre licence, ou sur spovc.matissime.eu/telecharger avec votre clé de licence.
  2. Lancez SPOVC-Setup-x.y.z.exe avec le compte Windows qui utilisera SPOVC. L'installation se fait pour cet utilisateur uniquement et ne demande pas de droits administrateur.
  3. Laissez cochée l'installation de PnP.PowerShell si le module n'est pas encore présent, puis lancez SPOVC depuis le menu Démarrer.

Pourquoi par utilisateur ? Le certificat qui permet à SPOVC de se connecter est stocké dans le magasin personnel de ce compte Windows. Installez et utilisez SPOVC avec le même compte, y compris pour les exécutions planifiées.

Les paramètres, journaux, rapports, la licence et les données de gouvernance sont écrits dans %LOCALAPPDATA%\SPOVC. Ils sont conservés lors des mises à jour et d'une désinstallation.

Première configuration

Au premier lancement, SPOVC propose Set up SPOVC. L'assistant se déroule en huit étapes et peut être relancé sans risque.

Premier lancement : SPOVC propose de se configurer.
Premier lancement : SPOVC propose de se configurer.
  1. Prérequis : vérifie PowerShell et PnP.PowerShell, et propose Install PnP.PowerShell si besoin.
  2. Connexion : Sign in with Microsoft avec le compte administrateur. SPOVC détecte le nom du tenant et l'adresse SharePoint. Vous pouvez aussi saisir le tenant vous-même.
  3. Connexion : SPOVC a trouvé le tenant.
    Connexion : SPOVC a trouvé le tenant.
  4. Choix : SPOVC cherche une inscription déjà créée dans le tenant. Choisissez Register SPOVC for me (recommandé), réutilisez l'inscription existante, ou indiquez la vôtre.
  5. Choix de l'inscription.
    Choix de l'inscription.
  6. Détails : nom du tenant, nom de l'application et durée du certificat (2 ans par défaut).
  7. Détails du tenant et de l'application.
    Détails du tenant et de l'application.
  8. Inscription : création de l'application dans Entra ID et du certificat dans le magasin de l'utilisateur.
  9. Consentement et vérification : SPOVC accorde les autorisations puis teste chaque capacité (liste des sites, lecture des versions, rapports, groupes). Juste après un consentement, Microsoft peut mettre quelques minutes à appliquer les droits : utilisez Run again.
  10. Vérification : chaque capacité est testée sur le tenant.
    Vérification : chaque capacité est testée sur le tenant.
  11. Préférences : Versions to keep per file, sites à ne jamais toucher et profils de départ.
  12. Préférences : versions à garder et sites à ne jamais toucher.
    Préférences : versions à garder et sites à ne jamais toucher.
  13. Fin : SPOVC se connecte et affiche l'écran d'accueil.
  14. Fin : récapitulatif de la configuration.
    Fin : récapitulatif de la configuration.

Combien de versions garder ? 25 est un bon départ pour la plupart des organisations. Les versions les plus récentes sont toujours conservées ; seules les plus anciennes au-delà de ce nombre sont supprimées.

Activer la licence

L'analyse, les rapports et la gouvernance fonctionnent sans licence. Le nettoyage nécessite une licence activée pour votre tenant.

  1. Cliquez sur le badge de licence en haut à droite (Evaluation).
  2. Collez la clé reçue par e-mail (SPOVC-XXXXX-...) et cliquez sur Activate.
  3. La licence est liée à votre tenant et le badge passe au vert.
La fenêtre de licence.
La fenêtre de licence.
  • Plusieurs machines : la licence est liée au tenant, pas à la machine. Activez la même clé sur chaque poste qui gère ce tenant.
  • Offre et nombre d'utilisateurs : chaque offre couvre un nombre d'utilisateurs Microsoft 365 actifs sur 30 jours (TPE jusqu'à 50, PME jusqu'à 250, ETI jusqu'à 1 000, Grande entreprise sans limite), avec une marge de 10 %. SPOVC le vérifie au plus une fois par semaine.
  • Sans accès internet : écrivez-nous avec votre clé ; vous recevrez un fichier de licence à importer avec Import licence file....
  • Mises à jour : la licence est à vie et inclut les versions publiées pendant 12 mois après l'achat (voir Mises à jour).

L'écran d'accueil

ZoneRôle
Bandeau supérieurBadge de licence, nombre de versions conservées et tenant connecté.
Barre de connexionÉtat de la connexion, validité du certificat, Sign in et Sign out.
TARGETSelect sites : choisissez les sites à analyser ou nettoyer (recherche, tri, taille).
Exécution en arrière-planSuivi de la dernière exécution : Watch / Details, Open report, Stop, Dismiss.
ACTIONSScan, Clean up et Governance.
MOREReports, Recycle bin, Tools, Settings, Keep session alive.
L'écran d'accueil, connecté.
L'écran d'accueil, connecté.

La méthode recommandée tient en une ligne : analysez d'abord, lisez le rapport, puis nettoyez.

Analyser (Scan)

  1. Select sites : cochez les sites voulus, ou tous. Commencez par les plus volumineux : c'est là que se trouve l'essentiel du volume.
  2. Sélection des sites, triés par taille.
    Sélection des sites, triés par taille.
  3. Cliquez sur Scan. L'analyse part en arrière-plan (voir Exécutions en arrière-plan).
  4. À la fin, ouvrez le rapport avec Open report.
Rapport d'analyse : le volume récupérable et les chiffres clés.
Rapport d'analyse : le volume récupérable et les chiffres clés.

L'analyse lit la liste des fichiers de chaque bibliothèque, puis l'historique des seuls fichiers qui dépassent le nombre de versions à garder. Elle ne modifie rien. Les bibliothèques système et la bibliothèque de conservation (Preservation Hold Library) sont exclues, car leur contenu ne peut pas être libéré.

Le rapport indique pour chaque site le volume récupérable, le nombre de fichiers et de versions concernés, la taille du site et, si elle est connue, la part que représente ce volume. Les tailles sont en unités binaires (GiB, TiB), comme dans le centre d'administration SharePoint.

Les sites qui concentrent le plus de volume récupérable.
Les sites qui concentrent le plus de volume récupérable.

Nettoyer (Clean up)

La suppression est définitive. Les versions supprimées par SPOVC ne passent pas par la corbeille SharePoint et ne peuvent pas être restaurées. Le fichier lui-même et ses versions les plus récentes ne sont jamais touchés.

  1. Vérifiez le nombre de versions conservées dans le bandeau (modifiable dans Settings).
  2. Sélectionnez les sites, de préférence après les avoir analysés.
  3. Cliquez sur Clean up et confirmez. Le nettoyage part en arrière-plan.
Première confirmation.
Première confirmation.
Seconde confirmation.
Seconde confirmation.
Suivi du nettoyage en cours.
Suivi du nettoyage en cours.
  • Premier essai : commencez par un site de test ou un petit site, contrôlez le résultat, puis élargissez.
  • Sites protégés : les sites listés dans Never touch these sites (Paramètres) ne peuvent être nettoyés par aucun chemin.
  • Stockage : SharePoint recalcule l'espace utilisé avec un délai de quelques heures. Si une stratégie de rétention Purview s'applique, une copie peut être conservée et l'espace ne baisse pas.
  • Grands volumes : un nettoyage à l'échelle d'un tenant peut durer plusieurs heures, voire plusieurs jours. Il reprend là où il s'est arrêté en cas d'interruption.

Exécutions en arrière-plan

Chaque analyse et chaque nettoyage s'exécutent dans leur propre session Windows, via une tâche planifiée que SPOVC crée lui-même. Fermer SPOVC, se déconnecter ou perdre la session Bureau à distance n'arrête pas l'exécution.

Une exécution en cours, sur l'accueil.
Une exécution en cours, sur l'accueil.
  • Première fois : Windows demande une fois les droits administrateur pour enregistrer la tâche. Les exécutions suivantes ne demandent plus rien.
  • Suivi : la ligne d'état de l'accueil affiche l'avancement ; Watch ouvre le journal en direct. Fermer cette fenêtre n'arrête pas l'exécution.
  • Arrêter : Stop arrête proprement et garde le point de reprise ; SPOVC propose de reprendre au prochain démarrage.
  • Terminer : une fois fini, Open report ouvre le rapport et Dismiss ferme la notification.
  • Supprimer la tâche : ToolsRemove background task. Elle sera recréée à la prochaine exécution.
Watch : l'avancement et le journal en direct.
Watch : l'avancement et le journal en direct.
Une exécution terminée : ouvrir le rapport ou fermer la notification.
Une exécution terminée : ouvrir le rapport ou fermer la notification.

Rapports

Chaque exécution écrit un rapport HTML et, si Microsoft Edge ou Chrome est présent, sa version PDF. Reports les liste tous, analyses, nettoyages et gouvernance, y compris ceux produits par les exécutions planifiées. ToolsOpen logs folder ouvre le dossier.

La liste des rapports.
La liste des rapports.

Un rapport indique toujours sa couverture : nombre de sites visés, traités, en erreur, et si l'exécution a été arrêtée avant la fin. Un total n'est jamais présenté sans ce contexte.

Gouvernance

Governance ouvre une fenêtre en lecture seule : rien n'y est jamais supprimé ni modifié. Choisissez les passes à exécuter puis Run.

Les passes de gouvernance.
Les passes de gouvernance.
PasseCe qu'elle produitDurée indicative (1 600 sites)
UseSites actifs, dormants, vides, protégés ou impossibles à juger, d'après les rapports d'usage SharePoint, Microsoft 365 et Teams sur 180 jours.2 min
Access and sharingPartage externe, liens Anyone, écarts avec la politique du tenant, sites sans propriétaire.15 s
Site permissionsAdministrateurs, groupes, accès de toute l'organisation, invités, droits directs.25 min
Sharing linksQui a partagé quoi, avec qui, quand et jusqu'à quand, pour les liens qui sortent de l'organisation.+15 min

La barre de progression et le temps restant couvrent l'ensemble des passes cochées.

Pendant l'analyse : progression et temps restant.
Pendant l'analyse : progression et temps restant.
Analyse terminée : ouvrir le rapport ou le classeur de revue.
Analyse terminée : ouvrir le rapport ou le classeur de revue.
Rapport de gouvernance : sites à revoir et répartition des verdicts.
Rapport de gouvernance : sites à revoir et répartition des verdicts.

Lire les verdicts

  • Dormant / Empty : aucune activité mesurable depuis 180 jours. Ce sont des candidats à revoir avec leur propriétaire, jamais à supprimer sans vérification.
  • Active : au moins un signal d'usage (une visite, un fichier modifié, un message Teams suffit).
  • Protected : sites système, hubs, sites verrouillés, archivés ou soumis à conservation.
  • Could not be judged : un signal nécessaire n'a pas pu être lu. Par prudence, ces sites ne sont jamais présentés comme inutilisés.
Chaque site candidat avec son propriétaire et les preuves du verdict.
Chaque site candidat avec son propriétaire et les preuves du verdict.
Les ouvertures vers l'extérieur : qui a partagé quoi, avec qui et jusqu'à quand.
Les ouvertures vers l'extérieur : qui a partagé quoi, avec qui et jusqu'à quand.

Rapports d'usage masqués : si Microsoft 365 masque les noms dans les rapports (réglage par défaut), la passe Use ne peut pas s'exécuter. La fenêtre explique le réglage à modifier et ce qu'il change avant d'ouvrir le centre d'administration ; à valider avec votre DPO.

Revue des constats et score

Chaque exécution de gouvernance alimente un registre des constats et produit un classeur Excel (Open workbook) avec les feuilles Summary, Findings, Sites, Changes, Trend et Sharing links.

Classeur de revue, feuille Summary.
Classeur de revue, feuille Summary.
Feuille Findings : un constat par ligne, avec le score du site et le détail.
Feuille Findings : un constat par ligne, avec le score du site et le détail.
  1. Dans la feuille Findings, renseignez Status (Open, In progress, Fixed, Accepted risk, False positive), Assignee, Due date et Comment. Ne modifiez pas la colonne ID.
  2. Enregistrez, puis dans la fenêtre Gouvernance cliquez sur Import review....
  3. À l'exécution suivante, SPOVC vérifie : un constat disparu passe en Resolved, un constat marqué Fixed mais toujours présent passe en Reopened.

Score : chaque site part de 100 ; un constat ouvert coûte 20 points (High), 8 (Medium) ou 3 (Unknown). Le score du tenant est la moyenne des sites moins les constats de politique du tenant. Notes : A à partir de 90, B 75, C 60, D 40.

Le score de gouvernance et les sites les moins bien notés.
Le score de gouvernance et les sites les moins bien notés.

La section Changes since the last run liste les nouveaux constats, les constats résolus, les nouveaux liens vers l'extérieur et les nouveaux invités depuis l'exécution précédente.

Corbeille

Recycle bin affiche les deux niveaux de la corbeille d'un site pour tous les utilisateurs : recherche, tri, restauration ou suppression définitive d'une sélection, et export Excel. La suppression définitive demande deux confirmations.

Automatisation et ligne de commande

Les profils définis dans les paramètres peuvent s'exécuter sans interface :

cd "$env:LOCALAPPDATA\Programs\SPOVC"
pwsh -File .\Invoke-SpovcJob.ps1 -ListProfiles
pwsh -File .\Invoke-SpovcJob.ps1 -ProfileName large-sites-preview
pwsh -File .\Invoke-SpovcJob.ps1 -ProfileName large-sites-cleanup -Resume

Pour une exécution régulière, utilisez ToolsScheduled runs. Codes de sortie :

CodeSignification
0Terminé sans erreur
1Terminé avec des erreurs, ou incomplet
2Configuration, profil ou authentification : rien n'a pu démarrer
3Annulé
4La liste des sites n'a pas pu être lue
5Rien à faire : aucun site ne correspond aux filtres
6La licence ne permet pas ce nettoyage

Mises à jour

Au démarrage, SPOVC vérifie s'il existe une nouvelle version. Si c'est le cas, un bandeau apparaît en haut de l'accueil : What's new affiche les nouveautés, Update now télécharge la version, vérifie son empreinte, ferme SPOVC, l'installe et le relance. Paramètres, rapports, licence et certificat sont conservés.

Le bandeau de mise à jour.
Le bandeau de mise à jour.
What's new : les nouveautés de la version.
What's new : les nouveautés de la version.
  • Inclus pendant 12 mois : votre licence inclut toutes les versions publiées dans les 12 mois suivant l'achat. Elle reste valable à vie pour ces versions.
  • Après 12 mois : SPOVC signale les nouvelles versions sans les installer. Si une version plus récente que votre période de mises à jour est installée, le nettoyage est désactivé et l'accueil propose d'installer la dernière version couverte par votre licence.
  • Pendant une exécution en arrière-plan : la mise à jour attend qu'elle soit terminée ou arrêtée.

Sessions distantes et mise en veille

Sur un serveur dont la stratégie ferme les sessions Bureau à distance inactives, une exécution lancée dans la session serait interrompue. C'est pourquoi SPOVC exécute analyses et nettoyages en arrière-plan. Pour garder aussi l'interface ouverte longtemps, Keep session alive suspend temporairement les délais d'inactivité de la machine (droits administrateur requis) et les rétablit à la fermeture de SPOVC. Reconnectez-vous après l'avoir activé : une session déjà ouverte garde ses anciens délais.

Dépannage

SymptômeÀ faire
« Consent » ou accès refusé juste après la configurationLes droits se propagent en quelques minutes. Relancez Run again ou ToolsSetup check.
Certificat expiré ou bientôt expiréToolsRenew certificate. SPOVC prévient 30 jours avant.
Une exécution en arrière-plan ne progresse pasOuvrez Watch, puis le journal BackgroundRun_*.log. Vérifiez que le certificat est dans le magasin de ce compte Windows.
La gouvernance refuse de juger l'usageLes noms sont masqués dans les rapports Microsoft 365 : suivez l'aide affichée dans la fenêtre.
Nettoyage refusé malgré la licenceOuvrez le badge de licence : la raison est indiquée (autre tenant, offre trop petite, version non couverte).
L'espace ne baisse pas après un nettoyageAttendez le recalcul SharePoint (quelques heures). Une stratégie de rétention peut conserver une copie.

Les journaux sont dans %LOCALAPPDATA%\SPOVC\Logs (ToolsOpen logs folder). Pour toute demande de support, écrivez à hello@matissime.eu en joignant le journal concerné et la version de SPOVC (premières lignes du journal).

Sécurité et confidentialité

  • Connexion : authentification par certificat avec l'inscription d'application de votre tenant. Aucun mot de passe n'est stocké.
  • Vos données : le contenu de vos sites ne quitte pas votre environnement. Rapports et registres restent sur la machine.
  • Serveur de licence : reçoit la clé et le nom du tenant à l'activation, et l'identifiant de licence pour les mises à jour.
  • Statistiques anonymes : volumes, durées et résultat de chaque exécution, sans aucun nom. Désactivables dans les paramètres. Détail dans la politique de confidentialité.
  • Désinstallation : retire le programme. Le dossier de données, le certificat et l'inscription d'application restent ; supprimez l'inscription dans Entra ID si vous n'utilisez plus SPOVC.