Applies to: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1, Exchange Server 2007
Topic Last Modified: 2007-08-29

This topic explains how to use the Exchange Queue Viewer or the Exchange Management Shell to filter messages that are present in the queues on a computer that has the Microsoft Exchange Server 2007 Hub Transport server role or the Edge Transport server role installed.

Before You Begin

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

  • Exchange Server 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 Server 2007, see Permission Considerations.

Before you create a message filter, you must follow these steps:

  • Verify that you are connected to an Exchange transport server. By default, the actions of the Queue Viewer or the Exchange Management Shell focus on the local server. For more information, see How to Connect to a Server by Using the Queue Viewer.

  • To connect to a specific transport server when you are using the Exchange Management Shell, include the Server parameter in your command.

  • Verify that you have configured the Queue Viewer options. These options determine the number of items that are displayed per page and the frequency at which the Queue Viewer updates the display. For more information, see How to Set Queue Viewer Options.

  • Determine the criteria that you will use to define your filter. For more information, see Filtering Messages.

Procedure

To use the Queue Viewer to filter messages

  1. Open the Exchange Management Console.

  2. In the console tree, click Toolbox.

  3. In the result pane, click Exchange Queue Viewer.

  4. In the action pane, click Open Tool.

  5. In the Queue Viewer, click the Messages tab. A list of all messages in all queues on the server to which you are connected is displayed. To limit the view to a single queue, click the Queues tab, double-click the queue name, and then click the Server\Queue tab that appears.

  6. Click Create Filter, and enter your filter expression as follows:

    1. Select a message property from the message property drop-down list.

    2. Select a comparison operator from the comparison operator drop-down list.

    3. Enter the value from the value drop-down list. If the property has fixed values, select a value from the drop-down list. If the property requires a date/time expression, change the current date/time values or click the drop-down list to select a date from the calendar interface.

    Note:
    The following step is optional.
  7. Click Add Expression to specify additional filter criteria. Only messages that meet all filter criteria will be displayed.

  8. Click Apply Filter. The results of messages that meet the filter criteria are displayed.

To use the Exchange Management Shell to filter queues

  • Run the following command:

    Copy Code
    Get-message -filter {property -operator "value"}
    

    The following example uses this syntax to view all messages that have a spam confidence level (SCL) value that is equal to or greater than 6 and were sent from any sender in the Contoso.com domain:

    Copy Code
    Get-message -filter {SCL -ge 6 -and FromAddress -eq "*Contoso.com"}
    

For detailed syntax and parameter information, see Get-Message.

For More Information

For more information about how to manage and filter messages, see the following topics: