Set-AddressRewriteEntry
S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Dernière rubrique modifiée : 2007-08-28
La cmdlet Set-AddressRewriteEntry permet de modifier une entrée de réécriture d'adresses existante qui réécrit des adresses électroniques d'expéditeur et de destinataire dans les messages électroniques échangés avec une organisation de messagerie électronique.
Syntaxe
set-addressrewriteentry -Identity <AddressRewriteEntryIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExceptionList <MultiValuedProperty>] [-ExternalAddress <String>] [-InternalAddress <String>] [-Name <String>] [-OutboundOnly <$true | $false>] [-WhatIf [<SwitchParameter>]]
set-addressrewriteentry [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExceptionList <MultiValuedProperty>] [-ExternalAddress <String>] [-Instance <AddressRewriteEntry>] [-InternalAddress <String>] [-Name <String>] [-OutboundOnly <$true | $false>] [-WhatIf [<SwitchParameter>]]
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 les connecteurs de réception et d'envoi d'un ordinateur sur lequel le rôle de serveur de transport Edge est installé.
Pour exécuter la cmdlet Set-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.
Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Exchange 2007, consultez la rubrique Considérations relatives aux autorisations.
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Identity |
Obligatoire |
Microsoft.Exchange.Management.MessagingPolicies.AddressRewrite.AddressRewriteEntryIdParameter |
Ce paramètre spécifie l'entrée de réécriture d'adresses à modifier. Le paramètre Identity accepte un GUID ou le nom unique de réécriture d'adresses. |
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. |
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 de 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. Pour plus d'informations sur l'ajout ou la suppression de valeurs des propriétés à valeurs multiples, consultez la rubrique Modification de propriétés à valeurs multiples. |
ExternalAddress |
Facultatif |
System.String |
Ce paramètre permet à l'administrateur de modifier 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 :
|
Instance |
Facultatif |
Microsoft.Exchange.Data.Directory.SystemConfiguration.AddressRewriteEntry |
Le paramètre Instance vous permet de transmettre un objet entier à la commande à traiter. Il est principalement utilisé dans les scripts où un objet entier doit être transmis à la commande. |
InternalAddress |
Facultatif |
System.String |
Ce paramètre permet à l'administrateur de modifier l'adresse électronique ou le nom de domaine interne objet de la réécriture. Les adresses ou les noms de domaine peuvent être entrés dans les trois formats suivants :
|
Name |
Facultatif |
System.String |
Ce paramètre permet à l'administrateur de modifier le nom unique pour cette entrée de réécriture d'adresses. |
OutboundOnly |
Facultatif |
System.Boolean |
Ce paramètre permet à l'administrateur de déterminer si des adresses électroniques ne doivent être réécrites que si des messages électroniques quittent l'organisation Exchange Server 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 $false si la valeur spécifiée dans InternalAddress contient un caractère générique.
|
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 |
---|---|
|
Exceptions
Exceptions | Description |
---|---|
|
Exemple
Les exemples suivants montrent comment modifier une entrée de réécriture d'adresses existante. Le premier exemple définit le nom de domaine interne à écrire. Le nom descriptif de cette entrée est également modifié afin de refléter le nouveau nom de domaine à réécrire.
Le second exemple définit le paramètre OutboundOnly sur $true
. Cette action indique à l'Agent de réécriture d'adresses de ne réécrire des adresses que sur des messages électroniques émis par l'organisation Exchange 2007.
Important : |
---|
Les expéditeurs internes affectés par une entrée de réécriture d'adresses pour laquelle le paramètre OutboundOnly a la valeur $true doivent avoir une adresse proxy configurée correspondant à l'adresse électronique réécrite. |
Set-AddressRewriteEntry "Address rewrite entry for contoso.com" -Name "Address rewrite entry for northwindtraders.com" -InternalAddress northwindtraders.com
Set-AddressRewriteEntry "Address rewrite entry for all contoso.com e-mail addresses" -OutboundOnly:$true