Get-MsOGroups-Html

MSOnline: HTML report of Azure AD groups

Script

#Requires -Version 5.1

[CmdletBinding()]
Param(
    [switch]$IsAgentRole,
    [switch]$HasLicenseErrorsOnly,
    [switch]$HasErrorsOnly,
    [ValidateSet('All','Security','MailEnabledSecurity','DistributionList')]
    [string]$GroupType = 'All',
    [guid]$TenantId
)

Process {
    try {
        [hashtable]$getArgs = @{'ErrorAction' = 'Stop'; 'TenantId' = $TenantId}
        if ($IsAgentRole) { $getArgs.Add('IsAgentRole', $true) }
        if ($HasLicenseErrorsOnly) { $getArgs.Add('HasLicenseErrorsOnly', $true) }
        if ($HasErrorsOnly) { $getArgs.Add('HasErrorsOnly', $true) }

        $result = Get-MsolGroup @getArgs -GroupType $GroupType | Select-Object DisplayName, EmailAddress, ObjectId, GroupType
        if ($null -eq $result -or $result.Count -eq 0) { Write-Output "No groups found"; return }
        Write-Output ($result | ConvertTo-Html -Fragment)
    }
    catch { throw }
}

Customize

IsAgentRole switch

Off

Only agent groups

HasLicenseErrorsOnly switch

Off

Only security groups with license errors

HasErrorsOnly switch

Off

Only groups with validation errors

GroupType string

Type of groups to retrieve

TenantId guid

Unique ID of the tenant