Import-Mailbox

Article
05/20/2011

S'applique à : Exchange Server 2010

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

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>] [-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
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. 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 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 commutateur AllowDuplicates spécifie s’il faut copier des éléments de messagerie sans vérifier s’ils s’agit de doublons d’éléments existants. 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 commutateur Confirm peut être utilisé pour supprimer la boîte de dialogue de confirmation qui s’affiche par défaut lorsque cette cmdlet est exécutée. Pour supprimer la boîte de dialogue de confirmation, utilisez la syntaxe de `-Confirm:$False`. Vous devez inclure un signe deux-points ( `:` ) dans la syntaxe.
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. Lorsque vous entrez une date précise, optez pour le format de date court qui est 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’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 Nom unique 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.
IncludeAssociatedMessages	Facultatif	System.Management.Automation.SwitchParameter	Le paramètre IncludeAssociatedMessages spécifie que les messages associés sont inclus dans l’importation. 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 l’importation.
IncludeFolders	Facultatif	Microsoft.Exchange.Data.MapiFolderPath[]	Le paramètre IncludeFolders spécifie la liste de dossiers à inclure durant l’importation. Lorsque vous utilisez ce paramètre, seuls les dossiers figurant dans la liste des paramètres sont inclus dans l’importation.
Locale	Facultatif	System.Globalization.CultureInfo	Le paramètre Locale spécifie les paramètres régionaux des messages à importer. La commande import 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.
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 l’expéditeur, 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. Lorsque vous entrez une date précise, optez pour le format de date court qui est 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 figurant dans le fichier .pst.
ValidateOnly	Facultatif	System.Management.Automation.SwitchParameter	Le commutateur ValidateOnly indique à la cmdlet d’évaluer les conditions et exigences nécessaires pour effectuer l’opération et signale ensuite si l’opération réussit ou échoue. Aucune modification n’est effectuée lorsque le commutateur ValidateOnly est utilisé. Remarque : Si vous exécutez la commande Import-Mailbox avec ce commutateur, 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

Pour importer des données d’un fichier .pst, vous devez exécuter la cmdlet Import-Mailbox à partir d’un ordinateur exécutant Microsoft Exchange Server 2010 sur lequel la version 64 bits de Microsoft Outlook 2010 est installée : Il est recommandé d’exécuter la commande sur un serveur Exchange dédié qui ne comporte aucune boîte aux lettres.

Vous ne pouvez importer des données d’un fichier .pst que dans une boîte aux lettres se trouvant sur un serveur Exchange 2010 sur lequel le rôle serveur de boîtes aux lettres est installé en utilisant la cmdlet Import-Mailbox. Pour importer des données à partir d’un fichier .pst vers une boîte aux lettres sur un serveur Exchange Server 2007, utilisez la version Exchange 2007 de la cmdlet Import-Mailbox. Pour importer des données d’un fichier .pst dans une boîte aux lettres qui se trouve sur un serveur Exchange Server 2003, 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 une base de données de récupération.

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

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

Exemples

EXEMPLE 1

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

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

EXEMPLE 2

Cet exemple importe les données de tous les fichiers .pst situés à l’emplacement C:\PSTFiles dans les boîtes aux lettres existantes. Les fichiers .pst doivent être nommés <alias>.pst, où alias désigne 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/2010 sont importés dans la boîte aux lettres.

Dir C:\PSTFiles | Import-Mailbox -StartDate 01/01/2010

EXEMPLE 3

Cet exemple importe 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 désigne 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 .pst à l’emplacement C:\PSTFiles pour un utilisateur de l’unité d’organisation Marketing, un message d’erreur s’affiche.

Get-Mailbox -OrganizationalUnit Marketing | Import-Mailbox -PSTFolderPath C:\PSTFiles

Partager via