Partager via

Résoudre les problèmes de migration des migrations de fichiers du Gestionnaire de migration

  • Article

Cet article explique comment résoudre les problèmes et les erreurs que vous pouvez rencontrer lors de l’utilisation du Gestionnaire de migration pour la migration de partage de fichiers.

Vérifier les conditions requises et les paramètres

Vérifiez que vous avez respecté les conditions requise pour l’installation de l’agent et que vous avez révisez les points de terminaison requis. Les clients cloud du secteur public doivent confirmer que leur configuration est correctement définie.

Messages d’erreur d’agent

Message Action
Impossible d’installer l’agent de migration. Fermez le programme d’installation et réessayez. Vous utilisez peut-être une version obsolète du fichier d'installation de l'agent pour l'installer. Pour plus d'informations, voir la section Échec de l'installation de l'agent ci-dessous.
L’utilisateur actuel n’a pas accès au partage de fichiers source Assurez-vous que le partage de fichiers source est un partage de fichiers réseau. Vérifiez que le compte Windows associé à l'agent dispose des autorisations de lecture pour le partage de fichiers que vous souhaitez migrer.
Le partage de fichiers source n’existe pas Assurez-vous que le partage de fichiers source est un partage de fichiers réseau existant. Vérifiez que le compte Windows associé à l’agent dispose d’autorisations en lecture sur le partage de fichiers que vous voulez déplacer.

Problèmes d’URL du site de destination

Message Action recommandée
Le site ou le site web de destination n’existe pas Confirmez que le site de destination ou le sous-site est présent. S’il s’agit d’un compte OneDrive, vérifiez qu’il a été préalablement configuré avant la migration.
Échec de la vérification de l’existence du site ou du site web. Confirmez que le site de destination ou le sous-site est présent.

Messages d’erreur fréquemment détectés

Message Action recommandée
Le dossier source n’est pas valide Vérifiez que le chemin d’accès que vous avez entré est correct et qu’il suit le format

approprié Confirmez que vous disposez d’un accès en lecture au dossier.
Le site ne peut pas être créé ou mis à jour Vérifiez que vous disposez des autorisations nécessaires pour créer le site et que l’URL est valide

Si le site existe, vérifiez que vous êtes l’administrateur

de la collection de sites Si l’opération échoue toujours, créez le site manuellement et pointez l’outil de migration vers ce site nouvellement créé.
L’analyse du fichier a échoué : Le nom du dossier n’est pas valide Voir Les noms de fichiers et les types de fichiers non valides dans OneDrive, OneDrive Entreprise et SharePoint
L’analyse du fichier a échoué : Le chemin d’accès cible est trop long Voir Noms de fichiers et types de fichiers non valides dans OneDrive et SharePoint

Le chemin d’accès entier, y compris le nom de fichier, doit contenir moins de 400 caractères pour OneDrive et SharePoint.
Nous n'avons pas pu analyser le fichier : espace disque insuffisant pour la compression de fichier L’espace disque disponible du dossier de travail de la migration est trop faible pour la taille de votre fichier source. Augmentez la taille de votre dossier de travail une nouvelle fois.
Échec de l’empaquetage : impossible d’ouvrir le fichier Échec de l’empaquetage en raison d’une source inexistante. Vérifiez que vous pouvez accéder au dossier racine source.
Une tâche en double a déjà été créée. Le fichier CSV utilisé pour effectuer une migration en bloc ne peut pas avoir d’entrées en double. Supprimez la ou les lignes dupliquées et réessayez.
Le dossier parent n’a pas été migré Le dossier parent n’a pas été migré. Par conséquent, tous les éléments du dossier ne parviennent pas à migrer. Vérifiez votre dossier parent et retentez votre migration.

Échec de l’installation d’un agent

Question : L'agent de migration ne s'installe pas lorsqu'on utilise une ancienne version du fichier d'installation de l'agent pour installer l'agent.

Défaillance de l'installation de l'agent écran

Diagnostic/Enquête :

Le problème pourrait être causé par un fichier clientsetup.exe périmé.

Atténuation :

  1. Accédez au Centre de migration dans le Centre d’administration SharePoint et connectez-vous avec un compte disposant d’autorisations d’administrateur pour votre organisation.
  2. Sélectionnez Télécharger le fichier d’installation de l’agent.
  3. Exécutez le fichier clientsetup.exe sur l'ordinateur ou la VM où vous voulez installer l'agent. Suivez les instructions pour terminer l'installation de l'agent.

Émettre: L’agent de migration ne s’installe pas correctement ou le clientsetup.exe ne peut pas être ouvert.

Exemple :

