Применимо к: Exchange Server 2010 SP1
Последнее изменение раздела: 2011-03-19
Командлет Get-Message используется для просмотра сведений об одном или нескольких сообщениях в очереди на компьютере с установленной ролью транспортного сервера-концентратора или пограничного транспортного сервера.
Синтаксис
Get-Message [-BookmarkIndex <Int32>]
[-BookmarkObject <MessageInfo>] [-Filter <String>]
[-IncludeBookmark <$true | $false>]
[-IncludeComponentLatencyInfo <SwitchParameter>]
[-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>]
[-IncludeComponentLatencyInfo <SwitchParameter>]
[-IncludeRecipientInfo <SwitchParameter>] [-ResultSize
<Unlimited>] [-ReturnPageInfo <$true | $false>]
[-SearchForward <$true | $false>] [-SortOrder
<SortOrderEntry[]>]
|
Get-Message [-BookmarkIndex <Int32>]
[-BookmarkObject <MessageInfo>] [-IncludeBookmark <$true |
$false>] [-IncludeComponentLatencyInfo <SwitchParameter>]
[-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:
С помощью оператора сравнения and можно задать несколько критериев фильтра. Значения свойств, не выраженные в виде одиночного целого числа, должны заключаться в кавычки ("). |
||||||||
|
Identity |
Необязательный |
Microsoft.Exchange.Data.QueueViewer.MessageIdentity |
Параметр Identity указывает целочисленное значение MessageIdentity. Это целое число представляет определенное сообщение и, дополнительно, удостоверение сервера и очереди. Этот параметр имеет следующие варианты синтаксиса:
|
||||||||
|
IncludeBookmark |
Необязательный |
System.Boolean |
Параметр IncludeBookmark указывает, включается ли объект
закладок в отображаемые результаты запроса. Параметр
IncludeBookmark является допустимым, если используется с
параметрами BookmarkObject или BookmarkIndex. Если
значение для параметра IncludeBookmark не указано,
используется значение по умолчанию — |
||||||||
|
IncludeComponentLatencyInfo |
Необязательный |
System.Management.Automation.SwitchParameter |
Переключатель IncludeComponentLatencyInfo указывает, будут ли сведения о задержке компонентов включаться в свойства сообщения. Если используется этот переключатель, объекты сообщений будут включаться в измерения задержки для каждого компонента транспорта, который влияет на задержку локального сервера для каждого сообщения в очереди. |
||||||||
|
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 — 1 000. Параметр ResultSize поддерживает неограниченное количество результатов, но 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. |
||||||||
Подробное описание
Можно отобразить сообщения, включив имя сервера как часть параметра Identity или Queue или включив параметр Server с запросом фильтра. Параметры Identity, Queue и Filter являются взаимоисключающими.
Запись «Очереди» в разделе Разрешения транспорта.
Примеры
ПРИМЕР 1
В этом примере отображаются подробные сведения обо всех сообщениях, находящихся в очереди на локальном сервере и полученных от отправителей в домене contoso.com.
 Скопировать код |
|
|---|---|
Get-Message -Filter {FromAddress -like "*@contoso.com"} | Format-List
|
|
ПРИМЕР 2
В этом примере перечисляются все сообщения, находящихся в очереди на локальном сервере, полученные от отправителей в домене contoso.com и имеющие значение оценки нежелательной почты выше 3.
| Скопировать код |
|
|---|---|
Get-Message -Filter {FromAddress -like "*@contoso.com" -and SCL -gt 3}
|
|
ПРИМЕР 3
В этом примере отображаются все сообщения, находящиеся в очереди на сервере Server1. Результаты вначале сортируются в порядке возрастания адреса отправителя, а затем в порядке убывания размера.
| Скопировать код |
|
|---|---|
Get-Message -Server Server1.contoso.com -SortOrder: +FromAddress,-Size |
|