Поиск очередей и сообщений в очередях в командной консоли Exchange

ПРИМЕНЯЕТСЯ К:2016 2019 по подписке

Как и в предыдущих версиях Exchange, командную консоль Exchange можно использовать в Exchange Server для просмотра сведений об очередях и сообщениях, а также использования этих сведений для выполнения действий с очередями и сообщениями. Как правило, активный Exchange содержит большое количество очередей и сообщений, требующих доставки, поэтому важно понимать, как определить очереди или сообщения, которыми вы хотите управлять.

Для управления элементами вы также можете воспользоваться средством просмотра очереди в панели элементов Exchange. Однако командлеты для просмотра очередей и сообщений в командной консоли Exchange поддерживают больше фильтруемых свойств и параметров фильтрации, чем средство просмотра очередей. Дополнительные сведения о средстве просмотра очереди см. в разделе Queue Viewer.

Также помните, что очереди существуют на серверах почтовых ящиков и пограничных транспортных серверах (транспортная служба). Дополнительные сведения об очередях и сообщениях в очередях см. в разделе Очереди и сообщения в очередях.

Параметры фильтрации очередей

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

Командлет	Параметры фильтрации	Comments
Get-Queue	Exclude Фильтр Identity Include Сервер	Параметры Include и Exclude можно использовать с другими параметрами фильтрации в одной команде. Параметры Identity и Filter нельзя использовать в одной команде. Параметр Server указывает сервер, на котором вы хотите выполнить команду. Параметры Server и Identity нельзя использовать в одной команде, но можно использовать параметр Server с другими параметрами фильтрации в той же команде.
Resume-Queue Retry-Queue Suspend-Queue	Identity Фильтр Сервер	Параметр Identity нельзя использовать с другими параметрами фильтрации в одной команде. Параметр Server указывает сервер, на котором вы хотите выполнить команду. В одной команде можно использовать параметры Server и Filter .
Get-QueueDigest	Dag Фильтр Forest Сервер Site	Необходимо использовать один из параметров DAG, Site, Server или Forest , но вы не можете использовать их вместе в одной команде. Параметр Filter можно использовать с любыми другими параметрами фильтрации.

Идентификатор очереди

Параметр Identity использует основной синтаксис <Server>\ <Queue>. Как правило, это значение однозначно определяет очередь, поэтому использовать другие параметры фильтрации с параметром Identity невозможно. Исключением является командлет Get-Queue , где можно использовать параметры Include и Exclude с параметром Identity .

В следующей таблице объясняется синтаксис параметров идентификаторов командлетов управления очередью.

Значение параметра Identity	Описание
<Server>\<PersistentQueueName> или <PersistentQueueName>	Постоянная очередь на указанном или локальном сервере. <PersistentQueueName> это Submission, Unreachable, или Poison. Дополнительные сведения о постоянных очередях см. в разделе Типы очередей.
<Server>\<NextHopDomain> или <NextHopDomain>	Очередь доставки на указанном или локальном сервере. <NextHopDomain> — это имя очереди из значения свойства NextHopDomain очереди. Например, адресное пространство соединителя отправки, имя сайта Active Directory или имя группы обеспечения доступности баз данных. Дополнительные сведения см. в разделе NextHopSolutionKey.
<Server>\<QueueInteger> или <QueueInteger>	Очередь доставки на указанном или локальном сервере. <QueueInteger> — это уникальное целое значение, назначенное очереди доставки или теневой очереди в базе данных очередей. Однако чтобы найти это значение в свойствах Identity или QueueIdentity, необходимо запустить командлет Get-Queue.
<Server>\Shadow\<QueueInteger> или Shadow\<QueueInteger>	Теневая очередь на указанном или локальном сервере. Дополнительные сведения о теневых очередях и теневой избыточности см. в статье Теневая избыточность в Exchange Server.
<Server>\* или *	Все очереди на указанном или локальном сервере. Примечание: Identity — это позиционный параметр, что означает, что вы можете указать значение без указания -Identity квалификатора. Например, следующие команды дают один и тот же результат: Get-Queue -Identity * Get-Queue * Get-Queue

Параметр фильтра в командлетах очереди

Параметр Filter можно использовать во всех командлетах управления очередями, чтобы определить одну или несколько очередей на основе свойств очередей. Параметр Filter создает OPath-фильтр с операторами сравнения, чтобы ограничить команду очередями, удовлетворяющими критериям фильтра. Логический оператор -and можно использовать для задания нескольких условий для соответствующего соответствия. Общий пример синтаксиса:

