exchangeMessageTrace リソースの種類

名前空間: microsoft.graph

Exchange Online organizationを通過するときの電子メール メッセージのトレース情報を表します。 メッセージ追跡を使用すると、テナント管理者はメールのライフサイクルを追跡し、その配信状態 (配信済み、保留中、失敗、検疫済み) を判断し、メールに適用されるアクションを理解できます。

メソッド

メソッド 戻り値の種類 説明
メッセージ追跡を一覧表示する exchangeMessageTrace コレクション exchangeMessageTrace オブジェクトのリストを取得します。
受信者別に詳細を取得する exchangeMessageTraceDetail コレクション 受信者でフィルター処理された exchangeMessageTraceDetail オブジェクトの一覧を取得します。

プロパティ

プロパティ 型 説明
fromIP 文字列 ソース IP アドレス。 受信メッセージの場合、この値はメッセージを送信した SMTP 電子メール サーバーのパブリック IP アドレスです。

$filter (eq)をサポートしています。
id 文字列 メッセージ トレースの一意識別子。

$filter (eq)をサポートしています。
messageId 文字列 メッセージの Message-ID ヘッダー フィールド。 Message-ID の形式は、メッセージを送信したメッセージング サーバーによって異なります。

$filter (eq)をサポートしています。
receivedDateTime DateTimeOffset メッセージが Exchange Online によって受信された日時。 タイムスタンプは UTC 形式です。

$filter (ge、le) をサポートします。
recipientAddress 文字列 メッセージの宛先であるユーザーの SMTP 電子メール アドレス。

$filter (eq)をサポートしています。
senderAddress 文字列 メッセージの送信元とされるユーザーの SMTP 電子メール アドレス。

$filter (eq)をサポートしています。
size Int32 メッセージのサイズ (バイト単位)。
status exchangeMessageTraceStatus メッセージの配信状態。 有効な値は、 gettingStatus、 pending、 failed、 delivered、 expanded、 quarantined、 filteredAsSpam、 unknownFutureValue、 recalled です。 Prefer: include-unknown-enum-members 要求ヘッダーを使用して、この進化可能な列挙型の値を取得します。recalled。

$filter (eq)をサポートしています。
subject 文字列 メッセージの件名。

$filter (contains、startsWith、endsWith) をサポートします。
toIP 文字列 宛先 IP アドレス。 送信メッセージの場合、この値は宛先ドメインの解決済み MX レコード内のパブリック IP アドレスです。 Exchange Online への受信メッセージの場合、この値は空白になります。

$filter (eq)をサポートしています。

前提条件

メッセージ 追跡の一覧 表示または 受信者 API による詳細の取得 を使用するには、その前に、次のアプリケーション (クライアント) ID を持つ Microsoft アプリケーションのテナントにサービス プリンシパルをプロビジョニングする必要があります。 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"
}
  • 最終更新: