Get-MessageTraceDetail

参考

模块:: ExchangePowerShell

适用于:: Exchange Online, Exchange Online Protection

此 cmdlet 仅在基于云的服务中可用。

使用 Get-MessageTraceDetail cmdlet 查看特定邮件的邮件跟踪事件详细信息。请注意，这些详细结果的返回速度低于Get-MessageTrace结果。

有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。

语法

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>]

说明

可以使用此 cmdlet 搜索过去 10 天的邮件数据。如果输入的时间段超过 10 天，将收到错误，并且命令不会返回任何结果。

若要搜索超过 10 天的邮件数据，请使用 Start-HistoricalSearch 和 Get-HistoricalSearch cmdlet。

您必须先获得权限，然后才能运行此 cmdlet。虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 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 cmdlet 检索在 2018 年 6 月 13 日至 2018 年 6 月 15 日之间发送 john@contoso.com 的 Exchange 网络消息 ID 值为 2bbad36aa4674c7ba82f4b307fff549f 的邮件跟踪信息，并将结果管道传送到 Get-MessageTraceDetail cmdlet。

参数

-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：消息由服务发送。
失败：无法传递消息。
DELIVER：邮件已传递到邮箱。
EXPAND：消息已发送到已展开的通讯组。
传输：由于内容转换、邮件收件人限制或代理，收件人被移动到了分位邮件。
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) 。

以下 cmdlet 的输出中也提供了 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 参数指定日期范围的起始日期。