Skip to content

spo listitem roleassignment add

Adds a role assignment to a listitem.

Usage

m365 spo listitem roleassignment add [options]

Options

-u, --webUrl <webUrl>
URL of the site where the listitem is located
--listId [listId]
ID of the list. Specify either listId, listTitle or listUrl but not multiple.
--listTitle [listTitle]
Title of the list. Specify either listId, listTitle or listUrl but not multiple.
--listUrl [listUrl]
Relative URL of the list. Specify either listId, listTitle or listUrl but not multiple.
--listItemId <listItemId>
Id of the listitem to assign the role to.
--principalId [principalId]
The SharePoint Id of the principal. It may be either a user id or group id to add a role assignment for. Specify either upn, groupName or principalId.
--upn [upn]
upn/email of user to assign role to. Specify either upn, groupName or principalId.
--groupName [groupName]
The group name of Azure AD or SharePoint group. Specify either upn, groupName or principalId.
--roleDefinitionId [roleDefinitionId]
ID of role definition. Specify either roleDefinitionId or roleDefinitionName but not both
--roleDefinitionName [roleDefinitionName]
Enter the name of a role definition, like 'Contribute', 'Read', etc. Specify either roleDefinitionId or roleDefinitionName 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, response, full. Default is full.
--query [query]
JMESPath query string. See http://jmespath.org/ for more information and examples
-o, --output [output]
Output type. json,text,csv,md. Default json
--verbose
Runs command with verbose logging
--debug
Runs command with debug logging

Examples

Add role assignment to specified listitem in specified list located in specified site for specified principal id and specified role definition id.

m365 spo listitem roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --listItemId 1 --principalId 11 --roleDefinitionId 1073741829

Add role assignment to specified listitem in specified list located in specified site for specified principal id and specified role definition id.

m365 spo listitem roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listId "0CD891EF-AFCE-4E55-B836-FCE03286CCCF" --listItemId 1 --principalId 11 --roleDefinitionId 1073741829

Add role assignment to specified listitem in specified list located in specified site for specified principal id and specified role definition id.

m365 spo listitem roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listUrl "sites/documents" --listItemId 1 --principalId 11 --roleDefinitionId 1073741829

Add role assignment to specified listitem in specified list located in specified site for specified upn and specified role definition id.

m365 spo listitem roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --listItemId 1 --upn "someaccount@tenant.onmicrosoft.com" --roleDefinitionId 1073741829

Add role assignment to specified listitem in specified list located in specified site for specified group and specified role definition id.

m365 spo listitem roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --listItemId 1 --groupName "someGroup" --roleDefinitionId 1073741829

Add role assignment to specified listitem in specified list located in specified site for specified principal id and specified role definition name.

m365 spo listitem roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --listItemId 1 --principalId 11 --roleDefinitionName "Full Control"

Response

The command won't return a response on success.