Get-MgmtGraphUser

MgmtGraph: Audits Microsoft Graph user accounts

Script

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

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

    [string[]]$Property = @('DisplayName', 'Id', 'UserPrincipalName', 'Mail', 'Department', 'JobTitle', 'AccountEnabled', 'UserType')
)

Process {
    try {
        $params = @{
            'ErrorAction' = 'Stop'
            'Property'    = $Property
        }

        if ($Identity) {
            $user = Get-MgUser -UserId $Identity @params -ErrorAction SilentlyContinue
            if (-not $user) {
                $user = Get-MgUser -Filter "displayName eq '$Identity'" @params
            }
        }
        else {
            $params.Add('All', $true)
            $user = Get-MgUser @params
        }

        if (-not $user) {
            Write-Warning "User '$Identity' not found."
            return
        }

        $results = foreach ($u in $user) {
            $obj = [ordered]@{}
            foreach ($p in $Property) {
                $obj[$p] = $u.$p
            }
            [PSCustomObject]$obj
        }

        Write-Output $results
    }
    catch {
        throw
    }
}

Customize

Identity string

Optional. Specifies the UserPrincipalName, DisplayName, or ID of the user to retrieve.

Property string

Optional. Specifies the list of properties to retrieve. Defaults to a standard set of identity and status fields.