View Queued Message Properties
Applies to: Exchange Server 2010 SP3, Exchange Server 2010 SP2
This topic explains how to use either the Exchange Queue Viewer in the EMC or the Shell to view the properties of a message that is queued for delivery.
What Do You Want to Do?
Use Queue Viewer in the EMC to view the properties of a message
Use the Shell to view the properties of a message
Use Queue Viewer in the EMC to view the properties of a message
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.
In the console tree, select Toolbox to display a list of available tools in Exchange Server 2010.
Under Performance tools, double-click Queue Viewer to open the tool in a new window.
Select the Messages tab to see the list of messages that are currently queued for delivery in your organization.
Right-click the message whose properties you want to view and then select Properties.
The General tab displays the following detailed information about the message:
Identity This field shows the integer that represents a particular message. The message identity is assigned by the queuing database when the message is received for processing. You can include an optional server and queue identity to identify a unique instance of the message.
Subject This field shows the subject of a message and is expressed as a text string. The value is taken from the
Subject:
header field.Internet Message ID This field shows the value of the
MessageID:
header field. The value of this property is expressed as a GUID followed by the SMTP address of the sending server, as in this example: 67D754D6103DC4FB3BA6BC7205DACABA61231@exchange.contoso.comFrom Address This field shows the SMTP address of the sender of the message. This value is taken from MAIL FROM: in the message envelope.
Status This field shows the current message status. A message can have one of the following status values:
◊ Active If the message is in a delivery queue, the message is being delivered to its destination. If the message is in the Submission queue, the message is being processed by the categorizer.
◊ Pending Remove The message was deleted by the administrator but was already in delivery. The message will be deleted if the delivery ends in an error that causes the message to re-enter the queue. Otherwise, delivery will continue.
◊ Pending Suspend The message was suspended by the administrator but was already in delivery. The message will be suspended if the delivery ends in an error that causes the message to re-enter the queue. Otherwise, delivery will continue.
◊ Ready The message is waiting in the queue and is ready to be processed.
◊ Retry The last connection attempt failed for the queue in which this message is located. The message is waiting for the next queue retry.
◊ Suspended The message was suspended by the administrator.
Size (KB) This field shows the size of the message rounded up to the nearest kilobyte (KB).
Message Source Name This field shows the name of the component that submitted this message to the queue.
Source IP This field shows the IP address of the external server that submitted the message to the Exchange organization.
SCL This field shows the spam confidence Level (SCL) rating of the message. Valid SCL entries are integers 0 through 9. An empty SCL entry indicates that the message hasn't been processed by the Content Filter agent.
Date Received This field shows the date-time when the message was received by the server that holds the queue in which the message is located.
Expiration Time This field shows the date-time when the message will expire and will be deleted from the queue if the message can't be delivered.
Last Error This field shows the last error that was recorded for a message.
Queue ID This field shows the identity of the queue that holds the message. The queue identity is expressed in the form Server\destination, where destination is a remote domain, mailbox server, persistent queue name, or the queue database identifier. The queue database identifier is represented as an integer and can be determined by viewing the message properties.
Recipients This field shows the list of recipients to which the message is addressed.
Retry Count This field shows the number of times that delivery of a message to a destination was tried.
The Recipient Information tab displays the following information about the message recipients:
Address This field shows the SMTP address of the recipient of the message. This value is taken from
RCPT TO:
in the message envelope.Status This field shows the current message status. A message can have one of the following status values:
◊ Active If the message is in a delivery queue, the message is being delivered to its destination. If the message is in the Submission queue, the message is being processed by the categorizer.
◊ Pending Remove The message has been deleted by the administrator but was already in delivery. The message will be deleted if the delivery ends in an error that causes the message to re-enter the queue. Otherwise, delivery will continue.
◊ Pending Suspend The message has been suspended by the administrator but was already in delivery. The message will be suspended if the delivery ends in an error that causes the message to re-enter the queue. Otherwise, delivery will continue.
◊ Ready The message is waiting in the queue and is ready to be processed.
◊ Retry The last connection attempt failed for the queue in which this message is located. The message is waiting for the next queue retry.
◊ Suspended The message has been suspended by the administrator.
Last Error This field shows the last error that was recorded for a message.
Use the Shell to view the properties of a message
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.
You can use the Get-Message cmdlet to view the properties of a message that is currently queued for delivery. The following example tabulates the sender address, recipients, subject, and received date information for all messages that are currently in retry state:
Get-Message -IncludeRecipientInfo -Filter {Status -eq "Retry"} | FT FromAddress,Recipients,Subject,DateReceived
For detailed syntax and parameter information, see Get-Message.
© 2010 Microsoft Corporation. All rights reserved.