Skip to content

Latest commit

 

History

History
141 lines (99 loc) · 3.49 KB

group-user-list.mdx

File metadata and controls

141 lines (99 loc) · 3.49 KB
Raw

import Global from '/docs/cmd/_global.mdx'; import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem';

entra group user list

Lists users of a specific Entra group

Usage

m365 entra group user list [options]

Alias

m365 aad group user list [options]

Options

`-i, --groupId [groupId]`
: The ID of the Entra group. Specify `groupId` or `groupDisplayName` but not both.

`-n, --groupDisplayName [groupDisplayName]`
: The display name of the Entra group. Specify `groupId` or `groupDisplayName` but not both.

`-r, --role [role]`
: Filter the results to only users with the given role: `Owner`, `Member`.

`-p, --properties [properties]`
: Comma-separated list of properties to retrieve.

`-f, --filter [filter]`
: OData filter to use to query the list of users with.

Remarks

When the properties option includes values with a /, for example: manager/displayName, an additional $expand query parameter will be included on manager.

Examples

List all group users from a group specified by ID.

m365 entra group user list --groupId 03cba9da-3974-46c1-afaf-79caa2e45bbe

List all owners from a group specified by display name.

m365 entra group user list --groupDisplayName Developers --role Owner

List all group users from a group specified by name. For each one return the display name, e-mail address, and manager display name.

m365 entra group user list --groupDisplayName Developers --properties "displayName,mail,manager/displayName"

List all group users from a group specified by name. For each one return the display name, e-mail address, and manager information.

m365 entra group user list --groupDisplayName Developers --properties "displayName,mail,manager/*"

List all group members that are guest users.

m365 entra group user list --groupDisplayName Developers --filter "userType eq 'Guest'"

Response

[
  {
    "id": "da52218e-4822-4ac6-b41d-255e2059655e",
    "displayName": "Adele Vance",
    "userPrincipalName": "AdeleV@contoso.OnMicrosoft.com",
    "givenName": "Adele",
    "surname": "Vance",
    "roles": [
      "Owner",
      "Member"
    ]
  }
]
id                                    displayName           userPrincipalName                     roles
------------------------------------  --------------------  ------------------------------------  --------
da52218e-4822-4ac6-b41d-255e2059655e  Adele Vance           AdeleV@contoso.OnMicrosoft.com        Owner,Member

id,displayName,userPrincipalName,givenName,surname
da52218e-4822-4ac6-b41d-255e2059655e,Adele Vance,AdeleV@contoso.OnMicrosoft.com,Adele,Vance

# entra group user list --groupId "1deaa428-8dde-4043-b028-5492226d6114"

Date: 2023-10-02

## Adele Vance (da52218e-4822-4ac6-b41d-255e2059655e)

Property | Value
---------|-------
id | da52218e-4822-4ac6-b41d-255e2059655e
displayName | Adele Vance
userPrincipalName | AdeleV@contoso.OnMicrosoft.com
givenName | Adele
surname | Vance

More information