Restore-Mailbox
Cette applet de commande est disponible uniquement dans Exchange Server 2010.
Utilisez l’applet de commande Restore-Mailbox pour extraire le contenu de la boîte aux lettres d’une base de données restaurée.
Remarque : Dans Exchange Server 2010 Service Pack 1 (SP1) ou version ultérieure, utilisez l’applet de commande New-MailboxRestoreRequest au lieu de l’applet de commande Restore-Mailbox pour extraire le contenu de la boîte aux lettres d’une base de données restaurée.
Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.
Syntaxe
Default (Par défaut)
Restore-Mailbox
[-Identity] <MailboxIdParameter>
-RecoveryDatabase <DatabaseIdParameter>
-RecoveryMailbox <StoreMailboxIdParameter>
-TargetFolder <String>
[-AllowDuplicates]
[-AllContentKeywords <String[]>]
[-AttachmentFilenames <String[]>]
[-BadItemLimit <Int32>]
[-Confirm]
[-ContentKeywords <String[]>]
[-EndDate <DateTime>]
[-ExcludeFolders <MapiFolderPath[]>]
[-GlobalCatalog <Fqdn>]
[-IncludeFolders <MapiFolderPath[]>]
[-Locale <CultureInfo>]
[-MaxThreads <Int32>]
[-RecipientKeywords <String[]>]
[-SenderKeywords <String[]>]
[-StartDate <DateTime>]
[-SubjectKeywords <String[]>]
[-ValidateOnly]
[-WhatIf]
[<CommonParameters>]
Description
L’applet de commande Restore-Mailbox copie les données de l’utilisateur final de n’importe quel serveur exécutant Microsoft Exchange Server 2010 vers une boîte aux lettres sur un serveur de boîtes aux lettres Exchange 2010 dans le même organization qui dispose de l’espace et des ressources suffisants pour prendre en charge la boîte aux lettres. L’applet de commande Restore-Mailbox peut uniquement utiliser des boîtes aux lettres déconnectées sur un serveur comme source de données, et l’applet de commande peut uniquement utiliser des boîtes aux lettres connectées comme cible pour les données.
Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cet article répertorie tous les paramètres de l’applet de commande, il se peut que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous sont attribuées. Pour rechercher les autorisations requises pour exécuter une cmdlet ou un paramètre dans votre organisation, voir Find the permissions required to run any Exchange cmdlet.
Exemples
Exemple 1
Restore-Mailbox -Identity Scott -RecoveryDatabase MyRecoveryDatabase
Cet exemple restaure une boîte aux lettres pour l’utilisateur Scott à partir de la base de données MyRecoveryDatabase.
Exemple 2
Restore-Mailbox -Identity Scott -RecoveryDatabase MyRecoveryDatabase -RecoveryMailbox John -TargetFolder Recovery
Cet exemple montre comment restaurer le contenu de la boîte aux lettres de John dans la boîte aux lettres de Scott sous le dossier Récupération.
Exemple 3
Restore-Mailbox -Identity Scott -RecoveryDatabase MyRecoveryDatabase -SubjectKeywords "Meeting" -ContentKeywords "business" -IncludeFolders \Inbox,\Calendar
Cet exemple montre comment restaurer uniquement le courrier avec l’objet Réunion, le corps du message contenant le mot business et l’emplacement du message dans la boîte de réception ou le dossier Calendrier. Cet exemple suppose que la boîte aux lettres est en anglais.
Exemple 4
Get-Mailbox -Database MyDatabase | Restore-Mailbox -RecoveryDatabase MyRecoveryDatabase
Cet exemple restaure en bloc toutes les boîtes aux lettres dans la base de données de boîtes aux lettres MyDatabase qui sont également présentes dans MyRecoveryDatabase.
Paramètres
-AllContentKeywords
Applicable : Exchange Server 2010
Le paramètre AllContentKeywords spécifie les filtres pour tous les éléments suivants :
- Sujet
- Corps du message
- Contenu de la pièce jointe
Cela permet une recherche OR de tous ces champs. Si vos critères de recherche font partie du contenu de l’objet, du corps du message ou de la pièce jointe, vous obtenez des résultats.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-AllowDuplicates
Applicable : Exchange Server 2010
Le commutateur AllowDuplicates copie les éléments de courrier sans vérifier s’ils sont des doublons d’éléments existants et sans supprimer d’éléments en double. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Nous vous recommandons d’utiliser ce commutateur avec le paramètre IncludeFolders.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-AttachmentFilenames
Applicable : Exchange Server 2010
Le paramètre AttachmentFilenames spécifie le filtre pour le nom du 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.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-BadItemLimit
Applicable : Exchange Server 2010
Le paramètre BadItemLimit spécifie le nombre d’éléments endommagés dans une boîte aux lettres à ignorer avant l’échec de l’opération d’exportation.
Propriétés du paramètre
| Type: | Int32 |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Confirm
Applicable : Exchange Server 2010
Le commutateur Confirme spécifie s’il faut afficher ou masquer l’invite de confirmation. L’incidence de ce commutateur sur la cmdlet varie selon que la cmdlet requiert une confirmation avant de poursuivre.
- Les applets de commande destructrices (par exemple, les applets de commande Remove-*) comportent une pause intégrée qui vous oblige à accuser réception de la commande avant de continuer. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte :
-Confirm:$false. - La plupart des autres applets de commande (par exemple, les applets de commande New-* et Set-*) n'ont pas de pause intégrée. Pour ces cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ContentKeywords
Applicable : Exchange Server 2010
Le paramètre ContentKeywords spécifie les filtres mot clé pour le corps du message et le contenu des pièces jointes dans la boîte aux lettres source.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-EndDate
Applicable : Exchange Server 2010
Le paramètre EndDate spécifie la date de fin du filtrage du contenu à exporter à partir de la boîte aux lettres source. Seuls les éléments de la boîte aux lettres dont la date est antérieure à la date de fin sont exportés. Lorsque 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 01/03/2010 pour spécifier le 1er mars 2010.
Propriétés du paramètre
| Type: | DateTime |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ExcludeFolders
Applicable : Exchange Server 2010
Le paramètre ExcludeFolders spécifie la liste de dossiers à exclure durant l’exportation. Les dossiers sont exclus au fur et à mesure qu’ils sont entrés. Ils ne sont pas localisés. Par exemple, l’exclusion du calendrier exclut uniquement le calendrier en anglais, car calendrier dans d’autres langues est un mot différent.
Propriétés du paramètre
| Type: | MapiFolderPath[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-GlobalCatalog
Applicable : Exchange Server 2010
Le paramètre GlobalCatalog spécifie le catalogue global à utiliser pour rechercher la boîte aux lettres cible.
Propriétés du paramètre
| Type: | Fqdn |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Identity
Applicable : Exchange Server 2010
Le paramètre Identity spécifie la boîte aux lettres que vous souhaitez restaurer. Vous pouvez utiliser n’importe quelle valeur qui identifie la boîte aux lettres de manière unique. Par exemple :
- Nom
- Alias
- Nom unique
- Nom unique
- Domaine\Nom d’utilisateur
- Adresse e-mail
- GUID
- LegacyExchangeDN
- SamAccountName
- Identifiant utilisateur ou nom d’utilisateur principal (UPN)
Propriétés du paramètre
| Type: | MailboxIdParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-IncludeFolders
Applicable : Exchange Server 2010
Le paramètre IncludeFolders spécifie la liste de dossiers à inclure durant l’exportation. Les dossiers sont inclus au fur et à mesure qu’ils sont entrés. Ils ne sont pas localisés. Par exemple, l’inclusion d’un calendrier inclut uniquement le calendrier en anglais, car calendrier dans d’autres langues est un mot différent.
Propriétés du paramètre
| Type: | MapiFolderPath[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Locale
Applicable : Exchange Server 2010
Le paramètre Paramètres régionaux spécifie le paramètre de paramètres régionaux sur un message à restaurer. Avec ce jeu de filtres, seuls les messages avec les paramètres régionaux spécifiés sont extraits.
Propriétés du paramètre
| Type: | CultureInfo |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-MaxThreads
Applicable : Exchange Server 2010
Le paramètre MaxThreads spécifie le nombre maximal de threads à utiliser.
Propriétés du paramètre
| Type: | Int32 |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-RecipientKeywords
Applicable : Exchange Server 2010
Le paramètre RecipientKeywords spécifie les filtres mot clé pour les destinataires des éléments dans la boîte aux lettres source. Ce filtre recherche la chaîne de recherche même si elle fait partie d’un mot. Il ne s’agit pas d’une recherche de mot entière.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-RecoveryDatabase
Applicable : Exchange Server 2010
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 n’importe quelle valeur qui identifie la base de données de manière unique. Par exemple :
- Nom
- Nom unique (DN)
- GUID
Propriétés du paramètre
| Type: | DatabaseIdParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-RecoveryMailbox
Applicable : Exchange Server 2010
Le paramètre RecoveryMailbox spécifie la boîte aux lettres à utiliser comme boîte aux lettres source. Ce paramètre est requis si la boîte aux lettres source est différente de la boîte aux lettres cible.
Vous identifiez la boîte aux lettres par sa valeur GUID. Vous pouvez trouver la valeur GUID à l’aide des cmdlets Get-Mailbox ou Get-MailboxStatistics.
Propriétés du paramètre
| Type: | StoreMailboxIdParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-SenderKeywords
Applicable : Exchange Server 2010
Le paramètre SenderKeywords spécifie les filtres mot clé pour les expéditeurs d’éléments dans la boîte aux lettres source. Ce filtre recherche la chaîne de recherche même si elle fait partie d’un mot. Il ne s’agit pas d’une recherche de mot entière.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-StartDate
Applicable : Exchange Server 2010
Le paramètre StartDate spécifie la date de début. La date de début doit être antérieure à la date de fin.
Propriétés du paramètre
| Type: | DateTime |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-SubjectKeywords
Applicable : Exchange Server 2010
Le paramètre SubjectKeywords spécifie les filtres mot clé pour les sujets des éléments dans la boîte aux lettres source. Ce filtre recherche la chaîne de recherche même si elle fait partie d’un mot. Il ne s’agit pas d’une recherche de mot entière.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-TargetFolder
Applicable : Exchange Server 2010
Le paramètre TargetFolder spécifie le dossier de boîte aux lettres créé sur la boîte aux lettres spécifiée. Ce paramètre est requis 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 n’est pas identique à la valeur spécifiée avec le paramètre RecoveryMailbox.) Dans ce cas, la commande Restore-Mailbox effectue une fusion. Si les valeurs sont identiques, le paramètre TargetFolder n’est pas obligatoire.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ValidateOnly
Applicable : Exchange Server 2010
Le commutateur ValidateOnly spécifie s’il faut évaluer la réussite ou l’échec potentiel de la commande sans apporter de modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-WhatIf
Applicable : Exchange Server 2010
Le commutateur WhatIf simule les actions de la commande. Vous pouvez utiliser ce commutateur pour afficher les modifications qui se produiraient sans réellement appliquer ces modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
Entrées
Input types
Pour visualiser les types d'entrées acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type d'entrée pour une cmdlet est vide, la cmdlet n'accepte pas les données d'entrée.
Sorties
Output types
Pour visualiser les types de retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.