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

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

By suspending a message, you prevent delivery of the message. A message that appears in the queue but is already in delivery will not be suspended. Delivery will continue, and the message status will be PendingSuspend. If the delivery fails, the message will re-enter the queue, and the message will then be suspended. You cannot suspend a message that is in the Submission queue or in the Poison Message queue.

A message that is being sent to multiple recipients might be located in multiple queues. To suspend a message in more than one queue in a single operation, you must use a filter.

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 suspend a message, 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 with a filter statement, or include the server name when you specify the message identity.

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

Procedure

To use the Queue Viewer to suspend a message

  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 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. Select one or more messages, right-click, and then select Suspend.

To use the Exchange Management Shell to suspend a message

  • Run the following command:

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

    The following example uses this syntax to suspend all messages in the queues that are from any sender in the domain Contoso.com:

    Copy Code
    Suspend-message -filter {FromAddress -eq "*contoso.com"}
    

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

For More Information