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

Параметры

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

BookmarkIndex

Дополнительно

System.Int32

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

BookmarkObject

Дополнительно

Microsoft.Exchange.Data.QueueViewer.MessageInfo

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

Filter

Дополнительно

System.String

Значением параметра Filter должно быть выражение, задающее критерии значений свойств для сообщений, которые требуется просмотреть. Выражение содержит имя свойства с оператором сравнения и значением. Следующие свойства сообщения — примеры допустимых критериев для параметра Filter:

  • DateReceived.   Дата получения сообщения.

  • ExpirationTime.   Время окончания действия сообщения.

  • FromAddress.   SMTP-адрес отправителя сообщения. Данное значение извлекается из поля MAIL FROM: на конверте сообщения.

  • Identity.   Целое число, представляющее определенное сообщение и (необязательно) удостоверение сервера и очереди.

  • InternetMessageId — значение поля заголовка Message-ID:. Значение этого свойства имеет вид идентификатора GUID, за которым следует SMTP-адрес сервера-отправителя, как в следующем примере: 67D7543D6103DC4FBEBA6BC7205DACABA61231@exchange.contoso.com.

  • LastError.   Текстовая строка последней ошибки, записанной для сообщения.

  • MessageSourceName.   Текстовая строка, содержащая название компонента, который занес это сообщение в очередь.

  • Queue.   Удостоверение очереди, в которой находится сообщение. Введите удостоверение очереди в форме сервер\адресат, где адресат представляет удаленный домен, почтовый сервер или постоянное название очереди.

  • RetryCount.   Количество выполненных попыток доставки сообщения адресату.

  • SCL.   Свойство SCL задает уровень вероятности нежелательной почты сообщения. Допустимыми значениями SCL являются целые числа в диапазоне от 0 до 9. Отсутствие значения свойства SCL свидетельствует о том, что сообщение не было обработано агентом фильтра содержимого.

  • Size.   Размер сообщения.

  • SourceIP.   IP-адрес внешнего сервера, который доставил сообщение в организацию Exchange.

  • Status.   Текущее состояние сообщения. Возможными значениями являются «Active», «Retry», «Suspended», «PendingSuspend» и «PendingRemove».

  • Subject.   Текстовая строка, представляющая тему сообщения электронной почты. Данное значение извлекается из поля Subject:.

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

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

Дополнительно

Microsoft.Exchange.Data.QueueViewer.MessageIdentity

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

  • сервер\удостоверение_очереди\удостоверение_сообщения

  • удостоверение_очереди\удостоверение_сообщения

  • сервер\*\удостоверение_сообщения

  • удостоверение_сообщения

IncludeBookmark

Дополнительно

System.Boolean

Параметр IncludeBookmark служит для указания необходимости включения объекта закладки в отображаемые результаты запроса. Параметр IncludeBookmark является допустимым, если используется с параметрами BookmarkObject или BookmarkIndex. Если значение для параметра IncludeBookmark не указано, используется значение по умолчанию $true.

IncludeRecipientInfo

Дополнительно

System.Management.Automation.SwitchParameter

Используйте параметр IncludeRecipientInfo, чтобы отобразить получателей сообщения в поле «Получатели». Если параметр IncludeRecipientInfo не включен, поле «Получатели» остается пустым.

Сохранение результатов выполнения команды Get-Message -IncludeRecipientInfo в переменной позволяет отобразить дополнительные свойства получателя сообщения. В следующем списке перечислены доступные свойства получателя:

  • Адрес Адрес электронной почты получателя.

  • Тип Тип получателя может быть «Внешний», «Почтовый ящик» или «Списки рассылки». Тип «Списки рассылки» используется, когда назначением является сервер расширения.

  • КонечноеНазначение Различающееся имя объекта, которое используется для маршрутизации сообщения. Этот объект не может быть соединителем, сервером почтовых ящиков или сервером расширения.

  • Состояние Состояние получателя может быть «Завершено», «Готово» или «Повторить».

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

Например, чтобы сохранить сведения о получателе сообщения в удаленной очереди доставки «Contoso.com», которая имеет значение MessageIdentity 1234, в переменную с именем $x, используйте следующую команду:

Копировать код 
$x=Get-Message -Identity "Contoso.com\1234" -IncludeRecipientInfo

Чтобы отобразить расширенные свойства получателя, которые теперь сохранены в переменной $x, используйте следующую команду:

Копировать код 
$x.Recipients

Queue

Дополнительно

Microsoft.Exchange.Data.QueueViewer.QueueIdentity

Параметр Queue используется для указания удостоверения очереди, содержащей сообщения, которые нужно отобразить. Введите удостоверение очереди в форме сервер\адресат, где адресат представляет удаленный домен, почтовый сервер или постоянное название очереди.

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), на котором располагаются очереди, содержащие отображаемые сообщения. Введите параметр Server как имя сервера или полное имя домена (FQDN). Если этот параметр не используется, выполняется запрос на локальном сервере.

SortOrder

Дополнительно

Microsoft.Exchange.Configuration.Tasks.SortOrderEntry[]

Параметр SortOrder служит для указания массива свойств сообщений, используемых для управления порядком сортировки результирующего набора. Каждое свойство отделяется запятой. Чтобы результаты отображались в порядке возрастания, добавьте к началу имени свойства символ +. Чтобы результаты отображались в порядке убывания, добавьте к началу имени свойства символ -. Если порядок сортировки не указан, результирующий набор отображается в порядке возрастания значения MessageIdentity.

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

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

Для выполнения командлета Get-Message используемой учетной записи необходимо делегировать роль администратора сервера Exchange Server.

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

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

Пример

В следующем примере показано, как отобрать сообщения с помощью команды 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