How to Create a New Address Rewrite Entry
Microsoft Exchange Server 2007 will reach end of support on April 11, 2017. To stay supported, you will need to upgrade. For more information, see Resources to help you upgrade your Office 2007 servers and clients.
Applies to: Exchange Server 2007, Exchange Server 2007 SP1, Exchange Server 2007 SP2, Exchange Server 2007 SP3
This topic provides an overview of Exchange Management Shell procedures that you can use to create a new address rewrite entry on a computer that has the Exchange Server 2007 Edge Transport server role installed.
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.
Important
The Address Rewriting Inbound agent and the Address Rewriting Outbound agent must be enabled so that address rewrite entries are applied to e-mail messages that enter and leave the Edge Transport server. If address rewrite entries have been created, but the Address Rewriting agents are disabled, Exchange Server 2007 will not apply the address rewrite entries. To verify whether the Address Rewriting agents are enabled on the Edge Transport server, run the following command:Get-TransportAgent
For more information about the Get-TransportAgent command, see Get-TransportAgent.
To enable the Address Rewriting agent if it is not enabled, run the following command:Enable-TransportAgent -Identity "Address Rewriting Inbound agent"Enable-TransportAgent -Identity "Address Rewriting Outbound agent"
For more information about the Enable-TransportAgent command, see Enable-TransportAgent.
Address Rewriting Procedures
There are three major address rewriting scenarios that Exchange Server 2007 can perform. The following list provides a brief explanation of each scenario and a link to the procedure that you use to implement each scenario:
Rewriting a single e-mail address You can rewrite the headers of e-mail messages that are sent to and from specific internal e-mail addresses when messages are sent to and from the Internet.
When you configure Exchange Server 2007 to rewrite a single e-mail address, the headers of e-mail messages that are sent to and from that e-mail address are rewritten. For example, the internal address joe@contoso.com can be rewritten so that it appears to be support@contoso.com when e-mail is sent from that account to the Internet. When replies to that e-mail address or new messages to that address arrive, Exchange Server 2007 rewrites the recipient address in the header of the inbound messages by using the internal address joe@contoso.com.
When you rewrite e-mail addresses, there is a one-to-one correlation between the internal e-mail address and the external e-mail address. This correlation enables Exchange Server 2007 to automatically rewrite e-mail messages to and from the Internet.
For more information, see How to Rewrite a Single E-Mail Address.
Rewriting a single domain You can rewrite the headers of e-mail messages that are sent to and from recipients that send messages from specific internal domain names when messages are sent to and from the Internet.
When you configure Exchange Server 2007 to rewrite a single domain, the headers of e-mail messages that are sent to and from that domain are rewritten so that the messages appear to be originating from another domain that the administrator has specified when they are sent to the Internet. When new messages, or replies to messages that originated from the rewritten domain, arrive at the Edge Transport server, Exchange Server 2007 rewrites the recipient address in the header of the inbound messages with the internal domain and delivers the message to the recipient.
For more information, see How to Rewrite All E-Mail Messages from a Single E-Mail Domain.
Rewriting multiple sub-domains You can rewrite the headers of e-mail messages that are sent from mailboxes that are located in one of multiple internal sub-domains. When you rewrite multiple sub-domains, you have the following options:
Rewrite e-mail messages from all sub-domains This option enables you to rewrite all sub-domains to a single external domain without exception. All e-mail messages from all subdomains will be rewritten.
Rewrite e-mail messages from specific sub-domains You may have to rewrite e-mail messages from specific sub-domains, but do not want to affect other sub-domains. This option is especially convenient when you have many sub-domains but only want to rewrite addresses for a few of them. Exchange Server 2007 lets you configure address rewriting for only those specific sub-domains without creating many exceptions.
Rewrite e-mail messages from all sub-domains with exceptions You may have to configure address rewriting for many sub-domains, but may also have to prevent some sub-domains from being rewritten. Instead of having to create individual address rewrite entries for each sub-domain, Exchange Server 2007 lets you create an address rewrite entry that encompasses all sub-domains and then lets you specify exceptions for those sub-domains that you do not want to rewrite.
For more information, see How to Rewrite All E-Mail Messages from Sub-Domains.
For More Information
For detailed syntax and parameter information, see New-AddressRewriteEntry.
For more information about address rewriting, see the following topics: