Gérer les demandes de restauration de boîte aux lettres

S’applique à : Exchange Server 2013

Les demandes de restauration de boîte aux lettres sont utilisées pour restaurer les boîtes aux lettres déconnectées. Une boîte aux lettres déconnectée est une boîte aux lettres d'une base de données de boîtes aux lettres Exchange qui n'est associée à aucun compte d'utilisateur Active Directory. Les boîtes aux lettres sont déconnectées lorsqu'elles sont désactivées, supprimées ou déplacés vers une autre base de données. Pour plus d'informations, consultez la rubrique Boîtes aux lettres déconnectées.

Les boîtes aux lettres déconnectées restent dans la base de données de boîtes aux lettres durant le temps spécifié dans les paramètres de rétention de boîtes aux lettres supprimées définis pour la base de données de boîtes aux lettres. Par défaut, les boîtes aux lettres déconnectées sont conservées pendant 30 jours. Pendant cette période de rétention, le contenu d'une boîte aux lettres supprimée peut être restauré (copié) dans une boîte aux lettres existante. Cette rubrique décrit comment gérer des demandes de restauration de boîtes aux lettres à l'aide de l'environnement de ligne de commande.

Pour les autres tâches relatives aux boîtes aux lettres déconnectées, consultez les rubriques suivantes :

Ce qu'il faut savoir avant de commencer

  • Durée d'exécution estimée de chaque procédure : 2 minutes.

  • 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 « Demande de restauration de boîte aux lettres » dans la rubrique Autorisations des destinataires.

  • Les procédures décrites dans cette rubrique ne peuvent être effectuées dans l'environnement de ligne de commande Exchange Management Shell. Il n'est pas possible d'utiliser le Centre d'administration Exchange (EAC) pour gérer des demandes de restauration de boîte aux lettres.

  • Pour afficher la valeur de la propriété Identity pour toutes les demandes de restauration de boîte aux lettres, exécutez la commande suivante.

    Get-MailboxRestoreRequest | Format-Table Identity
    

    Vous pouvez utiliser cette valeur d'identité pour spécifier une demande spécifique de restauration de boîte aux lettres, si vous exécutez les procédures de cette rubrique.

  • 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.

Conseil

Vous rencontrez des difficultés ? Demandez de l’aide en participant aux forums Exchange. Visitez les forums de Exchange Server.

Utiliser l'environnement de ligne de commande pour afficher les propriétés d'une demande de restauration

L'affichage des propriétés d'une demande de restauration de boîte aux lettres vous permet d'accéder aux informations de base sur le statut d'une demande de restauration de boîte aux lettres.

Pour afficher une liste et la valeur de la propriété Identity pour toutes les demandes de restauration de boîte aux lettres, exécutez la commande suivante.

Get-MailboxRestoreRequest | Format-Table Identity

Vous pouvez utiliser l'identité pour obtenir des informations sur des demandes spécifiques de restauration de boîtes aux lettres.

Cet exemple retourne l’état de la demande de restauration « Pilar Pinilla \MailboxRestore » à l’aide du paramètre Identity .

Get-MailboxRestoreRequest -Identity "Pilar Pinilla\MailboxRestore"

Cet exemple renvoie toutes les informations concernant la deuxième demande de restauration pour la boîte aux lettres cible de Pilar Pinilla.

Get-MailboxRestoreRequest -Identity "Pilar Pinilla\MailboxRestore1" | Format-List

Cet exemple renvoie l'état des demandes de restauration en cours de traitement à partir de la base de données source MBD01.

Get-MailboxRestoreRequest -SourceDatabase MBD01

Cet exemple renvoie toutes les demandes de restauration actuellement en cours.

Get-MailboxRestoreRequest -Status InProgress

Les autres états d’état utiles incluent Queued, Completed, Suspendedet Failed.

Cet exemple renvoie toutes les demandes de restauration suspendues.

Get-MailboxRestoreRequest -Suspend $true

Si la commande retourne une erreur, vérifiez que vous utilisez la syntaxe et l’identité correctes. Dans certains cas, l'exécution de la cmdlet peut réussir sans renvoyer de résultats. Par exemple, si vous avez envoyé une demande de restauration de boîte aux lettres et que vous exécutez la commande Get-MailboxRestoreRequest -Status InProgress et qu’aucun résultat n’est retourné, aucune des demandes de restauration n’est en cours d’exécution.

