Get-SafeLinksDetailReport
此 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 |