How to Remove an 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 explains how to use the Exchange Management Shell to remove a single address rewrite entry and multiple address rewrite entries on a computer that has the Edge Transport server role installed.

In Exchange Server 2007, the Address Rewriting agent lets you modify the addresses of senders and recipients on messages that enter and leave an Exchange Server 2007 organization.

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 View an Address Rewrite Entry.

Removing a Single Address Rewriting Entry

In the Exchange Management Shell, you can remove a single address rewrite entry by using the following command syntax:

Remove-AddressRewriteEntry <GUID or address rewrite entry name>

To use the Exchange Management Shell to remove a single address rewrite entry

1. Run the following command to test your changes:

   Remove-AddressRewriteEntry "Contoso.com to Northwindtraders.com" -WhatIf
   

2. Run the following command to apply your changes:

   Remove-AddressRewriteEntry "Contoso.com to Northwindtraders.com"
   

Removing Multiple Address Rewriting Entries

To remove multiple address rewrite entries, you must use pipelining to pipe the output of the Get-AddressRewriteEntry command to the Remove-AddressRewriteEntry command. The Get-AddressRewriteEntry command accepts wildcard characters that let you to specify matches that are based on partial names that you supply. The Remove-AddressRewriteEntry command accepts the results from Get-AddressRewriteEntry command and removes the address rewrite entries that are returned.

For example, assume that you have configured the following address rewrite entries:

• "Rewrite sales.northwindtraders.com to contoso.com"

• "Rewrite marketing.northwindtraders.com to contoso.com"

• "Rewrite research.northwindtraders.com to contoso.com"

• "Rewrite john@northwindtraders to support@contoso.com"

• "Rewrite joe@northwindtraders to support@contoso.com"

You can use a wildcard character to match a subset of these address rewrite entries. The following examples show how to use a wildcard character to match specific entries in this list:

• Match only the sub-domain address rewrite entries.

  Get-AddressRewriteEntry "*to contoso.com"
  

• Match only the e-mail address rewrite entries.

  Get-AddressRewriteEntry "*support@contoso.com"
  

For more information about pipelining, see Pipelining.

In the Exchange Management Shell, you can remove multiple address rewrite entries by using the following command syntax:

Get-AddressRewriteEntry <match criteria> | Remove-AddressRewriteEntry 

To use the Exchange Management Shell to remove multiple address rewrite entries

1. Run the following command to test your criteria:

   Get-AddressRewriteEntry "*to contoso.com" | Remove-AddressRewriteEntry -WhatIf
   

2. Run the following command to apply your changes:

   Get-AddressRewriteEntry "*to contoso.com" | Remove-AddressRewriteEntry
   

For More Information

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

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

• How to Create a New Address Rewrite Entry

• How to View an Address Rewrite Entry

• How to Modify an Address Rewrite Entry