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 john.doe@contoso.com --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
Usage
m365 viva engage role member remove [options]
Description
Revoke a Viva Engage role from a user
Options
--roleId [roleId]roleIdorroleName, but not both.--roleName [roleName]roleIdorroleName, but not both.--userId [userId]userIdoruserName, but not both.--userName [userName]userIdoruserName, but not both.--forceExamples
Remove a user specified by id from a Viva Engage role specified by a name
Remove a user specified by UPN from a Viva Engage role specified by id and do not prompt for confirmation
Default properties
Additional Info
Requires new permission
EngagementRole.ReadWrite.AllIt'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