Get-SafeLinksDetailReport

模块:

ExchangePowerShell

适用于:

Exchange Online

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

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

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

语法

Get-SafeLinksDetailReport
   [-Action <MultiValuedProperty>]
   [-AppNameList <MultiValuedProperty>]
   [-Domain <MultiValuedProperty>]
   [-EndDate <System.DateTime>]
   [-Page <Int32>]
   [-PageSize <Int32>]
   [-RecipientAddress <MultiValuedProperty>]
   [-StartDate <System.DateTime>]
   [<CommonParameters>]

说明

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

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

此 cmdlet 返回以下信息：

• ClickTime
• NetworkMessageId
• ClientMessageId
• SenderAddress
• RecipientAddress
• URL
• UrlDomain
• 操作
• AppName
• SourceId
• 组织
• DetectedBy (Microsoft Defender for Office 365) 中的安全链接
• urlType (当前为空)
• 标志 (0：允许 1：阻止 2：ClickedEvenBlocked 3：ClickedDuringScan)

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

示例

示例 1

Get-SafeLinksDetailReport -StartDate 06-07-2020 -EndDate 06-10-2020 -Action Allowed,Blocked -AppNameList "Email Client","Teams" -Domain google.com,teams.com -RecipientAddress faith@contoso.com,chris@contoso.com

此示例返回按以下信息筛选结果：

• 日期范围：2020 年 6 月 7 日至 2020 年 6 月 10 日
• 操作：允许和阻止
• AppNameList：Email客户端和 Teams
• URL 域：google.com 和 teams.com
• 收件人电子邮件地址： faith@contoso.com 和 chris@contoso.com

参数

-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

-Domain

Domain 参数按 URL 中的域筛选结果。

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

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

-EndDate

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

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

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

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

-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

-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

-RecipientAddress

RecipientAddress 参数按收件人的电子邮件地址筛选结果。

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

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

-StartDate

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

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

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

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