Skip to content

aad user list

Lists users matching specified criteria


m365 aad user list [options]


-p, --properties [properties]
Comma-separated list of properties to retrieve
-h, --help
output usage information
--query [query]
JMESPath query string. See for more information and examples
-o, --output [output]
Output type. json,text,csv. Default json
Runs command with verbose logging
Runs command with debug logging


Using the --properties option, you can specify a comma-separated list of user properties to retrieve from the Microsoft Graph. If you don't specify any properties, the command will retrieve user's display name and account name.

To filter the list of users, include additional options that match the user property that you want to filter with. For example --displayName Patt will return all users whose displayName starts with Patt. Multiple filters will be combined using the and operator.

Certain properties cannot be returned within a user collection. The following properties are only supported when retrieving an single user using: aboutMe, birthday, hireDate, interests, mySite, pastProjects, preferredName, responsibilities, schools, skills, mailboxSettings.


List all users in the tenant

m365 aad user list

List all users in the tenant. For each one return the display name and e-mail address

m365 aad user list --properties "displayName,mail"

Show users whose display name starts with Patt

m365 aad user list --displayName Patt

Show all account managers whose display name starts with Patt

m365 aad user list --displayName Patt --jobTitle 'Account manager'

More information