PS.M365UsageReport

2.0.1

source/02_ExchangeOnline/Get-ExchangeTopMailRecipient.ps1

Function Get-ExchangeTopMailRecipient {
    [CmdletBinding()]
    param (
        [Parameter()]
        [int]
        $ReportPeriod = 7,

        [Parameter()]
        [Int]
        $Top = 10
    )

    if ($ReportPeriod -gt 90) {
        SayInfo 'Maximum mail traffic data history is 90 days.'
        $ReportPeriod = 90
    }

    $now = (Get-Date)
    $startDate = $now.AddDays(-$ReportPeriod)

    try {
        $result = Get-MailTrafficSummaryReport -StartDate $startDate -EndDate $now -Category TopMailRecipient -ErrorAction Stop |
        Select-Object -First $Top -Property @{n = 'ID'; e = { $_.C1 } }, @{n = 'Message Count'; e = { $_.C2 } }
        return $result
    }
    catch {
        SayError $_.Exception.Message
        return $null
    }
}