Get-Queue -Filter "<Property1> -<ComparisonOperator> '<Value1>' -and <Property2> -<ComparisonOperator> '<Value2>'..."

Полный список свойств очереди, которые можно использовать с параметром Фильтр, см. в разделе Свойства очереди.

Список операторов сравнения, которые можно использовать с параметром Фильтр, см. в разделе Операторы сравнения, используемые при фильтрации очередей или сообщений , в этой статье.

Примеры процедур, использующих параметр Filter для просмотра очередей и управления ими, см. в разделе Процедуры для очередей.

Включение и исключение параметров в Get-Queue

Параметры Include и Exclude можно использовать в командлете Get-Queue по отдельности, вместе с каждым из параметров фильтрации или с другими параметрами фильтрации для точной настройки результатов. Например, вы можете:

• Исключите пустые очереди.

• Исключите очереди во внешние назначения.

• Включите очереди с определенным значением DeliveryType.

Параметры Include и Exclude используют следующие свойства очередей для фильтрации:

Значение	Описание	Пример
DeliveryType	Включает или исключает очереди на основе свойства DeliveryType , которое определяет, как сообщение будет передаваться на следующий шаг. Допустимые значения описаны в NextHopSolutionKey. Вы можете указать несколько значений, разделив их запятыми.	Возвращает все очереди доставки на локальном сервере, где следующий переход — соединитель Send, размещенный на локальном сервере и настроенный для маршрутизации промежуточного узла. Get-Queue -Include SmartHostConnectorDelivery
Empty	Включает или исключает пустые очереди. Пустые очереди имеют значение 0 в свойстве MessageCount .	Возвращает все очереди на локальном сервере, содержащие сообщения. Get-Queue -Exclude Empty
External	Включает или исключает очереди, имеющие значение External в свойстве NextHopCategory . Свойство DeliveryType внешних очередей всегда имеет одно из следующих значений: DeliveryAgent DnsConnectorDelivery NonSmtpGatewayDelivery SmartHostConnectorDelivery Дополнительные сведения см. в разделе NextHopSolutionKey.	Возвращает все внутренние очереди на локальном сервере. Get-Queue -Exclude External
Internal	Это значение включает или исключает очереди, которые имеют значение Internal в свойстве NextHopCategory . Обратите внимание, что сообщению для внешнего получателя может потребоваться несколько внутренних прыжков, прежде чем оно достигнет сервера шлюза, где оно будет доставлено извне.	Возвращает все внутренние очереди на локальном сервере. Get-Queue -Include Internal

Обратите внимание, что можно дублировать функциональность параметров Include и Exclude с помощью параметра Filter . Например, следующие команды дают один и тот же результат:

• Get-Queue -Exclude Empty

• Get-Queue -Filter "MessageCount -gt 0"

Однако, как видите, синтаксис параметров Include и Exclude проще и легче запомнить.

Get-QueueDigest

Командлет Get-QueueDigest позволяет просматривать сведения о некоторых или всех очередях в организации с помощью одной команды. В частности, с помощью командлета Get-QueueDigest вы можете просмотреть информацию об очередях в зависимости от их расположения на серверах, в группах обеспечения доступности баз данных, на сайтах Active Directory или во всем лесу Active Directory.

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

Примечание.

По умолчанию командлет Get-QueueDigest отображает очереди доставки, содержащие десять или более сообщений, а результаты получают от одной до двух минут. Инструкции по изменению этих значений по умолчанию см. в разделе Настройка Get-QueueDigest.

В следующей таблице описаны параметры фильтрации и сортировки, доступные в командлете Get-QueueDigest .

Параметр	Описание
Dag, Server или Site	Эти параметры являются взаимоисключающими (не могут использоваться в одной команде) и задают области командлета. Вам нужно указать один из этих параметров или переключатель Forest . Как правило, используется имя сервера, группы обеспечения доступности баз данных или сайта Active Directory, но можно использовать любое значение, которое однозначно идентифицирует сервер, группу обеспечения доступности баз данных или сайт. Можно указать несколько серверов, групп обеспечения доступности баз данных или сайтов, разделенных запятыми.
Forest	Этот параметр необходим, если вы не используете параметры DAG, Server или Site . Значение для этого переключателя указать нельзя. С помощью этого переключателя можно получать очереди со всех серверов почтовых ящиков Exchange в локальном лесу Active Directory. Этот переключатель нельзя использовать для просмотра очередей в удаленных лесах Active Directory.
DetailsLevel	Normal используется по умолчанию. В результатах возвращаются следующие свойства: QueueIdentity ServerIdentity MessageCount Verbose Возвращает следующие дополнительные свойства в результатах: DeferredMessageCount LockedMessageCount* IncomingRate ИсходящийКурс Velocity NextHopDomain СледующаяHopCategory NextHopConnector Тип доставки* Состояние RiskLevel* ИсходящиеIPPool* LastError TlsDomain None пропускает имя очереди в столбце "Сведения " в результатах. * Эти свойства зарезервированы для внутреннего использования Майкрософт и не используются в локальных организациях Exchange. Дополнительные сведения обо всех свойствах в этом списке см. в разделе Свойства очереди.
Фильтр	Фильтруйте очереди на основе свойств очереди, как описано в разделе Параметр фильтрации командлетов очереди . Можно использовать любые фильтруемые свойства очереди, как описано в разделе "Свойства очереди ".
GroupBy	Группирует результаты очереди. Объединить результаты можно по одному из следующих свойств: DeliveryType (Тип доставки) LastError СледующаяHopCategory NextHopDomain NextHopKey Состояние ServerName По умолчанию результаты группируются по свойству NextHopDomain. Дополнительные сведения об этих свойствах очереди см. в разделе "Свойства очереди".
ResultSize	Ограничивает результаты очереди указанным значением. Очереди сортируются в порядке убывания в зависимости от количества сообщений в очереди и группируются по значению, указанному параметром GroupBy . Значение по умолчанию — 1000. Это значит, что по умолчанию команда отображает первую тысячу очередей, сгруппированных по свойству NextHopDomain и упорядоченных по убыванию числа сообщений в очереди.
Timeout	Этот параметр задает количество секунд до истечения времени ожидания операции. Значение по умолчанию: 00:00:10 10 секунд.

В этом примере возвращаются все непустые внешние очереди на серверах с именами Mailbox01, Mailbox02 и Mailbox03.

Get-QueueDigest -Server Mailbox01,Mailbox02,Mailbox03 -Include External -Exclude Empty

Параметры фильтрации сообщений

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

Командлет	Параметры фильтрации	Comments
Get-Message	Фильтр Identity Очередь Сервер	В одной команде нельзя использовать параметры "Фильтр", "Удостоверение" или "Очередь ". Параметр Server указывает сервер, на котором вы хотите выполнить команду. В одной команде можно использовать параметры Server и Filter .
Remove-Message Resume-Message Suspend-Message	Фильтр Identity Сервер	Необходимо использовать параметр Identity или параметр Filter , но их нельзя использовать в одной команде. Параметр Server указывает сервер, на котором вы хотите выполнить команду. В одной команде можно использовать параметры Server и Filter .
Redirect-Message	Сервер	Этот командлет drain активных сообщений из всех очередей доставки на указанном сервере, поэтому Server — единственный доступный параметр фильтрации. Дополнительные сведения см. в статье Перенаправление сообщений в очередях.
Export-Message	Identity	Этот параметр на самом деле не является фильтром, поскольку он однозначно идентифицирует сообщение. Чтобы определить несколько сообщений для этого командлета, используйте команду Get-Message и передайте результаты в Export-Message. Дополнительные сведения и примеры см. в разделе Экспорт сообщений из очередей.

Идентификатор сообщения

Параметр Identity в командлетах управления сообщениями однозначно идентифицирует сообщение в одной или нескольких очередях, поэтому использовать другие параметры фильтрации сообщений невозможно. Параметр Identity использует базовый синтаксис <Server>\<Queue>\<MessageInteger>.

В следующей таблице описан синтаксис, который можно использовать с параметром Identity в командлетах управления сообщениями.

**Значение параметра идентичности	Описание**
<Server>\<Queue>\<MessageInteger> или <Queue>\<MessageInteger>	Сообщение в определенной очереди на указанном или локальном сервере. <Queue> — идентификатор очереди, как описано в разделе Идентификатор очереди : Имя постоянной очереди: Имя очереди доставки. Номер очереди. Идентификатор теневой очереди. <MessageInteger> — это уникальное целочисленное значение, присваиваемое сообщению при его первом поступлении в базу данных очередей на сервере. Если сообщение отправляется нескольким получателям, которые используют множество очередей, все копии сообщения во всех очередях из базы данных очередей обладают одинаковым целочисленным номером. Однако чтобы найти это значение в свойствах Identity или MessageIdentity, необходимо запустить командлет Get-Message.
<Server>\*\<MessageInteger> или *\<MessageInteger> или <MessageInteger>	Все копии сообщения во всех очередях в базе данных очередей на указанном или локальном сервере.

Параметр фильтра в командлетах сообщений

Параметр Filter можно использовать с командлетами Get-Message, Remove-Message, Resume-Message и Suspend-Message для идентификации одного или нескольких сообщений на основе свойств сообщений. Параметр Filter создает OPath-фильтр с операторами сравнения, чтобы ограничить команду сообщениями, удовлетворяющими критериям фильтра. Логический оператор -and можно использовать для задания нескольких условий для соответствующего соответствия. Общий пример синтаксиса:

Get-Message -Filter "<Property1> -<ComparisonOperator> '<Value1>' -and <Property2> -<ComparisonOperator> '<Value2>'..."

Полный список свойств сообщения, которые можно использовать с параметром Фильтр, см. в разделе Свойства сообщения).

Список операторов сравнения, которые можно использовать с параметром Фильтр, см. в разделе Операторы сравнения, используемые при фильтрации очередей или сообщений , в этой статье.

Примеры процедур, использующих параметр Filter для просмотра сообщений и управления ими, см. в разделе Процедуры для сообщений в очередях.

Параметр Queue

Параметр Queue доступен только в командлете Get-Message. С помощью этого параметра можно получить все сообщения в определенной очереди или все сообщения из нескольких очередей с использованием подстановочного знака (*). При использовании параметра Queue используйте формат <Server>\<Queue> идентификатора очереди, как описано в разделе Идентификаторы очереди в этой статье.

Операторы сравнения, используемые при фильтрации очередей и сообщений

Когда вы создаете выражение фильтрации очередей или сообщений с помощью параметра Filter, следует добавить оператор сравнения для выбора нужного значения свойства. Операторы сравнения, которые можно использовать, и описание работы каждого из них описаны в следующей таблице. Для всех операторов регистр задаваемых значений не учитывается.

Оператор	Функция	Пример кода
-eq	Точное совпадение указанного значения.	Показать все очереди с состоянием "Повторить": Get-Queue -Filter "Status -eq 'Retry'" Показать все сообщения со статусом "Повторить": Get-Message -Filter "Status -eq 'Retry'"
-ne	Не соответствует указанному значению.	Показать все очереди, которые не имеют состояния "Активно": Get-Queue -Filter "Status -ne 'Active'" Показать все сообщения без статуса "Активно": Get-Message -Filter "Status -ne 'Active'"
-gt	Больше указанного целого значения или значения даты и времени.	Показать очереди, которые в настоящее время содержат более 1000 сообщений: Get-Queue -Filter "MessageCount -gt 1000" Показать сообщения, количество повторных попыток которых в настоящее время превышает 3: Get-Message -Filter "RetryCount -gt 3"
-ge	Больше или равно указанному целому значению или значению даты и времени.	Показать очереди, которые в настоящее время содержат 1000 или более сообщений: Get-Queue -Filter "MessageCount -ge 1000" Показать сообщения, количество повторных попыток которых в настоящее время равно 3 или более: Get-Message -Filter "RetryCount -ge 3"
-lt	Меньше указанного целого значения или значения даты и времени.	Показать очереди, которые в настоящее время содержат менее 1000 сообщений: Get-Queue -Filter "MessageCount -lt 1000" Показать сообщения с оценкой вероятности менее 6: Get-Message -Filter "SCL -lt 6"
-le	Значение меньше или равно заданному целому значению или значению даты и времени.	Показать очереди, которые в настоящее время содержат 1000 или менее сообщений: Get-Queue -Filter "MessageCount -le 1000" Показать сообщения с оценкой вероятности 6 или меньше: Get-Message -Filter "SCL -le 6"
-like	Содержит указанный текст. В текстовую строку необходимо включить подстановочный знак (*).	Показать очереди, имеющие назначение для любого домена SMTP, который заканчивается на Contoso.com: Get-Queue -Filter "Identity -like '*contoso.com'" Показывать сообщения с темой, содержащей текст "займ до зарплаты": Get-Message -Filter "Subject -like '*payday loan*'"

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

Этот пример отображает список очередей, назначениями которых являются любые имена SMTP-доменов, заканчивающихся на Contoso.com, и которые содержат более 500 сообщений.

