.png)
Restore-Mailbox
S’applique à : Exchange Server 2010 SP3, Exchange Server 2010
Dernière rubrique modifiée : 2012-11-16
La cmdlet Restore-Mailbox permet d’extraire le contenu d’une boîte aux lettres à partir d’une base de données restaurée.
 Remarque : |
|---|
| Si vous exécutez Exchange Server Service Pack 1 (SP1) ou une version ultérieure, utilisez la cmdlet New-MailboxRestoreRequest à la place de la cmdlet Restore-Mailbox pour extraire le contenu de la boîte aux lettres d'une base de données restaurée. Pour plus d’informations, consultez les rubriques Nouvelles fonctionnalités de boîte aux lettres et de destinataires dans Exchange 2010 SP1 et New-MailboxRestoreRequest. |
restore-Mailbox -Identity <MailboxIdParameter> -RecoveryDatabase <DatabaseIdParameter> [-AllContentKeywords <String[]>] [-AllowDuplicates <SwitchParameter>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-Confirm [<SwitchParameter>]] [-ContentKeywords <String[]>] [-EndDate <DateTime>] [-ExcludeFolders <MapiFolderPath[]>] [-GlobalCatalog <Fqdn>] [-IncludeFolders <MapiFolderPath[]>] [-Locale <CultureInfo>] [-MaxThreads <Int32>] [-RecipientKeywords <String[]>] [-SenderKeywords <String[]>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
restore-Mailbox -Identity <MailboxIdParameter> -RecoveryDatabase <DatabaseIdParameter> -RecoveryMailbox <StoreMailboxIdParameter> -TargetFolder <String> [-AllContentKeywords <String[]>] [-AllowDuplicates <SwitchParameter>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-Confirm [<SwitchParameter>]] [-ContentKeywords <String[]>] [-EndDate <DateTime>] [-ExcludeFolders <MapiFolderPath[]>] [-GlobalCatalog <Fqdn>] [-IncludeFolders <MapiFolderPath[]>] [-Locale <CultureInfo>] [-MaxThreads <Int32>] [-RecipientKeywords <String[]>] [-SenderKeywords <String[]>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
La cmdlet Restore-Mailbox copie les données d’un utilisateur final se trouvant sur un serveur exécutant Microsoft Exchange Server 2010 dans une boîte aux lettres sur un serveur de boîtes aux lettres Exchange 2010 de la même organisation qui dispose de l’espace et des ressources nécessaire pour prendre en charge cette boîte aux lettres. La cmdlet Restore-Mailbox ne peut utiliser que des boîtes aux lettres déconnectées sur un serveur comme source des données et elle ne peut utiliser que des boîtes aux lettres connectées comme cibles des données.
Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que tous les paramètres de cette cmdlet soient répertoriés dans cette rubrique, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été attribuées. Pour voir les autorisations qui vous sont nécessaires, voir entrée « Récupération de boîtes aux lettres » dans la rubrique Autorisations de boîtes aux lettres.
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
| Identity | Obligatoire | Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter | Le paramètre Identity spécifie l’identité de la boîte aux lettres. Ce paramètre accepte les valeurs suivantes :
|
| RecoveryDatabase | Obligatoire | Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter | Le paramètre RecoveryDatabase spécifie la base de données de récupération à partir de laquelle vous restaurez la boîte aux lettres. Vous pouvez utiliser les valeurs suivantes :
|
| RecoveryMailbox | Obligatoire | Microsoft.Exchange.Configuration.Tasks.StoreMailboxIdParameter | Le paramètre RecoveryMailbox spécifie la boîte aux lettres à utiliser comme boîte aux lettres source. Ce paramètre est obligatoire si la boîte aux lettres source est différente de la boîte aux lettres cible. |
| TargetFolder | Obligatoire | System.String | Le paramètre TargetFolder spécifie le dossier de boîte aux lettres qui est créé sur la boîte aux lettres spécifiée. Ce paramètre est obligatoire si la boîte aux lettres en cours de restauration est différente de la boîte aux lettres cible. (Par exemple, la valeur spécifiée avec le paramètre Identity est différente de celle spécifiée avec le paramètre RecoveryMailbox.) Dans ce cas, la cmdlet Restore-Mailbox procède à une opération de fusion. Si les valeurs sont identiques, le paramètre TargetFolder n’est pas obligatoire. |
| AllowDuplicates | Facultatif | System.Management.Automation.SwitchParameter | Le paramètre AllowDuplicates permet de copier des éléments de messagerie sans vérifier s’il s’agit de doublons d’éléments existants et sans supprimer les éléments dupliqués. Il est recommandé d’utiliser le paramètre AllowDuplicates conjointement avec le paramètre IncludeFolders. |
| AllContentKeywords | Facultatif | System.String[] | Le paramètre AllContentKeywords spécifie les filtres pour les tous les éléments suivants :
Cela permet d’effectuer une recherche OR de tous ces champs. Si vos critères de recherche font référence au contenu de l’objet, du corps du message ou du contenu des pièces jointes, vous obtiendrez des résultats. |
| AttachmentFilenames | Facultatif | System.String[] | Le paramètre AttachmentFilenames spécifie le filtre pour le nom de fichier de pièce jointe. Vous pouvez utiliser des caractères génériques dans la chaîne. Par exemple, vous pouvez utiliser « *.txt » pour exporter des éléments qui ont une extension .txt. |
| BadItemLimit | Facultatif | System.Int32 | Le paramètre BadItemLimit spécifie le nombre d’éléments endommagés dans une boîte aux lettres à ignorer avant que l’opération d’exportation n’échoue. |
| Confirm | Facultatif | System.Management.Automation.SwitchParameter | Le commutateur Confirm suspend la commande et vous demande de confirmer les actions que la commande va exécuter avant de continuer le traitement. Il n’est pas nécessaire de spécifier une valeur pour le commutateur Confirm. |
| ContentKeywords | Facultatif | System.String[] | Le paramètre ContentKeywords spécifie les filtres de mots clés pour le corps du message et le contenu des pièces jointes dans la boîte aux lettres source. |
| EndDate | Facultatif | System.DateTime | Le paramètre EndDate spécifie la date de fin pour le filtrage du contenu exporté à partir de la boîte aux lettres source. Seuls les éléments dans la boîte aux lettres dont la date est antérieure à la date de fin sont exportés. Si vous entrez une date spécifique, utilisez le format de date courte défini dans les paramètres Options régionales configurés sur l’ordinateur local. Par exemple, si votre ordinateur est configuré pour utiliser le format de date courte mm/jj/aaaa, entrez 03/01/2010 pour spécifier le 1er mars 2010. |
| ExcludeFolders | Facultatif | Microsoft.Exchange.Data.MapiFolderPath[] | Le paramètre ExcludeFolders spécifie la liste de dossiers à exclure durant l’exportation. Les dossiers sont exclus à mesure qu’ils sont entrés. Ils ne sont pas localisés. Par exemple, l’exclusion de calendrier exclura uniquement « calendrier » en français, car ce mot est différent dans les autres langues. |
| GlobalCatalog | Facultatif | Microsoft.Exchange.Data.Fqdn | Le paramètre GlobalCatalog spécifie le catalogue global à utiliser pour rechercher la boîte aux lettres cible. |
| IncludeFolders | Facultatif | Microsoft.Exchange.Data.MapiFolderPath[] | Le paramètre IncludeFolders spécifie la liste de dossiers à inclure durant l’exportation. Les dossiers sont inclus à mesure qu’ils sont entrés. Ils ne sont pas localisés. Par exemple, l’inclusion de calendrier inclura uniquement « calendrier » en français, car ce mot est différent dans les autres langues. |
| Locale | Facultatif | System.Globalization.CultureInfo | Le paramètre Locale spécifie les paramètres régionaux d’un message à restaurer. Lorsque ce filtre est défini, seuls les messages avec les paramètres régionaux spécifiés sont extraits. |
| MaxThreads | Facultatif | System.Int32 | Le paramètre MaxThreads spécifie le nombre maximal de threads à utiliser. |
| RecipientKeywords | Facultatif | System.String[] | Le paramètre RecipientKeywords spécifie les filtres de mots clés pour les destinataires des éléments dans la boîte aux lettres source. Ce filtre trouvera la chaîne de recherche, même si elle fait partie d’un mot. Il ne s’agit pas d’une recherche de mot complet. |
| SenderKeywords | Facultatif | System.String[] | Le paramètre SenderKeywords spécifie les filtres de mots clés pour les expéditeurs des éléments dans la boîte aux lettres source. Ce filtre trouvera la chaîne de recherche, même si elle fait partie d’un mot. Il ne s’agit pas d’une recherche de mot complet. |
| StartDate | Facultatif | System.DateTime | Le paramètre StartDate spécifie la date de début. La date de début doit être antérieure à la date de fin. |
| SubjectKeywords | Facultatif | System.String[] | Le paramètre SubjectKeywords spécifie les filtres de mots clés pour les objets des éléments dans la boîte aux lettres source. Ce filtre trouvera la chaîne de recherche, même si elle fait partie d’un mot. Il ne s’agit pas d’une recherche de mot complet. |
| ValidateOnly | Facultatif | System.Management.Automation.SwitchParameter | Le commutateur ValidateOnly indique à la cmdlet d’évaluer les conditions et exigences nécessaires pour effectuer l’opération et signale ensuite si l’opération réussit ou échoue. Aucune modification n’est effectuée lorsque le commutateur ValidateOnly est utilisé. |
| WhatIf | Facultatif | System.Management.Automation.SwitchParameter | Le commutateur WhatIf donne pour instruction à la commande de simuler les actions qu’elle va appliquer à l’objet. Grâce au paramètre WhatIf, vous pouvez afficher des changements potentiels sans devoir les appliquer. Il n’est pas nécessaire de spécifier une valeur pour le commutateur WhatIf. |
Pour visualiser les types d’entrées acceptées par cette cmdlet, voir Types d’entrée et de sortie de la cmdlet. Si le champ Type d’entrée pour une cmdlet est vide, la cmdlet n’accepte pas les données d’entrée.
Pour visualiser les types de retour, connus également en tant que types de sortie, acceptés par cette cmdlet, voir Types d’entrée et de sortie de la cmdlet. Si le champ Type de sortie est vide, la cmdlet ne retourne pas de données.
Cet exemple restaure une boîte aux lettres pour l’utilisateur Scott à partir de la base de données MyRecoveryDatabase.
Restore-Mailbox -Identity Scott -RecoveryDatabase MyRecoveryDatabase
Cet exemple restaure le contenu de la boîte aux lettres de John dans la boîte aux lettres de Scott dans le répertoire de récupération.
Restore-Mailbox -Identity Scott -RecoveryDatabase MyRecoveryDatabase -RecoveryMailbox John -TargetFolder Recovery
Cet exemple restaure uniquement les messages avec l’objet Meeting, dont le corps contient le mot business et qui se trouvent dans le répertoire Inbox ou Calendar. Cet exemple suppose que la boîte aux lettres est en anglais.
Restore-Mailbox -Identity Scott -RecoveryDatabase MyRecoveryDatabase -SubjectKeywords "Meeting" -ContentKeywords "business" -IncludeFolders \Inbox,\Calendar
Cet exemple restaure en bloc toutes les boîtes aux lettres de la base de données de boîtes aux lettres MyDatabase qui sont également présentes dans la base de données MyRSGDatabase.
Get-Mailbox -Database MyDatabase | Restore-Mailbox -RecoveryDatabase MyRecoveryDatabase
