Командлет Get-Message (окончательная первоначальная версия)

 

Применимо к: Exchange Server 2007 SP1, Exchange Server 2007

Последнее изменение раздела: 2007-08-06

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