Get-MgmtGraphUserMessage

MgmtGraph: Audits user mailbox messages

Script

#Requires -Version 5.1
#Requires -Modules Microsoft.Graph.Mail

[CmdletBinding()]
Param (
    [Parameter(Mandatory = $true, Position = 0)]
    [string]$Identity,

    [string]$MessageId
)

Process {
    try {
        $params = @{
            'UserId'      = $Identity
            'ErrorAction' = 'Stop'
        }

        if ($MessageId) {
            $params.Add('MessageId', $MessageId)
        }
        else {
            $params.Add('Top', 50)
        }

        $messages = Get-MgUserMessage @params
        
        $results = foreach ($m in $messages) {
            [PSCustomObject]@{
                Subject          = $m.Subject
                ReceivedDateTime = $m.ReceivedDateTime
                SentDateTime     = $m.SentDateTime
                From             = $m.From.EmailAddress.Address
                Id               = $m.Id
                IsRead           = $m.IsRead
                HasAttachments   = $m.HasAttachments
                Timestamp        = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
            }
        }

        Write-Output ($results | Sort-Object ReceivedDateTime -Descending)
    }
    catch {
        throw
    }
}

Customize

Identity string

Specifies the UserPrincipalName or ID of the user.

MessageId string

Optional. Specifies the ID of a specific message to retrieve. If omitted, the latest messages are listed.