Restore-Mailbox (RTM)
S’applique à : Exchange Server 2007
Dernière rubrique modifiée : 2007-06-05
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[]>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-ContentKeywords <String[]>] [-EndDate <DateTime>] [-ExcludeFolders <MapiFolderPath[]>] [-GlobalCatalog <Fqdn>] [-IncludeFolders <MapiFolderPath[]>] [-Locale <CultureInfo>] [-MaxThreads <Int32>] [-ReportFile <LocalLongFullPath>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>]
restore-Mailbox -Identity <MailboxIdParameter> -RSGDatabase <DatabaseIdParameter> -RSGMailbox <StoreMailboxIdParameter> -TargetFolder <String> [-AllContentKeywords <String[]>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-ContentKeywords <String[]>] [-EndDate <DateTime>] [-ExcludeFolders <MapiFolderPath[]>] [-GlobalCatalog <Fqdn>] [-IncludeFolders <MapiFolderPath[]>] [-Locale <CultureInfo>] [-MaxThreads <Int32>] [-ReportFile <LocalLongFullPath>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <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.
Un groupe de stockage de récupération permet de récupérer des données à partir d'une copie de sauvegarde de la base de données sans perturber l'accès des utilisateurs aux données actuelles. Le groupe de stockage de récupération peut également être utile pour récupérer des données en cas de perte. Un serveur ne peut contenir qu'un seul groupe de stockage de récupération.
Pour exécuter la cmdlet Restore-Mailbox, vous devez utiliser un compte auquel a été délégué :
- le rôle Administrateur de serveur Exchange et le groupe Administrateurs local pour les serveurs source et cible.
Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Exchange Server 2007, consultez la rubrique Considérations relatives aux autorisations.
Les serveurs font partie d'une forêt unique ou de forêts ressource. Des données de boîte aux lettres ne peuvent être exportées qu'à l'intérieur de la même forêt. Les comptes du service d'annuaire Active Directory associés à la boîte aux lettres peuvent se trouver dans une forêt externe mais les données de cette boîte aux lettres ne peuvent pas être exportées vers des serveurs dans d'autres forêts.
Les bases de données récupérée et source doivent provenir d'un serveur Exchange 2007.
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 des boîtes aux lettres connectées comme cibles des données.
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 :
|
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éé sur la boîte aux lettres spécifiée. |
AllContentKeywords |
Facultatif |
System.String[] |
Le paramètre AllContentKeywords spécifie les filtres pour les tous les éléments suivants :
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. |
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. |
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 de calendrier exclura uniquement « calendrier » en français, parce que ce mot 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 de calendrier inclura uniquement « calendrier » en français, parce que ce mot 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. |
ReportFile |
Facultatif |
Microsoft.Exchange.Data.LocalLongFullPath |
Le paramètre ReportFile spécifie le chemin et le nom de fichier du journal de rapport XML. |
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. |
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. |
Types d'entrées
Types de retours
Erreurs
Erreur |
Description |
|
|
Exceptions
Exceptions |
Description |
|
|
Exemple
Dans l'exemple de code suivant, le premier exemple restaure un boîte aux lettres pour l'utilisateur Chris 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 Ricardo dans la boîte aux lettres de Chris dans le répertoire de récupération. Le troisième exemple restaure uniquement les messages avec le sujet « Meeting » ET 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 chris -RSGDatabase MyRSGDatabase
Restore-Mailbox -Identity Chris -RSGDatabase MyRSGDatabase -RSGMailbox Ricardo -TargetFolder Recovery
Restore-Mailbox -Identity Chris -RSGDatabase MyRSGDatabase -SubjectKeywords "Meeting" -ContentKeyword "business" -IncludeFolders \Inbox,\Calendar
Get-mailbox -Database MyDatabase | Restore-Mailbox -RSGDatabase MyRSGDatabase