Échec de l’installation de l’agent du gestionnaire de la migration

Diagnostic/Enquête :

Si le clientsetup.exe ne peut pas être ouvert :

  • Connectez-vous à Windows en tant qu’administrateur, ou fournissez le nom d’utilisateur et le mot de passe de l’administrateur à l’ouverture de l’application. Le compte d’administrateur doit déjà être ajouté au domaine.

Si des erreurs se sont produites lors du processus de l’installation :

  • Le message d’erreur doit déjà inclure la raison de l’échec, ainsi que les mesures appropriées à prendre si possible.
  • Si les erreurs ne suggèrent pas d’actions à résoudre, le problème peut être dû à une défaillance temporaire du réseau ou à d’autres problèmes inconnus.

Atténuation :

Si le clientsetup.exe ne peut pas être ouvert :

  1. Connectez-vous à Windows en tant qu’administrateur.
  2. Rouvrez l’application clientsetup.exe, ou fournissez le nom d’utilisateur et le mot de passe d’administrateur à l’ouverture de l’application.

Si des erreurs se sont produites lors du processus de l’installation :

  • Pour les erreurs liées à des actions spécifiques établies, effectuez l’action correspondante, puis rouvrez le clientsetup.exe.
  • Pour les autres erreurs non spécifiques, vérifiez que votre compte Administrateur a été ajouté au domaine. Fermez la fenêtre de l’application, puis réessayez d’effectuer l’installation.

Déconnexion de l’agent

Problème : « l’état » de l’agent est bloqué a « déconnecté » et n’apparaît jamais.

Déconnexion de l’agent

Diagnostic/Enquête :

  • Vérifiez l’intégrité du réseau sur l’ordinateur sur lequel est installé l’agent.
  • Si le mot de passe du compte d’administrateur de client connecté a changé, ou si d’autres modifications critiques similaires ont été appliquées au compte d’administrateur client qui nécessiteraient une nouvelle connexion, tous les agents sont déconnectés et la réinstallation est requise sur chacun d’eux.
  • Si l’agent n’a pas pu effectuer la mise à niveau automatique, la version est probablement trop ancienne. Réinstallez l’agent.
  • L’expiration du jeton peut également entraîner la déconnexion de l’agent.

Atténuation :

  • Si vous rencontrez un problème de réseau, résolvez ce problème. L’agent devrait se reconnecter peu de temps après.
  • Si des modifications critiques ont été apportées au compte d’administrateur du client qui nécessitent une nouvelle connexion : réinstallez l’agent sur tous les ordinateurs.
  • Si aucune de ces conditions ne s’applique, commencez par réinstaller l’agent.

Tâche bloquée à l’état de « mise en file d’attente »

Problème : l’état d’une tâche reste « mise en file d’attente » et n'est jamais programmée pour être exécutée sur un agent.

Tâche bloquée à l’état de mise en file d’attente

Diagnostic/Enquête :

  • Assurez-vous que des agents sont installés pour ce client. Ils doivent être répertoriées dans la liste des agents.
  • Vérifiez l’état de chaque agent. Ils doivent être configurées sur « activé ».
  • L’état « en cours d’utilisation » indique que l’agent traite déjà une autre tâche. L’agent ne pourra pas recevoir d’autres tâches sans terminer la tâche actuelle.
  • Si un agent est répertorié comme « désactivé », activez-le.
  • S’ils semblent être « déconnectés » pendant un long moment, cochez la fonction agent déconnecté.

Atténuation :

  • S’il existe des agents activés disponibles dans la liste, mais les tâches n’ont pas été planifiées pendant un long moment : créer une autre tâche qui est identique. Parfois, il résout le problème.

Impossible de télécharger le rapport de tâche

Problème : Le rapport de tâche ne peut pas être téléchargé à partir du lien dans le panneau détails de la tâche.

  • Le lien de rapport de tâches de téléchargement est désactivé.
  • Le lien de rapport des tâche de téléchargement affiche actif, mais rien ne se passe lorsque vous cliquez dessus

Impossible de télécharger le rapport des tâches

Diagnostic/Enquête :

  • Le lien « Télécharger le rapport des tâches » est désactivé jusqu’à ce que la tâche soit terminée. Les rapports ne sont disponibles que lorsque l’état de la tâche affiche « terminé » ou « échec ». Les tâches ayant échoué en raison d’un délai d’attente sont également associées à un lien de rapport de tâche désactivé.
  • Si aucun rapport ne peut être téléchargé pour les tâches terminées, qui ne sont pas chronométrées, il y a probablement des erreurs qui se sont produites pendant le processus de migration, ce qui a interrompu le chargement des rapports vers SharePoint. Toutefois, elles peuvent être trouvées localement tant qu’elles existent.

