Тип ресурса exchangeMessageTrace

Пространство имен: microsoft.graph

Представляет сведения о трассировки сообщения электронной почты при его прохождении через Exchange Online организацию. Трассировка сообщений позволяет администраторам клиентов отслеживать жизненный цикл сообщения электронной почты, определять его состояние доставки (доставлено ли сообщение, ожидается, не удалось или помещено в карантин), а также понимать, какие действия к нему применяются.

Методы

Метод	Тип возвращаемых данных	Описание
Вывод списка трассировок сообщений	Коллекция exchangeMessageTrace	Получение списка объектов exchangeMessageTrace .
Получение сведений по получателям	коллекция exchangeMessageTraceDetail	Получение списка объектов exchangeMessageTraceDetail , отфильтрованных по получателю.

Свойства

Свойство	Тип	Описание
fromIP	String	Исходный IP-адрес. Для входящих сообщений это значение является общедоступным IP-адресом SMTP-сервера электронной почты, отправившего сообщение. Поддерживает $filter (eq).
id	String	Уникальный идентификатор трассировки сообщения. Поддерживает $filter (eq).
Messageid	String	Поле заголовка Message-ID сообщения. Формат Message-ID зависит от сервера обмена сообщениями, с которого было отправлено сообщение. Поддерживает $filter (eq).
receivedDateTime	DateTimeOffset	Дата и время получения сообщения Exchange Online. Метка времени имеет формат UTC. Поддерживает $filter (ge, le).
recipientAddress	String	SMTP-адрес электронной почты пользователя, которому было адресовано сообщение. Поддерживает $filter (eq).
senderAddress	String	SMTP-адрес электронной почты пользователя, от который якобы было отправлено сообщение. Поддерживает $filter (eq).
size	Int32	Размер сообщения в байтах.
status	exchangeMessageTraceStatus	Состояние доставки сообщения. Возможные значения: , , , , , expanded, quarantined, filteredAsSpam, . unknownFutureValuedeliveredfailedpendinggettingStatus Поддерживает $filter (eq).
subject	String	Строка темы сообщения. Поддерживает $filter (contains, startsWith, endsWith).
toIP	String	IP-адрес назначения. Для исходящих сообщений это значение является общедоступным IP-адресом в разрешенной записи MX для целевого домена. Для Exchange Online входящих сообщений это значение пусто. Поддерживает $filter (eq).

Предварительные условия

Перед использованием трассировки сообщений списка или получения сведений по API-интерфейсам получателей необходимо подготовить субъект-службу в клиенте для приложения Майкрософт со следующим идентификатором приложения(клиента): 8bd644d1-64a1-4d4b-ae52-2e0cbf64e373. Подготовка субъекта-службы создает локальное представление приложения в клиенте и включает проверку подлинности и авторизацию для этих API.

Чтобы подготовить субъект-службу, выполните следующие действия.

1. Подключение к Microsoft Graph PowerShell:

   Connect-MgGraph -Scopes "Application.ReadWrite.All"
   

2. Выполните следующую команду, чтобы подготовить субъект-службу:

   New-MgServicePrincipal -AppId 8bd644d1-64a1-4d4b-ae52-2e0cbf64e373
   
   

Связи

Отсутствуют.

Представление JSON

В следующем представлении JSON показан тип ресурса.

{
  "@odata.type": "#microsoft.graph.exchangeMessageTrace",
  "fromIP": "String",
  "id": "String (identifier)",
  "messageId": "String",
  "receivedDateTime": "String (timestamp)",
  "recipientAddress": "String",
  "senderAddress": "String",
  "size": "Int32",
  "status": "String",
  "subject": "String",
  "toIP": "String"
}