This topic explains how to use the Exchange Management Shell to modify an existing address rewrite entry on a computer that has the Exchange Server 2007 Edge Transport server role installed.

Note:

You cannot administer the Address Rewriting agent by using the Exchange Management Console. To administer the Address Rewriting agent, you must use the Exchange Management Shell. For more information about how to use the Exchange Management Shell, see Using the Exchange Management Shell.

To perform the following procedures on a computer that has the Edge Transport server role installed, you must log on by using an account that is a member of the local Administrators group on that computer.

Be careful when you modify an address rewrite entry. Any changes that you make are applied immediately when the command is run. We recommend that you first run the command with the WhatIf parameter.
For more information about the WhatIf parameter, see WhatIf, Confirm, and ValidateOnly Parameters.

Important:

On a single address rewrite entry, the InternalAddress parameter and the ExternalAddress parameter both must either be an e-mail address or a domain. You cannot mix the two types of values on a single address rewrite entry. For more information about address rewrite scenarios, see How to Create a New Address Rewrite Entry.

Important:

You must use the OutboundOnly parameter when you configure address rewrite entries to rewrite multiple internal sub-domains to a single external domain. If the OutboundOnly parameter is enabled on an address rewrite entry, Exchange Server 2007 does not rewrite inbound e-mail messages that are sent to the rewritten external domain that you have specified.
For more information about how to configure Exchange Server 2007 to rewrite multiple internal sub-domains, see How to Rewrite All E-Mail Messages from Sub-Domains.

To modify an address rewrite entry, you must provide the Identity of the address rewrite entry that you want to modify. You typically use the name of the address rewrite entry as its identity, although you can also use its GUID.

You can modify several parameters that are configured on an address rewrite entry. To modify an address rewrite entry, specify the identity of the entry in double quotation marks. You do not have to specify the Identity parameter label because it is implied. Also, you should include each parameter that you want to modify, together with its value. Use the following syntax to modify an address rewrite entry:

If the ExceptionList property that the ExceptionList parameter modifies contains multiple values, be sure that you don't overwrite existing values when you add new sub-domains. For more information about how to add values to, and remove values from, the ExceptionList property, see Modifying Multivalued Properties.