Atténuation :

Sur l’ordinateur qui a effectué la tâche, essayez de récupérer les rapports.

  • Dans le dossier %AppData%\Microsoft\SPMigration\Logs\Migration\MigrationTool[tenant_site] ou < Your-Customized-Working-Folder >\Migration\MigrationTool[tenant_site], triez les sous-dossiers en fonction de leur heure de modification. Recherchez le sous-dossier dont l’heure de modification est la plus proche de l’heure de début de la tâche. Si les rapports de tâche existent, ils se trouvent dans le dossier « Rapport » de ce sous-dossier.

Ou

  • En cas d’échec de la tâche, accédez au dossier %AppData%\Microsoft\SPMigration\Logs\ErrorReports, puis triez les sous-dossiers en fonction de leur date de modification. Recherchez le sous-dossier dont l’heure de modification est la plus proche de l’heure de début de la tâche. Le rapport d’erreurs se trouve dans ce sous-dossier.

Erreurs de migration dans les rapports de tâches

Problème : les tâches de migration échouent pour plusieurs raisons et sont détaillés dans les rapports des tâches.

Erreur du gestionnaire de la migration

Diagnostic/Enquête :

  • Les raisons de l’échec doivent déjà être écrites de façon détaillée dans les rapports avec des solutions suggérées.

  • Si vous ne pouvez pas télécharger les rapports de tâche, reportez-vous à Rapport de tâche impossible à télécharger

Atténuation :

Recherchez l’erreur spécifique ici pour plus d’informations : Codes d’erreur.

Si vous recevez une erreur semblable à celle-ci : ÉCHEC DE SOUMISSION de la tâche au serveur : raison inconnue de l’échec lors de l’envoi d’un travail. 0x01610002

Vérifiez les paramètres des applications antivirus installées sur l’ordinateur de l’agent. Ajoutez nos deux applications de migration comme exceptions afin de ne pas interrompre le trafic de la migration :

  • microsoft.sharepoint.migration.clientservice.exe
  • microsoft.sharepoint.migration.mthost.exe

Le rapport d’erreurs Google affiche le code HTML dans le rapport.

Problème : les rapports d’erreur générés pour une migration Google auront parfois du code HTML incorporé dans le rapport.

Le rapport d’erreurs Google inclut du code HTML

Détails :

Les API Google retournent des erreurs HTML qui sont incluses dans les rapports générés. Cela peut se produire en cas d’erreur de chargement du serveur Google.

Atténuation :

Exécutez moins de transactions simultanées.

Statut :

Il s’agit là d’un problème identifié. ETA non définie.

Administrateurs géographiques non pris en charge

Le Gestionnaire de migration ne prend actuellement pas en charge le rôle d’administrateur géographique pour des scénarios spécifiques. Pour les migrations de partage de fichiers, ces utilisateurs ne peuvent pas accéder à l’onglet Analyses. Pour les migrations dans le cloud, ces utilisateurs ne peuvent pas accéder ni aux analyses ni à l’onglet Migrations.

Solution de contournement Attribuez à l’utilisateur géographique un rôle d SharePoint ou d’administrateur global.

  1. Dans le Centre d’administration, accédez à la page Utilisateurs>Utilisateurs actifs.
  2. Dans la page Utilisateurs actifs, sélectionnez l’utilisateur dont vous souhaitez modifier le rôle d’administrateur. Dans le volet volant, sous Rôles, sélectionnez Gérer les rôles.
  3. Sélectionnez le rôle d’administrateur que vous voulez attribuer à l’utilisateur. Si vous ne voyez pas le rôle que vous recherchez, sélectionnez Afficher tout en bas de la liste.

Groupes hérités SharePoint administrateurs ne pouvant pas accéder aux analyses et aux onglets de migrations

Les rôles d’administrateur SharePoint créés suite à la participation à un groupe Azure ne sont pas entièrement pris en charge par le Gestionnaire de migration. Pour les migrations de partage de fichiers, ces utilisateurs ne peuvent pas accéder à l’onglet Analyses. Pour les migrations dans le cloud, ces utilisateurs ne peuvent pas accéder ni aux analyses ni à l’onglet Migrations.

