Get-SafeLinksAggregateReport

模組:

ExchangePowerShell

適用於:

Exchange Online

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

使用 Get-SafeLinksAggregateReport Cmdlet 可傳回過去 90 天內安全連結結果的一般資訊。 昨天是您可以指定的最新日期。

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

Syntax

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

Description

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

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

針對您所指定的報告期間，Cmdlet 會傳回下列資訊：

• 動作
• 應用程式
• MessageCount
• RecipientCount

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

此範例會傳回由指定日期範圍Email用戶端和 Teams 結果所摘要的結果。

參數

-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

-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 值的每個實例，而不是看到該特定 Action 或 App 的實例總數。

針對此 Cmdlet，有效值為：

• 動作：只會傳回 Action 參數所指定的值。
• 應用程式：只會傳回 AppNameList 參數所指定的值。

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