Commands › Exchange Online

Get-SafeLinksAggregateReport

Exchange Online ExchangeOnlineManagement Get-*

Return general information about Safe Links results for the last 90 days. Yesterday is the most recent date that you can specify.

Quick start script

# Get-SafeLinksAggregateReport — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-ExchangeOnline -CertificateThumbprint $thumb -AppId $appId -Organization $org

# 2. Run and inspect
Get-SafeLinksAggregateReport | Format-List

# 3. Export for evidence / drift tracking
Get-SafeLinksAggregateReport | Export-Clixml .\SafeLinksAggregateReport-$(Get-Date -Format yyyyMMdd).xml

Syntax

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

Parameters (5)

Parameter	Type	What it controls
-Action	MultiValuedProperty	The Action parameter filters the results by action. Valid values are:
-AppNameList	MultiValuedProperty	The AppNameList parameter filters the results by the app where the link was found. Valid values are:
-EndDate	DateTime	The EndDate parameter specifies the end date of the date range.
-StartDate	DateTime	The StartDate parameter specifies the start date of the date range.
-SummarizeBy	String	The SummarizeBy parameter returns totals based on the values you specify. If your report filters data using any of the values accepted by this parameter, you can use the SummarizeBy parameter to summarize the results...

Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.