Queue properties

 

Applies to: Exchange Server 2016

Topic Last Modified: 2016-06-20

Learn about queue properties to use in filters in Exchange 2016.

Filtering queues by one or more queue properties in Exchange Server 2016 allows you to quickly find and take action on those queues. The following scenarios are examples of how you might use queue filtering to manage mail flow:

  • You receive a message from the System Center Operations Manager that indicates a queue length has exceeded the established threshold. You want to investigate whether a server-wide mail flow problem exists.

    You create a filter to view all the queues on a server whose message count exceeds what you consider to be typical. If a mail flow problem is indicated, you can select all the queues in the results and suspend the queues while you continue to investigate.

  • You suspend several queues to investigate the cause of mail flow problems. You determine that the problem was caused by an incorrect connector configuration that is now fixed.

    You can create a filter to view all the queues that have a status of Suspended, and then select all the queues in the filter results and resume the queues.

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

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

The following table describes the queue 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

DeferredMessageCount

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 messages returned to the Submission queue because of transient errors that were encountered during recipient resolution. For more information about deferred messages, see Recipient resolution.

n/a

DDeferredMessageCountsPerPriority

Equals (-eq)

Does Not Equal (-ne)

Contains (-like)

An array that shows the number of deferred messages in the queue by priority (importance) value. The MessageCountsPerPriority property shows what each number means.

For example, the value {1, 5, 10, 0} indicates the queue contains 1 deferred High priority message, 5 deferred Normal priority messages, 10 deferred Low priority messages, and no deferred messages that have the priority value None.

Delivery Type

DeliveryType

Equals (-eq)

Does Not Equal (-ne)

The results of the categorization of the message, and how the Transport service intends to transmit the message to the next hop. For a list of the available DeliveryType values, see NextHopSolutionKey.

n/a

FirstRetryTime

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 date/time of the first connection attempt for a queue that has a status of Retry. For more information, see Message retry, resubmit, and expiration intervals.

n/a

Identity

n/a

The identity of the queue in the form of <Server>\<Queue>. For more information see Queue identity.

n/a

IncomingRate

Equals (-eq)

Does not equal (-ne)

Greater than (-gt)

Greater than or equal to (-ge)

Less than (-lt)

Less than or equal to (-le)

A calculated number that indicates how quickly messages are entering the queue. For more information, see IncomingRate, OutgoingRate, and Velocity.

Last Error

LastError

Equals (-eq)

Does Not Equal (-ne)

Contains (-contains)

Is Present

Is Not Present

The last error that was recorded for the queue. For more information about SMTP error codes, see DSNs and NDRs in On-Premises Exchange 2013.

Last Retry Time

LastRetryTime

Greater Than (-gt)

Greater Than or Equals (-ge)

Less Than (-lt)

Less Than or Equals (-le)

Is Present ()

Is Not Present ()

The date/time of the last connection attempt for a queue that has a status of Retry. For more information, see Message retry, resubmit, and expiration intervals.

n/a

LockedMessageCount

n/a

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

Message Count

MessageCount

Equals (-eq)

Does Not Equal (-ne)

Greater Than (-gt)

Greater Than or Equals (-ge)

Less Than (-lt)

Less Than or Equals (-le)

The number of messages in the queue.

n/a

MessageCountsPerPriority

Equals (-eq)

Does Not Equal (-ne)

Contains (-like)

An array that shows the number of messages in the queue by priority (importance) value. The MessageCountsPerPriority property shows what each number means.

For example, the value {1, 100, 10, 0} indicates the queue contains 1 High priority message, 100 Normal priority messages, 10 Low priority messages, and no messages that have the priority value None.

For more information about priority queuing, see Priority queuing.

n/a

NextHopCategory

Equals (-eq)

Does Not Equal (-ne)

The value Internal or External for the next hop based on the value of the DeliveryType property. For more information, seeNextHopSolutionKey.

n/a

NextHopConnector

Equals (-eq)

Does Not Equal (-ne)

Contains (-like)

The GUID of the next hop based on the value of the DeliveryType property. For more information, see NextHopSolutionKey.

Next Hop Domain

NextHopDomain

Equals (-eq)

Does Not Equal (-ne)

Contains (-like)

The name of next hop based on the value of the DeliveryType property. For more information, see NextHopSolutionKey.

Next Retry Time

NextRetryTime

Greater Than (-gt)

Greater Than or Equals (-ge)

Less Than (-lt)

Less Than or Equals (-le)

Is Present

Is Not Present

The date/time of the next connection attempt for a queue that has a status of Retry. For more information, see Message retry, resubmit, and expiration intervals.

n/a

OutboundIPPool

n/a

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

n/a

OutgoingRate

Equals (-eq)

Does not equal (-ne)

Greater than (-gt)

Greater than or equal to (-ge)

Less than (-lt)

Less than or equal to (-le)

A calculated number that indicates how quickly messages are leaving the queue. For more information, see IncomingRate, OutgoingRate, and Velocity.

n/a

OverrideSource

n/a

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

n/a

PriorityDescriptions

n/a

The value descriptions in the DeferredMessageCountsPerPriority and MessageCountsPerPriority properties. The value of this property is {High, Normal, Low, None}.

Because the value of this property is always the same, it won't make a good filter.

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 connection attempts for a queue that has a status of Retry. For more information, see Message retry, resubmit, and expiration intervals.

n/a

RiskLevel

n/a

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

Status

Status

Equals (-eq)

Does Not Equal (-ne)

The current queue status. A queue can have one of the following status values: Active, Connecting, Suspended, Ready, or Retry. For more information, see Queue status.

n/a

TlsDomain

Equals (-eq)

Does Not Equal (-ne)

Contains (-like)

The FQDN of the destination domain if the domain is configured for Domain Security (mutual TLS authentication).

n/a

Velocity

Equals (-eq)

Does not equal (-ne)

Greater than (-gt)

Greater than or equal to (-ge)

Less than (-lt)

Less than or equal to (-le)

A calculated number that indicates how effectively the queue is draining. For more information, see IncomingRate, OutgoingRate, and Velocity

 
Show: