Commands › Exchange Online

Get-CompromisedUserAggregateReport

Exchange Online ExchangeOnlineManagement Get-*

Return general data about compromised users for the last 10 days.

Quick start script

# Get-CompromisedUserAggregateReport — 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-CompromisedUserAggregateReport | Format-List

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

Syntax

Get-CompromisedUserAggregateReport
 [-Action <MultiValuedProperty>]
 [-EndDate <System.DateTime>]
 [-Page <Int32>]
 [-PageSize <Int32>]
 [-StartDate <System.DateTime>]
 [<CommonParameters>]

Parameters (5)

Parameter	Type	What it controls
-Action	MultiValuedProperty	The Action parameter filters the results by the compromised user status. Valid values are:
-EndDate	DateTime	The EndDate parameter specifies the end date of the date range.
-Page	Int32	The Page parameter specifies the page number of the results you want to view. Valid input for this parameter is an integer between 1 and 1000. The default value is 1.
-PageSize	Int32	The PageSize parameter specifies the maximum number of entries per page. Valid input for this parameter is an integer between 1 and 5000. The default value is 1000.
-StartDate	DateTime	The StartDate parameter specifies the start date of the date range.

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