Get-MessageTrace

参考

模块:: ExchangePowerShell

适用于:: Exchange Online, Exchange Online Protection

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

使用 Get-MessageTrace cmdlet 以在它们通过基于云的组织时跟踪邮件。

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

语法

Get-MessageTrace
   [-EndDate <DateTime>]
   [-FromIP <String>]
   [-MessageId <MultiValuedProperty>]
   [-MessageTraceId <Guid>]
   [-Page <Int32>]
   [-PageSize <Int32>]
   [-ProbeTag <String>]
   [-RecipientAddress <MultiValuedProperty>]
   [-SenderAddress <MultiValuedProperty>]
   [-StartDate <DateTime>]
   [-Status <MultiValuedProperty>]
   [-ToIP <String>]
   [<CommonParameters>]

说明

可以使用此 cmdlet 搜索过去 10 天的邮件数据。如果在没有任何参数的情况下运行此 cmdlet，则仅返回过去 48 小时的数据。

如果输入的开始日期早于 10 天，将收到错误，并且命令不会返回任何结果。

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

默认情况下，此 cmdlet 最多返回 1000 个结果，并且会在非常大的查询上超时。如果查询返回的结果过多，请考虑使用较小的 StartDate 和 EndDate 间隔将其拆分。

输出上的时间戳采用 UTC 时间格式。这可能不同于用于 -StartDate 和 -EndDate 参数的时间格式。

您必须先获得权限，然后才能运行此 cmdlet。虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。

示例

示例 1

Get-MessageTrace -SenderAddress john@contoso.com -StartDate 06/13/2018 -EndDate 06/15/2018

此示例检索 2018 年 6 月 13 日至 2018 年 6 月 15 日之间发送 john@contoso.com 的消息的消息跟踪信息。

参数

-EndDate

EndDate 参数指定日期范围的结束日期。

请使用短日期格式，该格式在运行命令的计算机上的“区域选项”设置中定义。例如，如果将计算机配置为使用短日期格式 mm/dd/yyyy，请输入 09/01/2018 来指定 2018 年 9 月 1 日。可以只输入日期，也可以输入当天的日期和时间。如果输入当天的日期和时间，请将该值括在引号 (") 中，例如，"09/01/2018 5:00 PM"。

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

-FromIP

FromIP 参数按照源 IP 地址筛选结果。对于传入邮件，FromIP 的值是发送邮件的 SMTP 电子邮件服务器的公用 IP 地址。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
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:	MultiValuedProperty
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-MessageTraceDetail

Type:	Guid
Position:	Named
Default value:	None
Required:	False
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:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-SenderAddress

SenderAddress 参数按发件人的电子邮件地址筛选结果。可以指定用逗号分隔的多个值。

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

-StartDate

StartDate 参数指定日期范围的起始日期。

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

-Status

Status 参数按邮件的传送状态筛选结果。 PasswordQuality 参数指定设备密码所需的最小密码质量分级。密码质量是指示密码安全性和复杂性的数值。质量值越高表示密码越安全。

None：邮件没有任何传递状态，因为邮件被拒绝或者重定向到其他收件人。
GetStatus：消息正在等待状态更新。
Failed：已尝试传递邮件，但传递失败；或者邮件已被当作垃圾邮件或恶意软件筛选，或者已按传输规则筛选。
Pending：正在传递邮件；或者邮件传递延迟，正在重试。
Delivered：邮件已送达目的地。
已扩展：由于邮件已发到通讯组，并且分发的成员身份已展开，因此没有邮件传递。
已隔离：邮件已隔离。
FilteredAsSpam：邮件标记为垃圾邮件。

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

-ToIP

ToIP 参数按照目标 IP 地址筛选结果。对于传出邮件，ToIP 的值是目标域解析后的 MX 记录的公用 IP 地址。对于到 Exchange Online 的传入邮件，该值为空。

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

输入

Input types

若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。

输出

Output types

若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。