Export-Mailbox

 

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

Dernière rubrique modifiée : 2010-05-24

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> [-AllContentKeywords <String[]>] [-AllowDuplicates <SwitchParameter>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-Confirm [<SwitchParameter>]] [-ContentKeywords <String[]>] [-DeleteAssociatedMessages <SwitchParameter>] [-DeleteContent <SwitchParameter>] [-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>]]

export-Mailbox -Identity <MailboxIdParameter> -TargetFolder <String> -TargetMailbox <MailboxIdParameter> [-AllContentKeywords <String[]>] [-AllowDuplicates <SwitchParameter>] [-AllowMerge <SwitchParameter>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-Confirm [<SwitchParameter>]] [-ContentKeywords <String[]>] [-DeleteAssociatedMessages <SwitchParameter>] [-DeleteContent <SwitchParameter>] [-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>]]

export-Mailbox -Identity <MailboxIdParameter> -PSTFolderPath <LongPath> [-AllContentKeywords <String[]>] [-AllowDuplicates <SwitchParameter>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-Confirm [<SwitchParameter>]] [-ContentKeywords <String[]>] [-DeleteAssociatedMessages <SwitchParameter>] [-DeleteContent <SwitchParameter>] [-EndDate <DateTime>] [-ExcludeFolders <MapiFolderPath[]>] [-GlobalCatalog <Fqdn>] [-IncludeAssociatedMessages <SwitchParameter>] [-IncludeFolders <MapiFolderPath[]>] [-Locale <CultureInfo>] [-MaxThreads <Int32>] [-RecipientKeywords <String[]>] [-ReportFile <LocalLongFullPath>] [-SenderKeywords <String[]>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>] [-WhatIf [<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.

  • l'accès total aux boîtes aux lettres source et cible.

Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Microsoft Exchange Server 2007, consultez la rubrique Considérations relatives aux autorisations.

Pour octroyer un accès total à une boîte aux lettres, utilisez la cmdlet Add-MailboxPermission en définissant le paramètre AccessRights sur FullAccess.

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 permet d'exporter des données dans un dossier ou un fichier .pst. Les boîtes aux lettres source et cible doivent être installées sur :

  • un serveur Exchange 2007 ;

  • un serveur Exchange Server 2003 Service Pack 2 (SP2) (ou versions ultérieures) ;

  • un serveur Exchange 2000 Server Service Pack 3 (SP3) (ou versions ultérieures).

Pour exporter les données d'un fichier .pst, vous devez exécuter la cmdlet Export-Mailbox à partir d'un ordinateur 32 bits sur lequel les éléments suivants sont installés :

  • version 32 bits des outils de gestion Exchange ;

  • Microsoft Office Outlook 2003 Service Pack 2 (SP2) ou versions ultérieures.

Notes

Les articles 289999 et 813593 de la Base de connaissances Microsoft décrivent un problème d'utilisation d'Outlook 2003 dans le cadre de la suppression de plusieurs objets d'un serveur. La cmdlet Export-Mailbox ne permet pas de supprimer plus de 4 000 objets d'un dossier. Pour exporter un plus grand nombre d'objets, vous devez utiliser Outlook 2007.

Pour des informations de téléchargement sur la version 32 bits des outils de gestion d'Exchange 2007, consultez la page Microsoft Exchange Server 2007 Management Tools (32-Bit) - Français.

Vous ne pouvez pas exporter de données dans un fichier .pst à partir d'une boîte aux lettres figurant dans un groupe de stockage de récupération (RSG).

Vous ne pouvez pas exporter de données d'une base de données de dossiers publics.

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

  • Tasks

La cmdlet Export-Mailbox exporte aussi les messages à partir du conteneur de dépôt. Les messages du conteneur de dépôt sont convertis en éléments normaux dans le dossier ou le fichier .pst dans lequel vous exportez les données.

Si vous exportez des données vers une autre boîte aux lettres à l'aide du paramètre TargetMailbox, la cmdlet Export-Mailbox exporte également les messages du conteneur de dépôt Éléments supprimés. Lors de leur exportation, les messages du conteneur de dépôt sont convertis en messages normaux.

Notes

Si vous utilisez des paramètres de mot clé, la cmdlet Export-Mailbox commence par exporter tous les messages, y compris ceux figurant dans le conteneur de dépôt, puis rechercher dans la boîte aux lettres cible des messages correspondant aux critères de mot clé. Les messages qui se trouvent dans le conteneur de dépôt de la boîte aux lettres source sont convertis en messages ordinaires dans la boîte aux lettres cible et les mots clés y sont également recherchés. La cmdlet Export-Mailbox supprime ensuite les messages de la boîte aux lettres cible qui ne correspondent pas aux critères de mot clé. Si vous utilisez également le paramètre DeleteContent, Export-Mailbox supprime les messages correspondant aux critères de mot clé de la boîte aux lettres source.

Pour plus d'informations sur les messages figurant dans le 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 :

  • Alias

  • Adresse SMTP (Simple Mail Transfer Protocol)

  • Nom complet

Si l'objet commande Get-Mailbox est canalisé, ce paramètre n'est pas obligatoire.

PSTFolderPath

Obligatoire

Microsoft.Exchange.Data.LongPath

Le paramètre PSTFolderPath spécifie le chemin d'accès du fichier .pst vers lequel exporter des données.

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.

Le tampon pour le paramètre AllContentKeywords et de 32 Ko.

> [!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.

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.

AllowMerge

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre AllowMerge spécifie que le contenu exporté est fusionné vers le dossier cible pour éviter tout contenu dupliqué. Si vous spécifiez le paramètre AllowMerge, le nom du sous-dossier vers lequel le contenu est exporté n'inclut pas d'horodatage. Vous pouvez exporter les données vers un même dossier ou sous-dossier à plusieurs reprises à l'aide du paramètre AllowMerge.

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.

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre Confirm suspend le traitement par la commande et vous demande de confirmer les actions que la commande va exécuter avant de continuer le traitement. Il n'est pas nécessaire de spécifier une valeur pour le paramètre Confirm.

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.

DeleteAssociatedMessages

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre DeleteAssociatedMessages spécifie la suppression des messages associés. Des messages associés contiennent des données masquées avec des informations sur les règles, les écrans et les formulaires.

Si vous utilisez le paramètre DeleteAssociatedMessages sans spécifier le paramètre TargetMailbox et TargetFolder ou PSTFolderPath, aucun contenu n'est exporté.

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.

IncludeAssociatedMessages

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre IncludeAssociatedMessages spécifie que les messages associés sont inclus dans l'export. Des messages associés contiennent des données masquées avec des informations sur les règles, les écrans et les formulaires. Par défaut, les messages associés ne sont pas inclus dans un export.

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. La valeur par défaut est 4.

RecipientKeywords

Facultatif

System.String[]

Le paramètre RecipientKeywords spécifie les adresses de messagerie des destinataires ou leurs noms complets. Si la commande trouve un message avec un destinataire identique au mot clé de destinataire spécifié, elle exporte le message.

Si le mot clé de destinataire spécifié est identique au groupe de distribution destinataire du message, le message est exporté. La commande ne développe pas les groupes de distribution pour comparer les mots clés de destinataire spécifiés aux membres du groupe de distribution destinataire du message.

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 adresses de messagerie des expéditeurs ou leurs noms complets. Si la commande trouve un message avec un expéditeur identique au mot clé d'expéditeur spécifié, elle exporte le message.

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 offre la possibilité de valider l'exportation sans exporter les données. Le paramètre ValidateOnly valide toutes les conditions préalables pour la commande.

> [!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.

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, vous pouvez afficher des changements potentiels sans devoir les appliquer. Il n'est pas nécessaire de spécifier une valeur pour le paramètre WhatIf.

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 rassembler toutes les boîtes aux lettres de la base de données « DB1 » et recherche la chaîne « Virus message » dans l'objet. 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.

Le cinquième exemple montre comment exporter le contenu de la boîte aux lettres de l'utilisateur john@contoso.com vers un fichier .pst appelé john.pst situé à l'emplacement C:\PSTFiles.

Le sixième exemple montre comment exporter des données à partir des boîtes aux lettres des utilisateurs de l'unité d'organisation Marketing. Les données de chaque boîte aux lettres sont exportées dans un fichier .pst distinct situé à l'emplacement C:\PSTFiles. Le nom de chaque fichier .pst est <alias>.pst. Les messages exportés sont ceux dont les destinataires incluent tony@fabrikam.com ou christine@fabrikam.com.

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"
Export-Mailbox -Identity john@contoso.com -PSTFolderPath C:\PSTFiles\john.pst
Get-Mailbox -OrganizationalUnit Marketing | Export-Mailbox -PSTFolderPath C:\PSTFiles -RecipientKeywords "tony@fabrikam.com","christine@fabrikam.com"