Solution de contournement Tant que ce problème n’est pas résolu, l’utilisateur a SharePoint un rôle d’administrateur ou d’administrateur global.

  1. Dans le Centre d’administration, accédez à la page Utilisateurs>Utilisateurs actifs.
  2. Dans la page Utilisateurs actifs, sélectionnez l’utilisateur dont vous souhaitez modifier le rôle d’administrateur. Dans le volet volant, sous Rôles, sélectionnez Gérer les rôles.
  3. Sélectionnez le rôle d’administrateur que vous voulez attribuer à l’utilisateur. Si vous ne voyez pas le rôle que vous recherchez, sélectionnez Afficher tout en bas de la liste.

La collection de sites « XXXX » ne peut pas être créée ou mise à jour

Le nom d’utilisateur principal (UPN) référencé n’est pas valide. Pour créer ou mettre à jour une collection de sites OneDrive, l’ID Microsoft Entra doit contenir l’UPN référencé. Vérifiez votre URL de destination et vérifiez que l’utilisateur existe dans l’ID Microsoft Entra.

Tâche d’analyse bloquée dans l’état « mise en file d’attente »

Problème : l’état d’une analyse de partage de fichiers reste « En file d’attente » et n’est jamais planifié sur un agent pour s’exécuter.

Problème de tâche d’analyse bloqué dans la phase mise en file d’attente

Diagnostic/investigation

  • Recherchez les tâches d’analyse dans la colonne Groupe d’agents. Seuls les agents du groupe d’agents par défaut peuvent être planifiés.

Résolution des problèmes liés aux tâches d’analyse

Atténuation

  • S’il n’y a aucun agent dans le groupe d’agents par défaut , remplacez le groupe de l’agent existant par Défaut. Toutes les tâches d’analyse qui ont été bloquées doivent maintenant sortir de cet état.

Problèmes de tâche d’analyse - Modifier les agents

Codes d’erreur

