New command: viva engage role member remove #6821
Description
Usage
m365 viva engage role member remove [options]
Description
Revoke a Viva Engage role from a user
Options
| Option | Description |
|---|---|
--roleId [roleId] |
The id of the Viva Engage role. Specify either roleId or roleName, but not both. |
--roleName [roleName] |
The name of the Viva Engage role. Specify either roleId or roleName, but not both. |
--userId [userId] |
The id of the user to be removed from the Viva Engage role. Specify either userId or userName, but not both. |
--userName [userName] |
The UPN of the user to be removed from the Viva Engage role. Specify either userId or userName, but not both. |
--force |
Do not prompt for confirmation |
Examples
Remove a user specified by id from a Viva Engage role specified by a name
m365 viva engage role member remove --userId 7a2ca997-9461-402e-9882-58088a370889 --roleName 'Verified Admin'
Remove a user specified by UPN from a Viva Engage role specified by id and do not prompt for confirmation
m365 viva engage role member remove --userName [email protected] --roleId 77aa47ad-96fe-4ecc-8024-fd1ac5e28f17 --force
Default properties
Additional Info
Requires new permission EngagementRole.ReadWrite.All
It's a beta endpoint, let's not forget to mention this in the docs with an admonition.
More info: https://learn.microsoft.com/graph/api/engagementrole-delete-members?view=graph-rest-beta