Pour obtenir des informations détaillées sur la syntaxe et les paramètres, consultez la rubrique Get-MailboxRestoreRequest.

Sortie de la cmdlet Get-MailboxRestoreRequest

Par défaut, la cmdlet Get-MailboxRestoreRequest renvoie le nom de la demande, la boîte aux lettres cible dans laquelle les données sont restaurées et l'état de la demande. Le tableau suivant répertorie des informations utiles renvoyées si vous canalisez la commande vers la cmdlet Format-List.

Valeur Description
SourceDatabase Spécifie la base de données contenant la boîte aux lettres déconnectée en cours de restauration.
TargetMailbox Indique la boîte aux lettres dans laquelle les données sont restaurées.
Name Indique le nom de la demande.
RequestQueue Indique la base de données sur laquelle le service de réplication de boîte aux lettres Exchange (MRS) enregistre l'état détaillé de la demande.
Status Indique l'état de la demande.
Suspend Indique si la demande est suspendue. Une restauration de boîte aux lettres peut être suspendue lorsqu’elle est créée à l’aide de l’applet de commande New-MailboxRestoreRequest avec le paramètre Suspend . Elle peut également être suspendue par un administrateur à l'aide de la cmdlet Suspend-MailboxRestoreRequest ou en cas d'échec de l'opération de restauration de boîte aux lettres.
Identity Indique l'identité de la demande. Cette identité est une combinaison du nom de la boîte aux lettres cible et du nom de la demande.

Utiliser l'environnement de ligne de commande pour afficher les statistiques d'une demande de restauration

L'affichage des statistiques d'une demande de restauration de boîte aux lettres vous permet de consulter des informations détaillées que vous pouvez utiliser à des fins de dépannage.

Cet exemple renvoie les statistiques par défaut de la demande de restauration danp\MailboxRestore1. Par défaut, les informations renvoyées incluent le nom, la boîte aux lettres, l'état et le pourcentage d'exécution.

Get-MailboxRestoreRequestStatistics -Identity danp\MailboxRestore1

Cet exemple renvoie les statistiques relatives à la boîte aux lettres de Dan Park et exporte le rapport dans un fichier .csv.

Get-MailboxRestoreRequestStatistics -Identity "Dan Park\MailboxRestore" | Export-CSV \\SERVER01\RestoreRequest_Reports\DanPark_Restorestats.csv

Cet exemple retourne des informations supplémentaires sur la demande de restauration de la boîte aux lettres de Pilar Pinilla à l’aide du paramètre IncludeReport et en pipant les résultats vers l’applet de commande Format-List .

Get-MailboxRestoreRequestStatistics -Identity "Pilar Pinilla\MailboxRestore" -IncludeReport | Format-List

Cet exemple retourne des informations supplémentaires pour toutes les demandes de Failed restauration dont l’état est d’utiliser le paramètre IncludeReport , puis enregistre les informations dans le fichier AllRestoreReports.txt à l’emplacement où la commande est exécutée.

Get-MailboxRestoreRequest -Status Failed | Get-MailboxRestoreRequestStatistics -IncludeReport | Format-List > AllRestoreReports.txt

Pour des informations détaillées sur la syntaxe et les paramètres, consultez les rubriques Get-MailboxRestoreRequestStatistics et Get-MailboxRestoreRequest.

Sortie de la cmdlet Get-MailboxRestoreRequestStatistics

Par défaut, la cmdlet Get-MailboxRestoreRequestStatistics renvoie le nom et l'état de la demande, l'alias de la boîte aux lettres cible et le pourcentage d'exécution. Le tableau suivant répertorie d'autres informations utiles renvoyées si vous canalisez la cmdlet vers la cmdlet Format-List.

Valeur Description
Name Indique le nom de la demande.
Status Indique l'état de la demande.
StatusDetail Fournit des informations détaillées sur l'état de la demande. Par exemple, si la Status valeur retourne InProgress, la StatusDetail valeur retourne les étapes spécifiques de l’état InProgress , telles que CreatingFolderHierarchy et CopyingMessages.
SyncStage Indique le pourcentage de traitement de la demande au cours du processus de restauration.
Suspend Indique si la demande de restauration est suspendue. Cette valeur se trouve true dans les scénarios suivants :
  • MRS a interrompu ou est en train d'interrompre la demande en raison d'un échec.
  • Un administrateur a suspendu la demande.
