Share via


Properties of messages in queues

Filtering messages in queues by one or more message properties in Exchange Server allows you to quickly locate messages and take action on them. When an email message is sent to multiple recipients, the message might be located in multiple queues on the server. When you filter messages in queues by message properties, you can locate messages across all queues. The following scenarios are examples of how you might use message filtering to manage mail flow:

  • The Submission queue on the Mailbox server or Edge Transport server that receives email from the Internet has a high volume of messages that are queued for delivery. Many of the messages have the same subject. Therefore, you suspect that spam is being sent to your organization. You can create a filter to view all the messages that meet the subject criteria. If you determine that the messages are spam, you can select them all and delete them from the delivery queue without sending an NDR.

  • A user reports that mail flow is slow. You examine the queues and see that many messages with random subjects appear to be coming from a single domain. You can create a filter to view all the queued messages from that domain. If you determine that the messages are spam, you can select them all and delete them from the queues without sending an NDR.

You can create message filters in Queue Viewer in the Exchange Toolbox, or by using the Filter parameter on the message management cmdlets. Note that the message management cmdlets support more filterable properties than Queue Viewer.

For more information about Queue Viewer, see Queue Viewer. For more information about the message management cmdlets, see Procedures for messages in queues and Find queues and messages in queues in the Exchange Management Shell.

Message properties to use as filters

The following table describes the message properties that you can use as filters in Queue Viewer and the Exchange Management Shell.

Queue Viewer Exchange Management Shell Comparison operators Description
n/a AccountForest n/a his property is reserved for internal Microsoft use, and isn't used in on-premises Exchange organizations.

In on-premises Exchange, this property is the forest root domain where the mailbox resides (for example, contoso.com).

n/a ComponentLatency n/a This property is reserved for internal Microsoft use, and isn't used in on-premises Exchange organizations.
Date Received DateReceived Greater Than (-gt)

Greater Than or Equals (-ge)

Less Than (-lt)

Less Than or Equals (-le)

The date/time when the message was placed in the queue.
n/a DeferReason Equals (-eq)

Does not equal (-ne)

Contains (-like)

Indicates why the message was deferred. If the message wasn't deferred, this property has the value None. A deferred message is returned to the Submission queue because of transient errors that were encountered during recipient resolution. For more information about deferred messages, see Recipient resolution in Exchange Server. The possible values are:

AD Transient Failure During Content Conversion)

AD Transient Failure During Resolve

Agent

Ambiguous Recipient

Config Update

Loop Detected

Marked As Retry Delivery If Rejected

Recipient does not have a mailbox database

Recipient Thread Limit Exceeded

Rerouted By Store Driver

Storage Transient Failure During Content Conversion

Target Site Inbound Mail Disabled

Transient Accepted Domains Load Failure

Transient Attribution Failure

Transient Failure

n/a Directionality Equals (-eq)

Does Not Equal (-ne)

Valid values are Incoming, Originating, and Undefined.
Expiration Time ExpirationTime Greater Than (-gt)

Greater Than or Equals (-ge)

Less Than (-lt)

Less Than or Equals (-le)

The date/time when the message will expire and be deleted from the queue if the message can't be delivered.
n/a ExternalDirectoryOrganizationId n/a This property is reserved for internal Microsoft use, and isn't used in on-premises Exchange organizations.

In on-premises Exchange, the value is 00000000-0000-0000-0000-000000000000.

From Address FromAddress Equals (-eq)

Does Not Equal (-ne)

Contains (-contains)

The SMTP address of the sender.
n/a Identity n/a The identity of the message in the form of <Server>\ <Queue>\ <MessageInteger>. For more information see Message identity.
Internet Message ID InternetMessageId Equals (-eq)

Does Not Equal (-ne)

Contains (-contains)

The value of the Message-Id: header field in the message header. This value is constant for the lifetime of the message. For messages created in Exchange, the value is in the format <GUID@ServerFQDN>, including the angle brackets (< >). For example, <4867a3d78a50438bad95c0f6d072fca5@mailbox01.contoso.com>.
Last Error LastError Equals (-eq)

