Get-SafeLinksDetailReport

  • 參考
模組:
ExchangePowerShell
適用於:
Exchange Online

此指令程式只能在雲端式服務中使用。

使用 Get-SafeLinksDetailReport Cmdlet 可傳回過去 7 天安全連結結果的詳細資訊。 昨天是您可以指定的最新日期。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

Syntax

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

Description

注意：如果您執行Get-SafeLinksDetailReport但未指定日期範圍，命令會傳回未指定的錯誤。

安全連結是適用於 Office 365 的 Microsoft Defender中的一項功能，可檢查電子郵件訊息中的連結，以查看是否導致惡意網站。 當使用者按一下郵件中的連結時，系統會暫時重寫 URL 並核對已知的惡意網站清單。

此 Cmdlet 會傳回下列資訊：

  • ClickTime
  • NetworkMessageId
  • ClientMessageId
  • SenderAddress
  • RecipientAddress
  • URL
  • UrlDomain
  • 動作
  • AppName
  • SourceId
  • Organization
  • DetectedBy (中的安全連結適用於 Office 365 的 Microsoft Defender)
  • UrlType (目前空白)
  • 旗 (0：允許 1：封鎖 2：ClickedEvenBlocked 3：ClickedDuringScan)

您必須已獲指派權限，才能執行此指令程式。 雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。 若要尋找在組織中執行任何 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 參數會依動作篩選結果。 有效值為：

  • 已允許
  • 已封鎖
  • 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

您可以輸入多個以逗號分隔的值。 如果值包含空格或需要引號，請使用下列語法： "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