Get-Queue -Filter "Identity -like '*contoso.com*' -and MessageCount -gt 500"

В этом примере отображается список сообщений, отправленных с любого адреса электронной почты в домене contoso.com со значением SCL больше 5.

Get-Message -Filter "FromAddress -like '*Contoso.com*' -and SCL -gt 5"

Расширенные параметры разбивки по страницам

При использовании командной консоли Exchange для просмотра очередей и сообщений в очередях запрос получает по одной странице информации за раз. Расширенные параметры подкачки управляют размером результатов и порядком их отображения. Все расширенные параметры разбиения на страницы являются необязательными и могут использоваться как с другими параметрами фильтрации, так и без них в командлетах Get-Queue и Get-Message . Если расширенные параметры разбивки по страницам не указываются, запрос возвращает результаты в порядке возрастания идентификаторов.

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

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

Дополнительные параметры подкачки описаны в следующей таблице.

Параметр	Описание
Индекс закладки	Указывает позицию в результатах, с которой начинаются отображаемые результаты. Значение этого параметра является индексом, основанным на 1 в общих результатах. Если значение меньше или равно 0, возвращается первая полная страница результатов. Если задано Int.MaxValueзначение , возвращается последняя полная страница результатов. Этот параметр нельзя использовать с параметром BookmarkObject .
Объект закладки	Указывает объект в результатах, с которого начинаются отображаемые результаты. Если указать объект закладки, этот объект используется в качестве пункта начала поиска. Извлекаются строки до или после этого объекта (в зависимости от значения параметра SearchForward ). Этот параметр нельзя использовать с параметром BookmarkIndex .
IncludeBookmark	Указывает, следует ли включать объект-закладку в результаты. Допустимые значения: $true: объект закладки включается в результаты. Это значение используется по умолчанию. $false: объект закладки не включается в результаты. Используйте это значение, когда вы выполняете запрос с ограниченным размером результата, а затем указываете последний элемент в качестве закладки для следующего запроса. Это предотвратит включение объекта-закладки в оба результата.
ResultSize	Количество результатов на странице. Если значение не указано, по умолчанию используется размер результатов, равный 1000 объектам. Exchange ограничивает количество результатов до 250 000.
ReturnPageInfo	Это скрытый параметр. Он возвращает сведения об общем числе результатов и индекс первого объекта текущей страницы. Значение по умолчанию — $false.
ПоискВперед	Определяет направление поиска. Закладка указана: поиск вперед или назад в результатах относительно индекса или объекта закладки. Закладка не указана: выполните поиск вперед или назад по результатам с первого или последнего элемента в результатах. Допустимые значения: $true: переход вперед от первого элемента в результатах или от указанной закладки. Если после закладки нет результатов, запрос возвращает последнюю полную страницу результатов. Это значение используется по умолчанию. $false: переход назад от последнего элемента в результатах или от указанной закладки. Если после закладки содержится меньше полной страницы результатов, запрос возвращает первую полную страницу результатов.
SortOrder	Задает свойства сообщения, которые определяют порядок сортировки результатов. Порядок указания свойств указывает на убывающий порядок приоритета (результаты сортируются по первому свойству, затем эти результаты сортируются по второму свойству и далее по нему). Этот параметр использует синтаксис: <+|-><Property1>,<+|-><Property2>..., где + сортирует свойство в порядке возрастания, а - сортирует свойство — в порядке убывания. Если этот параметр не используется, результаты сортируются по свойству Identity в порядке возрастания.

В этом примере показано, как использовать расширенные параметры разбиения на страницы в запросе. Команда возвращает первые 500 сообщений на указанном сервере. Результаты сначала сортируются по возрастанию по адресу отправителя, а затем по убыванию по размеру сообщения.

Get-Message -Server mailbox01.contoso.com -ResultSize 500 -SortOrder +FromAddress,-Size

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

1. Выполните следующую команду, чтобы получить первую страницу результатов.

   $Results=Get-Message -Server mailbox01.contoso.com -ResultSize 500 -SortOrder +FromAddress,-Size
   

2. Чтобы установить объект закладки, выполните следующую команду для сохранения последнего элемента первой страницы в переменной.

   $Temp=$Results[$results.length-1]
   

3. Чтобы получить следующие 500 объектов на указанном сервере и исключить объект-закладку, выполните следующую команду.

   Get-Message -Server mailbox01.contoso.com -BookmarkObject:$Temp -IncludeBookmark $false -ResultSize 500 -SortOrder +FromAddress,-Size