Get-Message

Синтаксис

Get-Message
   [-Filter <String>]
   [-BookmarkIndex <Int32>]
   [-BookmarkObject <ExtensibleMessageInfo>]
   [-IncludeBookmark <Boolean>]
   [-IncludeComponentLatencyInfo]
   [-IncludeRecipientInfo]
   [-ResultSize <Unlimited>]
   [-ReturnPageInfo <Boolean>]
   [-SearchForward <Boolean>]
   [-Server <ServerIdParameter>]
   [-SortOrder <QueueViewerSortOrderEntry[]>]
   [<CommonParameters>]
Get-Message
   [[-Identity] <MessageIdentity>]
   [-BookmarkIndex <Int32>]
   [-BookmarkObject <ExtensibleMessageInfo>]
   [-IncludeBookmark <Boolean>]
   [-IncludeComponentLatencyInfo]
   [-IncludeRecipientInfo]
   [-ResultSize <Unlimited>]
   [-ReturnPageInfo <Boolean>]
   [-SearchForward <Boolean>]
   [-SortOrder <QueueViewerSortOrderEntry[]>]
   [<CommonParameters>]
Get-Message
   [-Queue <QueueIdentity>]
   [-BookmarkIndex <Int32>]
   [-BookmarkObject <ExtensibleMessageInfo>]
   [-IncludeBookmark <Boolean>]
   [-IncludeComponentLatencyInfo]
   [-IncludeRecipientInfo]
   [-ResultSize <Unlimited>]
   [-ReturnPageInfo <Boolean>]
   [-SearchForward <Boolean>]
   [-SortOrder <QueueViewerSortOrderEntry[]>]
   [<CommonParameters>]

Описание

Можно отобразить сообщения, включив имя сервера как часть параметра Identity или Queue или включив параметр Server с запросом фильтра. Параметры Identity, Queue и Filter являются взаимоисключающими.

Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.

Примеры

Пример 1

Get-Message -Filter "FromAddress -like '*@contoso.com'" | Format-List

В этом примере отображаются подробные сведения обо всех сообщениях, находящихся в очереди на локальном сервере и полученных от отправителей в домене contoso.com.

Пример 2

Get-Message -Filter "FromAddress -like '*@contoso.com' -and SCL -gt 3"

В этом примере выводится список всех сообщений, помещенных в очередь на локальном сервере, полученных от любого отправителя в домене contoso.com и имеющих значение вероятности нежелательной почты, превышающее 3.

Пример 3

Get-Message -Server Server01.contoso.com -SortOrder: +FromAddress,-Size

В этом примере отображаются все сообщения, находящиеся в очереди на сервере Server01. Результаты вначале сортируются в порядке возрастания адреса отправителя, а затем в порядке убывания размера.

Параметры

-— BookmarkIndex

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

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-— Filter

Параметр Filter задает одно или несколько сообщений с помощью синтаксиса фильтра OPath. Фильтр OPath содержит имя свойства сообщения, за которым следует оператор сравнения и значение (например, "FromAddress -like '*@contoso.com'" ). Дополнительные сведения о фильтруемых свойствах сообщений и операторах сравнения можно посмотреть в разделе Свойства сообщений в очередях и найти очереди и сообщения в очередях в командной консоли Exchange.

Можно указать несколько условий с помощью оператора и. Значения свойств, не выраженные в виде целого числа, должны заключаться в кавычки (").

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-— ResultSize

Параметр ResultSize указывает максимальное число возвращаемых результатов. Если требуется возвратить все результаты, отвечающие условиям запроса, используйте для этого параметра значение unlimited. Значение по умолчанию — 1000.

Type:Unlimited
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-— SortOrder

Параметр SortOrder указывает массив свойств сообщений, которые используются для управления порядком сортировки набора результатов. Каждое свойство отделяется запятой. Для отображения результатов в порядке возрастания вставьте символ "плюс" (+) в начале имени свойства. Для отображения результатов в порядке убывания вставьте символ "минус" (-) в начале имени свойства.

Если порядок сортировки не указан, результирующий набор отображается в порядке возрастания целого числа MessageIdentity.

Type:QueueViewerSortOrderEntry[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-— Букмаркобжект

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

Type:ExtensibleMessageInfo
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-— Инклудебукмарк

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

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-— Инклудекомпонентлатенциинфо

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-— ИнклудереЦипиентинфо

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

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

  • Address. Адрес электронной почты получателя.
  • Тип: тип получателя, который может быть внешним, почтовым ящиком или группой рассылки. Группа рассылки используется, когда целевым объектом является сервер расширения.
  • FinalDestination. Различающееся имя объекта, которое используется для маршрутизации сообщения.
  • Состояние: состояние получателя — "завершено", "Готово" или "Повтор".
  • LastError. Ответ SMTP после последней попытки доставки или локализованное сообщение об ошибке, если сообщение помещено в недоступную очередь.

Например, чтобы сохранить сведения о получателе сообщения в очереди удаленной доставки contoso.com с MessageIdentity значением 1234 переменной с именем $x, выполните следующую команду: $x = Get - Identity - Identity "contoso.com \ 1234" инклудереЦипиентинфо.

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-— Очередь

Параметр Queue указывает удостоверение очереди, содержащей сообщения, которые нужно отобразить. Допустимые входные данные для этого параметра используют синтаксис <Server>\<Queue> или <Queue> , например, Mailbox01 \ contoso.com или недоступен. Подробнее об удостоверении очереди можно узнать в разделе "идентификатор очереди" в разделе Поиск очередей и сообщений в очередях в командной консоли Exchange.

При использовании параметра Queue нельзя использовать параметры Identity, Filter и Server.

Type:QueueIdentity
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-— Ретурнпажеинфо

ReturnPageInfo — это скрытый параметр. Он служит для получения сведений об общем количестве результатов и индексе первого объекта текущей страницы. Значение по умолчанию — $false.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-— Сеарчфорвард

Параметр SearchForward указывает, должен ли поиск в наборе результатов выполняться в прямом или обратном порядке. Значение по умолчанию — $true. Если указано это значение, при возврате страницы результатов используется прямой порядок поиска от начала набора результатов или от закладки, если она указана.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Identity

Параметр Identity определяет сообщение. Допустимые входные данные для этого параметра использует \ очередь сервера \ MessageInteger или очередь \ MessageInteger или MessageInteger, например Mailbox01 \ contoso.com \ 5 или 10. Сведения об удостоверении сообщения можно узнать в статье удостоверение сообщения.

Type:MessageIdentity
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Сервер

Параметр Server указывает сервер Exchange, на котором требуется выполнить эту команду. Параметр MailboxServer указывает сервер почтовых ящиков exExchange2k16 или exExchange2k13, который необходимо протестировать. Примеры:

  • Имя
  • FQDN
  • различающееся имя (DN);
  • Устаревшее различающееся имя Exchange

Устаревшее различающееся имя Exchange

Параметр Server можно использовать вместе с параметром Filter в одной команде. Параметр Server невозможно использовать вместе с параметром Identity в одной команде.

Type:ServerIdParameter
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Входные данные

Типы входных данных, поддерживаемые этим командлетом, см. в статье Типы входных и выходных данных для командлетов. Если поле "Типы входных данных" для командлета пустое, этот командлет не поддерживает ввода данных.

Выходные данные

Типы возвращаемых данных, или типы выходных данных, которые поддерживаются этим командлетом, см. в статье Типы входных и выходных данных для командлетов. Если поле "Типы выходных данных" пустое, командлет не возвращает данные.