SourceExchangeGuid Indique le GUID de la boîte aux lettres source à partir de laquelle les données sont restaurées.
SourceRootFolder Spécifie le nom du dossier racine dans la hiérarchie de boîtes aux lettres source à partir de laquelle les données sont restaurées. Si cette valeur n'est pas renseignée, les données sont restaurées à partir du dossier « Partie supérieure de la banque d'informations ».
SourceDatabase Indique le nom de la base de données dans laquelle se trouve la boîte aux lettres source.
MailboxRestoreFlags Spécifie que la boîte aux lettres en cours de restauration est Disabled ou Soft-Deleted.
TargetAlias Indique l'alias de la boîte aux lettres cible.
TargetIsArchive Indique si la boîte aux lettres est restaurée dans une archive.
TargetExchangeGuid Indique le GUID de la boîte aux lettres cible.
TargetRootFolder Indique le nom du dossier racine dans la hiérarchie de boîtes aux lettres cible vers laquelle les données sont restaurées. Si la valeur n'est pas renseignée, les données sont restaurées dans le dossier « Partie supérieure de la banque d'informations ».
TargetDatabase Indique le nom de la base de données dans laquelle se trouve la boîte aux lettres cible.
TargetMailboxIdentity Indique l'identité de la boîte aux lettres cible.
IncludeFolders Indique la liste des dossiers à inclure pendant la restauration. Si cette valeur est vide, aucun dossier n’a été spécifié lors de la création de la demande et tous les dossiers sont restaurés dans la boîte aux lettres (sauf si le paramètre ExcludeFolders est utilisé pour exclure des dossiers spécifiques).
ExcludeFolders Indique la liste des dossiers à exclure pendant la restauration. Si cette valeur est vide, aucun dossier n’a été spécifié lors de la création de la demande et tous les dossiers sont restaurés dans la boîte aux lettres (sauf si le paramètre IncludeFolders est utilisé pour inclure des dossiers spécifiques).
ExcludeDumpster Indique si le dossier Éléments récupérables a été exclu au moment de la création de la demande.
ConflictResolutionOption Indique l'action que MRS doit entreprendre s'il existe des messages correspondants dans les dossiers cible et source.
AssociatedMessagesCopyOption Indique si les messages associés sont copiés lors du traitement de la demande. Des messages associés constituent des messages spéciaux qui contiennent des données masquées avec des informations sur les règles, les écrans et les formulaires.
BadItemLimit Indique le nombre d'éléments incorrects que MRS ignorera si la demande rencontre des messages endommagés.
BadItemsEncountered Indique le nombre de messages endommagés rencontrés par la commande. Si la valeur BadItemsEncountered est supérieure à la valeur BadItemLimit , la requête échoue.
QueuedTimeStamp Indique la date et l'heure auxquelles la demande a été transmise au service MRS.
StartTimeStamp Indique les date et heure auxquelles le service de réplication de boîte aux lettres (MRS) a démarré le traitement de la demande de restauration.
LastUpdateTimeStamp Indique la date et l'heure de la dernière modification apportée à la demande. La modification a pu être effectuée par un administrateur ou par MRS.
SuspendTimeStamp Indique la date et l'heure auxquelles la demande a été suspendue.
OverallDuration Indique le temps qu'il a fallu pour traiter la demande. Si la demande est dans un Failed état, cette valeur spécifie le délai entre le lancement de la demande et l’échec de la requête. Si la demande n'est pas terminée, cette valeur indique la durée écoulée entre l'envoi de la demande et l'exécution de la cmdlet Get-MailboxRestoreRequestStatistics.
TotalSuspendedDuration Spécifie la durée pendant laquelle la demande a été dans l’état Suspended .
TotalFailedDuration Spécifie la durée pendant laquelle la demande a été dans l’état Failed .
TotalQueuedDuration Spécifie la durée pendant laquelle la demande a été dans l’état Queued .
TotalInProgressDuration Spécifie la durée pendant laquelle la demande a été dans l’état In Progress .
TotalStalledDueToHADuration Indique la durée pendant laquelle la demande a été bloquée pour cause de haute disponibilité.
MRSServerName Indique le nom du serveur d'accès au client qui a traité la demande.
EstimatedTransferSize Spécifie la taille totale du fichier qui a été restaurée ou la taille de fichier que MRS s’attend à restaurer si la demande est dans l’état In Progress .
EstimatedTransferItemCount Spécifie le nombre d’éléments qui ont été restaurés ou le nombre d’éléments que MRS s’attend à restaurer si la demande est dans l’état In Progress .
BytesTransferredPerMinute Indique le nombre moyen d'octets qui ont été transférés par minute.
ItemsTransferred Indique le nombre d'éléments qui ont été transférés.
PercentComplete Indique le pourcentage de traitement de la demande.
CompletedRequestAgeLimit Indique le temps qu'une demande de restauration terminée doit être conservée avant d'être supprimée. La valeur par défaut est 30 jours.
PositionInQueue Si le traitement de la demande n'a pas commencé, cette valeur spécifie la position de la demande dans la file d'attente.
FailureCode En cas de défaillance, cette valeur indique le code correspondant.
FailureType En cas de défaillance, cette valeur indique le type correspondant.
FailureSide En cas de défaillance, cette valeur indique si la défaillance s'est produite sur la boîte aux lettres cible ou sur la boîte aux lettres source.
Message En cas de défaillance, cette valeur indique le message correspondant. Cette valeur peut également spécifier le commentaire de suspension.
FailureTimestamp Si la demande a échoué, cette valeur spécifie la date et l'heure de l'échec de la demande.
FailureContext En cas d'échec de la demande, cette valeur fournit des informations sur l'opération effectuée au moment de l'échec.
ValidationMessage Si la demande n'était pas valide, cette valeur en indique le motif.
RequestQueue Indique la base de données dans laquelle MRS enregistre l'état détaillé de la demande.
Identity Indique l'identité de la demande.
Report Si vous avez utilisé le paramètre IncludeReport , cette valeur spécifie les informations qui peuvent être utilisées pour résoudre la demande.

