Partager via


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.