Partager via


Import-Mailbox

 

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

Dernière rubrique modifiée : 2011-06-21

La cmdlet Import-Mailbox permet d'importer des données de boîte aux lettres d'un fichier .pst dans une boîte aux lettres.

Syntaxe

import-Mailbox [-Identity <MailboxIdParameter>] -PSTFolderPath <LongPath> [-AllContentKeywords <String[]>] [-AllowDuplicates <SwitchParameter>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-Confirm [<SwitchParameter>]] [-ContentKeywords <String[]>] [-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>]]

Description détaillée

Pour exécuter la cmdlet Import-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 à la boîte aux lettres 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.

Pour importer des données d'un fichier .pst, vous devez exécuter la cmdlet Import-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 version ultérieure.

Pour des informations de téléchargement sur la version 32 bits des outils de gestion d'Exchange 2007, consultez la page sur les outils de gestion (32 bits) Microsoft Exchange Server 2007.

La cmdlet Import-Mailbox permet d'importer des données dans un dossier ou un fichier .pst. Les boîtes aux lettres source et cible doivent exister sur un ordinateur exécutant l'une des versions suivantes d'Exchange :

  • Exchange Server 2007

  • Exchange Server 2003 Service Pack 2 (SP1) ou versions ultérieures ;

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

Pour importer les données d'un fichier .pst dans une boîte aux lettres d'une autre version d'Exchange, vous devez utiliser l'Assistant Fusion de boîtes aux lettres Microsoft Exchange (ExMerge.exe).

La cmdlet Import-Mailbox ne permet pas d'importer de données d'un fichier .pst dans une boîte aux lettres figurant dans un groupe de stockage de récupération (RSG).

Vous ne pouvez pas importer de données à l'aide de la cmdlet Import-Mailbox dans une base de données de dossiers publics.

Notes

Il n'est pas nécessaire de configurer un profil MAPI lorsque vous utilisez la cmdlet Import-Mailbox.

Paramètres

Paramètre Obligatoire Type Description

PSTFolderPath

Obligatoire

Microsoft.Exchange.Data.LongPath

Le paramètre PSTFolderPath spécifie le chemin d'accès du fichier .pst à partir duquel importer des données.

AllContentKeywords

Facultatif

System.String[]

Le paramètre AllContentKeywords spécifie les mots clés du contenu à inclure dans l'importation. Si la commande trouve un mot clé spécifié dans le corps du message, le contenu des pièces jointes ou l'objet, elle importe 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 importe 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 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.

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 importer 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 un fichier .pst à ignorer avant que l'opération d'importation é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 l'importation. Si la commande trouve un mot clé spécifié dans le corps du message ou dans le contenu des pièces jointes, elle importe ces messages.

EndDate

Facultatif

System.DateTime

Le paramètre EndDate spécifie la date de fin pour le filtrage du contenu à importer dans la boîte aux lettres cible. Seuls les éléments du fichier .pst dont la date est antérieure ou identique à la date de fin sont importé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'importation.

GlobalCatalog

Facultatif

Microsoft.Exchange.Data.Fqdn

Le paramètre GlobalCatalog spécifie le catalogue global à utiliser pour rechercher la boîte aux lettres cible.

Identity

Facultatif

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Le paramètre Identity spécifie l'objet boîte aux lettres cible dans lequel importer des données. Vous pouvez utiliser l'une des valeurs suivantes :

  • ADObjectID

  • Nom unique

  • DN Exchange hérité

  • GUID

  • Domaine\Nom de compte

  • Nom d'utilisateur principal (UPN)

  • Adresse de messagerie

  • Alias

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

IncludeFolders

Facultatif

Microsoft.Exchange.Data.Mapi.MapiFolderPath[]

Le paramètre IncludeFolders spécifie la liste de dossiers à inclure durant l'importation.

Locale

Facultatif

System.Globalization.CultureInfo

Le paramètre Locale spécifie les paramètres régionaux des messages à importer. La commande importera uniquement les messages avec les paramètres régionaux que vous avez 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 mots clés du contenu à inclure dans l'importation. Si la commande trouve un mot clé spécifié dans la liste des destinataires, elle importe ces messages.

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 mots clés du contenu à inclure dans l'importation. Si la commande trouve un mot clé spécifié dans la liste des expéditeurs, elle importe ces messages.

StartDate

Facultatif

System.DateTime

Le paramètre StartDate spécifie la date de début pour le filtrage du contenu à importer dans la boîte aux lettres cible. Seuls les éléments du fichier .pst dont la date est postérieure à la date de début sont importé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 figurant dans le fichier .pst.

ValidateOnly

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre ValidateOnly offre la possibilité de valider l'importation sans importer les données. Le paramètre ValidateOnly valide toutes les conditions préalables pour la commande.

> [!Note] > Si vous exécutez la commande Import-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

 

Exemple

Le premier exemple montre comment importer les données du fichier C:\PSTFiles\john.pst dans la boîte aux lettres existante connectée de john@contoso.com.

Le deuxième exemple montre comment importer les données de tous les fichiers .pst situés à l'emplacement C:\PSTFiles dans des boîtes aux lettres existantes. Les fichiers .pst doivent être nommés <alias>.pst, où alias est l'alias de la boîte aux lettres dans laquelle les données sont importées. Pour chaque fichier .pst, seuls les messages reçus après le 01/01/2007 sont importés dans la boîte aux lettres.

Le troisième exemple montre comment importer des données de fichiers .pst dans des boîtes aux lettres dont les utilisateurs font partie de l'unité d'organisation Marketing. Les fichiers .pst doivent être nommés <alias>.pst, où alias est l'alias de la boîte aux lettres dans laquelle les données sont importées. Seuls les fichiers .pst dont l'alias correspond à un utilisateur de l'unité d'organisation Marketing sont importés. S'il n'y a pas de fichier dans C:\PSTFiles pour un utilisateur de l'unité d'organisation Marketing, un message d'erreur s'affiche.

Import-Mailbox -Identity john@contoso.com -PSTFolderPath C:\PSTFiles\john.pst
Dir C:\PSTFiles | Import-Mailbox -StartDate 01/01/2007
Get-Mailbox -OrganizationalUnit Marketing | Import-Mailbox -PSTFolderPath C:\PSTFiles