Exécutez la cmdlet Get-MailboxRestoreRequestStatistics pour vérifier que vous pouvez afficher les statistiques relatives aux demandes de restauration de boîtes aux lettres. Si la cmdlet renvoie une erreur, vérifiez que vous utilisez l'identité correcte pour la demande de restauration.

Utiliser l'environnement de ligne de commande pour modifier les propriétés d'une demande de restauration

Si une demande de restauration de boîte aux lettres échoue, utilisez la cmdlet Set-MailboxRestoreRequest pour modifier les propriétés de la demande et tenter une récupération après défaillance.

Dans cet exemple, il est spécifié que la demande de restauration MailboxRestore1 pour la boîte aux lettres de Debra Garcia doit ignorer 10 éléments de boîte aux lettres endommagés.

Set-MailboxRestoreRequest -Identity "Debra Garcia\MailboxRestore1" -BadItemLimit 10

Cet exemple montre que la demande de restauration MailboxRestore1 pour la boîte aux lettres de Florence Flipo ignore 100 éléments endommagés. Étant donné que la valeur BadItemLimit est supérieure à 50, le paramètre AcceptLargeDataLoss doit être spécifié.

Set-MailboxRestoreRequest -Identity "Florence Flipo\MailboxRestore1" -BadItemLimit 100 -AcceptLargeDataLoss

Pour obtenir des informations détaillées sur la syntaxe et les paramètres, consultez la rubrique Set-MailboxRestoreRequest.

Comment savez-vous que vous avez correctement modifié les propriétés d’une demande de restauration ?

Pour vérifier que les propriétés d'une demande de restauration ont été correctement modifiées, exécutez la cmdlet Get-MailboxRestoreRequestStatistics afin d'afficher les propriétés révisées pour la demande de restauration. Si la demande de restauration a été créée avec succès, la propriété Status aura la valeur Queued, InProgressou Completed. Une fois la demande de restauration exécutée, le contenu de la boîte aux lettres supprimée (récupérable) doit apparaître dans la boîte aux lettres cible.

Pour obtenir des informations détaillées sur la syntaxe et les paramètres, consultez la rubrique Get-MailboxRestoreRequestStatistics.

Utiliser l’environnement de ligne de commande Exchange Management Shell pour interrompre une demande de restauration

Vous pouvez suspendre une demande de restauration à tout moment après la création de la demande, mais avant que la demande atteigne l’état de Completed. Pour la syntaxe de la commande permettant de reprendre la demande de restauration à l'aide de la cmdlet Resume-MailboxRestoreRequest, consultez la section Reprendre une demande de restauration via l'environnement de ligne de commande Exchange Management Shell plus loin dans cette rubrique .

Dans cet exemple, nous interrompons la demande de restauration MailboxRestore1 de la boîte aux lettres de Pilar Pinilla.

Suspend-MailboxRestoreRequest -Identity "Pilar Pinilla\MailboxRestore1"

