How to View a Transport Rule

  • Article

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 Console or the Exchange Management Shell to view an existing transport rule on a computer that has the Microsoft Exchange Server 2007 Hub Transport server role or the Edge Transport server role installed.

For more information about the Transport Rules agent, see Overview of Transport Rules.

Before You Begin

To perform the following procedures, the account you use must be delegated the following:

  • Exchange View-Only Administrator role

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.

For more information about permissions, delegating roles, and the rights that are required to administer Exchange 2007, see Permission Considerations.

Note

When you view transport rules on a Hub Transport server, you can view any transport rule that is configured in the Exchange organization, except transport rules that are configured on Edge Transport servers.
If you view transport rules on an Edge Transport server, you can only view the transport rules on the local computer. To view transport rules on another Edge Transport server, you must open the Exchange Management Console on that computer.

Using the Exchange Management Console to View a Transport Rule

Note

The procedure for viewing a transport rule on a Hub Transport server is slightly different from the procedure for viewing a transport rule on an Edge Transport server.

To use the Exchange Management Console to view an existing transport rule on a Hub Transport server

  1. Open the Exchange Management Console on the Hub Transport server.

  2. In the console tree, click Organization Configuration, and then click Hub Transport.

  3. In the result pane, on the Transport Rules tab, right-click the rule that you want to view, and then click Edit Rule.

  4. Click Next to navigate through the Transport Rule wizard to view the configuration of the transport rule.

  5. Click Cancel when you are finished viewing the transport rule and have not made any changes.

To use the Exchange Management Console to view an existing transport rule on an Edge Transport server

  1. Open the Exchange Management Console on the Edge Transport server that contains the transport rule that you want to view.

  2. In the console tree, click Edge Transport.

  3. In the result pane, on the Transport Rules tab, right-click the rule that you want to view, and then click Edit Rule.

  4. Click Next to navigate through the Transport Rule wizard to view the configuration of the transport rule.

  5. Click Cancel when you are finished viewing the transport rule and have not made any changes.

Using the Exchange Management Shell to View a Summary List of All Transport Rules

In the Exchange Management Shell, you can view a summary list of all transport rules that are configured on all Hub Transport servers or on the local Edge Transport server by using the following command syntax:

Get-TransportRule

To use the Exchange Management Shell to view a summary list of all transport rules

  • Run the following command:

    Get-TransportRule

Using the Exchange Management Shell to View a Single Transport Rule

To view the detailed configuration of a transport rule in the Exchange Management Shell, you must pipe the output of the Get-TransportRule command to the Format-List command by using the following command syntax:

Get-TransportRule <GUID or transport rule name> | Format-List

For more information about pipelining, see Pipelining.

For more information about how to work with the information that is returned by a command, see Working with Command Output.

To use the Exchange Management Shell to view the detailed configuration of a single transport rule

  • Run the following command:

    Get-TransportRule "Messages sent to the Sales group" | Format-List

You can also view the list of conditions, exceptions, and actions that are configured on a transport rule and their values by assigning the transport rule to a variable. Use the following command syntax:

$TransportRule = Get-TransportRule <GUID or transport rule name>

You can then access the conditions, exceptions, or actions that are configured on the transport rule, and view the values that are configured on each condition, exception, or action.

To use the Exchange Management Shell to view the conditions, exceptions, or actions that are configured on a transport rule

  1. Run the following command to assign the transport rule to a variable:

    $TransportRule = Get-TransportRule "Test Rule"

  2. Run the following command to display the configured conditions and their values:

    $TransportRule.Conditions

  3. Run the following command to display the configured exceptions and their values:

    $TransportRule.Exceptions

  4. Run the following command to display the configured actions and their values:

    $TransportRule.Actions

Note

You can view single conditions, exceptions, or actions by specifying the array index number of a condition, exception, or action.
For more information about array index numbers, see Arrays.

For More Information

For detailed syntax and parameter information for the Get-TransportRule command, see Get-TransportRule.

For more information about transport rules, see the following topics: