Get-ATPTotalTrafficReport
此 cmdlet 仅在基于云的服务中可用。
使用 Get-ATPTotalTrafficReport 查看有关Microsoft Defender for Office 365组织中的邮件流量的详细信息。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
Default （默认值）
Get-ATPTotalTrafficReport
[-Action <MultiValuedProperty>]
[-AggregateBy <String>]
[-Direction <MultiValuedProperty>]
[-Domain <MultiValuedProperty>]
[-EndDate <System.DateTime>]
[-Page <Int32>]
[-PageSize <Int32>]
[-ProbeTag <String>]
[-StartDate <System.DateTime>]
[-SummarizeBy <MultiValuedProperty>]
[<CommonParameters>]
说明
在所指定的报表周期里，该 cmdlet 返回以下信息：
- EventType：TotalBulkCount、TotalMalwareCount、TotalMissedSafeAttachmentCount、TotalMissedSafeLinkCount、TotalPhishCount、TotalSafeAttachmentCount、TotalSafeLinkCount、TotalSpamCount
- 组织
- 日期
- MessageCount
- StartDate
- EndDate
- AggregateBy
- 索引
当收件人或租户未包含在安全附件策略中时，TotalMissedSafeAttachmentCount 表示，但在传递后，零小时自动清除 (ZAP) 删除了检测到附件的邮件。
TotalMissedSafeLinkCount 表示收件人或租户未包含在安全链接策略中，但在传递后，ZAP 删除了检测到 URL 的邮件。
如果租户具有安全附件或安全链接策略，则消息将被阻止且未传递。
默认情况下，命令返回过去 14 天的数据。 过去 90 天的数据可用。
您必须先获得权限，然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数，但如果某些参数未包含在分配给你的权限中，则可能无法访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Get-ATPTotalTrafficReport -StartDate (get-date).AddDays(-5) -EndDate (get-date).AddDays(-1)
此示例返回过去 5 天的数据。
参数
-Action
适用：Exchange Online、Exchange Online Protection
Action 参数按对消息执行的作筛选报表。 若要查看此参数的有效值的完整列表，请运行命令： Get-MailFilterListReport -SelectionTarget Actions。 指定的作必须与报表类型相对应。 例如，只能为恶意软件报告指定恶意软件筛选器作。
Action 参数按 DLP 策略、传输规则、恶意软件筛选或垃圾邮件筛选所进行的操作来筛选报告。要查看该参数有效值的完整列表，请运行命令 Get-MailFilterListReport -SelectionTarget Actions。您指定的操作必须与报表类型对应。例如，您只能针对恶意软件报告指定恶意软件筛选操作。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-AggregateBy
适用：Exchange Online、Exchange Online Protection
AggregateBy 参数指定报告周期。 有效值为 Hour、Day 或 Summary。 默认值为 Day。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Direction
适用：Exchange Online、Exchange Online Protection
Direction 参数按传入的邮件或待发邮件筛选结果。 有效值包含:
- 入境
- 出站
可以指定用逗号分隔的多个值。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Domain
适用：Exchange Online、Exchange Online Protection
Domain 参数按基于云的组织中的接受的域来筛选结果。 您可以指定用逗号分隔的多个域值或指定值 All。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-EndDate
适用：Exchange Online、Exchange Online Protection
EndDate 参数指定日期范围的结束日期。
请使用短日期格式，该格式在运行命令的计算机上的“区域选项”设置中定义。 例如，如果计算机配置为使用短日期格式 MM/dd/yyyy，请输入 09/01/2018 以指定 2018 年 9 月 1 日。 可以只输入日期，也可以输入当天的日期和时间。 如果输入当天的日期和时间，请将该值括在引号 (") 中，例如，"09/01/2018 5:00 PM"。
参数属性
| 类型: | System.DateTime |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Page
适用：Exchange Online、Exchange Online Protection
Page 参数指定您希望查看的结果的页数。 此参数的有效输入是介于 1 和 1000 之间的整数。 默认值为 1。
参数属性
| 类型: | Int32 |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-PageSize
适用：Exchange Online、Exchange Online Protection
PageSize 参数指定每页的最大条目数量。 此参数的有效输入是介于 1 和 5000 之间的整数。 默认值为 1000。
参数属性
| 类型: | Int32 |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ProbeTag
适用：Exchange Online、Exchange Online Protection
保留此参数以供 Microsoft 内部使用。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-StartDate
适用：Exchange Online、Exchange Online Protection
StartDate 参数指定日期范围的起始日期。
请使用短日期格式，该格式在运行命令的计算机上的“区域选项”设置中定义。 例如，如果计算机配置为使用短日期格式 MM/dd/yyyy，请输入 09/01/2018 以指定 2018 年 9 月 1 日。 可以只输入日期，也可以输入当天的日期和时间。 如果输入当天的日期和时间，请将该值括在引号 (") 中，例如，"09/01/2018 5:00 PM"。
参数属性
| 类型: | System.DateTime |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-SummarizeBy
适用：Exchange Online、Exchange Online Protection
SummarizeBy 参数根据您指定的值返回总和。 如果您的报告使用此参数接受的任意值筛选数据，则您可以使用 SummarizeBy 参数根据这些值对结果进行汇总。 若要减少报告中返回的行数，请考虑使用 SummarizeBy 参数。 汇总可以减少报告检索的数据量，从而更快速地生成报告。 例如，与其在报告中的一行上查看 EventType 的特定值的每个实例，不如使用 SummarizeBy 参数在报告的一行中查看 EventType 的特定值的实例总数。
对于此 cmdlet，有效值为：
- 操作
- 方向
- Domain
- EventType
可以指定用逗号分隔的多个值。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。