Filter Queues

  • Article

 

Applies to: Exchange Server 2010 SP3, Exchange Server 2010 SP2

You can use Queue Viewer or the Exchange Management Shell to filter queues on a computer that has the Exchange Server 2010 Hub Transport server role or the Edge Transport server role installed. The list of queues can be lengthy, depending on current mail flow. The list of queues can also frequently change when messages enter and leave the server. By filtering queues, you can adjust your search to specific criteria and locate queues that are experiencing a mail flow problem. You can then perform operations that modify the status of those queues.

To learn more about filtering queues, see "Queue Filtering Scenarios" in Understanding Transport Queues.

Looking for other management tasks related to queues? Check out Managing Transport Queues.

Use Queue Viewer to filter queues

You need to be assigned permissions before you can perform this procedure. To see what permissions you need, see the "Queues" entry in the Transport Permissions topic.

  1. Open the EMC.

  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 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.

  7. (Optional) 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.

Use the Shell to filter queues

You need to be assigned permissions before you can perform this procedure. To see what permissions you need, see the "Queues" entry in the Transport Permissions topic.

This example uses the Get-Queue cmdlet to view all queues that have a message count 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.

 © 2010 Microsoft Corporation. All rights reserved.