Troubleshoot public folder batch migrations

 

**Sapplique à :**Exchange Server 2013

**Dernière rubrique modifiée :**2016-12-09

Résumé : Cet article présente les étapes à suivre pour résoudre les problèmes rencontrés lors d’une migration par lots de dossiers publics Exchange.

Lors de migrations par lots de dossiers publics entre une ancienne version d’Exchange et Exchange 2013 ou Office 365, certains problèmes peuvent survenir. Les informations contenues dans cet article vont vous aider à identifier et à résoudre ces problèmes, pour que vous réussissiez votre migration par lots.

Les sujets suivants sont abordés et, le cas échéant, des solutions vous sont proposées pour vérifier ou corriger le problème :

  • Recherche des informations nécessaires pour résoudre les problèmes rencontrés lors d’une migration par lots

  • Échec de l’activation de la messagerie des dossiers publics

  • Finalisation du processus de migration

  • Hiérarchie de service des boîtes aux lettres après migration

  • Exécution simultanée de plusieurs tâches

  • Analyse des éléments endommagés

Ce qu’il faut savoir avant de commencer

  • Durée d’exécution estimée de cette tâche : varie selon le type de problèmes rencontrés lors de la migration

  • Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette procédure. Pour voir les autorisations qui vous sont nécessaires, consultez l'entrée « Dossiers publics » dans la rubrique Autorisations de partage et de collaboration.

  • Pour des informations sur les raccourcis clavier applicables aux procédures de cette rubrique, voir Raccourcis clavier dans Exchange 2013Raccourcis clavier dans le Centre d’administration Exchange.

ConseilConseil :
Vous rencontrez des difficultés ? Demandez de l’aide en participant aux forums Exchange. Visitez les forums sur les pages Exchange Server, Exchange Online, et Exchange Online Protection.

Que souhaitez-vous faire ?

Recherche des informations nécessaires pour résoudre les problèmes rencontrés lors d’une migration par lots

Les données de la migration par lots sont réparties sur différents emplacements, ce qui complique la collecte et le diagnostic des problèmes par rapport à l’ancienne migration en série qui était centralisée. Lorsqu’une demande de migration par lot est créée, toutes les informations sont stockées dans des messages créés sous la boîte aux lettres de l’organisation (migration). Les informations sur les migrations par lots affichées dans le Centre d’administration Exchange proviennent de la boîte aux lettres de migration. Vous pouvez trouver la base de données dans laquelle se trouve la boîte aux lettres en exécutant :

Get-Mailbox -Arbitration -Organization $org Mig* | fl Name,Database

Ensuite, vous pouvez exécuter la commande Get-MailboxDatabaseCopyStatus pour déterminer le serveur dans lequel cette base de données de boîte aux lettres est montée.

Le service de migration s’exécute sous MSExchangeServiceHost sur le serveur en question. Il est chargé de créer, reprendre, suspendre et supprimer les tâches MRS qui font partie de la demande de migration par lots.

Lorsque la demande de migration par lots commence par la cmdlet New-PublicFolderMailboxMigrationRequest, les éléments de tâche et leurs tâches MRS sous-jacentes sont créés. Chaque tâche MRS est stockée dans la boîte aux lettres Système de la base de données qui héberge la boîte aux lettres cible pour cette tâche. Comme toute autre tâche MRS, leurs données sont disponibles via les cmdlets Get-*Request et Get-*RequestStatistics.

À partir de la boîte aux lettres de migration, vous pouvez recueillir des informations sur :

  • les points de terminaison, ou les paramètres de connectivité de la demande de migration par lots ;

  • les métadonnée du lot, y compris les informations du fichier .csv généré par les scripts de migration par lots, les limites des éléments endommagés et des éléments volumineux, et un résumé de l’état de la demande de migration par lots et son état actuel ;

  • les informations sur l’élément de tâche. Il existe une correspondance 1:1 entre un élément de tâche et une tâche MRS. Les éléments de tâche sont constamment mis à jour en fonction des captures instantanées prises en exécutant New-PublicFolderMailboxMigrationRequest ;

  • les rapports sur les différentes phases de la migration par lots, envoyés par courrier électronique.

Exécutez les commandes suivantes pour rechercher l’utilisateur de migration et la tâche MRS correspondante qui cible la boîte aux lettres principale :

$primaryMailboxGuid = (Get-OrganizationConfig $org).RootPublicFolderMailbox.HierarchyMailboxGuid

$primaryMailboxUser = $users | ?{$_.MailboxGuid -eq $primaryMailboxGuid}

$primaryMailboxJob = Get-PublicFolderMailboxMigrationRequest "$org\$($primaryMailboxUser.RequestGuid)"

Exécutez les commandes suivantes pour obtenir des informations précises sur le statut de la tâche :

$primaryMailboxUserStats = $primaryMailboxUser | Get-MigrationUserStatistics -Organization $org

$primaryMailboxUserStats | fl Status,Error

Vous pouvez obtenir encore plus d’informations en utilisant la cmdlet Get-*Statistics.

Pour obtenir des informations détaillées sur la syntaxe et les paramètres, consultez les rubriques suivantes :

Résolution des problèmes liés à l’activation de la messagerie des dossiers publics

Quand l’activation de la messagerie des dossiers publics échoue pendant une migration, la cause peut être l’une des suivantes :

  • Les objets Active Directory ne sont pas correctement synchronisés entre l’environnement local et Office 365.

  • Après la synchronisation initiale, certains dossiers publics dans Active Directory dans Office 365 n’ont pas été associés à tous les dossiers de stockage.

