Get-SafeLinksDetailReport
此指令程式只能在雲端式服務中使用。
使用 Get-SafeLinksDetailReport Cmdlet 可傳回過去 7 天安全連結結果的詳細資訊。 昨天是您可以指定的最新日期。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
語法
Default (預設值)
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 的所有參數，但如果某些參數未包含在指派給您的許可權中，您可能無法存取這些參數。 若要尋找在組織中執行任何 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
適用：Exchange Online
Action 參數會依動作篩選結果。 有效值為：
- 允許：因為「良好」的決策而允許URL。
- 已封鎖：URL 因「錯誤」決策而遭封鎖。
- ClickedDuringScan：使用者略過 URL 的驗證，並在安全連結完成掃描之前繼續前往目的地 URL。
- ClickedEvenBlocked：使用者在單擊時遭到封鎖而無法存取 URL。
- 掃描：正在掃描 URL。
- TenantAllowed：租使用者允許/封鎖清單中的URL允許專案。
- TenantBlocked：租使用者允許/封鎖清單中的 URL 封鎖專案。
- TenantBlockedAndClickedThrough：URL 因租用戶允許/封鎖清單中的封鎖專案而遭封鎖，且使用者按兩下封鎖頁面以存取 URL。
您可以指定多個以逗號分隔的值。
注意：此參數的值會區分大小寫。 沒有針對動作傳回的數據表示動作未發生。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-AppNameList
適用：Exchange Online
AppNameList 參數會依找到連結的應用程式篩選結果。 有效值為：
- Email 用戶端
- OfficeDocs
- Teams
您可以輸入多個以逗號分隔的值。 如果這些值包含空格或需要引號，請使用下列語法: "Value1","Value2",..."ValueN"。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Domain
適用：Exchange Online
Domain 參數會依 URL 中的網域篩選結果。
您可以指定多個以逗號分隔的值。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-EndDate
適用：Exchange Online
EndDate 參數會指定日期範圍的結束日期。
在您要執行命令的電腦上，使用該電腦的 [地區選項] 設定中定義的簡短日期格式。 例如，如果計算機設定為使用簡短日期格式MM/dd/yyyy，請輸入09/01/2018以指定2018年9月1日。
昨天是您可以指定的最新日期。 您無法指定早於 7 天的日期。
參數屬性
| 類型: | System.DateTime |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Page
適用：Exchange Online
Page 參數會指定您要檢視的結果頁數。 此參數的有效輸入是 1 與 1000 之間的整數。 預設值為 1。
參數屬性
| 類型: | Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-PageSize
適用：Exchange Online
PageSize 參數會指定每頁的顯示項目數上限。 此參數的有效輸入是 1 與 5000 之間的整數。 預設值為 1000。
參數屬性
| 類型: | Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RecipientAddress
適用：Exchange Online
RecipientAddress 參數會依收件者電子郵件地址來篩選結果。
您可以指定多個以逗號分隔的值。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-StartDate
適用：Exchange Online
StartDate 參數會指定日期範圍的開始日期。
在您要執行命令的電腦上，使用該電腦的 [地區選項] 設定中定義的簡短日期格式。 例如，如果計算機設定為使用簡短日期格式MM/dd/yyyy，請輸入09/01/2018以指定2018年9月1日。
昨天是您可以指定的最新日期。 您無法指定早於 7 天的日期。
參數屬性
| 類型: | System.DateTime |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。