Get-MessageTraceDetailV2
说明
可以使用此 cmdlet 搜索过去 90 天的邮件数据。 每个查询只能查询 10 天的数据。 如果输入的时间范围超过 90 天，则会收到错误，并且命令不会返回任何结果。
限制：运行 5 分钟内最多接受 100 个查询请求。 如果请求速率在过去 5 分钟内低于 100 个请求，则不会自动应用限制
您必须先获得权限，然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数，但如果某些参数未包含在分配给你的权限中，则可能无法访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Get-MessageTraceDetailV2 -MessageTraceId ae5c1219-4c90-41bf-fef5-08d837917e7c -RecipientAddress robert@contoso.com
此示例检索消息跟踪 ID 值为 ae5c1219-4c90-41bf-fef5-08d837917e7c 的消息 robert@contoso.com的详细消息跟踪信息。
示例 2
Get-MessageTraceV2 -MessageTraceId 2bbad36aa4674c7ba82f4b307fff549f -SenderAddress john@contoso.com -StartDate 06/13/2025 -EndDate 06/15/2025 | Get-MessageTraceDetailV2
此示例使用 Get-MessageTraceV2 cmdlet 检索在 2025 年 6 月 13 日至 2025 年 6 月 15 日之间发送 john@contoso.com 的 Exchange 网络消息 ID 值为 2bbad36aa4674c7ba82f4b307fff549f 的邮件跟踪信息，并将结果管道传送到 Get-MessageTraceDetailV2 cmdlet。
参数
-Action
适用：Exchange Online、Exchange Online Protection
Action 参数按对消息执行的作筛选报表。 若要查看此参数的有效值的完整列表，请运行命令： Get-MailFilterListReport -SelectionTarget Actions。 指定的作必须与报表类型相对应。 例如，只能为恶意软件报告指定恶意软件筛选器作。
Action 参数按 DLP 策略、传输规则、恶意软件筛选或垃圾邮件筛选所进行的操作来筛选报告。要查看该参数有效值的完整列表，请运行命令 Get-MailFilterListReport -SelectionTarget Actions。您指定的操作必须与报表类型对应。例如，您只能针对恶意软件报告指定恶意软件筛选操作。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 1 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-EndDate
适用：Exchange Online、Exchange Online Protection
EndDate 参数指定日期范围的结束日期。
请使用短日期格式，该格式在运行命令的计算机上的“区域选项”设置中定义。 例如，如果计算机配置为使用短日期格式 MM/dd/yyyy，请输入 09/01/2025 以指定 2025 年 9 月 1 日。 可以只输入日期，也可以输入当天的日期和时间。 如果输入日期和时间，请将值括在引号 (“) ，例如”09/01/2025 5：00 PM”。
如果不使用 StartDate 和 EndDate 参数，则仅返回过去 48 小时的数据。
参数属性
| 类型: | System.DateTime |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 2 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-Event
适用：Exchange Online、Exchange Online Protection
Event 参数按邮件事件筛选报告。 下面是常见事件的示例：
- RECEIVE：服务已收到消息。
- SEND：消息由服务发送。
- 失败：无法传递消息。
- DELIVER：邮件已传递到邮箱。
- EXPAND：消息已发送到已展开的通讯组。
- 传输：由于内容转换、邮件收件人限制或代理，收件人被移动到了分位邮件。
- DEFER：消息传递已推迟，以后可能会重新尝试。
可以指定用逗号分隔的多个值。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 3 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-MessageId
适用：Exchange Online、Exchange Online Protection
MessageId 参数按邮件的 Message-ID 头字段筛选结果。 此值也称为“客户端 ID”。 Message-ID 的格式取决于发送邮件的消息传送服务器。 此值应对每封邮件都是唯一的。 但是，并非所有消息传送服务器都会以相同方式创建 Message-ID 的值。 请务必包含完整的消息 ID 字符串 (，其中可能包含尖括号) ，并将值括在引号 (，例如“”d9683b4c-127b-413a-ae2e-fa7dfb32c69d@DM3NAM06BG401.Eop-nam06.prod.protection.outlook.com) 。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 4 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-MessageTraceId
适用：Exchange Online
MessageTraceId 参数按消息的消息跟踪 ID 值筛选结果。 系统 (处理的每个消息生成此 GUID 值，例如 c20e0f7a-f06b-41df-fe33-08d9da155ac1) 。
参数属性
| 类型: | Guid |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 5 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-RecipientAddress
适用：Exchange Online、Exchange Online Protection
RecipientAddress 参数按收件人的电子邮件地址筛选结果。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 6 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-SenderAddress
适用：Exchange Online、Exchange Online Protection
SenderAddress 参数按发件人的电子邮件地址筛选结果。 可以指定用逗号分隔的多个值。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 7 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-StartDate
适用：Exchange Online、Exchange Online Protection
StartDate 参数指定日期范围的起始日期。
请使用短日期格式，该格式在运行命令的计算机上的“区域选项”设置中定义。 例如，如果计算机配置为使用短日期格式 MM/dd/yyyy，请输入 09/01/2025 以指定 2025 年 9 月 1 日。 可以只输入日期，也可以输入当天的日期和时间。 如果输入日期和时间，请将值括在引号 (“) ，例如”09/01/2025 5：00 PM”。
如果不使用 StartDate 和 EndDate 参数，则仅返回过去 48 小时的数据。
参数属性
| 类型: | System.DateTime |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 8 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。