Procédure d'importation d'entrées de réécriture d'adresses
S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1, Exchange Server 2007
Dernière rubrique modifiée : 2007-02-19
Cette rubrique décrit l'utilisation de l'environnement de ligne de commande Exchange Management Shell pour importer des entrées de réécriture d'adresses sur un ordinateur sur lequel le rôle serveur de transport Edge Microsoft Exchange Server 2007 est installé.
L'environnement de ligne de commande Exchange Management Shell permet d'effectuer des importations en bloc d'entrées de réécriture d'adresses sur un serveur de transport Edge. Vous pouvez effectuer une importation en bloc d'entrées de réécriture d'adresses dans le cadre des scénarios courants suivants :
Migration Vous pouvez importer en bloc des entrées de réécriture d'adresses d'une solution antérieure remplacée par une solution de type serveur de transport Edge.
Externalisation Vous pouvez importer en bloc des entrées de réécriture d'adresses lorsque vous parvenez à des accords avec des fournisseurs de solutions tiers, accords au terme desquels leurs adresses de messagerie doivent être réécrites.
Acquisition Vous pouvez importer en bloc des entrées de réécriture d'adresses en cas d'acquisition d'autres organisations requérant la réécriture intermédiaire des adresses de messagerie des organisations rachetées.
Si vous disposez de plusieurs serveurs de transport Edge, il est recommandé d'utiliser les procédures suivantes pour importer des entrées de réécriture d'adresses sur un serveur de transport Edge, puis de dupliquer la configuration de ce serveur de transport Edge sur les autres serveurs de transport Edge dans votre organisation.
Pour plus d'informations sur la duplication d'un serveur de transport Edge, consultez la rubrique Utilisation d'une configuration dupliquée de serveur de transport Edge.
Avant de commencer
Pour exécuter les procédures suivantes sur un ordinateur sur lequel le rôle serveur de transport Edge est installé, vous devez ouvrir une session en utilisant un compte membre du groupe Administrateurs local sur cet ordinateur.
Vous devez savoir comment créer une entrée de réécriture d'adresses avant d'utiliser des fichiers au format CSV pour effectuer des importations en bloc d'entrées de réécriture d'adresses. Pour plus d'informations sur la création d'une entrée de réécriture d'adresses, consultez la rubrique Procédure de création d'une entrée de réécriture d'adresses.
Procédure
Les sections suivantes permettent de comprendre comment importer des entrées de réécriture d'adresses à l'aide de fichiers CSV :
Création d'un fichier CSV Cette section décrit les champs obligatoires et facultatifs dans un fichier CSV utilisé pour importer des entrées de réécriture d'adresses. Elle décrit également les exigences spécifiques liées à l'utilisation des paramètres ExceptionList et OutboundOnly dans le fichier CSV.
Utilisation des fichiers CSV avec la cmdlet New-AddressRewriteEntry Cette section décrit comment l'environnement de ligne de commande Exchange Management Shell met en forme et utilise les données contenues dans le fichier CSV pour importer des entrées de réécriture d'adresses.
Importation d'un fichier CSV pour créer plusieurs entrées de réécriture d'adresses Cette section s'appuie sur les informations des sections précédentes avec des instructions relatives à l'utilisation des commandes de l'environnement de ligne de commande Exchange Management Shell requises pour importer un fichier CSV et l'utiliser pour créer plusieurs entrées de réécriture d'adresses.
Création d'un fichier CSV
Vous devez commencer par créer un fichier CSV contenant des colonnes de valeurs correspondant aux paramètres requis par la cmdlet New-AddressRewriteEntry. Les valeurs suivantes sont requises par la cmdlet New-AddressRewriteEntry et doivent donc avoir des colonnes correspondantes dans le fichier CSV :
Name Ce paramètre est une chaîne qui identifie de façon unique l'entrée de réécriture d'adresses.
InternalEmailAddress Ce paramètre spécifie l'adresse SMTP (Simple Mail Transfer Protocol) interne devant être réécrite.
ExternalEmailAddress Ce paramètre spécifie l'adresse SMTP externe devant être réécrite.
Les paramètres suivants sont facultatifs. Vous pouvez inclure des colonnes pour ces paramètres dans le fichier CSV au besoin :
ExceptionList Ce paramètre spécifie la liste de sous-domaines ne devant pas être réécrits. Aucune adresse SMTP contenue dans les sous-domaines spécifiés n'est réécrite.
OutboundOnly Ce paramètre spécifie si l'entrée de réécriture d'adresses doit réécrire les adresses SMTP pour les messages entrants et sortants dans l'organisation Exchange 2007, ou réécrire seulement les adresses des messages sortants de l'organisation Exchange 2007.
Si vous spécifiez des valeurs pour les colonnes ExceptionList et OutboundOnly dans le fichier CSV, chaque ligne doit inclure une valeur dans cette colonne. Par exemple, si vous spécifiez une valeur pour la colonne ExceptionList dans une ligne du fichier CSV, toutes les autres lignes du fichier CSV doivent également contenir une valeur dans cette colonne. En effet, le paramètre ExceptionList dans la ligne de commande attend une valeur du fichier CSV.
Pour plus d'informations sur chaque paramètre dans ces listes, consultez la rubrique New-AddressRewriteEntry.
Exigences spécifiques lorsque le paramètre ExceptionList est inclus dans un fichier CSV
Si vous voulez créer plusieurs entrées de réécriture d'adresses avec certaines entrées requérant des valeurs pour le paramètre ExceptionList et d'autres non, vous devez séparer ces entrées de réécriture d'adresses et créer des fichiers CSV distincts, puis importer chacun de ces fichiers CSV. Par ailleurs, vous devez placer les valeurs utilisées avec le paramètre ExceptionList entre guillemets ("
). Si vous voulez spécifier le paramètre ExceptionList pour plusieurs domaines, vous devez séparer chaque valeur avec des virgules (,
). Par exemple, la chaîne "domain1.com,domain2.com, domain3.com"
contient trois domaines placés entre guillemets et séparés par des virgules.
Exigences spécifiques lorsque le paramètre OutboundOnly est inclus dans un fichier CSV
Si vous spécifiez des valeurs dans la colonne OutboundOnly dans une ligne du fichier CSV, vous devez spécifier une valeur dans la colonne OutboundOnly de chaque autre ligne du fichier CSV, comme pour le paramètre ExceptionList. Il est toutefois aisé de satisfaire à cette exigence en spécifiant si le paramètre OutboundOnly doit être True
ou False
dans chaque ligne.
Contrairement à l'utilisation d'opérateurs booléens ailleurs dans l'environnement de ligne de commande Exchange Management Shell, lorsque vous spécifiez une valeur pour le paramètre OutboundOnly dans un fichier CSV, vous devez spécifier la valeur True
ou False
, et non $True
ou $False
. La valeur figurant dans le fichier CSV est en effet convertie manuellement en valeur booléenne lorsque le fichier CSV est interprété dans la ligne de commande.
Pour plus d'informations sur l'utilisation du paramètre OutboundOnly, consultez la section « Considérations en relation avec l'utilisation de la réécriture d'adresses Outbound-Only » de la rubrique Planification de la réécriture d'adresses.
Exemple de fichier CSV avec des paramètres facultatifs renseignés
L'exemple suivant montre comment un fichier CSV peut être renseigné avec les paramètres facultatifs ExceptionList et OutboundOnly :
Name,InternalAddress,ExternalAddress,ExceptionList,OutboundOnly
"Wingtip UK", *.wingtiptoys.co.uk, tailspintoys.com,"legal.wingtiptoys.co.uk,finance.wingtiptoys.co.uk,support.wingtiptoys.co.uk",True
"Wingtip USA", *.wingtiptoys.com, tailspintoys.com,"legal.wingtiptoys.com,finance.wingtiptoys.com,support.wingtiptoys.com,corp.wingtiptoys.com",True
"Wingtip Canada", *.wingtiptoys.ca, tailspintoys.com,"legal.wingtiptoys.ca,finance.wingtiptoys.ca,support.wingtiptoys.ca",True
L'exemple suivant montre comment un fichier CSV peut être renseigné avec le paramètre facultatif OutboundOnly :
Name,InternalAddress,ExternalAddress,OutboundOnly
"Contoso Sales",*.sales.contoso.com,contoso.com,True
"Contoso Research",*.research.contoso.com,contoso.com,True
"Contoso UK",*.contoso.co.uk,contoso.com,True
"Contoso Japan",*.contoso.co.jp,contoso.com,True
"Contoso Support",support@adatum.com,support@contoso.com,False
"Contoso Financial External",contosofinancial@woodgrovebank.com,financialinqueries@contoso.com,False
Utilisation des fichiers CSV avec la cmdlet New-AddressRewriteEntry
Pour importer des entrées de réécriture d'adresses à l'aide de fichiers CSV, vous devez utiliser la cmdlet Import-Csv. La cmdlet Import-Csv lit le fichier CSV et canalise chaque ligne du fichier CSV comme élément de tableau et chaque colonne figurant dans la ligne comme propriété de cet élément de tableau. Vous pouvez voir le fonctionnement de la cmdlet en utilisant le fichier CSV de la section « Exemple de fichier CSV avec des paramètres facultatifs renseignés » ci-avant dans cette rubrique. Importez le fichier CSV d'exemple à l'aide de la commande suivante, après avoir copié le texte de l'exemple dans un fichier nommé example.csv
:
$CsvContents = Import-Csv c:\example.csv
Tapez ensuite la commande suivante dans la ligne de commande :
$CsvContents
Les données suivantes sont retournées :
Name InternalAddress ExternalAddress OutboundOnly
---- --------------- --------------- ------------
Contoso Sales *.sales.contoso.com contoso.com True
Contoso Research *.research.conto... contoso.com True
Contoso UK *.contoso.co.uk contoso.com True
Contoso Japan *.contoso.co.jp contoso.com True
Contoso Support support@adatum.com support@contoso.com False
Contoso Financia... contosofinancial... financialinqueri... False
Si vous voulez seulement afficher la valeur contenue dans la colonne InternalAddress de la troisième ligne, vous pouvez utiliser la commande suivante :
$CsvContents[2].InternalAddress
La commande retourne la valeur *.contoso.co.uk
.
Notes
Les tableaux commencent toujours à 0
. Aussi, pour extraire les valeurs de la troisième ligne, vous devez spécifier l'élément de tableau 2
. Pour plus d'informations sur les tableaux, consultez la rubrique Tableaux.
Cet exemple permet de comprendre comment l'environnement de ligne de commande Exchange Management Shell traite le fichier CSV et l'utilise pour transmettre des données à la cmdlet New-AddressRewriteEntry.
Comme vous pouvez le voir dans l'exemple, chaque ligne du fichier CSV devient un élément de tableau et chaque colonne devient une propriété de cet élément de tableau. À l'aide de la cmdlet ForEach, l'environnement de ligne de commande Exchange Management Shell peut parcourir le tableau de façon automatique du début à la fin et effectuer des actions pour chaque élément de tableau (dans ce cas, une ligne du fichier CSV) rencontré. Une fois qu'un élément de tableau a été transmis à la cmdlet ForEach dans le pipeline, l'environnement de ligne de commande Exchange Management Shell peut ensuite accéder aux propriétés stockées dans la cmdlet. Dans ce cas, les propriétés correspondent aux colonnes contenues dans chaque ligne.
Vous pouvez utiliser ces propriétés pour définir la commande New-AddressRewiteEntry requise pour créer des entrées de réécriture d'adresses. Ces propriétés sont nommées en fonction des en-têtes de colonne figurant dans le fichier CSV. Il n'est pas utile qu'elles correspondent au nom de paramètre dans la cmdlet. La commande suivante est basée sur l'explication dans cet exemple :
Import-Csv c:\example.csv | ForEach { New-AddressRewriteEntry -Name $_.Name -InternalAddress $_.InternalAddress -ExternalAddress $_.ExternalAddress -OutboundOnly ([Bool]::Parse($_.OutboundOnly)) -ExceptionList ($_.ExceptionList.Split(","))}
Notes
Vous n'avez pas à affecter un fichier CSV importé à une variable comme indiqué dans l'exemple au début de cette section. Vous pouvez simplement inclure la cmdlet Import-Csv et canaliser la sortie de cette cmdlet vers la cmdlet ForEach comme montré dans cet exemple.
Cette commande passe en revue chaque ligne du fichier example.csv
, puis utilise la cmdlet New-AddressRewriteEntry pour créer des entrées de réécriture d'adresses à l'aide des valeurs de paramètre récupérées dans les colonnes existantes pour chaque ligne.
Vous avez probablement remarqué la variable spéciale $_
dans cette commande. La variable spéciale $_
indique à la commande d'examiner l'objet en cours dans le pipeline. Dans ce cas, il s'agit de la ligne en cours du fichier CSV.
Du texte est également associé aux valeurs respectives des propriétés OutboundOnly et ExceptionList. Le texte ([Bool]::Parse($_.OutboundOnly))
indique à l'environnement de ligne de commande Exchange Management Shell d'interpréter la chaîne contenue dans la propriété OutboundOnly comme valeur booléenne. Le texte ($_.ExceptionList.Split(","))
indique à l'environnement de ligne de commande Exchange Management Shell de séparer les valeurs contenues dans la propriété ExceptionList à l'aide de virgules. Sans le texte associé à la propriété ExceptionList, les valeurs contenues dans la propriété ExceptionList sont traitées comme une seule chaîne, même s'il y a des virgules.
Pour plus d'informations sur le traitement en pipeline, consultez la rubrique Traitement en pipeline.
Importation d'un fichier CSV pour créer plusieurs entrées de réécriture d'adresses
Maintenant que vous avez compris le processus sous-jacent, vous pouvez créer un fichier CSV et l'utiliser pour créer plusieurs entrées de réécriture d'adresses. Créez le fichier CSV avec au minimum les colonnes Name, InternalAddress et ExternalAddress. Si vous voulez spécifier des valeurs pour les paramètres ExternalAddress et OutboundOnly, ajoutez également ces colonnes. Pour rappel, chaque ligne doit comporter une valeur dans chaque colonne. Pour obtenir un exemple de fichier CSV correctement mis en forme, consultez la section « Exemple de fichier CSV avec des paramètres facultatifs renseignés » ci-avant dans cette rubrique.
Utilisez la syntaxe de commande suivante pour créer plusieurs entrées de réécriture d'adresses à l'aide d'un fichier CSV :
Import-Csv <CSV file path> | ForEach { New-AddressRewriteEntry -Name $_.<Name CSV column heading> -InternalAddress $_.<InternalAddress CSV column heading> -ExternalAddress $_.<ExternalAddress CSV column heading> -OutboundOnly ([Bool]::Parse($_.<OutboundOnly CSV column heading>)) -ExceptionList ($_.<ExceptionList CSV column heading>.Split(","))}
Utilisation d'un fichier CSV dans l'environnement de ligne de commande Exchange Management Shell pour créer plusieurs entrées de réécriture d'adresses
Créez et renseignez un fichier CSV nommé
C:\ImportAddressRewriteEntries.csv
.Exécutez la commande suivante :
Import-Csv c:\ImportAddressRewriteEntries.csv | ForEach { New-AddressRewriteEntry -Name $_.Name -InternalAddress $_.InternalAddress -ExternalAddress $_.ExternalAddress -OutboundOnly ([Bool]::Parse($_.OutboundOnly)) -ExceptionList ($_.ExceptionList.Split(","))}
Pour plus d'informations sur la syntaxe et les paramètres, consultez la rubrique New-AddressRewriteEntry.