Code d’erreur Action recommandée
0x00000000 Erreur inattendue.
0x01110001 Raison inconnue.
0x0111000B Le chemin d’accès est trop long.
0x0111000F Le dossier parent n’a pas été migré. Consultez le rapport d’échec pour déterminer le fichier, puis réessayez.
0x01110003 Impossible d’accéder au dossier source.
0x01110009 Cound ne récupère pas les métadonnées du fichier.
0x01110010 Caractères non valides dans le nom de fichier. Recherchez les noms de fichiers dans le rapport avec <>:" ?*/,
0x01110011 L’élément « heure de création » ou « heure de modification » n’est pas pris en charge.
0x0201000D Vérifiez si la liste existe ou si vous pouvez y accéder dans le site source et le site cible.
0x02050008 Impossible d’accéder au stockage local. Redémarrez la migration.
0x02010023 Votre modèle de liste de sources n’est pas pris en charge. Essayez-en une autre.
0x0201000C Vérifiez vos informations d’identification, puis saisissez de nouveau votre nom d’utilisateur et votre mot de passe.
0x02010017 Vous devez être un administrateur de collection de sites.
0x02060009 1 - Impossible de créer la collection de sites, car l’URL est déjà utilisée ou une URL non valide.
2 - Impossible de créer la collection de sites, car l’URL contient un caractère non valide.
3 - La collection de sites ne peut pas être créée ou mise à jour.
0x02060007 1 - Impossible de créer la collection de sites, car l’URL est déjà utilisée ou une URL non valide.
2 - Impossible de créer la collection de sites, car l’URL contient un caractère non valide.
0x02010018 1 - Vérifiez vos informations d’identification, puis réessayez.
2 - Un problème est survenu lors de l’accès à SharePoint.   Vérifiez vos informations d’identification, puis réessayez.
3 - Un problème est survenu lors de l’accès à SharePoint. Vérifiez vos informations d’identification et votre connexion réseau, puis réessayez.
4 - Un problème est survenu lors de l’accès à SharePoint. Vérifiez l’exactitude de vos informations d’identification et de l’URL du site, puis réessayez.
5 - Un problème est survenu lors de l’accès à SharePoint. Vérifiez vos informations d’identification et le format de votre URL. Réessayez.
6 - Un problème est survenu lors de l’accès à SharePoint.   Vérifiez vos informations d’identification, puis réessayez.   Si le problème persiste, ouvrez un dossier de support.
7 - Un problème est survenu lors de l’accès à SharePoint.   Vérifiez vos informations d’identification et essayez d’ouvrir votre site dans un navigateur.
0x0204000A Impossible de créer un fichier de package. Tous les fichiers et dossiers du dossier de travail de gestionnaire de migration%appdata%\Microsoft\MigrationToolStorage doivent être fermés. Redémarrez la migration.
0x02030001 1 - Vérifiez vos informations d’identification. Redémarrez la migration.
2 - Vérifiez vos informations d’identification. Redémarrez la migration.
3 - Vérifiez vos informations d’identification et votre connexion réseau. Redémarrez la migration.
4 - Vérifiez vos informations d’identification et l’URL du site. Redémarrez la migration.
5 - Vérifiez vos informations d’identification et le format de votre URL. Redémarrez la migration.
6 - Vérifiez vos informations d’identification et redémarrez votre migration. Si le problème persiste, ouvrez un dossier de support.
7 - Vérifiez vos informations d’identification et essayez d’ouvrir votre site dans un navigateur. Redémarrez la migration.
0x02010008 Confirmez le chemin d’accès et le format du fichier de mappage de l’utilisateur ainsi que votre autorisation d’accès.
0x02050001 Tous les fichiers et dossiers du dossier de travail de gestionnaire de migration%appdata%\Microsoft\MigrationToolStorage doivent être fermés. Redémarrez la migration.
0x02010002 Vérifiez l’état de votre réseau. Si vous ne pouvez pas accéder aux sites source à partir d’un navigateur, ouvrez un dossier de support.
0x02010010 Vérifiez que la liste source et la liste cible possèdent le même modèle.
0x0204000D Tous les fichiers et dossiers du dossier de travail de gestionnaire de migration%appdata%\Microsoft\MigrationToolStorage doivent être fermés pendant la migration. Redémarrez la migration.
0x02040012 L'espace de stockage temporaire de votre ordinateur local est trop faible. Le gestionnaire de migration met en cache le package sur le dossier de travail. Développez votre espace de stockage temporaire et réessayez.
0x02030003 Un trop grand nombre d’éléments sont dotés d'autorisations uniques. Simplifiez votre liste d'autorisations en réduisant le nombre de d'autorisations uniques. Retentez la migration.
0x02050001 Le fichier de stockage local est endommagé. Le dossier de travail a été affecté ou modifié pendant la migration. Réessayez la migration.
0x02080001 Le fichier du package a été modifié ou supprimé lors du chargement. Tous les fichiers et dossiers du dossier de travail de gestionnaire de migration%appdata%\Microsoft\MigrationToolStorage doivent être fermés. Redémarrez la migration.
0x02040009 Impossible de créer le package, car le répertoire est introuvable. Tous les fichiers et dossiers du dossier de travail de gestionnaire de migration%appdata%\Microsoft\MigrationToolStorage doivent être fermés. Redémarrez la migration.
0x02010020 Désactivez la migration de l’historique des versions dans les paramètres du gestionnaire de migration ou activez le contrôle de version dans SPO.
0x0201000E Vérifiez si le paramètre global a filtré des caractères spéciaux dans le chemin d’accès cible ou si le chemin d’accès comporte des caractères non pris en charge.
0X0201000F URL du site non valide. Vérifiez que l’URL du site est valide. Essayez d’accéder à l’URL via un navigateur. S’il s’agit d’un compte OneDrive, vérifiez qu’il a été préalablement configuré avant la migration.
0x0207001 Vous n’avez pas accès au dossier de tâches. Vérifiez si vous pouvez accéder à %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorage.
0x01410010 Une erreur s’est produite en raison de dépendances manquantes sur les éléments de liste. Pour plus d’informations, consultez le FailureSummaryReport.csv. Vérifiez si les dépendances ont été incluses dans l’étendue de votre migration.
0x01510001 Les packages n’ont pas pu être téléchargés. Si vous un espace de stockage personnalisé Azure, vérifiez que vous pouvez accéder au stockage Azure et au site cible. Recommencez la migration.
0x01510001 Désolé... Nous n’avons pas pu charger le travail sur le serveur : le chargement du fichier a échoué lors de la migration.
0x02070009 Plusieurs packages n’ont pas pu être téléchargés. Arrêtez la tâche et vérifiez votre connexion réseau.
0x01710009 Une erreur s’est produite suite à des échecs de fin de tâche. Certains éléments ont fait défaut dans le package. Redémarrez la migration.
0x01710009 Erreurs ou expiration du délai de traitement du fichier par le serveur : tous les éléments du package n’ont pas été migrés.
0x01610001 Le conteneur Azure a expiré. Relancez la tâche de migration.
0x01710006 Erreurs ou expiration du délai de traitement du fichier par le serveur : erreur irrécupérable du travail.
0x01710004 Erreurs ou expiration du délai de traitement du fichier par le serveur. Impossible de rechercher le nom du dossier. L’élément existe peut-être dans une autre liste ou dans un autre site de la même collection de sites. Ou l’élément se trouve dans la corbeille.
0x0131000F Désolé... Nous n’avons pas pu lire le fichier. Le fichier est extrait.