Rewrite a Single E-Mail Address

[This is pre-release documentation and subject to change in future releases. This topic's current status is: Writing Not Started.]

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 Create an 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: