Применимо к: Exchange Server 2010 SP1
Последнее изменение раздела: 2009-12-07
В этом разделе объясняются способы использования командлетов и наборов параметров в командной консоли Exchange для создания запроса, получения результатов и внесения изменений. Дополнительные сведения о задачах, решаемых для очередей, и их применении для контроля и устранения неполадок см. в разделе Общие сведения об очередях транспорта.
В Microsoft Exchange Server 2010 можно использовать командную консоль для выполнения задач управления и настройки, а также для создания сценариев с целью автоматизации задач. Командную консоль можно также использовать для просмотра сведений об очередях на сервере и о сообщениях в этих очередях, а также для управления очередями и сообщениями. Эти операции полезны для устранения неполадок в почтовом потоке и для идентификации нежелательной почты. Дополнительные сведения об использовании командной консоли см. в разделе Командная консоль Exchange.
Необходимы сведения о задачах управления, связанных с очередями? См. раздел Управление транспортными очередями.
Содержание
Управление очередями и сообщениями
Наборы параметров задач, решаемых для очередей
Управление очередями и
сообщениями
Задачи, решаемые для очередей, группируются в две категории:
- Действия по просмотру позволяют отображать очереди и сообщения,
находящиеся в очередях на сервере, и выбирать порядок группировки и
сортировки данных при их отображении.
- Действия по модификации изменяют состояние очередей и
сообщений.
При выполнении задач обоих типов доступ к данным осуществляется путем подключения к транспортному рабочему процессу с помощью удаленного вызова процедур (RPC).
По умолчанию для выполнения задач средство просмотра очереди подключается к той базе данных очередей, которая находится на том сервере, к которому подключается средство. Однако можно подключиться к другому серверу, отличному от того, на котором выполняются задачи средства просмотра очереди.
Дополнительные сведения о транспортном процессе Exchange 2010 см. в разделе Общие сведения о конвейере транспорта. Дополнительные сведения об использовании командной консоли для просмотра очередей и сообщений см. в разделах Просмотр очередей и Просмотр свойств очереди сообщений.
Командлеты для очередей
В следующей таблице перечислены командлеты, которые доступны в командной консоли для управления очередями и сообщениями в очередях. Дополнительные сведения о применении каждого командлета см. в разделах справки, указанных в столбце Дополнительные сведения.
Командлеты очереди
| Командлет | Применение | Дополнительные сведения |
|---|---|---|
|
Export-Message |
Этот командлет сохраняет копию сообщения в файле, указываемом администратором. |
|
|
Get-Message |
Этот командлет отображает подробные сведения о сообщениях, которые в текущий момент находятся в очереди для доставки. Командлет Get-Message может использоваться для извлечения набора сообщений и последующей конвейерной передачи результатов выполнения командлета в один из других командлетов управления сообщениями. |
|
|
Get-Queue |
Этот командлет отображает сведения о конфигурации очередей на транспортных серверах. Командлет Get-Queue может использоваться для извлечения набора очередей и последующей конвейерной передачи результатов выполнения командлета в один из командлетов управления очередями. |
|
|
Remove-Message |
Этот командлет удаляет сообщение из очереди. Можно выбрать, следует ли отправлять отчет о недоставке. |
|
|
Resume-Message |
Этот командлет возобновляет доставку ранее приостановленного сообщения. Можно также использовать командлет Resume-Message, чтобы повторно отправить сообщения, находящиеся в очереди подозрительных сообщений, обратно в очередь отправки для повторной обработки классификатором. |
|
|
Resume-Queue |
Этот командлет возобновляет доставку сообщений из ранее приостановленной очереди. |
|
|
Retry-Queue |
Этот командлет выполняет попытку подключения для очереди, имеющей в текущий момент состояние «Retry». Данная попытка подключения заменяет следующую плановую попытку. Командлет Retry-Queue можно также использовать вместе с параметром Resubmit для отправки сообщений, находящихся в очередях доставки или в недоступной очереди, в очередь отправки для повторной обработки классификатором. |
|
|
Suspend-Message |
Этот командлет приостанавливает доставку сообщения, которое находится в очереди на транспортном сервере Exchange 2010. |
|
|
Suspend-Queue |
Этот командлет приостанавливает исходящие действия для очереди на транспортном сервере Exchange 2010. |
Наборы параметров задач,
решаемых для очередей
Задачи, решаемые для очередей, поддерживают несколько наборов параметров. Существуют следующие наборы таких параметров: «Identity», «Filter» и «Queue». В команде не допускается объединение наборов параметров «Identity», «Filter» и «Queue». Набор параметров «Filter» доступен только с командами сообщений.
Можно также использовать расширенные параметры разбивки по страницам, которые доступны в командной консоли в сочетании с наборами параметров «Identity», «Filter» и «Queue». Расширенные параметры разбивки по страницам используются в командлетах Get-Message и Get-Queue для управления сортировкой и отображением набора результатов. Расширенные параметры разбивки по страницам описываются далее в этом разделе в таблице в подразделе «Расширенные параметры страниц».
Набор параметров «Identity», «Filter» или «Queue» следует применять при использовании команды, которая изменяет сообщения или очереди. Если никакие параметры не указаны, командлеты Get-Message и Get-Queue отображают все объекты сообщений и очередей, существующие на локальном сервере.
Если набор результатов для запроса очереди или сообщения содержит более 250 000 элементов, возникает ошибка и выводится запрос на применение фильтра для уменьшения количества результатов.
Параметр «Identity»
Параметр Identity применяется, когда известно конкретное сообщение (или очередь), которое требуется просмотреть или выполнить над ним действие. Поиск по идентификатору выполняется быстрее, чем форматирование такого же запроса в виде фильтра.
Имя сервера может быть представлено как имя узла или полное имя домена. Можно ввести имя удаленного сервера как часть идентификатора, чтобы инициировать подключение удаленного вызова процедуры к серверу, к которому может адресоваться запрос об очередях на этом сервере. Если имя сервера не указывается, по умолчанию используется локальный узел.
Когда предоставляется идентификатор для внесения изменения, идентифицируемый объект должен быть полностью определен и быть уникальным. Если идентификатор не определен явно, действие не выполняется. Если в идентификаторе опустить серверную часть, по умолчанию используется локальный компьютер.
При использовании параметра Identity в командлете Get-Queue или Get-Message параметр Identity поддерживает использование подстановочных выражений.
Идентификатор очереди
Постоянные очереди имеют уникальные имена и могут указываться по имени. Очередям доставки назначаются уникальные идентификаторы баз данных. Этот идентификатор базы данных можно использовать для указания очереди, можно также для указания очереди использовать имя места назначения доставки. Чтобы выполнить операцию над очередью путем указания ее уникального идентификатора базы данных, необходимо вначале выполнить командлет Get-Queue. Идентификатор базы данных будет возвращен в результатах выполнения команды. Допустимые форматы идентификаторов для очередей показаны в следующей таблице.
Форматы идентификатора очереди
| Формат идентификатора очереди | Применение |
|---|---|
|
Server\QueueJetID (Int64) |
Полный уникальный идентификатор для очереди доставки. |
|
\QueueJetID |
Идентификатор очереди на локальном сервере. Имя сервера опущено. Поэтому по умолчанию используется локальный сервер. |
|
Server\* |
Любая очередь на указанном сервере. |
|
Server\NextHopDomain |
Очередь на указанном сервере, в которой находятся сообщения для доставки в заданный удаленный домен. |
|
\NextHopDomain |
Расположенная на локальном сервере очередь, в которой находятся сообщения, предназначенные для указанного домена. |
|
Server\Poison |
Очередь подозрительных сообщений, которая находится на указанном сервере. |
|
Server\Submission |
Очередь, которая содержит элементы, ожидающие обработки классификатором. |
|
Server\Unreachable |
Расположенная на указанном сервере очередь, содержащая элементы, которые невозможно маршрутизировать. |
Следующий код служит примером использования идентификатора очереди в командлете Get-Queue. В этом примере возвращается список всех очередей, содержащих сообщения для доставки в SMTP-домены, имена которых заканчиваются на Contoso.com. В данном примере выполняется также форматирование набора результатов в виде подробного списка:
Get-Queue -Identity Server\*Contoso.com |
format-list
Идентификатор сообщения
Идентификатор сообщения — это совокупность уникального почтового элемента базы данных и идентификатора очереди. Идентификатор в виде целого числа присваивается сообщению, когда сообщение поступает в базу данных расширенного обработчика хранилищ (ESE) (прежнее название — Jet) для очередей, и это число добавляется к идентификатору очереди для создания идентификатора сообщения.
Чтобы выполнить операцию над сообщением путем указания ее уникального идентификатора базы данных, необходимо вначале выполнить командлет Get-Message. Идентификатор возвращается в результатах выполнения команды. Если требуется подключиться к удаленному серверу, можно включить имя сервера как часть идентификатора сообщения. Если имя сервера опускается, по умолчанию используется локальный сервер.
Сообщение, отправляемое нескольким получателям, может находиться в нескольких очередях. Можно использовать подстановочный знак, чтобы указать, что сообщение необходимо найти во всех очередях, в которые направлялось сообщение. Следующая таблица содержит примеры допустимых идентификаторов сообщений.
Форматы идентификатора сообщения
| Формат идентификатора сообщения | Применение |
|---|---|
|
Server\QueueJetId\MessageJetID |
Полное обозначение сообщения в очереди. |
|
Server\Poison\MessageJetID |
Сообщение, которое находится в очереди подозрительных сообщений. |
|
MessageJetID |
Все сообщения, имеющие этот идентификатор базы данных и маршрутизированные в какую-либо очередь на локальном сервере (одно сообщение направляется в несколько очередей). |
|
Server\*\MessageJetID |
Все сообщения, имеющие этот идентификатор базы данных и маршрутизированные в какую-либо очередь на указанном сервере. |
Следующий код служит примером использования идентификатора сообщения в командлете Get-Message. В этом примере возвращается список всех сообщений, имеющих указанный идентификатор и находящихся в какой-либо очереди на заданном сервере. В этом примере выполняется также форматирование набора результатов в виде подробного списка.
Get-message -Identity Server\*\1234 |
Format-List
Параметр «Filter»
Задачи, решаемые для очередей, поддерживают использование параметра Filter, позволяющего задавать критерии, в соответствии с которыми извлекаются очереди и сообщения. Свойства очередей и сообщений используются в качестве условий отбора. Создайте фильтр, чтобы отобразить ограниченный набор очередей или сообщений. После обнаружения очередей и сообщений, которые требуется проконтролировать, можно просмотреть сведения о свойствах каждого объекта. Эти сведения полезны при устранении проблем в почтовом потоке.
Параметр Filter используется для добавления в выражение логических операторов и операторов отношения, чтобы на экране отображались только объекты очереди или сообщения, которые соответствуют условиям фильтра. Логический оператор -and можно использовать для указания нескольких условий, которым должны соответствовать результаты. Если применяется оператор -and, то отображаться будут только объекты, соответствующие всем заданным условиям выражения. Для указания условий фильтра используется подмножество свойств сообщения или очереди. При указании свойства это должно быть допустимое свойство объекта, для которого составляется запрос, а значение, для которого ищется соответствие, должно быть выражено с помощью правильного синтаксиса. Если выражение для значения свойства не является одиночным целым числом, убедитесь, что значение заключено в кавычки.
Параметр Server может включаться в команду вместе с параметром Filter. Параметр Server применяется для указания имени узла или имени FQDN для сервера, к которому требуется подключиться, используя удаленный вызов процедуры, чтобы запросить очереди и сообщения на этом сервере и извлечь набор результатов.
Дополнительные сведения о свойствах, которые могут использоваться для фильтрации, о правильном синтаксисе для этих свойств и о поддерживаемых операторах см. в следующих разделах:
Параметр «Queue»
Параметр Queue используется только с командами сообщений. Данный параметр применяется для указания идентификатора очереди, из которой извлекаются сообщения. Если очередь задана, извлекаются все сообщения из этой очереди. Это позволяет извлечь все сообщения из некоторой очереди без необходимости использовать выражение фильтра. Используя подстановочный знак, можно извлекать сообщения из нескольких выражений.
При использовании параметра Queue в команде сообщения используйте формат идентификатора очереди из таблицы в подразделе «Идентификатор очереди» выше в этом разделе. Следующий пример кода показывает, как использовать параметр Queue в командлете Get-Message. В этом примере показано получение набора результатов, содержащего только те сообщения, которые расположены на указанном сервере и находятся в очереди на доставку в SMTP-домен Contoso.com.
Get-message -Queue Server\Contoso.com
Расширенные параметры разбивки по страницам
В зависимости от текущего потока почты запросы к очередям и сообщениям могут возвращать очень большой набор объектов. Для управления извлечением и отображением результатов запросов можно использовать расширенные параметры страниц.
При использовании командной консоли для просмотра очередей и сообщений, находящихся в очередях, запрос за один раз извлекает одну страницу данных. Расширенные параметры страниц управляют размером набора результатов и могут также применяться для сортировки результатов. Все расширенные параметры разбивки по страницам применяются по мере необходимости и могут комбинироваться с любым из наборов параметров, которые используются в командлетах Get-Queue и Get-Message. Если расширенные параметры разбивки по страницам не указываются, запрос возвращает результаты в порядке возрастания идентификаторов.
По умолчанию при указании порядка сортировки свойство идентификатора сообщения всегда включается и сортируется в порядке возрастания. Данное отношение порядка применяется по умолчанию. Свойство идентификатора сообщения включается, поскольку другие свойства, которые могут включаться в порядок сортировки, не являются уникальными. Посредством явного включения свойства идентификации сообщения в порядок сортировки можно указать, что результаты должны отображать идентификаторы сообщений, отсортированные в порядке убывания.
С помощью параметров BookmarkIndex и BookmarkObject можно отметить позицию в отсортированном наборе результатов. Если при извлечении следующей страницы результатов объект закладки больше не существует, отношение порядка по умолчанию гарантирует, что набор результатов будет начинаться с объекта, расположенного ближе остальных к закладке. Ближайший объект определяется указанным порядком сортировки.
В следующей таблице описываются расширенные параметры разбивки по страницам.
Расширенные параметры разбивки по страницам
| Параметр | Описание |
|---|---|
|
BookmarkIndex |
Параметр BookmarkIndex задает позицию в наборе результатов, с которой начинается отображение результатов. Значение параметра BookmarkIndex — индекс в общем наборе результатов с отсчетом от единицы. Если значение меньше или равно 0, возвращается первая полная страница результатов. Если значение установлено равным Int.MaxValue, возвращается последняя полная страница результатов. |
|
BookmarkObject |
Параметр BookmarkObject задает в наборе результатов объект, с которого начинается отображение результатов. Если указать объект закладки, этот объект используется в качестве пункта начала поиска. В зависимости от значения параметра SearchForward извлекаются строки, расположенные до или после этого объекта. В одиночном запросе не допускается объединение параметров BookmarkObject и BookmarkIndex. |
|
IncludeBookmark |
Параметр IncludeBookmark указывает, должен ли включаться
объект закладки в набор результатов. По умолчанию для этого
параметра устанавливается значение |
|
ResultSize |
Параметр ResultSize указывает число результатов, выводимых на каждой странице. Если значение не указано, по умолчанию используется размер результатов, равный 1000 объектам. Exchange 2010 ограничивает набор результатов до 250 000. |
|
ReturnPageInfo |
ReturnPageInfo — это скрытый параметр. Он возвращает
сведения об общем числе результатов и индекс первого объекта
текущей страницы. По умолчанию используется значение
|
|
SearchForward |
Параметр SearchForward указывает, должен ли поиск в наборе результатов выполняться вперед или назад. Этот параметр не влияет на порядок, в котором возвращается набор результатов. Он определяет направление поиска относительно индекса или объекта закладки. Если не задан ни индекс, ни объект закладки, параметр SearchForward указывает, будет ли поиск начинаться с первого или последнего объекта в наборе результатов. По умолчанию для этого параметра используется значение
Если параметр SearchForward установлен равным
|
|
SortOrder |
Параметр SortOrder указывает массив свойств сообщений, которые используются для управления порядком сортировки набора результатов. Свойства порядка сортировки задаются в порядке убывания старшинства. Каждое свойство отделяется запятой и дополняется знаком плюс (+) для сортировки в порядке возрастания или знаком минус (-) для сортировки в порядке убывания. Если с помощью этого параметра не указан явный порядок сортировки, то записи, соответствующие условиям запроса, отображаются и сортируются по полю «Identity» соответствующего типа объекта. Если порядок сортировки не задан в явном виде, результаты всегда сортируются по идентификатору в порядке возрастания. |
В следующем примере кода показано, как использовать в запросе расширенные параметры страниц. В данном примере команда выполняет подключение к указанному серверу и извлекает набор результатов, содержащий 500 объектов. Результаты отображаются отсортированными сначала в порядке возрастания адреса отправителя, а затем в порядке убывания размера сообщения.
Get-message -Server Exchange.Contoso.com
-ResultSize 500 -SortOrder +FromAddress,-Size
Если требуется просмотреть последующие страницы, можно установить закладку для последнего извлеченного объекта в наборе результатов и выполнить дополнительный запрос. Для выполнения этой процедуры необходимо использовать возможности работы со сценариями в командной консоли.
В следующем примере с помощью сценария извлекается первая страница результатов, устанавливается объект закладки, исключается объект закладки из набора результатов, и затем извлекаются следующие 500 объектов на указанном сервере.
- Откройте командную консоль и введите следующую команду, чтобы
извлечь первую страницу результатов.
Скопировать код$Results=Get-message -Server Exchange.Contoso.com -ResultSize 500 -SortOrder +FromAddress,-Size
- Чтобы установить объект закладки, введите следующую команду для
сохранения последнего элемента первой страницы в переменной.
Скопировать код$temp=$results[$results.length-1]
- Чтобы извлечь следующие 500 объектов на указанном сервере и
исключить объект закладки, введите следующую команду.
Скопировать кодGet-message -Server Exchange.Contoso.com -BookmarkObject:$temp -IncludeBookmark $False -ResultSize 500 -SortOrder +FromAddress,-Size