Does Not Equal (-ne)

Contains (-contains)

Is Present

Is Not Present

The last error that was recorded for a message. For example, A matching connector cannot be found to route the external recipient.
n/a LockReason n/a This property is reserved for internal Microsoft use, and isn't used in on-premises Exchange organizations.
n/a MessageLatency Equals (-eq)

Does not equal (-ne)

Greater than (-gt)

Greater than or equal to (-ge)

Less than (-lt)

Less than or equal to (-le

The amount of time that elapsed between when the message first entered the Submission queue on the server, and when the message was placed in the queue. The value uses the syntax hh:mm:ss.ff, where hh = hour, mm = minute, ss = second, and ff = fractions of a second.
Message Source Name MessageSourceName Equals (-eq)

Does Not Equal (-ne)

Contains (-contains)

The name of the transport component that submitted the message to the queue. For example, if the message came in through a Receive connector, the value is: SMTP: <ConnectorName>. If the message is a delivery status notification (DSN), the value is DSN.
n/a OriginalFromAddress Equals (-eq)

Does not equal (-ne)

Contains (-like)

The original sender's email address for any new side effect messages that are created during categorization (for example, journal rules, NDRs, or mail flow rules rules, also known as transport rules).
n/a Priority Equals (-eq)

Does not equal (-ne)

The priority (importance) of the message that's assigned by the user in Microsoft Outlook or Outlook on the web. Valid values are Low, Normal, and High. For more information, see Priority Queuing.
Queue ID Queue Equals (-eq)

Does Not Equal (-ne)

Contains (-contains)

The queue that holds the message. The queue identity uses the syntax <Server>\<Queue>. For more information, see Queue identity.
n/a Recipients Contains (-like) An array that contains details about the recipient and the Send connector that will be used, or any errors that were encountered. For example:

{chris@contoso.com;2;2;A matching connector cannot be found to route the external recipient;16;<No Matching Connector>;0}

n/a RetryCount Equals (-eq)

Does not equal (-ne)

Greater than (-gt)

Greater than or equal to (-ge)

Less than (-lt)

Less than or equal to (-le

The number of times that delivery of the message to the destination was tried, either automatically or manually.
SCL SCL Equals (-eq)

Does Not Equal (-ne)

Greater Than (-gt)

Greater Than or Equals (-ge)

Less Than (-lt)

Less Than or Equals (-le

The spam confidence level (SCL) rating of the message. Valid SCL entries are integers 0 through 9, or -1 for internal (authenticated) messages. For more information, see Exchange spam confidence level (SCL) thresholds.
Size (KB) Size Equals (-eq)

Does Not Equal (-ne)

Greater Than (-gt)

Greater Than or Equals (-ge)

Less Than (-lt)

Less Than or Equals (-le

The size of the message. In Queue Viewer, you need to specify the message size in kilobytes (KB), but in the Exchange Management Shell, you can also specify other sizes, for example, bytes (B) or megabytes (MB).
Source IP SourceIP Equals (-eq)

Does Not Equal (-ne)

The IPv4 or IPv6 address of the server that submitted the message to the Exchange server that holds the message in the queue. The address could be the IP address of a remote SMTP server, or the IP address of the local Exchange server.
Status Status Equals (-eq)

Does Not Equal (-ne)

The current message status. Valid values are:

Active

Locked

Pending Remove (PendingRemove)

Pending Suspend (PendingSuspend)

Ready

Retry

Suspended

For more information, see Message status.

Subject Subject Equals (-eq)

Does Not Equal (-ne)

Contains (-contains)

Is Present
Is Not Present

The subject of the message (from the Subject: header field).
n/a TrafficType n/a This property is reserved for internal Microsoft use, and isn't used in on-premises Exchange organizations.

In on-premises Exchange, this property is blank or has the value Email.

n/a TrafficSubType n/a This property is reserved for internal Microsoft use, and isn't used in on-premises Exchange organizations.