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 utilisateur final de n’importe quel serveur exécutant Microsoft Exchange Server 2010 dans 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 nécessaires pour prendre en charge la boîte aux lettres. L’applet de commande Restore-Mailbox ne peut utiliser que des boîtes aux lettres déconnectées sur un serveur comme source de données et l’applet de commande ne peut utiliser que des boîtes aux lettres connectées comme cible de 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 restaure le contenu de la boîte aux lettres de John dans la boîte aux lettres de Scott dans le dossier de récupération.
Exemple 3
Restore-Mailbox -Identity Scott -RecoveryDatabase MyRecoveryDatabase -SubjectKeywords "Meeting" -ContentKeywords "business" -IncludeFolders \Inbox,\Calendar
Cet exemple restaure uniquement le courrier avec l’objet Réunion, avec le corps du message contenant le mot entreprise et avec l’emplacement du message dans la boîte de réception ou le dossier Calendar. 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 de 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 OU de tous ces champs. Si vos critères de recherche font partie de l’objet, du corps du message ou du contenu 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 Autoriser les doublons copie les éléments de courrier sans vérifier s’il s’agit de doublons d’éléments existants et sans supprimer les doublons. 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 joint. 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’impact de ce commutateur sur l’applet de commande varie selon que l’applet de commande nécessite une confirmation avant de continuer.
- 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 applets de commande, la spécification du commutateur Confirmer sans valeur introduit une pause qui vous oblige à accuser réception de la commande avant de continuer.
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 de mots clés 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 DateFin 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 à mesure qu’ils sont entrés. Ils ne sont pas localisés. Par exemple, exclure calendrier uniquement 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 Identité 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 de calendrier inclut uniquement 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 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.
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 de mots clés pour les destinataires des éléments de la boîte aux lettres source. Ce filtre trouve la chaîne de recherche même si elle fait partie d’un mot. Ce n’est pas une recherche de mots entiers.
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 obligatoire si la boîte aux lettres source est différente de la boîte aux lettres cible.
Vous identifiez la boîte aux lettres grâce à 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 de mots clés pour les expéditeurs d’éléments dans la boîte aux lettres source. Ce filtre trouve la chaîne de recherche même si elle fait partie d’un mot. Ce n’est pas une recherche de mots entiers.
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 DateDébut 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 de mots clés pour les objets des éléments de la boîte aux lettres source. Ce filtre trouve la chaîne de recherche même si elle fait partie d’un mot. Ce n’est pas une recherche de mots entiers.
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 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 n’est pas la même que 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 affiche ce que la commande fait 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 |
| 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 communs : -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.