Get-SafeLinksAggregateReport

  • 参考
模块:
ExchangePowerShell
适用于:
Exchange Online

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

使用 Get-SafeLinksAggregateReport cmdlet 可返回有关过去 90 天安全链接结果的常规信息。 昨天是可以指定的最近日期。

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

语法

Get-SafeLinksAggregateReport
   [-Action <MultiValuedProperty>]
   [-AppNameList <MultiValuedProperty>]
   [-EndDate <System.DateTime>]
   [-StartDate <System.DateTime>]
   [-SummarizeBy <String>]
   [<CommonParameters>]

说明

注意：如果在未指定日期范围的情况下运行 Get-SafeLinksAggregateReport，该命令将返回未指定的错误。

安全链接是Microsoft Defender for Office 365中的一项功能，用于检查电子邮件中的链接，以查看它们是否导致恶意网站。 在用户单击邮件中的链接后，系统会临时重写 URL，并对照已知的恶意网站列表来检查此 URL。

在所指定的报表周期里，该 cmdlet 返回以下信息：

  • 操作
  • 应用
  • MessageCount
  • RecipientCount

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

示例

示例 1

Get-SafeLinksAggregateReport -StartDate 06-01-2020 -EndDate 06-10-2020 -SummarizeBy App -AppNameList "Email Client","Teams"

此示例返回由指定日期范围的客户端和 Teams 结果Email汇总的结果。

参数

-Action

Action 参数按操作筛选结果。 有效值包含:

  • Allowed
  • Blocked
  • ClickedDuringScan
  • ClickedEvenBlocked
  • 扫描
  • TenantAllowed
  • TenantBlocked
  • TenantBlockedAndClickedThrough

可以指定用逗号分隔的多个值。

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

-AppNameList

AppNameList 参数按找到链接的应用筛选结果。 有效值包含:

  • Email 客户端
  • OfficeDocs
  • Teams

Update 如果值包含空格或需要引号，请使用以下语法： "Value1","Value2",..."ValueN"。

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

-EndDate

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

请使用短日期格式，该格式在运行命令的计算机上的“区域选项”设置中定义。 例如，如果将计算机配置为使用短日期格式 mm/dd/yyyy，请输入 09/01/2018 来指定 2018 年 9 月 1 日。

昨天是可以指定的最近日期。 不能指定超过 90 天的日期。

Type:System.DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-StartDate

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

请使用短日期格式，该格式在运行命令的计算机上的“区域选项”设置中定义。 例如，如果将计算机配置为使用短日期格式 mm/dd/yyyy，请输入 09/01/2018 来指定 2018 年 9 月 1 日。

昨天是可以指定的最近日期。 不能指定超过 90 天的日期。

Type:System.DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-SummarizeBy

SummarizeBy 参数根据您指定的值返回总和。 如果您的报告使用此参数接受的任意值筛选数据，则您可以使用 SummarizeBy 参数根据这些值对结果进行汇总。 若要减少报告中返回的行数，请考虑使用 SummarizeBy 参数。 汇总可以减少报告检索的数据量，从而更快速地生成报告。 例如，可以使用 SummarizeBy 参数查看报表中某一行上特定值 Action 或 AppNameList 的每个实例，而不是查看报表中一行中该特定操作或 AppNameList 的实例总数。

对于此 cmdlet，有效值为：

  • 操作：仅返回 Action 参数指定的值。
  • 应用：仅返回 AppNameList 参数指定的值。
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online