Get-Message
Применимо к: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Последнее изменение раздела: 2007-08-29
Командлет Get-Message используется для просмотра сведений об одном или нескольких сообщениях в очереди на компьютере с установленной ролью транспортного сервера-концентратора или пограничного транспортного сервера.
Синтаксис
Get-Message [-BookmarkIndex <Int32>] [-BookmarkObject <MessageInfo>] [-Filter <String>] [-IncludeBookmark <$true | $false>] [-IncludeRecipientInfo <SwitchParameter>] [-ResultSize <Unlimited>] [-ReturnPageInfo <$true | $false>] [-SearchForward <$true | $false>] [-Server <ServerIdParameter>] [-SortOrder <SortOrderEntry[]>]
Get-Message [-Identity <MessageIdentity>] [-BookmarkIndex <Int32>] [-BookmarkObject <MessageInfo>] [-IncludeBookmark <$true | $false>] [-IncludeRecipientInfo <SwitchParameter>] [-ResultSize <Unlimited>] [-ReturnPageInfo <$true | $false>] [-SearchForward <$true | $false>] [-SortOrder <SortOrderEntry[]>]
Get-Message [-BookmarkIndex <Int32>] [-BookmarkObject <MessageInfo>] [-IncludeBookmark <$true | $false>] [-IncludeRecipientInfo <SwitchParameter>] [-Queue <QueueIdentity>] [-ResultSize <Unlimited>] [-ReturnPageInfo <$true | $false>] [-SearchForward <$true | $false>] [-SortOrder <SortOrderEntry[]>]
Подробное описание
Командлет Get-Message отображает данные одного или нескольких сообщений в существующей очереди на транспортном сервере-концентраторе или пограничном транспортном сервере. Без параметров команда отбирает все сообщения из всех очередей на локальном сервере и возвращает общую страницу результатов. По умолчанию страница содержит 1000 объектов. Можно также просмотреть сообщения на удаленном сервере. Для этого нужно включить имя сервера в параметр Identity или Queue или добавить параметр Server в фильтр запроса. Параметры Identity, Queue и Filter являются взаимно исключающими.
Для выполнения командлета Get-Message используемой учетной записи необходимо делегировать роль администратора Exchange Server.
Чтобы выполнить командлет Get-Message на компьютере с установленной ролью пограничного транспортного сервера, необходимо войти в систему, используя учетную запись, являющуюся членом локальной группы «Администраторы» данного компьютера.
Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования сервера Microsoft Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.
Параметры
Параметр | Обязательный | Тип | Описание |
---|---|---|---|
BookmarkIndex |
Необязательный |
System.Int32 |
Параметр BookmarkIndex используется для указания позиции в наборе результатов, с которой начинаются отображаемые результаты. Значение этого параметра — индекс в общем наборе результатов с отсчетом от единицы. Параметр BookmarkIndex не может использоваться с параметром BookmarkObject. |
BookmarkObject |
Необязательный |
Microsoft.Exchange.Data.QueueViewer.MessageInfo |
Параметр BookmarkObject используется для указания объекта в наборе результатов, с которого начинаются отображаемые результаты. Параметр BookmarkObject не может использоваться с параметром BookmarkIndex. |
Filter |
Необязательный |
System.String |
Значением параметра Filter должно быть выражение, задающее критерии значений свойств для сообщений, которые требуется просмотреть. Выражение содержит имя свойства с оператором сравнения и значением. Следующие свойства сообщения — примеры допустимых критериев для параметра Filter:
С помощью оператора сравнения - and можно задать несколько критериев фильтра. Значения свойств, не выраженные в виде целого числа, должны заключаться в кавычки. |
Identity |
Необязательный |
Microsoft.Exchange.Data.QueueViewer.MessageIdentity |
Параметр Identity используется для задания целого числа MessageIdentity. Это целое число представляет определенное сообщение и, дополнительно, удостоверение сервера и очереди. Этот параметр имеет следующие варианты синтаксиса:
|
IncludeBookmark |
Необязательный |
System.Boolean |
Параметр IncludeBookmark используется для указания необходимости включения в отображаемые результаты запроса объекта закладки. Параметр IncludeBookmark является допустимым, если используется с параметрами BookmarkObject или BookmarkIndex. Если значение для параметра IncludeBookmark не указано, используется значение по умолчанию |
IncludeRecipientInfo |
Необязательный |
System.Management.Automation.SwitchParameter |
Используйте параметр IncludeRecipientInfo, чтобы отобразить получателей сообщения в поле «Получатели». Если параметр IncludeRecipientInfo не включен, поле «Получатели» остается пустым. Сохранение результатов выполнения команды Get-Message -IncludeRecipientInfo в переменной позволяет отобразить дополнительные свойства получателя сообщения. В следующем списке перечислены доступные свойства получателя:
Например, чтобы сохранить сведения о получателе сообщения в удаленной очереди доставки «Contoso.com», которая имеет значение
Чтобы отобразить расширенные свойства получателя, которые теперь сохранены в переменной
|
Queue |
Необязательный |
Microsoft.Exchange.Data.QueueViewer.QueueIdentity |
Параметр Queue используется для указания удостоверения очереди, содержащей сообщения, которые нужно отобразить. Введите удостоверение очереди в форме сервер\адресат, где адресат представляет удаленный домен, почтовый сервер или постоянное название очереди. |
ResultSize |
Необязательный |
Microsoft.Exchange.Data.Unlimited |
Параметр ResultSize используется для указания общего количества элементов, которые нужно отобразить в наборе результатов. Значение по умолчанию параметра ResultSize — 1000. ResultSize поддерживает неограниченное количество результатов, но Microsoft Exchange устанавливает для набора результатов ограничение в 250 000 объектов. |
ReturnPageInfo |
Необязательный |
System.Boolean |
ReturnPageInfo является скрытым параметром. Он используется для получения сведений об общем количестве результатов и индекса первого объекта текущей страницы. Значение по умолчанию — |
SearchForward |
Необязательный |
System.Boolean |
Параметр SearchForward используется для указания направления поиска в наборе результатов вперед или назад. Значение по умолчанию — |
Server |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Параметр Server задает имя сервера для подключения с использованием удаленного вызова процедур (RPC), на котором располагаются очереди, содержащие отображаемые сообщения. Введите параметр Server как имя сервера или полное имя домена (FQDN). Если этот параметр не используется, выполняется запрос на локальном сервере. |
SortOrder |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.SortOrderEntry[] |
Параметр SortOrder используется для указания массива свойств сообщений, используемых для управления порядком сортировки набора результатов. Каждое свойство отделяется запятой. Чтобы результаты отображались в порядке возрастания, добавьте к началу имени свойства символ +. Чтобы результаты отображались в порядке убывания, добавьте к началу имени свойства символ -. Если порядок сортировки не указан, результирующий набор отображается в порядке возрастания значения MessageIdentity. |
Пример
В следующем примере показано, как отобрать сообщения с помощью команды Get-Message. В первом примере показано, как отобразить все сообщения, занесенные в очередь на локальном сервере и полученные от любого отправителя в заданном домене. Эта команда передается в команду Format-List для форматирования результатов в виде подробного списка.
Во втором примере показано, как отобразить все сообщения, занесенные в очередь на локальном сервере, полученные от любого отправителя в заданном домене и имеющие значение уровня нежелательной почты больше 3.
В третьем примере показано, как подключиться к удаленному серверу и затем отобразить все сообщения, занесенные в очередь на удаленном сервере, в заданном порядке сортировки. Результаты вначале сортируются в порядке возрастания адреса отправителя, а затем в порядке убывания размера.
Дополнительные сведения о конвейеризации см. в разделе Конвейеризация.
Дополнительные сведения о работе с выходными данными команды см. в разделе Работа с возвращаемыми данными команды.
Дополнительные сведения об использовании среды управления Exchange для выполнения задач просмотра очереди см. в разделе Использование среды управления Exchange для управления очередями.
Get-Message -Filter {FromAddress -like "*@contoso.com"} | format-list
Get-Message -Filter {FromAddress -like "*@contoso.com" -and SCL -gt 3}
Get-Message -Server exchange.contoso.com -SortOrder: +FromAddress,-Size