Applies to: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1, Exchange Server 2007
Topic Last Modified: 2007-08-13

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.

For more information about address rewriting, see Planning for Address Rewriting.

Before You Begin

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.

Also, before you perform this procedure, read How to Create a New Address Rewrite Entry.

Caution:
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.

Procedure

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:

Copy Code 
Set-AddressRewriteEntry <Identity> -Parameter <value>

To use the Exchange Management Shell to modify an existing address rewrite entry

  • Run the following command to modify the ExternalAddress parameter:

    Copy Code 
    Set-AddressRewriteEntry "Contoso to Northwindtraders" -ExternalAddress northwindtraders.net

  • Run the following command to modify the InternalAddress parameter:

    Copy Code 
    Set-AddressRewriteEntry "Northwindtraders to Contoso" -InternalAddress northwindtraders.net

  • Run the following command to modify the OutboundOnly parameter:

    Copy Code 
    Set-AddressRewriteEntry "Contoso to Northwindtraders" -OutboundOnly:$true

  • Run the following command to modify the ExceptionList parameter:

    Copy Code 
    Set-AddressRewriteEntry "Contoso to Northwindtraders" -ExceptionList sales.northwindtraders.net
    Note:
    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.

  • Run the following command to modify the Name parameter:

    Copy Code 
    Set-AddressRewriteEntry "Contoso to Northwindtraders" -Name "Contoso to Woodgrove Bank"

For More Information

For detailed syntax and parameter information, see Set-AddressRewriteEntry.

For more information about address rewriting, see the following topics: