Применимо к: Exchange Server 2010 SP1

Последнее изменение раздела: 2011-03-19

Командлет Get-Queue используется для просмотра сведений о конфигурации очередей на компьютере с установленной ролью транспортного сервера-концентратора или пограничного транспортного сервера.

Синтаксис

Get-Queue [-BookmarkIndex <Int32>] [-BookmarkObject <QueueInfo>] [-Filter <String>] [-IncludeBookmark <$true | $false>] [-ResultSize <Unlimited>] [-ReturnPageInfo <$true | $false>] [-SearchForward <$true | $false>] [-Server <ServerIdParameter>] [-SortOrder <SortOrderEntry[]>]
Get-Queue [-Identity <QueueIdentity>] [-BookmarkIndex <Int32>] [-BookmarkObject <QueueInfo>] [-IncludeBookmark <$true | $false>] [-ResultSize <Unlimited>] [-ReturnPageInfo <$true | $false>] [-SearchForward <$true | $false>] [-SortOrder <SortOrderEntry[]>]

Параметры

Параметр Обязательный Тип Описание

BookmarkIndex

Необязательный

System.Int32

Параметр BookmarkIndex задает позицию в наборе результатов, с которой начинаются отображаемые результаты. Значение этого параметра — индекс в общем результирующем наборе с отсчетом от единицы. Параметр BookmarkIndex нельзя использовать вместе параметром BookmarkObject.

BookmarkObject

Необязательный

Microsoft.Exchange.Data.QueueViewer.QueueInfo

Параметр BookmarkObject задает в наборе результатов объект, с которого начинаются отображаемые результаты. Параметр BookmarkObject нельзя использовать вместе параметром BookmarkIndex.

Filter

Необязательный

System.String

Значением параметра Filter должно быть выражение, задающее критерии значений свойств для тех очередей, которые требуется просмотреть. Это выражение включает в себя имя свойства, за которым следует оператор сравнения и значение. Для параметра Filter допустимы следующие свойства очереди:

  • DeliveryType.   Тип доставки для данной очереди, определяемый транспортом. Тип доставки должен иметь одно из следующих значений:

    • DNSConnectorDelivery

    • NonSMTPGatewayDelivery

    • SmartHostConnectorDelivery

    • SmtpRelayWithinAdSitetoEdge

    • MapiDelivery

    • SmtpRelayWithinAdSite

    • SmtpRelaytoRemoteAdSite

    • SmtpRelaytoTiRg

    • Undefined

    • Unreachable

  • Identity   Идентификатор очереди выражается в виде Сервер\место_назначения, где место_назначения может быть удаленным доменом, почтовым сервером, постоянным именем очереди или идентификатором базы данных очередей.

  • LastError.   Текстовая строка последней ошибки, записанной для очереди.

  • LastRetryTime.   Время последней попытки подключения для данной очереди.

  • MessageCount.   Число элементов в очереди.

  • NextHopConnector.   Идентификатор GUID соединителя, который использовался для создания очереди.

  • NextHopDomain   Следующий домен для прыжка этой очереди, указанный в виде SMTP-домена, имени сервера, имени сайта Служба каталогов Active Directory или идентификатора базы данных сообщений (MDB).

  • NextRetryTime.   Время следующей попытки подключения для данной очереди.

  • Status.   Состояние очереди. Возможные значения состояния очереди: «Active», «Ready», «Retry» или «Suspended».

Можно указать несколько критериев с использованием оператора сравнения AND. Значения свойств, не выраженные в виде целого числа, должны заключаться в кавычки (").

Identity

Необязательный

Microsoft.Exchange.Data.QueueViewer.QueueIdentity

Параметр Identity указывает удостоверение очереди, содержащей сообщения, которые нужно отобразить. Идентификатор очереди вводится в виде Сервер\назначение, где в части назначение указывается удаленный домен, почтовый сервер или постоянное имя очереди.

IncludeBookmark

Необязательный

System.Boolean

Параметр IncludeBookmark указывает, включается ли объект закладок в отображаемые результаты запроса. Параметр IncludeBookmark является допустимым, когда он используется с параметром BookmarkObject или BookmarkIndex. Если значение для параметра IncludeBookmark не указано, используется значение по умолчанию — $true.

ResultSize

Необязательный

Microsoft.Exchange.Data.Unlimited

Параметр ResultSize указывает общее количества элементов, которые нужно отобразить в результирующем наборе. Значение по умолчанию параметра ResultSize — 1 000. Параметр ResultSize поддерживает неограниченное количество результатов, но Microsoft Exchange устанавливает для результирующего набора ограничение в 250 000 объектов.

ReturnPageInfo

Необязательный

System.Boolean

ReturnPageInfo — это скрытый параметр. Этот параметр возвращает сведения об общем числе результатов и индекс первого объекта текущей страницы. Значение по умолчанию: $false.

SearchForward

Необязательный

System.Boolean

Параметр SearchForward указывает, должен ли поиск в наборе результатов выполняться вперед или назад. Значение по умолчанию: $true. При этом значении результирующая страница вычисляется вперед от начала результирующего набора или от закладки, если она указана.

Server

Необязательный

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Параметр Server задает имя сервера для подключения с использованием удаленного вызова процедур (RPC), на котором располагаются очереди, содержащие отображаемые сообщения. Введите имя сервера как имя компьютера или полное имя домена (FQDN). Если параметр Server не используется, запрос направляется локальному серверу.

SortOrder

Необязательный

Microsoft.Exchange.Configuration.Tasks.SortOrderEntry[]

Параметр SortOrder указывает массив свойств сообщений, которые используются для управления порядком сортировки набора результатов. Каждое свойство отделяется запятой. Чтобы результаты отображались в порядке возрастания, добавьте к началу имени свойства символ +. Чтобы результаты отображались в порядке убывания, добавьте к началу имени свойства символ -. Если порядок сортировки не указан, результирующий набор отображается в порядке возрастания целочисленного значения QueueIdentity.

Подробное описание

Командлет Get-Queue отображает информацию о существующих очередях на транспортном сервере-концентраторе или пограничном транспортном сервере.

 Запись «Очереди» в разделе Разрешения транспорта.

Примеры

ПРИМЕР 1

В этом примере отображаются подробные сведения обо всех очередях на пограничном транспортном сервере, на котором выполнена команда.

Скопировать код 
Get-Queue | Format-List

ПРИМЕР 2

В этом примере перечисляются очереди, содержащие больше 100 сообщений.

Скопировать код 
Get-Queue -Filter {MessageCount -gt 100}

ПРИМЕР 3

В этом примере отображаются подробные сведения об отдельной очереди, существующей на сервере Server1.

Скопировать код 
Get-Queue -Identity Server1\contoso.com | Format-List