Utilisateur PowerShell pour automatiser la migration

L’applet de commande PowerShell est conçue pour gérer les tâches de migration de partage de fichiers exécutées dans le service Gestionnaire de migration, et pour télécharger les rapports d’analyse et de migration.

Reportez-vous à ce lien pour vous assurer que votre ordinateur répond à la configuration système requise.

Avant de commencer

Pour démarrer la migration du partage de fichiers du Gestionnaire de migration :

1. Installez les agents du Gestionnaire de migration, puis connectez-les au locataire de destination avec un compte d’administrateur.
2. Connectez-vous au Centre Administration SharePoint en tant qu’administrateur et accédez à Migration/Partage de fichiers.

 Téléchargez le fichier zip PowerShell ici, puis décompressez la build dans un dossier de travail.

Utiliser l’applet de commande PowerShell

Lancer PowerShell en tant qu’administrateur

Exécutez les commandes suivantes :

> Get-ChildItem -Path "working_folder" -Recurse | Unblock-File

> Set-ExecutionPolicy Unrestricted -Scope CurrentUser -Force

Fermez la première fenêtre PowerShell et lancez PowerShell en tant qu’administrateur

Exécutez les commandes suivantes :

> Import-Module "working_folder\Microsoft.SharePoint.MigrationManager.PowerShell.dll"

Se connecter au service Gestionnaire de migration

> Connect-MigrationService

Cette applet de commande se connecte au service Gestionnaire de migration. Une fois qu’une connexion est établie, vous pouvez ajouter des tâches de migration et démarrer la migration.

Ajouter une tâche de migration

> Add-MigrationTask

Utilisez cette applet de commande pour créer une tâche de migration. Après sa création, la tâche s’affiche dans la page Gestionnaire de migration.

Les paramètres suivants sont requis :

• TaskName : spécifie le nom de la tâche de migration.

• SourceUri : définit le chemin du fichier source.

• TargetSiteUrl : indique l’URL du site SharePoint de destination.

• TargetListName : spécifie le nom de la liste SharePoint de destination.

Paramètres facultatifs :

• ScheduleStartTime : spécifie l’heure à laquelle la tâche commence à s’exécuter. Par défaut, une tâche démarre juste après l’avoir ajoutée.

• AgentGroup : Affectez un groupe d’agents pour exécuter la tâche. Par défaut, le groupe « Par défaut » est affecté.

• Étiquettes: Affectez des balises à la tâche. Pour affecter plusieurs étiquettes, un point-virgule est utilisé pour séparer les valeurs de balise.

Message de sortie :

• « La tâche de migration est créée avec l’ID de tâche taskId » si la tâche est correctement ajoutée au service de migration.

• « Échec de l’ajout de la tâche de migration. errorMessage » si l’applet de commande génère une erreur.

Pour obtenir la liste complète des paramètres pris en charge, exécutez :

> Get-Help Add-MigrationTask -Full

Obtenir des rapports de migration

> Get-MigrationReport

Utilisez cette applet de commande pour récupérer les rapports des tâches de migration terminées en fonction des paramètres spécifiés :

• OutputPath : spécifie le chemin d’accès au répertoire où les rapports générés sont enregistrés.

• StartTime : filtre les tâches de migration qui ont démarré après la date et l’heure spécifiées.

• EndTime : filtre les tâches de migration qui ont commencé avant la date et l’heure spécifiées.

• TaskNameContains : filtre les tâches de migration dont les noms contiennent le mot clé spécifié.

• Balises : filtre les tâches de migration dont la balise est identique au paramètre donné. Si plusieurs balises sont indiquées, séparées par un point-virgule (;)), toutes les tâches dont la balise est identique à une dans le paramètre tags doivent être retournées.

• État : filtre les tâches de migration dont la status est identique au paramètre donné. Les valeurs prises en charge sont Completed et Failed. Par défaut, les rapports des tâches terminées et échec sont téléchargés.

Si aucun paramètre n’est spécifié, l’applet de commande télécharge par défaut tous les rapports Terminé et Échec .

Message de sortie :

• « Rapport téléchargé pour taskeId » pour chaque tâche si le fichier zip du rapport est téléchargé. Le dernier message est une ligne récapitulative « Le téléchargement des rapports de migration s’est terminé, case activée le dossier de sortie : outputPath »

• « Échec du téléchargement du rapport de migration. errorMessage » si l’applet de commande génère une erreur.

Pour obtenir la liste complète des paramètres pris en charge, exécutez :

> Get-Help Get-MigrationReport -Full

Obtenir des rapports d’analyse

> Get-ScanReport

Utilisez cette applet de commande pour récupérer les rapports des tâches d’analyse terminées en fonction du paramètre spécifié

• OutputPath : spécifie le chemin d’accès au répertoire où les rapports générés sont enregistrés.

• StartTime : filtre les tâches de migration qui ont démarré après la date et l’heure spécifiées.

• EndTime : filtre les tâches de migration qui ont commencé avant la date et l’heure spécifiées.

• Balises : filtre les tâches de migration dont la balise est identique au paramètre donné. Si plusieurs balises sont indiquées, séparées par un point-virgule (;)), toutes les tâches dont la balise est identique à une dans le paramètre tags doivent être retournées.

• État : filtre les tâches de migration dont la status est identique au paramètre donné. Les valeurs prises en charge sont Prêt, Avertissement et Erreur. Par défaut, les rapports des tâches Prêt à migrer, Avertissement et Erreur sont téléchargés.

Si aucun paramètre n’est spécifié, l’applet de commande télécharge par défaut tous les rapports Prêt à migrer, Avertissement et Erreur .

Message de sortie :

• « Journal d’analyse téléchargé pour taskeid » pour chaque tâche si le fichier zip du rapport est téléchargé. Le dernier message est une ligne récapitulative « Le téléchargement des journaux d’analyse s’est terminé, case activée le dossier de sortie : outputPath ».

• « Échec du téléchargement du journal d’analyse. error_message » si l’applet de commande génère une erreur.

Pour obtenir la liste complète des paramètres pris en charge, exécutez :

> Get-Help Get-ScanReport -Full