View or Configure an Address Rewrite Entry

You can use the Shell to view or modify an existing address rewrite entry on a computer that has the Microsoft Exchange Server 2010 Edge Transport server role installed.For more information about address rewriting, see Understanding Address Rewriting.

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

You need to be assigned permissions before you can perform this procedure. To see what permissions you need, see the "Address Rewriting agent" entry in the Transport Permissions topic.

Note:

You can't use the EMC to modify an address rewrite entry.

To modify an address rewrite entry, you must provide the Identity parameter 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 use its GUID.

You can modify several parameters configured on an address rewrite entry. To modify an address rewrite entry, specify the identity of the entry in double quotation marks. You don't have to specify the Identity parameter label because it's implied. Also, you should include each parameter that you want to modify, together with its value.

On a single address rewrite entry, the ExternalAddress parameter and the InternalAddress parameter both must either be an e-mail address or a domain. You can't mix the two types of values on a single address rewrite entry.

You must use the OutboundOnly parameter when you configure address rewrite entries to rewrite multiple internal subdomains to a single external domain. If the OutboundOnly parameter is enabled on an address rewrite entry, Exchange 2010 doesn't rewrite inbound e-mail messages sent to the rewritten external domain that you specified.

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