How to Filter Queues

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 Queue Viewer or the Exchange Management Shell to filter queues that are present 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 queue 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 Queues.

Procedure

To use the Queue Viewer to filter queues

  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 Queues tab. A list of all queues on the server to which you are connected is displayed.

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

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

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

    3. Enter a 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 queues that meet all filter criteria will be displayed.

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

To use the Exchange Management Shell to filter queues

  • Run the following command:

    Get-queue -filter {property -operator "value"}
    

    The following example uses this syntax to view all queues that have a message count that is equal to or greater than 1,000 and that have a status of Retry:

    Get-queue -filter {MessageCount -ge 1000 -and Status -eq "Retry"}
    

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

For More Information

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

For more information about the queue properties by which you can filter and the valid operators, see Filtering Queues.