Restore-Mailbox

Article
09/30/2014

S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Dernière rubrique modifiée : 2009-05-14

Utilisez la cmdlet Restore-Mailbox pour extraire le contenu de la boîte aux lettres à partir d'une base de données restaurée vers un groupe de stockage de récupération.

Syntaxe

restore-Mailbox -Identity <MailboxIdParameter> -RSGDatabase <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[]>] [-ReportFile <LocalLongFullPath>] [-SenderKeywords <String[]>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

restore-Mailbox -Identity <MailboxIdParameter> -RSGDatabase <DatabaseIdParameter> -RSGMailbox <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[]>] [-ReportFile <LocalLongFullPath>] [-SenderKeywords <String[]>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Description détaillée

La cmdlet Restore-Mailbox copie les données d'utilisateur final à partir d'un groupe de stockage de récupération de tout serveur exécutant Microsoft Exchange Server 2007 dans une boîte aux lettres de tout serveur de boîtes aux lettres Exchange 2007 de la même organisation qui dispose de l'espace et des ressources nécessaire pour prendre en charge la boîte aux lettres. La cmdlet Restore-Mailbox ne peut utiliser que des boîtes aux lettres déconnectées d'un groupe de stockage de récupération sur un serveur comme source des données, et ne peut utiliser que des boîtes aux lettres connectées comme cibles des données.

Pour exécuter la cmdlet Restore-Mailbox, vous devez utiliser un compte auquel ont été délégués le rôle Administrateur de serveur Exchange et le groupe Administrateurs local pour les serveurs cible et source. Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Exchange 2007, consultez la rubrique Considérations relatives aux autorisations.

Paramètres

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 cible. Ce paramètre est un nom ou un GUID. Si la boîte aux lettres source n'est pas identifiée avec le paramètre RSGMailbox, on suppose que la boîte aux lettres source a le même GUID de boîte aux lettres que la boîte aux lettres cible.
RSGDatabase	Obligatoire	Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter	La paramètre RSGDatabase spécifie la base de groupes de stockage de récupération à partir de laquelle vous restaurez la boîte aux lettres. Vous pouvez utiliser les valeurs suivantes : GUID de la base de données Nom de la base de données Nom de serveur\nom de base de données Nom de serveur\groupe de stockage\nom de base de données
RSGMailbox	Obligatoire	Microsoft.Exchange.Configuration.Tasks.StoreMailboxIdParameter	Le paramètre RSGMailbox spécifie la boîte aux lettres du groupe de stockage de récupération à 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 sera créé dans la boîte aux lettres spécifiée. Si la boîte aux lettre en cours de restauration est différente de la boîte aux lettres dans le groupe de stockage de récupération, la cmdlet Restore-Mailbox effectuera une fusion.
AllContentKeywords	Facultatif	System.String[]	Le paramètre AllContentKeywords spécifie les filtres pour les tous les éléments suivants : Subject Corps du message Contenu des pièces jointes Il permet une recherche OU de tous ces champs. Si vos critères de recherche se trouvent dans l'objet, le corps du message ou le contenu des pièces jointes, vous obtiendrez des résultats.
AllowDuplicates	Facultatif	System.Management.Automation.SwitchParameter	Le paramètre AllowDuplicates permet de copier les éléments de message 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 avec le paramètre IncludeFolders.
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 paramètre Confirm suspend le traitement par la commande et demande à l'administrateur de confirmer les actions que la commande va effectuer avant de continuer le traitement. La valeur par défaut est $true.
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/2006 pour spécifier le 1er mars 2006.
ExcludeFolders	Facultatif	Microsoft.Exchange.Data.Mapi.MapiFolderPath[]	Le paramètre ExcludeFolders spécifie la liste de dossiers à exclure durant l'exportation. Les répertoires sont exclus lorsqu'ils sont entrés. Ils ne sont pas localisés. Par exemple, l'exclusion du dossier calendrier exclura uniquement la version en français de ce dossier, parce que le mot calendrier 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.Mapi.MapiFolderPath[]	Le paramètre IncludeFolders spécifie la liste de dossiers à inclure durant l'exportation. Les répertoires sont inclus lorsqu'ils sont entrés. Ils ne sont pas localisés. Par exemple, l'inclusion du dossier calendrier inclura uniquement la version en français de ce dossier, parce que le mot calendrier 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, l'extraction sera effectuée uniquement dans les messages de la langue définie.
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.
ReportFile	Facultatif	Microsoft.Exchange.Data.LocalLongFullPath	Le paramètre ReportFile spécifie le chemin et le nom de fichier du journal de rapport XML.
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	La 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.
TargetFolder	Facultatif	System.String	Le paramètre TargetFolder spécifie le dossier de boîte aux lettres qui sera 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 celle du groupe de stockage de récupération. (Par exemple, la valeur spécifiée avec le paramètre Identity n’est pas la même que celle spécifiée avec le paramètre RSGMailbox.) 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.
ValidateOnly	Facultatif	System.Management.Automation.SwitchParameter	Le paramètre ValidateOnly donne pour instruction à la commande de simuler les actions qu'elle va appliquer à l'objet. La valeur par défaut est $true.
WhatIf	Facultatif	System.Management.Automation.SwitchParameter	Le paramètre WhatIf donne pour instruction à la commande de simuler les actions qu'elle va appliquer à l'objet. Grâce au paramètre WhatIf, l'administrateur peut afficher les changements potentiels sans devoir les appliquer. La valeur par défaut est $true.

Types d'entrées

Types de retours

Erreurs

Exceptions

Exemple

Dans l'exemple de code suivant, le premier exemple restaure un boîte aux lettres pour l'utilisateur Scott depuis la base de données de groupes de stockage de récupération MyRSGDatabase.

Le deuxième 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.

Le troisième exemple restaure uniquement les messages avec le sujet « Meeting », qui contiennent le mot « business » dans le corps et qui sont situés dans le répertoire Boîte de réception ou Calendrier. Cet exemple suppose que la boîte aux lettres est en Anglais.

Le dernier exemple restaure en bloc toutes les boîtes aux lettres de la base de données de boîtes aux lettres MyDatabase également présentes dans MyRSGDatabase.

Restore-Mailbox -Identity Scott -RSGDatabase MyRSGDatabase
Restore-Mailbox -Identity Scott -RSGDatabase MyRSGDatabase -RSGMailbox John -TargetFolder Recovery
Restore-Mailbox -Identity Scott -RSGDatabase MyRSGDatabase -SubjectKeywords "Meeting" -ContentKeyword "business" -IncludeFolders \Inbox,\Calendar
Get-Mailbox -Database MyDatabase | Restore-Mailbox -RSGDatabase MyRSGDatabase