Get-Queue

  • Статья

 

Применимо к: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Последнее изменение раздела: 2007-08-29

Командлет 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[]>]

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

Командлет Get-Queue отображает информацию о существующих очередях на транспортном сервере-концентраторе или пограничном транспортном сервере. Без параметров команда отбирает все очереди на локальном сервере и возвращает общую страницу результатов. По умолчанию страница содержит 1000 объектов. Можно также просмотреть очереди на удаленном сервере. Для этого нужно включить имя сервера в параметр Identity или добавить параметр Server в запрос фильтра. Параметры Identity и Filter являются взаимоисключающими.

Для выполнения командлета Get-Queue используемой учетной записи необходимо делегировать следующую роль:

  • Роль администраторов сервера Exchange

Чтобы выполнить команду Get-Queue на компьютере с установленной ролью пограничного транспортного сервера, необходимо войти в систему используя учетную запись из локальной группы администраторов этого компьютера.

Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования сервера Microsoft Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.

Параметры

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

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 — 1000. 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. Первая команда отображает сведения о конфигурации для всех очередей на узловом или граничном транспортном сервере, на котором выполнена команда. Эта команда передается в команду Format-List для форматирования результатов в виде подробного списка.

Вторая команда отображает данные конфигурации только для очередей, содержащих более 100 сообщений.

Третья команда отображает данные конфигурации для очереди, существующей на удаленном сервере.

Дополнительные сведения о конвейеризации см. в разделе Конвейеризация.

Дополнительные сведения о работе с выходными данными команды см. в разделе Работа с возвращаемыми данными команды.

Дополнительные сведения об использовании среды управления Exchange для выполнения задач просмотра очереди см. в разделе Использование среды управления Exchange для управления очередями.

Get-Queue | format-list
Get-Queue -Filter {MessageCount -gt 100}
Get-Queue -Identity Server1\contoso.com