Export-Mailbox

Article
05/20/2011

S'applique à : Exchange Server 2010

Dernière rubrique modifiée : 2009-07-07

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[]>] [-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[]>] [-SenderKeywords <String[]>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

export-Mailbox -Identity <MailboxIdParameter> -TargetFolder <String> -TargetMailbox <MailboxIdParameter> [-AllContentKeywords <String[]>] [-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[]>] [-SenderKeywords <String[]>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

export-Mailbox -Identity <MailboxIdParameter> -PSTFolderPath <LongPath> [-AllContentKeywords <String[]>] [-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[]>] [-SenderKeywords <String[]>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

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 Nom complet Si l’objet de 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 contient un sous-dossier appelé Données récupérées - <alias de la boîte aux lettres source> - <horodatage>. 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 cible 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 est 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 l’objet, elle exporte ces messages. Remarque : 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-clé 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-clé que vous spécifiez pour le paramètre SubjectKeywords dans l’objet.
AllowMerge	Facultatif	System.Management.Automation.SwitchParameter	Le paramètre AllowMergespécifie que le contenu exporté est fusionné dans 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 qu’il faut ignorer avant que l’opération d’exportation n’échoue.
Confirm	Facultatif	System.Management.Automation.SwitchParameter	Le commutateur Confirm suspend 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 commutateur 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 indique que les messages associés sont supprimé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 les paramètres TargetMailbox et TargetFolder ou PSTFolderPath , aucun contenu n’est exporté.
DeleteContent	Facultatif	System.Management.Automation.SwitchParameter	Le paramètre DeleteContent spécifie l’option de suppression du contenu de la boîte aux lettres source après son exportation dans un dossier. Le dossier source n’est 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/2010 pour spécifier le 1er mars 2010.
ExcludeFolders	Facultatif	Microsoft.Exchange.Data.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’exportation. Les 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.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 les paramètres régionaux spécifiés.
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.
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 fin du 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/2010 pour spécifier le 1er mars 2010.
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. Remarque : Si vous exécutez la commande Export-Mailbox avec ce paramètre, la commande n’applique aucun filtre aux messages. Elle vérifie seulement si les boîtes aux lettres source et cible existent.
WhatIf	Facultatif	System.Management.Automation.SwitchParameter	Le commutateur 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 commutateur WhatIf.

Description détaillée

Vous ne pouvez pas exporter des 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 se trouver sur un serveur exécutant Microsoft Exchange Server 2010.

Pour exporter des données à partir d’un fichier .pst, vous devez exécuter la cmdlet Export-Mailbox sur un serveur Exchange doté de la version 64 bits de Microsoft Outlook 2010. Il est recommandé d’exécuter la commande sur un serveur Exchange dédié qui ne comporte aucune boîte aux lettres.

La cmdlet Export-Mailbox exporte tous les dossiers vides et les fichiers spéciaux vers l’emplacement cible. Les dossiers spéciaux sont les suivants :

Boîte de réception
Éléments supprimés
Brouillons
Courrier indésirable
Boîte d’envoi
Éléments envoyés
Journal
Calendrier
Contacts
Notes
Tâches

Remarque :
Exchange 2010 n’exporte pas de données contenues dans les bennes.

Remarque :
Si vous utilisez des paramètres mot-clé, la cmdlet Export-Mailbox commence par exporter tous les messages, puis recherche les messages correspondant aux critères de mot-clé dans la boîte aux lettres cible. Les messages contenus dans la benne de la boîte aux lettres source sont convertis en messages ordinaires dans la boîte aux lettres cible et font également l’objet d’une recherche de mots-clé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 le paramètre DeleteContent, la cmdlet Export-Mailbox supprime les messages correspondant aux critères de mot-clé de la boîte aux lettres source.

Si vous utilisez des paramètres mot-clé, la cmdlet Export-Mailbox commence par exporter tous les messages, puis recherche les messages correspondant aux critères de mot-clé dans la boîte aux lettres cible. Les messages contenus dans la benne de la boîte aux lettres source sont convertis en messages ordinaires dans la boîte aux lettres cible et font également l’objet d’une recherche de mots-clé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 le paramètre DeleteContent, la cmdlet Export-Mailbox supprime les messages correspondant aux critères de mot-clé de la boîte aux lettres source.

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que tous les paramètres de cette cmdlet soient répertoriés dans cette rubrique, 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 voir les autorisations qui vous sont nécessaires, voir Entrée « Importer/exporter une boîte aux lettres » dans la rubrique Autorisations de boîte aux lettres.

Types d’entrées

Types de retours

Erreurs

Erreur	Description

Exceptions

Exceptions	Description

Exemples

EXEMPLE 1

Cet exemple exporte 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.

Export-Mailbox -Identity john@contoso.com -TargetMailbox ExportMailbox -TargetFolder MyData

EXEMPLE 2

Cet exemple utilise les filtres pour spécifier les éléments dans 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.

Export-Mailbox -Identity contoso\john -TargetMailbox ExportMailbox -TargetFolder MyData -ContentKeywords "merger" -AttachmentFilenames "*orgchart*" -StartDate "03/01/2010 12:01:00"

EXEMPLE 3

Cet exemple recherche et supprime des é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 « Message virus » 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.

Get-Mailbox -Database DB1 | Export-Mailbox -TargetMailbox ExportMailbox -TargetFolder VirusData -SubjectKeywords "Virus message" -DeleteContent

EXEMPLE 4

Cette commande canalise la sortie de la cmdlet Get-User vers la commande Export-Mailbox. Cet exemple exclut aussi deux dossiers de l’exportation. 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.

Remarque :
Vous pouvez aussi canaliser la sortie à partir des la commande Get-Recipient ou Get-Mailbox vers la commande Export-Mailbox.

Get-User john | Export-Mailbox -TargetMailbox ExportMailbox -TargetFolder MyData -ExcludeFolders "\Junk E-mail","\Contacts"

EXEMPLE 5

Cet exemple exporte le contenu de la boîte aux lettres de l’utilisateur john@contoso.com vers un fichier .pst appelé john.pst placé dans C:\PSTFiles.

Export-Mailbox -Identity john@contoso.com -PSTFolderPath C:\PSTFiles\john.pst

EXEMPLE 6

Cet exemple exporte les données de toutes les 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 placé dans C:\PSTFiles. Le nom de chaque fichier .pst est <alias>.pst. Les messages exportés sont ceux dont les destinataires incluent jean-charles@fabrikam.com ou christine@fabrikam.com.

Get-Mailbox -OrganizationalUnit Marketing | Export-Mailbox -PSTFolderPath C:\PSTFiles -RecipientKeywords "jean-charles@fabrikam.com","christine@fabrikam.com"