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