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 :
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"