Export-Mailbox (RTM)
S’applique à : Exchange Server 2007
Dernière rubrique modifiée : 2007-06-05
La cmdlet Export-Mailbox permet de déplacer le contenu d'une boîte aux lettres vers un dossier de boîte aux lettres spécifié.
Syntaxe
export-Mailbox -Identity <MailboxIdParameter> -TargetFolder <String> -TargetMailbox <MailboxIdParameter> [-AllContentKeywords <String[]>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-ContentKeywords <String[]>] [-DeleteContent <SwitchParameter>] [-EndDate <DateTime>] [-ExcludeFolders <MapiFolderPath[]>] [-GlobalCatalog <Fqdn>] [-IncludeFolders <MapiFolderPath[]>] [-Locale <CultureInfo>] [-MaxThreads <Int32>] [-ReportFile <LocalLongFullPath>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>]
Description détaillée
Pour exécuter la cmdlet Export-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 le serveur 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.
Vous ne pouvez pas exporter de données d'une boîte aux lettres figurant dans une forêt vers une boîte aux lettres dans une autre forêt. Les boîtes aux lettres source et cible doivent se trouver dans la même forêt.
La cmdlet Export-Mailbox exporte tous les dossiers vides et les fichiers spéciaux à la localisation cible. Les dossiers spéciaux sont les suivants :
Inbox
Éléments supprimés
Drafts
Courrier indésirable
Outbox
Éléments envoyés
Journal
Calendrier
contacts ;
notes ;
tâches ;
La cmdlet Export-Mailbox exporte aussi les messages à partir du conteneur de dépôt. Pour plus d'informations sur les messages figurant dans la conteneur de dépôt, consultez la rubrique Procédure de récupération d'un élément supprimé.
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter |
Le paramètre Identity spécifie la boîte aux lettres à partir de laquelle exporter du contenu. Vous pouvez utiliser les valeurs suivantes :
Si l'objet commande Get-Mailbox est canalisé, ce paramètre n'est pas obligatoire. |
TargetFolder |
Obligatoire |
System.String |
Le paramètre TargetFolder spécifie le dossier de boîte aux lettres de niveau supérieur qui sera créé sur la boîte aux lettres spécifiée par le paramètre TargetMailbox. Ce dossier contiendra un sous-dossier appelé source de Données récupérées < l’alias de la boîte aux lettres source> < timbre horodateur>. Le sous-dossier contient les données exportées. Si le dossier cible que vous spécifiez existe déjà dans la boîte aux lettres cible, les données exportées sont ajoutées au dossier existant. Si le dossier n'existe pas, il est créé. |
TargetMailbox |
Obligatoire |
Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter |
Le paramètre TargetMailbox spécifie la boîte aux lettres dans laquelle le dossier cible sera créé. La boîte aux lettres que vous spécifiez doit exister pour que la commande l’exécute avec succès. |
AllContentKeywords |
Facultatif |
System.String[] |
Le paramètre AllContentKeywords spécifie les mots clés du contenu à inclure dans le déplacement. Si la commande trouve un mot clé spécifié dans le corps du message, le contenu des pièces jointes ou le sujet, elle exporte ces messages. > [!Note] > Cela est différent de l’utilisation des paramètres ContentKeywords et SubjectKeywords. Si vous utilisez les paramètres ContentKeywords et SubjectKeywords, la commande exporte uniquement les messages comprenant à la fois le mot de passe que vous avez spécifié pour le paramètre ContentKeywords dans le corps du message ou le contenu des pièces jointes et le mot de passe que vous avez spécifié pour le paramètre SubjectKeywords dans l’objet. |
AttachmentFilenames |
Facultatif |
System.String[] |
Le paramètre AttachmentFilenames spécifie le filtre pour les pièces jointes. 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 mots clés du contenu à inclure dans le déplacement. Si la commande trouve un mot clé spécifié dans le corps du message ou dans le contenu des pièces jointes, elle exporte ces messages. |
DeleteContent |
Facultatif |
System.Management.Automation.SwitchParameter |
Le paramètre DeleteContent spécifie l'option pour supprimer le contenu de la boîte aux lettres source après son exportation dans un dossier. Le dossier source ne sera pas supprimé. |
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 ou identique à 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. |
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. |
Locale |
Facultatif |
System.Globalization.CultureInfo |
Le paramètre Locale spécifie les paramètres régionaux des messages à exporter. La commande n’exporte que les messages avec le paramètre de lieu que vous spécifiez. |
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 |
Le paramètre StartDate spécifie la date de début pour le filtrage du contenu exporté à partir de la boîte aux lettres source. Seuls les éléments de la boîte aux lettres dont la date est postérieure à la date de début 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. |
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. |
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. Grâce au paramètre ValidateOnly, l'administrateur peut afficher les changements potentiels sans devoir les appliquer. > [!Note] > Si vous exécutez la commande Export-Mailbox avec ce paramètre, la commande n’applique aucun filtre aux messages. Elle vérifiera seulement si les boîtes aux lettres source et cible existent. |
Types d'entrées
Types de retours
Erreurs
| Erreur | Description |
|---|---|
|
Exceptions
| Exceptions | Description |
|---|---|
|
Exemple
Le premier exemple montre comment exporter le contenu de la boîte aux lettres de l'utilisateur john@contoso.com vers le dossier MyData de la boîte aux lettres ExportMailbox.
Le deuxième exemple montre comment utiliser des filtres pour spécifier les éléments de la boîte aux lettres source à inclure dans l'exportation. Cet exemple exporte tous les éléments de la boîte aux lettres de l'utilisateur contoso\john qui ont le mot clé « merger » dans le corps du message ou dans le contenu d'une pièce jointe, qui ont une pièce jointe nommée *orgchart* et dont la date est postérieure au 03/01/2006 à 12:01:00.
Le troisième exemple montre comment rechercher et supprimer les éléments d’une boîte aux lettres. Cet exemple commence par identifier toutes les boîtes aux lettres de la base de données « DB1 » puis recherche les éléments dont l'objet contient la chaîne « Virus message ». Il exporte les éléments vers une autre boîte aux lettres et supprime ces éléments de la boîte aux lettres source.
Le quatrième exemple montre que vous pouvez canaliser la sortie à partir de la commande Get-User vers la commande Export-Mailbox. Cet exemple exclut aussi deux dossiers de l’export. Les éléments des dossiers Courrier indésirable et Contacts dans la boîte aux lettres de John ne seront pas exportés vers la boîte aux lettres ExportMailbox.
Notes
Vous pouvez aussi canaliser la sortie à partir des la commande Get-Recipient ou Get-Mailbox vers la commande Export-Mailbox.
Export-Mailbox -Identity john@contoso.com -TargetMailbox ExportMailbox -TargetFolder MyData
Export-Mailbox -Identity contoso\john -TargetMailbox ExportMailbox -TargetFolder MyData -ContentKeywords "merger" -AttachmentFilenames "*orgchart*" -StartDate "03/01/2006 12:01:00"
Get-Mailbox -Database DB1 | Export-Mailbox -TargetMailbox ExportMailbox -TargetFolder VirusData -SubjectKeywords "Virus message" -DeleteContent
Get-User john | Export-Mailbox -TargetMailbox ExportMailbox -TargetFolder MyData -ExcludeFolders "\Junk E-Mail","\Contacts"