Cet exemple suspend toutes les demandes de restauration en cours en récupérant d’abord toutes les demandes dont l’état InProgressest , puis en dirigeant la sortie vers l’applet de commande Suspend-MailboxRestoreRequest et en incluant le commentaire de suspension « Reprendre après la maintenance FY13Q2 ».

Get-MailboxRestoreRequest -Status InProgress | Suspend-MailboxRestoreRequest -SuspendComment "Resume after FY13Q2 Maintenance"

Pour obtenir des informations détaillées sur la syntaxe et les paramètres, consultez la rubrique Suspend-MailboxRestoreRequest.

Comment savez-vous que vous avez correctement suspendu une demande de restauration de boîte aux lettres ?

Pour vérifier que la suspension d'une demande de restauration de boîte aux lettres s'est correctement effectuée, exécutez la commande suivante :

Get-MailboxRestoreRequest <identity> | Format-List Suspend,Status

Si la valeur de la propriété Suspend est Trueégale à , la demande de restauration a été suspendue avec succès. En outre, une valeur de Suspended pour la propriété Status indique que la demande de restauration a été suspendue.

Reprendre une demande de restauration via l’environnement de ligne de commande Exchange Management Shell

La cmdlet Resume-MailboxRestoreRequest permet de reprendre une demande de restauration ayant échoué ou ayant été suspendue.

Cet exemple montre comment reprendre la demande de restauration Pilar Pinilla\MailboxRestore1.

Resume-MailboxRestoreRequest -Identity "Pilar Pinilla\MailboxRestore1"

Cet exemple montre comment reprendre toutes les demandes de restauration dont l'état est Échec.

Get-MailboxRestoreRequest -Status Failed | Resume-MailboxRestoreRequest

Pour obtenir des informations détaillées sur la syntaxe et les paramètres, consultez la rubrique Resume-MailboxRestoreRequest.

Comment savez-vous que vous avez correctement repris une demande de restauration ?

Pour vérifier que vous avez bien repris une demande de restauration, exécutez la commande suivante.

Get-MailboxRestoreRequest <identity> | Format-List Suspend,Status

Si la valeur de la propriété Suspend est égale Falseà , la demande de restauration a repris avec succès. En outre, une valeur de InProgress pour la propriété Status indique que la demande de restauration a repris.

Supprimer une demande de restauration via l’environnement de ligne de commande Exchange Management Shell

La cmdlet Remove-MailboxRestoreRequest vous permet de supprimer des demandes de restauration de boîtes aux lettres. Si vous supprimez une demande de restauration après l'échec de la copie des données de boîte aux lettres vers la boîte aux lettres cible, la boîte aux lettres cible conserve les données copiées.

Remarque

Comme indiqué précédemment, les demandes de restauration exécutées sont conservées pendant 30 jours par défaut avant leur suppression automatique.

Cet exemple montre comment supprimer la demande de restauration Pilar Pinilla\MailboxRestore1.

Remove-MailboxRestoreRequest -Identity "Pilar Pinilla\MailboxRestore1"

Cet exemple supprime toutes les demandes de restauration dont l'état est Terminé (Completed).

Get-MailboxRestoreRequest -Status Completed | Remove-MailboxRestoreRequest

Cet exemple annule la demande de restauration à l’aide du paramètre RequestGuid pour une requête stockée sur MBXDB01. Le jeu de paramètres qui nécessite les paramètres RequestGuid et RequestQueue est utilisé uniquement à des fins de débogage du service de réplication Microsoft. N'utilisez ce jeu que sur instruction du service de support technique Microsoft.

Remove-MailboxRestoreRequest -RequestQueue MBXDB01 -RequestGuid 25e0eaf2-6cc2-4353-b83e-5cb7b72d441f

Pour obtenir des informations détaillées sur la syntaxe et les paramètres, consultez la rubrique Remove-MailboxRestoreRequest.

Comment avez-vous supprimé une demande de restauration de boîte aux lettres ?

Pour vérifier que la suppression d'une demande de restauration de boîte aux lettres s'est correctement effectuée, exécutez la commande suivante :

Get-MailboxRestoreRequest -Identity <identity of removed restore request>

La commande renvoie une erreur indiquant que la demande de restauration n'existe pas.

Vous pouvez également exécuter la cmdlet Get-MailboxRestoreRequest. Si une demande de restauration a bien été supprimée, cette dernière figure pas dans les résultats.