Dans les deux cas, la méthode de récupération consiste à exécuter le script Sync-MailPublicFolders.

Résolution des problèmes liés à la finalisation du processus de migration

Avant la finalisation, la migration par lots doit afficher l’état Synced. Si l’état est SyncedWithErrors, vous devez exécuter la commande Start-MigrationBatch avant de continuer. La commande Start-MigrationBatch reprendra ou recommencera les tâches qui ont échoué, tandis que la commande Complete-MigrationBatch reprendra toutes les tâches. La commande Start-MigrationBatch vous permet de résoudre les tâches qui ont échoué, et de vérifier si le correctif a été efficace, avant de poursuivre la finalisation. Il est déconseillé de poursuivre la finalisation sans résoudre les erreurs au préalable. En effet, ces erreurs peuvent interrompre le processus de migration dans son intégralité.

Le diagramme suivant illustre les différents états de la migration par lots lors d’une finalisation réussie.

Progression de l’état de migration au cours d’une migration réussie

Et voici les différents états de chaque élément de tâche :

Transition d’état pour les éléments de tâche individuels

De même, l’état des tâches MRS doit évoluer de la manière suivante :

Transition d’état de tâche MRS

Si une tâche individuelle échoue lors de l’une des phases vertes indiquées dans les deux illustrations ci-dessus, le processus de migration effectuera deux nouvelles tentatives. Si le processus continue d’échouer, un rapport sera envoyé par courrier électronique à l’administrateur et le processus de migration par lots retrouvera l’état SyncedWithErrors.

Lorsque vous commencez la finalisation de la migration par lots, le service de migration reprendra toutes les tâches, tout en vérifiant que chacune d’entre elles réussit sa synchronisation incrémentielle. Cette opération se produit une fois la source verrouillée pour éviter toute perte de données. Si toutes les tâches MRS atteignent une nouvelle fois l’état AutoSuspended, cela signifie que la synchronisation a réussi et que la finalisation va se poursuivre. Le déploiement des dossiers publics Exchange Online/Office 365 est déverrouillé. Ensuite, toutes les tâches reprennent une dernière fois pour effectuer des tâches de nettoyage jusqu’à ce qu’elles atteignent l’état Completed. Lorsque toutes les tâches individuelles ont atteint l’état Completed, l’ensemble de la migration par lots affiche l’état Completed.

Résolution des problèmes liés à la hiérarchie de service des boîtes aux lettres après migration

...

...le client doit définir la propriété IsExcludedFromServingHierarchy=true uniquement s’il souhaite convertir cette boîte aux lettres en boîte aux lettres de contenu uniquement (c’est-à-dire qui ne servent pas la hiérarchie à tous les utilisateurs). En outre, lors de la migration, le paramètre PublicFoldersEnabled=Remote devrait apparaître, ce qui empêchera AutoD d’attribuer des boîtes aux lettres de dossiers publics locales pour servir la hiérarchie aux utilisateurs dans Office 365. En fait, dans ce cas, AutoD redirigera ces utilisateurs vers les bases de données de dossiers publics locales. Toutefois, pendant la finalisation, la source est verrouillée, ce qui générera un temps d’arrêt pour ces utilisateurs. La seule exception à cette règle est d’affecter manuellement une boîte aux lettres de dossiers publics locale à un utilisateur Office 365, que la procédure a recommandé de tester en cas de réussite de la migration (étape 8.1), avant de redéfinir le paramètre sur PublicFoldersEnabled=Local.

.....

Augmentation du nombre de tâches pouvant être exécutées simultanément

Vous pouvez exécuter la commande suivante pour augmenter les paramètres de simultanéité par défaut d’une migration par lots :

Set-MigrationEndpoint PublicFolderEndpoint -MaxConcurrentMigrations 88 -MaxConcurrentIncrementalSyncs 88

L’exemple ci-dessus définit le nombre par défaut à 88. Ensuite, en entrant Run Start-MigrationBatch, il reprendra les 88 tâches simultanément.

Analyse des éléments endommagés

La présence d’éléments endommagés entraîne l’échec des migrations.

Voici comment trouver l’utilisateur de migration sous-jacent et la tâche MRS correspondante qui cible la boîte aux lettres principale :

$primaryMailboxGuid = (Get-OrganizationConfig $org).RootPublicFolderMailbox.HierarchyMailboxGuid

$primaryMailboxUser = $users | ?{$_.MailboxGuid -eq $primaryMailboxGuid}

$primaryMailboxJob = Get-PublicFolderMailboxMigrationRequest "$org\$($primaryMailboxUser.RequestGuid)"

L’exemple ci-dessus renvoie certaines informations sur l’utilisateur ou la tâche en question. Il est possible d’obtenir des informations plus précises à l’aide de la cmdlet Get-*Statistics, comme dans l’exemple suivant :

$primaryMailboxUserStats = $primaryMailboxUser | Get-MigrationUserStatistics -Organization $org

$primaryMailboxUserStats | fl Status,Error

Problèmes courants

MigrationPermanentException. Erreur : Cette boîte aux lettres a dépassé le nombre maximal d’éléments endommagés spécifiés pour cette demande de déplacement.

Cette erreur indique que la messagerie des dossiers publics a été activée, mais la tâche a échoué en raison d’un trop grand nombre d’éléments endommagés. Vous pouvez analyser les éléments endommagés en utilisant un rapport de la tâche MRS ou en exécutant la commande Get-MigrationUserStatistics.