Migration SharePoint On-Premises vers SharePoint Online avec SPMT : Guide complet

Vue d'ensemble de la migration

La migration SharePoint On-Premises vers Online est un projet structuré qui comporte des risques si elle est menée sans méthode. Ce guide couvre chaque étape : évaluation du patrimoine documentaire, nettoyage pré-migration, mapping des permissions, exécution par vagues et validation.

1. Évaluation avec SharePoint Assessment Tool

# Télécharger et lancer le SharePoint Migration Assessment Tool
# https://www.microsoft.com/en-us/download/details.aspx?id=53598

# Lancer l'analyse de la ferme sur le serveur SharePoint source
.SMAT.exe -f "C:SMAT-Reports" -site https://sp2019.contoso.local

# Le rapport identifie :
# - Fonctionnalités non supportées dans SPO (Sandbox solutions, InfoPath, etc.)
# - Workflows SharePoint 2010/2013 à remplacer
# - Grandes listes (> 5000 éléments)
# - Tailles de sites et bibliothèques
# - Permissions détaillées (brisées, directes, héritées)

2. Pré-requis et configuration SPMT

# Installer SPMT via PowerShell (Windows 10/11 ou Windows Server 2019+)
Install-Module -Name Microsoft.SharePoint.MigrationTool -Force

# Démarrer l'interface graphique SPMT
Start-SPMTMigration

# Ou en mode non interactif via PowerShell
Register-SPMTMigration -SPOCredential $spoCredential -Force

# Authentifier le compte source SharePoint on-premises
$sourceCredential = Get-Credential "admin@sp2019.contoso.local"

3. Stratégie de mapping Source → Destination

4. Exécution de la migration par lots

# Préparer le fichier CSV de mapping bulkMigration.csv
# SourceUrl,SourceDocLib,DestinationUrl,DestinationDocLib
# https://sp2019/sites/RH,Documents,https://contoso.sharepoint.com/sites/RH,Documents

# Démarrer la migration en mode complet (avec ACLs)
Add-SPMTTask -SharePointSourceCredential $sourceCredential `
             -SharePointSourceSiteUrl "https://sp2019.contoso.local/sites/RH" `
             -SourceList "Documents" `
             -SharePointTargetSiteUrl "https://contoso.sharepoint.com/sites/RH" `
             -TargetList "Documents" `
             -MigrateFileVersionHistory $true `
             -KeepAllVersions $true `
             -MigratePermissions $true

# Démarrer la migration
Start-SPMTMigration -NoShow

# Récupérer le statut en temps réel
Get-SPMTMigration

5. Gérer les workflows SharePoint 2010/2013

Les workflows SP2010/2013 ne sont pas supportés dans SharePoint Online moderne. Options de remplacement :

• Power Automate : remplacement recommandé pour 90% des cas, interface no-code
• Azure Logic Apps : pour les workflows complexes appelant des API externes
• SharePoint 2013 Workflow Manager : migration intermédiaire si délais serrés (déprécié)

6. Validation post-migration

# Vérifier la cohérence des fichiers migrés avec PnP PowerShell
Connect-PnPOnline -Url "https://contoso.sharepoint.com/sites/RH" -Interactive

# Compter les fichiers dans la bibliothèque cible
$items = Get-PnPListItem -List "Documents" -PageSize 5000
Write-Host "Nombre de fichiers migrés : $($items.Count)"

# Exporter un rapport des éléments avec leurs métadonnées
$items | Select-Object {$_.FieldValues["FileLeafRef"]},
                        {$_.FieldValues["Created"]},
                        {$_.FieldValues["Modified"]},
                        {$_.FieldValues["File_x0020_Size"]} |
    Export-Csv "C:Reportsmigration-validation-RH.csv" -NoTypeInformation -Encoding UTF8

7. Checklist de go-live

• ✅ Tous les fichiers validés (comptage source = destination)
• ✅ Permissions vérifiées sur 20% des documents (sondage aléatoire)
• ✅ Workflows Power Automate testés et validés par les métiers
• ✅ Formation utilisateurs réalisée (30 min / département)
• ✅ Redirection des favoris et raccourcis réseau vers les nouvelles URL
• ✅ Désactivation du site source (lecture seule pendant 30 jours)

Conclusion

Une migration SharePoint réussie est avant tout une affaire de préparation. L'évaluation préalable, la stratégie de mapping claire, la migration par vagues et la validation rigoureuse sont les clés d'une transition transparente pour les utilisateurs finaux.