Migrer vers SharePoint à l’aide de PowerShell

Article
05/22/2024

Cet article concerne les nouvelles applets de commande PowerShell basées sur le moteur de migration de l’outil de migration SharePoint (SPMT). Ils peuvent être utilisés pour déplacer des fichiers de SharePoint 2010 et SharePoint 2013 des bibliothèques de documents locales, des éléments de liste et des partages de fichiers vers Microsoft 365. Pour plus d’informations sur toutes les applets de commande PowerShell actuelles relatives à la migration SharePoint, consultez les informations de référence sur les applets de commande de l’outil de migration Microsoft SharePoint.

Les cmdlets PowerShell offrent les mêmes fonctionnalités que l’outil de migration SharePoint.

Remarque

Ces applets de commande PowerShell ne sont actuellement pas disponibles pour les utilisateurs d’Office 365 géré par 21Vianet en Chine.

Configuration requise

Exigences recommandées pour des performances optimales*

Description	Recommandation
UC	Processeur quadruple cœur de 64 bits minimum
Mémoire RAM	16 Go
Stockage local	Disque dur : 150 Go d’espace disponible
Système d’exploitation	Windows Server 2016 Standard ou Datacenter Windows Server 2012 R2 Client Windows 10 .NET Framework 4.6.2
Redistributable Microsoft Visual C++ 2015	Requis pour la migration de OneNote

Importante

PowerShell 5.0x et .NET Framework 4.6.2 ou version ultérieure sont nécessaires pour prendre en charge la migration des chemins de fichiers d’un maximum de 400 caractères.

Configuration minimale requise (exécution lente probable)

Description	Spécification minimale
UC	Processeur double cœur de 1,4 GHz et 64 bits minimum
Mémoire RAM	8 Go
Stockage local	Disque dur : 150 Go d'espace disponible
Carte réseau	Connexion Internet haut débit
Système d’exploitation	Windows Server 2008 R2 Windows 7 Windows 8 ou 8.1 .NET Framework 4.6.2
Redistributable Microsoft Visual C++ 2015	Requis pour la migration de OneNote.
PowerShell	PowerShell 5.x est requis pour prendre en charge la migration des chemins d’accès de fichiers de jusqu’à 400 caractères. PowerShell 6.0 ou version ultérieure n’est pas pris en charge.

Avant de commencer

Provisionnez votre Microsoft 365 avec votre annuaire Active Directory existant ou l’une des autres options permettant d’ajouter des comptes à Microsoft 365. Pour plus d’informations, consultez Intégration de Microsoft 365 aux environnements locaux et Ajouter des utilisateurs à Applications Microsoft 365 pour les PME.
Ouvrez le dossier :

$env:UserProfile\Documents\WindowsPowerShell\Modules\Microsoft.SharePoint.MigrationTool.PowerShell

Vérifiez qu’il contient des fichiers DLL. Si vous utilisez OneDrive, il est possible que vous deviez copier le dossier WindowsPowershell dans OneDrive/Documents.
À partir de cet emplacement, exécutez la commande PowerShell suivante
```
Import-Module Microsoft.SharePoint.MigrationTool.PowerShell
```

Créer et initialiser une session de migration

Register-SPMTMigration
Cette applet de commande crée, puis initialise une session de migration. L’initialisation configure les paramètres de migration au niveau de la session. Si aucun paramètre spécifique n’est défini, les paramètres par défaut sont utilisés. Une fois qu’une session est inscrite, vous pouvez ajouter une tâche à la session et démarrer la migration.

Ajouter une tâche de migration

Add-SPMTTask
Utilisez cette applet de commande pour ajouter une nouvelle tâche de migration à la session de migration inscrite. Il existe actuellement trois types de tâches autorisés : tâche de partage de fichiers, tâche SharePoint et tâche définie par JSON. Remarque : les tâches en double ne sont pas autorisées.

Supprimer une tâche

Remove-SPMTTask
Utilisez cette cmdlet pour supprimer une tâche de migration existante de la migration enregistrée.

Démarrer la migration

Start-SPMTMigration
Cette cmdlet démarre la migration SPMT enregistrée.

Renvoyer l’objet de la session actuelle

Get-SPMTMigration
Retourne l’objet de la session active. Cette applet de commande inclut le status des tâches actuelles et des paramètres de niveau session actuel. Les status de tâches actuelles incluent :
- Nombre de fichiers analysés
- Nombre de fichiers migrés
- Les messages d’erreur de migration

Arrêter votre migration actuelle

Stop-SPMTMigration
Cette cmdlet annule la migration actuelle.

Afficher les détails de l’état votre migration dans la console

Show-SPMTMigration
Si vous démarrez la migration en mode NoShow, l’exécution de l’applet de commande Show-SPMTMigration affiche l’ID de tâche, l’emplacement de la source de données, l’emplacement cible et les status de migration dans la console. Appuyez sur Ctrl+C pour revenir au mode NoShow .

Supprimer la session de migration

Unregister-SPMTMigration
Utilisez cette cmdlet pour supprimer la session de migration.

Exemples de scénarios

Exemple 1 : L’administrateur informatique ajoute une tâche SharePoint locale et démarre la migration en arrière-plan.

