How to Rewrite a Single E-Mail Address

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 explains how to use the Exchange Management Shell to create a new address rewrite entry that rewrites a single e-mail address 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 procedure 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.

Procedure

To create a new address rewrite entry that rewrites the internal address, use the following command syntax in the Exchange Management Shell:

New-AddressRewriteEntry -Name <address rewrite entry name> -InternalAddress <internal e-mail address> -ExternalAddress <external e-mail address>

To use the Exchange Management Shell to create a new address rewrite entry that rewrites a single e-mail address

  • Run the following command:

    New-AddressRewriteEntry -name "david@contoso.com to david@northwindtraders.com" -InternalAddress david@contoso.com -ExternalAddress david@northwindtraders.com
    

For More Information

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

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