Share via

New-AddressRewriteEntry (RTM)

  • Article

 

S’applique à : Exchange Server 2007

Dernière rubrique modifiée : 2007-06-07

La cmdlet New‑AddressRewriteEntry permet de créer une entrée de réécriture d'adresses qui réécrit des adresses électroniques d'expéditeur et de destinataire dans les messages électroniques échangés par une organisation de messagerie électronique.

Syntaxe

new-AddressRewriteEntry -Name <String> -ExternalAddress <String> -InternalAddress <String> [-DomainController <Fqdn>] [-ExceptionList <MultiValuedProperty>] [-OutboundOnly <$true | $false>] [-TemplateInstance <PSObject>]

Description détaillée

Dans Microsoft Exchange Server 2007, la réécriture d'adresses vous permet de modifier les adresses d'expéditeurs et de destinataires sur les messages entrants et sortants d'une organisation Exchange 2007. Vous configurez les agents de réécriture d'adresses sur le connecteur de réception et le connecteur d'envoi d'un ordinateur sur lequel le rôle serveur de transport Edge est installé.

Pour exécuter la cmdlet New-AddressRewriteEntry sur un ordinateur sur lequel le rôle de serveur de transport Edge est installé, vous devez ouvrir une session en utilisant un compte membre du groupe Administrateurs local présent sur cet ordinateur.

Paramètres

Paramètre Obligatoire Type Description

ExternalAddress

Obligatoire

System.String

Ce paramètre spécifie l'adresse électronique ou le nom de domaine externe utilisé lors de la réécriture d'une adresse électronique ou d'un nom de domaine interne. Si une adresse électronique est spécifiée dans InternalAddress, la valeur spécifiée dans ExternalAddress doit également être une adresse électronique. Si un nom de domaine ou un nom de domaine contenant un caractère générique est spécifié dans InternalAddress, un nom de domaine doit être spécifié dans ExternalAddress. Les adresses ou les noms de domaine peuvent être entrés dans les deux formats suivants :

  • Adresse électronique   Réécrivez une adresse électronique interne unique à l'aide de l'adresse spécifiée. Par exemple, david@northwindtraders.com.

  • Nom de domaine   Réécrivez toutes les adresses électroniques internes incluses dans InternalAddress à l'aide du nom de domaine externe spécifié. Par exemple, northwindtraders.com.

> [!Note] > Le caractère astérisque ne peut pas être utilisé avec le paramètre ExternalAddress.

InternalAddress

Obligatoire

System.String

Ce paramètre spécifie l'adresse électronique ou le nom de domaine interne à réécrire. Les adresses ou les noms de domaine peuvent être entrés dans les trois formats suivants :

  • Adresse de messagerie simple   Réécrivez uniquement l'adresse spécifiée. Par exemple, david@contoso.com.

  • Nom de domaine   Réécrivez toutes les adresses électroniques associées au nom de domaine spécifié. Par exemple, contoso.com.

  • Nom de domaine avec astérisque   Réécrivez toutes les adresses électroniques associées au nom de domaine spécifié et à tous les sous-domaines. Par exemple, *.contoso.com.

Name

Obligatoire

System.String

Ce paramètre permet à l'administrateur de modifier le nom unique pour cette entrée de réécriture d'adresses.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Pour spécifier le nom de domaine complet (FQDN) du contrôleur de domaine qui écrit ce changement de configuration dans le service d'annuaire Active Directory, incluez le paramètre DomainController dans la commande. Le paramètre DomainController n'est pas pris en charge sur les serveurs de transport Edge. Le rôle serveur de transport Edge écrit uniquement sur l'instance ADAM locale.

ExceptionList

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Ce paramètre spécifie les noms de domaine qui ne doivent pas être réécrits lorsque le paramètre InternalAddress contient une valeur qui spécifie plusieurs noms de domaine. Vous pouvez séparer plusieurs noms de domaine inclus dans le paramètre ExceptionList à l'aide de virgules.

OutboundOnly

Facultatif

System.Boolean

Ce paramètre spécifie si des adresses électroniques ne doivent être réécrites que si des messages électroniques quittent l'organisation Exchange 2007 ou si des adresses doivent être réécrites lorsque des messages sont envoyés dans les deux sens. Les deux valeurs possibles pour ce paramètre sont $true et $false. La valeur par défaut est $false.

> [!Note] > Ce paramètre ne peut pas être défini sur $false si la valeur spécifiée dans InternalAddress contient un caractère générique.

TemplateInstance

Facultatif

System.Management.Automation.PSObject

Lorsqu'un objet existant est fourni pour ce paramètre, la cmdlet utilise la configuration de l'objet pour créer une copie identique de l'objet sur un serveur local ou cible.

Types d'entrées

Types de retours

Erreurs

Erreur Description

 

Exceptions

Exceptions Description

 

Exemple

Les exemples suivants présentent trois scénarios différents :

  • Réécriture d'une adresse électronique unique. Les messages électroniques dans les deux sens sont réécrits.

  • Réécriture de toutes les adresses électroniques pour le domaine contoso.com. Les messages électroniques dans les deux sens sont réécrits.

  • Réécriture de toutes les adresses électroniques pour le domaine contoso.com et tous les sous-domaines, à l'exception de recherche.contoso.com et corp.contoso.com. Seuls les messages électroniques sortants sont réécrits.

New-AddressRewriteEntry -Name "Address rewrite entry for david@contoso.com" -InternalAddress david@contoso.com -ExternalAddress david@northwindtraders.com
New-AddressRewriteEntry -Name "Address rewrite entry for all contoso.com e-mail addresses" -InternalAddress contoso.com -ExternalAddress northwindtraders.com
New-AddressRewriteEntry -Name "Address rewrite entry for all contoso.com and subdomain e-mail addresses" -InternalAddress *.contoso.com -ExternalAddress northwindtraders.com -OutboundOnly:$true