Skip to content

aad o365group list

Lists Microsoft 365 Groups in the current tenant

Usage

m365 aad o365group list [options]

Options

-h, --help
output usage information
-d, --displayName [displayName]
Retrieve only groups with displayName starting with the specified value
-m, --mailNickname [displayName]
Retrieve only groups with mailNickname starting with the specified value
--includeSiteUrl
Set to retrieve the site URL for each group
--deleted
Set to only retrieve deleted groups
--orphaned
Set to only retrieve groups without owners
--query [query]
JMESPath query string. See http://jmespath.org/ for more information and examples
-o, --output [output]
Output type. json,text. Default text
--verbose
Runs command with verbose logging
--debug
Runs command with debug logging

Remarks

Using the --includeSiteUrl option, you can retrieve the URL of the site associated with the particular Microsoft 365 Group. If you however retrieve too many groups and will try to get their site URLs, you will most likely get an error as the command will get throttled, issuing too many requests, too frequently. If you get an error, consider narrowing down the result set using the --displayName and --mailNickname filters.

Retrieving the URL of the site associated with the particular Microsoft 365 Group is not possible when retrieving deleted groups.

Using the --orphaned option, you can retrieve Microsoft 365 Groups without owners.

Examples

List all Microsoft 365 Groups in the tenant

m365 aad o365group list

List Microsoft 365 Groups with display name starting with Project

m365 aad o365group list --displayName Project

List Microsoft 365 Groups mail nick name starting with team

m365 aad o365group list --mailNickname team

List deleted Microsoft 365 Groups with display name starting with Project

m365 aad o365group list --displayName Project --deleted

List deleted Microsoft 365 Groups mail nick name starting with team

m365 aad o365group list --mailNickname team --deleted

List Microsoft 365 Groups with display name starting with Project including the URL of the corresponding SharePoint site

m365 aad o365group list --displayName Project --includeSiteUrl

List Microsoft 365 Groups without owners

m365 aad o365group list --orphaned