Поделиться через


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:

  • 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 можно задать несколько критериев фильтра. Значения свойств, не выраженные в виде целого числа, должны заключаться в кавычки.

Identity

Необязательный

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