Get-MessageTraceDetail

リファレンス

モジュール:: ExchangePowerShell

適用対象:: Exchange Online, Exchange Online Protection

このコマンドレットは、クラウドベースのサービスでのみ使用できます。

特定のメッセージのメッセージトレースイベントの詳細を表示するには、Get-MessageTraceDetail コマンドレットを使用します。これらの詳細な結果は、Get-MessageTraceの結果よりも短時間で返されることに注意してください。

以下の構文セクションのパラメーターセットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

Get-MessageTraceDetail
   -MessageTraceId <Guid>
   -RecipientAddress <String>
   [-Action <MultiValuedProperty>]
   [-EndDate <DateTime>]
   [-Event <MultiValuedProperty>]
   [-MessageId <String>]
   [-Page <Int32>]
   [-PageSize <Int32>]
   [-ProbeTag <String>]
   [-SenderAddress <String>]
   [-StartDate <DateTime>]
   [<CommonParameters>]

説明

このコマンドレットを使用して、過去 10 日間のメッセージデータを検索できます。 10 日を超える期間を入力すると、エラーが発生し、コマンドは結果を返しません。

10 日を超えるメッセージデータを検索するには、Start-HistoricalSearch コマンドレットと Get-HistoricalSearch コマンドレットを使用します。

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。

例

例 1

Get-MessageTraceDetail -MessageTraceId ae5c1219-4c90-41bf-fef5-08d837917e7c -RecipientAddress robert@contoso.com

この例では、メッセージトレース ID 値 ae5c1219-4c90-41bf-fef5-08d837917e7c によって robert@contoso.com受信されたメッセージの詳細なメッセージトレース情報を取得します。

例 2

Get-MessageTrace -MessageTraceId 2bbad36aa4674c7ba82f4b307fff549f -SenderAddress john@contoso.com -StartDate 06/13/2018 -EndDate 06/15/2018 | Get-MessageTraceDetail

この例では、Get-MessageTrace コマンドレットを使用して、Exchange Network Message ID 値 2bbad36aa4674c7ba82f4b307fff549f が 2018 年 6 月 13 日から 2018 年 6 月 15 日の間に john@contoso.com 送信されたメッセージのメッセージトレース情報を取得し、結果を Get-MessageTraceDetail コマンドレットにパイプライン処理します。

パラメーター

-Action

Action パラメーターは、メッセージに対して実行されたアクションによってレポートをフィルター処理します。このパラメーターの有効な値の完全な一覧を表示するには、コマンドを実行します。 Get-MailFilterListReport -SelectionTarget Actions 指定するアクションは、レポートの種類に対応している必要があります。たとえば、マルウェアレポートのマルウェアフィルターアクションのみを指定できます。

Action パラメーターは、DLP ポリシー、トランスポートルール、マルウェアフィルター、またはスパムフィルターによって実行された操作別にレポートをフィルター処理します。このパラメーターの有効な値の完全な一覧を表示するには、コマンド Get-MailFilterListReport -SelectionTarget Actions を実行します。指定する操作は、レポートの種類に対応している必要があります。たとえば、マルウェアレポートの場合に指定できるのはマルウェアフィルターの操作のみです。

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-EndDate

EndDate パラメーターには、日付範囲の終了日を指定します。

コマンドを実行するコンピューターの [地域のオプション] 設定で定義されている短い日付形式を使用します。たとえば、短い日付形式 mm/dd/yyyy を使用するようにコンピューターが構成されている場合は、「09/01/2018」と入力して 2018 年 9 月 1 日を指定します。日付のみを入力したり、日付と時刻を入力することもできます。日付と時刻を入力する場合は、値を引用符 (”) で囲む必要があります (例: "09/01/2018 5:00 PM")。

StartDate パラメーターと EndDate パラメーターを使用しない場合は、過去 48 時間のデータのみが返されます。

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Event

Event パラメーターは、メッセージイベント別にレポートをフィルター処理します。以下は一般的なイベントの例です。

RECEIVE: サービスによってメッセージが受信されました。
SEND: メッセージはサービスによって送信されました。
FAIL: メッセージの配信に失敗しました。
配信: メッセージがメールボックスに配信されました。
展開: 展開された配布グループにメッセージが送信されました。
転送: 受信者は、コンテンツの変換、メッセージ受信者の制限、またはエージェントのために、分岐されたメッセージに移動されました。
DEFER: メッセージ配信は延期され、後で再試行される可能性があります。

複数の値をコンマで区切って指定できます。

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-MessageId

MessageId パラメーターは、メッセージの Message-ID 件名フィールド別に結果をフィルター処理します。この値はクライアント ID とも呼ばれます。 Message-ID の形式は、メッセージを送信したメッセージングサーバーによって異なります。値はメッセージごとに一意である必要があります。ただし、すべてのメッセージングサーバーが同じ方法で Message-ID の値を作成するわけではありません。完全なメッセージ ID 文字列 (山かっこを含む場合があります) を必ず含め、値を引用符 ("d9683b4c-127b-413a-ae2e-fa7dfb32c69d@DM3NAM06BG401.Eop-nam06.prod.protection.outlook.com" など) で囲んでください。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-MessageTraceId

MessageTraceId パラメーターは、メッセージのメッセージトレース ID 値によって結果をフィルター処理します。この GUID 値は、システムによって処理されるすべてのメッセージに対して生成されます (例: c20e0f7a-f06b-41df-fe33-08d9da155ac1)。

MessageTraceId 値は、次のコマンドレットの出力でも使用できます。

Get-MailDetailATPReport
Get-MailDetailDlpPolicyReport
Get-MailDetailEncryptionReport
Get-MailDetailTransportRuleReport
Get-MessageTrace

Type:	Guid
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Page

Page パラメーターは、表示する結果のページ数を指定します。このパラメーターの有効な入力値は、1 ～ 1000 の整数です。既定値は 1 です。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-PageSize

PageSize パラメーターは、ページあたりのエントリの最大数を指定します。このパラメーターの有効な入力値は、1 ～ 5000 の整数です。既定値は 1000 です。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-ProbeTag

このパラメーターは、Microsoft の内部使用のために予約されています。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-RecipientAddress

RecipientAddress パラメーターは、受信者の電子メールアドレスで結果をフィルター処理します。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-SenderAddress

SenderAddress パラメーターは、送信者の電子メールアドレスで結果をフィルター処理します。複数の値をコンマで区切って指定できます。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-StartDate

StartDate パラメーターは、日付範囲の開始日を指定します。