viva engage role member list
Lists all users assigned to a Viva Engage role
Usage
m365 viva engage role member list [options]
Options
-i, --roleId [roleId]
The id of the Viva Engage role. Specify either
roleId
orroleName
, but not both.-n, --roleName [roleName]
The name of the Viva Engage role. Specify either
roleId
orroleName
, but not both.
-h, --help [help]
Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are
options
,examples
,remarks
,permissions
,response
,full
. Default isoptions
.--query [query]
JMESPath query string. See http://jmespath.org/ for more information and examples.
-o, --output [output]
Output type.
json
,text
,csv
,md
,none
. Defaultjson
.--verbose
Runs command with verbose logging.
--debug
Runs command with debug logging.
Remarks
This command is based on an API that is currently in preview and is subject to change once the API reaches general availability.
Permissions
- Delegated
- Application
Resource | Permissions |
---|---|
Microsoft Graph | EngagementRole.Read.All |
Resource | Permissions |
---|---|
Microsoft Graph | EngagementRole.Read.All |
Examples
Get all users assigned to a Viva Engage role specified by id
m365 viva engage role member list --roleId 77aa47ad-96fe-4ecc-8024-fd1ac5e28f17
Get all users assigned to a Viva Engage role specified by name
m365 viva engage role member list --roleName 'Verified Admin'
Response
- JSON
- Text
- CSV
- Markdown
[
{
"id": "1f5595b2-aa07-445d-9801-a45ea18160b2",
"createdDateTime": "2024-05-22T15:43:08.368Z",
"userId": "1f5595b2-aa07-445d-9801-a45ea18160b2"
}
]
id userId
------------------------------------ ------------------------------------
1f5595b2-aa07-445d-9801-a45ea18160b2 1f5595b2-aa07-445d-9801-a45ea18160b2
id,createdDateTime,userId
1f5595b2-aa07-445d-9801-a45ea18160b2,2024-05-22T15:43:08.406Z,1f5595b2-aa07-445d-9801-a45ea18160b2
# viva engage role member list --roleId "966b8ec4-6457-4f22-bd3c-5a2520e98f4a"
Date: 8/1/2025
## 1f5595b2-aa07-445d-9801-a45ea18160b2
Property | Value
---------|-------
id | 1f5595b2-aa07-445d-9801-a45ea18160b2
createdDateTime | 2024-05-22T15:43:08.406Z
userId | 1f5595b2-aa07-445d-9801-a45ea18160b2