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.
Syntax
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 de la même organisation 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 cette rubrique répertorie tous les paramètres de cette cmdlet, 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 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
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.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-AllowDuplicates
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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-AttachmentFilenames
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.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-BadItemLimit
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.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-Confirm
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-*) ont 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.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-ContentKeywords
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.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-EndDate
Le paramètre EndDate spécifie la date de fin du filtrage du contenu qui sera exporté à 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.
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-ExcludeFolders
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.
Type: | MapiFolderPath[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-GlobalCatalog
Le paramètre GlobalCatalog spécifie le catalogue global à utiliser pour rechercher la boîte aux lettres cible.
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-Identity
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)
Type: | MailboxIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-IncludeFolders
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.
Type: | MapiFolderPath[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-Locale
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.
Type: | CultureInfo |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-MaxThreads
Le paramètre MaxThreads spécifie le nombre maximal de threads à utiliser.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-RecipientKeywords
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 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.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-RecoveryDatabase
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
Type: | DatabaseIdParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-RecoveryMailbox
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.
Type: | StoreMailboxIdParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-SenderKeywords
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 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.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-StartDate
Le paramètre StartDate spécifie la date de début. La date de début doit être antérieure à la date de fin.
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-SubjectKeywords
Le paramètre SubjectKeywords spécifie les filtres de mots clés 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.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-TargetFolder
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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-ValidateOnly
Le commutateur ValidateOnly indique à la commande d’évaluer les conditions et les exigences nécessaires à l’exécution de l’opération, puis de signaler si l’opération va réussir ou échouer. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Aucune modification n’est apportée lorsque vous utilisez ce commutateur.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-WhatIf
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.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
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.