Параметр Identity применяется, когда конкретное сообщение (или очередь), которое требуется просмотреть или над которым выполняется действие, известно. Поиск по идентификатору выполняется быстрее, чем форматирование такого же запроса в виде фильтра. Имя сервера может быть представлено как имя узла или полное имя домена. Можно ввести имя удаленного сервера как часть идентификатора, чтобы инициировать подключение удаленного вызова процедуры к серверу, к которому может адресоваться запрос об очередях на этом сервере. Если имя сервера не указывается, по умолчанию используется локальный узел. Когда идентификатор предоставляется для изменяющего действия, идентифицируемый объект должен быть полностью определен и должен быть уникальным. Если идентификатор не определен явно, действие не выполняется. Если в идентификаторе опустить серверную часть, по умолчанию используется локальный компьютер.

При использовании параметра «Identity» в командлете Get-Queue или Get-Message параметр «Identity» поддерживает использование подстановочных выражений.

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

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

Задачи, решаемые для очередей, поддерживают использование параметра Filter, позволяющего задавать критерии, в соответствии с которыми извлекаются очереди и сообщения. Свойства очередей и сообщений используются в качестве условий отбора. Создайте фильтр, чтобы отобразить ограниченный набор очередей или сообщений. После обнаружения очередей и сообщений, которые требуется проконтролировать, можно просмотреть сведения о свойствах каждого объекта. Эти сведения полезны при устранении проблем в почтовом потоке.

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

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

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

• Фильтрация очередей
  
  
• Фильтрация сообщений
  
  

Параметр Queue используется только с командами сообщений. Данный параметр применяется для указания идентификатора очереди, из которой извлекаются сообщения. Если очередь задана, извлекаются все сообщения из этой очереди. Это позволяет извлечь все сообщения из некоторой очереди без необходимости использовать выражение фильтра. Используя подстановочный знак, можно извлекать сообщения из нескольких выражений. Применяйте формат идентификатора очереди из таблицы 2, когда используете параметр Queue вместе с командой сообщения. Следующий пример кода показывает, как использовать параметр Queue в командлете Get-Message. В этом примере получают набор результатов, содержащий только те сообщения, которые расположены на указанном сервере и находятся в очереди на доставку в SMTP-домен «Contoso.com»:

Get-message -Queue Server\Contoso.com

В зависимости от текущего почтового потока запросы очередей и сообщений могут возвращать очень большой набор объектов. Для управления извлечением и отображением результатов запросов можно использовать расширенные параметры страниц.

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

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

В таблице 4 описываются расширенные параметры страниц.

Таблица 4.   Расширенные параметры страниц

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

Get-message -Server Exchange.Contoso.com -ResultSize 500 -SortOrder +FromAddress,-Size

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

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

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

   	Копировать код
   $Results=Get-message -Server Exchange.Contoso.com -ResultSize 500 -SortOrder +FromAddress,-Size

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

   	Копировать код
   $temp=$results[$results.length-1]

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

   	Копировать код
   Get-message -Server Exchange.Contoso.com -BookmarkObject:$temp -IncludeBookmark $False -ResultSize 500 -SortOrder +FromAddress,-Size