#Define SharePoint 2013 data source#
$SourceSiteUrl = "http://YourOnPremSite/"
$OnPremUserName = "Yourcomputer\administrator"
$OnPremPassword = ConvertTo-SecureString -String "OnPremPassword" -AsPlainText -Force
$SPCredential = New-Object -TypeName System.Management.Automation.PSCredential -ArgumentList $OnPremUserName, $OnPremPassword
$SourceListName = "SourceListName"

#Define SharePoint target#
$SPOUrl = "https://contoso.sharepoint.com"
$UserName = "admin@contoso.onmicrosoft.com"
$PassWord = ConvertTo-SecureString -String "YourSPOPassword" -AsPlainText -Force
$SPOCredential = New-Object -TypeName System.Management.Automation.PSCredential -ArgumentList $UserName, $PassWord
$TargetListName = "TargetListName"

#Define File Share data source#
$FileshareSource = "YourFileShareDataSource"

#Import SPMT Migration Module#
Import-Module Microsoft.SharePoint.MigrationTool.PowerShell

#Register the SPMT session with SharePoint credentials#
Register-SPMTMigration -SPOCredential $SPOCredential -Force

#Add two tasks into the session. One is SharePoint migration task, and another is File Share migration task.#
Add-SPMTTask -SharePointSourceCredential $SPCredential -SharePointSourceSiteUrl $SourceSiteUrl  -TargetSiteUrl $SPOUrl -MigrateAll
Add-SPMTTask -FileShareSource $FileshareSource -TargetSiteUrl $SPOUrl -TargetList $TargetListName

#Start Migration in the console. #
Start-SPMTMigration

Exemple 2 : Un administrateur informatique souhaite afficher la migration de l’arrière-plan en « mode NoShow » au premier plan, et exécuter la cmdlet ci-dessous pour l’affichage de la progression de la migration dans la console.

Show-SPMTMigration

Exemple 3 : Le Administration informatique souhaite effectuer une migration en bloc en chargeant un fichier .csv. L’exemple de fichier est ici SPMT.csv.

Load CSV;
$csvItems = import-csv "C:\spmt.csv" -Header c1,c2,c3,c4,c5,c6
ForEach ($item in $csvItems)
{
    Write-Host $item.c1
    Add-SPMTTask -FileShareSource $item.c1 -TargetSiteUrl $item.c4 -TargetList $item.c5 -TargetListRelativePath $item.c6
}

Deux tâches de migration sont définies dans le fichier spmt.csv.

D:\MigrationTest\Files\Average_1M\c,,,https://SPOSite.sharepoint.com,Documents,Test
C:\work\Powershell\negative,,,https://SPOSite.sharepoint.com/,Documents,DocLibrary_SubfolderName

Extraits de code pour la migration en bloc en chargeant un fichier JSON :

#Load JSON:
$jsonItems = Get-Content -Raw -Path  "C:\spmt.json" | ConvertFrom-Json
ForEach ($taskItem in $jsonItems.Tasks)
{
    $jsonString = ConvertTo-Json $taskItem -Depth 100
    Add-SPMTTask -JsonDefinition $jsonString -SharePointSourceCredential $onpremCredential
}

Trois tâches de migration sont définies dans le fichier spmt.json.

{
   "Tasks":[
      {
         "SourcePath":"http://On-prem/sites/test",
         "TargetPath":"https://YourSPO.sharepoint.com",
         "Items":{
            "Lists":[
               {
                  "SourceList":"list-01",
                  "TargetList":"list-01"
               }
            ],
            "SubSites":[

            ]
         }
      },
      {
         "SourcePath":"http://On-prem/sites/test",
         "TargetPath":"https://YourSPO.sharepoint.com",
         "Items":{
            "Lists":[
               {
                  "SourceList":"list-02",
                  "TargetList":"list-02"
               }
            ],
            "SubSites":[

            ]
         }
      },
      {
         "SourcePath":"http://On-prem/sites/test",
         "TargetPath":"https://YourSPO.sharepoint.com",
         "Items":{
            "Lists":[
               {
                  "SourceList":"doclib-01",
                  "TargetList":"doclib-01"
               }
            ],
            "SubSites":[

            ]
         }
      }
   ]
}

Exemple 4 : Afficher la progression de la migration

Ces exemples montrent comment afficher la progression de votre projet de migration. Get-SPMTMigration renvoie l’objet de la session actuelle. Il inclut l’état actuel des tâches et les paramètres du niveau de la session actuelle. L’état des tâches actuelles comprend :

Nombre de fichiers analysés.
Nombre de fichiers filtrés.
Nombre de fichiers migrés.
Nombre de fichiers ayant échoué.
Progression de la migration de la tâche actuelle (0 ~ 100).
La tâche actuelle status.
Messages d’erreur de migration, le cas échéant.


# Start migration in the background
Start-SPMTMigration -NoShow

# Get the object of current migration
$session = Get-SPMTMigration

# Query migration status every 5 seconds until migration is finished
while ($session.Status -ne "Finished")
{
Write-Host $session.Status

    # Query migration progress of each tasks
    Foreach ($taskStatus in $session.StatusOfTasks)
    {
        $taskStatus.MigratingProgressPercentage
}

    Start-Sleep -Seconds 5
}

Partager via