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.

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(","))}

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

1. Créez et renseignez un fichier CSV nommé C:\ImportAddressRewriteEntries.csv.

2. 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.