Partager via


Export-Mailbox

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.

Aa998579.note(fr-fr,EXCHG.140).gifRemarque :
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.

Aa998579.note(fr-fr,EXCHG.140).gifRemarque :
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
Aa998579.note(fr-fr,EXCHG.140).gifRemarque :
Exchange 2010 n’exporte pas de données contenues dans les bennes.
Aa998579.note(fr-fr,EXCHG.140).gifRemarque :
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.

Aa998579.note(fr-fr,EXCHG.140).gifRemarque :
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"