Commands › Exchange Online

Get-EligibleDistributionGroupForMigration

Exchange Online ExchangeOnlineManagement Get-*

This cmdlet is functional only in the cloud-based service. Use the Get-EligibleDistributionGroupForMigration cmdlet to identify distribution groups that can be upgraded to Microsoft 365 Groups. You can't upgrade mail-enabled security groups to Microsoft 365 Groups.

Quick start script

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

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

Syntax — 2 parameter sets

Identity

Get-EligibleDistributionGroupForMigration [[-Identity] <DistributionGroupIdParameter>]
 [-OrganizationalUnit <OrganizationalUnitIdParameter>]
 [-ResultSize <Unlimited>]
 [<CommonParameters>]

ManagedBy

Get-EligibleDistributionGroupForMigration [-ManagedBy <GeneralRecipientIdParameter>]
 [-OrganizationalUnit <OrganizationalUnitIdParameter>]
 [-ResultSize <Unlimited>]
 [<CommonParameters>]

Parameters (4)

Parameter	Type	What it controls
-Identity	DistributionGroupIdParameter	The Identity parameter filters the results by the email address of the specified distribution group. If no results are returned for the specified email address, the group can't be upgraded to a Microsoft 365 Group.
-ManagedBy	GeneralRecipientIdParameter	The ManagedBy parameter filters the results by the manager of the distribution group (the ManagedBy property). You can use any value that uniquely identifies the distribution group manager. For example:
-OrganizationalUnit	OrganizationalUnitIdParameter	The OrganizationalUnit parameter filters the results based on the object's location in Active Directory. Only objects that exist in the specified location are returned. Valid input for this parameter is an...
-ResultSize	Unlimited	The ResultSize parameter specifies the maximum number of results to return. If you want to return all requests that match the query, use unlimited for the value of this parameter. The default value is 1000.

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