@pnp/cli-microsoft365 6.0.0-beta.8352f49 → 6.0.0-beta.9e3459d

package/docs/docs/cmd/spo/folder/folder-rename.md

@@ -13,7 +13,7 @@ m365 spo folder rename [options]
 `-u, --webUrl <webUrl>`
 : The URL of the site where the folder to be renamed is located
 
-`-f, --folderUrl <folderUrl>`
+`-f, --url <url>`
 : Site-relative URL of the folder (including the folder)
 
 `-n, --name`
@@ -26,5 +26,5 @@ m365 spo folder rename [options]
 Renames a folder with site-relative URL _/Shared Documents/My Folder 1_ located in site _https://contoso.sharepoint.com/sites/project-x_
 
 ```sh
-m365 spo folder rename --webUrl https://contoso.sharepoint.com/sites/project-x --folderUrl '/Shared Documents/My Folder 1' --name 'My Folder 2'
+m365 spo folder rename --webUrl https://contoso.sharepoint.com/sites/project-x --url '/Shared Documents/My Folder 1' --name 'My Folder 2'
 ```

package/docs/docs/cmd/spo/folder/folder-roleinheritance-break.md

@@ -0,0 +1,39 @@
+# spo folder roleinheritance break
+
+Breaks the role inheritance of a folder.
+
+## Usage
+
+```sh
+m365 spo folder roleinheritance break [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: URL of the site where the folder is located.
+
+`-f, --folderUrl <folderUrl>`
+: The site-relative URL or server-relative URL of the folder.
+
+`-c, --clearExistingPermissions`
+: Clear all existing permissions from the folder.
+
+`--confirm`
+: Don't prompt for confirmation to breaking role inheritance of the folder.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Break the inheritance of a folder with a specified site-relative URL.
+
+```sh
+m365 spo folder roleinheritance break --webUrl "https://contoso.sharepoint.com/sites/project-x" --folderUrl "Shared Documents/TestFolder"
+```
+
+Break the inheritance of a folder with a specified server-relative URL. It will clear the existing permissions of the folder. It will **not** prompt for confirmation before breaking the inheritance.
+
+```sh
+m365 spo folder roleinheritance break --webUrl "https://contoso.sharepoint.com/sites/project-x" --folderUrl "/sites/project-x/Shared Documents/TestFolder" --clearExistingPermissions --confirm
+```

package/docs/docs/cmd/spo/folder/folder-roleinheritance-reset.md

@@ -0,0 +1,36 @@
+# spo folder roleinheritance reset
+
+Restores the role inheritance of a folder.
+
+## Usage
+
+```sh
+m365 spo folder roleinheritance reset [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: URL of the site where the folder is located.
+
+`-f, --folderUrl <folderUrl>`
+: The site-relative URL of the folder.
+
+`--confirm`
+: Don't prompt for confirmation to reset role inheritance of the folder.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Reset inheritance of folder with site-relative url _Shared Documents/TestFolder_ located in site _https://contoso.sharepoint.com/sites/project-x_.
+
+```sh
+m365 spo folder roleinheritance reset --webUrl "https://contoso.sharepoint.com/sites/project-x" --folderUrl "Shared Documents/TestFolder"
+```
+
+Reset inheritance of folder with server-relative url _/sites/project-x/Shared Documents/TestFolder_ located in site _https://contoso.sharepoint.com/sites/project-x_. It will **not** prompt for confirmation before resetting.
+
+```sh
+m365 spo folder roleinheritance reset --webUrl "https://contoso.sharepoint.com/sites/project-x" --folderUrl "/sites/project-x/Shared Documents/TestFolder" --confirm
+```

package/docs/docs/cmd/spo/group/group-add.md

@@ -0,0 +1,51 @@
+# spo group add
+
+Creates group in the specified site
+
+## Usage
+
+```sh
+m365 spo group add [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: URL of the site where the group should be added.
+
+`-n, --name <name>`
+: Name of the group to add.
+
+`--description [description]`
+: The description for the group.
+
+`--allowMembersEditMembership [allowMembersEditMembership]`
+: Who can edit the membership of the group? When `true` members can edit membership, otherwise only owners can do this. Default `false`.
+
+`--onlyAllowMembersViewMembership [onlyAllowMembersViewMembership]`
+: Who can view the membership of the group? When `false` everyone can view the group membership, otherwise only group members can. Default `true`.
+
+`--allowRequestToJoinLeave [allowRequestToJoinLeave]`
+: Specify whether to allow users to request membership in this group and allow users to request to leave the group. Default `false`.
+
+`--autoAcceptRequestToJoinLeave [autoAcceptRequestToJoinLeave]`
+: If auto-accept is enabled, users will automatically be added or removed when they make a request. Default `false`.
+
+`--requestToJoinLeaveEmailSetting [requestToJoinLeaveEmailSetting]`
+: All membership requests will be sent to the email address specified.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Create group with title and description
+
+```sh
+m365 spo group add --webUrl https://contoso.sharepoint.com/sites/project-x --name "Project leaders" --description "This group contains all project leaders"
+```
+
+Create group with membership requests
+
+```sh
+m365 spo group add --webUrl https://contoso.sharepoint.com/sites/project-x --name "Project leaders" --allowRequestToJoinLeave true --requestToJoinLeaveEmailSetting john.doe@contoso.com
+```

package/docs/docs/cmd/spo/group/group-get.md

@@ -11,13 +11,16 @@ m365 spo group get [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: URL of the site where the group is located
+: URL of the site where the group is located.
 
 `-i, --id [id]`
-: ID of the site group to get. Use either `id` or `name`, but not all. e.g `7`
+: ID of the site group to get. Use either `id`, `name` or `associatedGroup` but not multiple.
 
 `--name [name]`
-: Name of the site group to get. Specify either `id` or `name` but not both e.g `Team Site Members`
+: Name of the site group to get. Use either `id`, `name` or `associatedGroup` but not multiple.
+
+`--associatedGroup [associatedGroup]`
+: Type of the associated group to get. Available values: `Owner`, `Member`, `Visitor`. Use either `id`, `name` or `associatedGroup` but not multiple.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -34,3 +37,9 @@ Get group with name _Team Site Members_ for web _https://contoso.sharepoint.com/
 ```sh
 m365 spo group get --webUrl https://contoso.sharepoint.com/sites/project-x --name "Team Site Members"
 ```
+
+Get the associated owner group of a specified site
+
+```sh
+m365 spo group get --webUrl https://contoso.sharepoint.com/sites/project-x --associatedGroup Owner
+```

package/docs/docs/cmd/spo/group/group-set.md

@@ -0,0 +1,69 @@
+# spo group set
+
+Updates a group in the specified site
+
+## Usage
+
+```sh
+m365 spo group set [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: URL of the site where the group is located.
+
+`-i, --id [id]`
+: ID of the group to update. Specify either `id` or `name` but not both.
+
+`-n, --name [name]`
+: Name of the group. Specify either `id` or `name` but not both.
+
+`--newName [newName]`
+: New name for the group.
+
+`--description [description]`
+: The description for the group.
+
+`--allowMembersEditMembership [allowMembersEditMembership]`
+: Who can edit the membership of the group? When `true` members can edit membership, otherwise only owners can do this.
+
+`--onlyAllowMembersViewMembership [onlyAllowMembersViewMembership]`
+: Who can view the membership of the group? When `true` only group members can view the membership, otherwise everyone can.
+
+`--allowRequestToJoinLeave [allowRequestToJoinLeave]`
+: Specify whether to allow users to request membership in this group and allow users to request to leave the group.
+
+`--autoAcceptRequestToJoinLeave [autoAcceptRequestToJoinLeave]`
+: If auto-accept is enabled, users will automatically be added or removed when they make a request.
+
+`--requestToJoinLeaveEmailSetting [requestToJoinLeaveEmailSetting]`
+: All membership requests will be sent to the email address specified.
+
+`--ownerEmail [ownerEmail]`
+: Set user with this email as owner of the group. Specify either `ownerEmail` or `ownerUserName` but not both.
+
+`--ownerUserName [ownerUserName]`
+: Set user with this login name as owner of the group. Specify either `ownerEmail` or `ownerUserName` but not both.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Update group title and description
+
+```sh
+m365 spo group set --webUrl https://contoso.sharepoint.com/sites/project-x --id 18 --newTitle "Project leaders" --description "This group contains all project leaders"
+```
+
+Update group with membership requests
+
+```sh
+m365 spo group set --webUrl https://contoso.sharepoint.com/sites/project-x --title "Project leaders" --allowRequestToJoinLeave true --requestToJoinLeaveEmailSetting john.doe@contoso.com
+```
+
+Sets a specified user as group owner
+
+```sh
+m365 spo group set --webUrl https://contoso.sharepoint.com/sites/project-x --id 18 --ownerEmail john.doe@contoso.com
+```

package/docs/docs/cmd/spo/hubsite/hubsite-connect.md

@@ -10,10 +10,10 @@ m365 spo hubsite connect [options]
 
 ## Options
 
-`-u, --url <url>`
+`-u, --siteUrl <siteUrl>`
 : The URL of the site collection to connect to the hub site
 
-`-i, --hubSiteId <hubSiteId>`
+`-i, --id <id>`
 : The ID of the hub site to which to connect the site collection
 
 --8<-- "docs/cmd/_global.md"
@@ -25,14 +25,14 @@ m365 spo hubsite connect [options]
 
 If the specified site collection is already connected to a hub site, it will be disconnected and connected to the newly specified hub site.
 
-If the specified `hubSiteId` doesn't point to a valid hub site, you will get a `ResourceNotFoundException` error.
+If the specified `id` doesn't point to a valid hub site, you will get a `ResourceNotFoundException` error.
 
 ## Examples
 
 Connect the site collection with URL _https://contoso.sharepoint.com/sites/contoso-sales_ to the hub site with ID _255a50b2-527f-4413-8485-57f4c17a24d1_
 
 ```sh
-m365 spo hubsite connect --url https://contoso.sharepoint.com/sites/contoso-sales --hubSiteId 255a50b2-527f-4413-8485-57f4c17a24d1
+m365 spo hubsite connect --siteUrl https://contoso.sharepoint.com/sites/contoso-sales --id 255a50b2-527f-4413-8485-57f4c17a24d1
 ```
 
 ## More information

package/docs/docs/cmd/spo/hubsite/hubsite-disconnect.md

@@ -1,6 +1,6 @@
 # spo hubsite disconnect
 
-Disconnects the specifies site collection from its hub site
+Disconnects the specified site collection from its hub site
 
 ## Usage
 
@@ -10,7 +10,7 @@ m365 spo hubsite disconnect [options]
 
 ## Options
 
-`-u, --url <url>`
+`-u, --siteUrl <siteUrl>`
 : URL of the site collection to disconnect from its hub site
 
 `--confirm`
@@ -28,13 +28,13 @@ m365 spo hubsite disconnect [options]
 Disconnect the site collection with URL _https://contoso.sharepoint.com/sites/sales_ from its hub site. Will prompt for confirmation before disconnecting from the hub site.
 
 ```sh
-m365 spo hubsite disconnect --url https://contoso.sharepoint.com/sites/sales
+m365 spo hubsite disconnect --siteUrl https://contoso.sharepoint.com/sites/sales
 ```
 
-Disconnect the site collection with URL _https://contoso.sharepoint.com/sites/sales- from its hub site without prompting for confirmation
+Disconnect the site collection with URL _https://contoso.sharepoint.com/sites/sales_ from its hub site without prompting for confirmation
 
 ```sh
-m365 spo hubsite disconnect --url https://contoso.sharepoint.com/sites/sales --confirm
+m365 spo hubsite disconnect --siteUrl https://contoso.sharepoint.com/sites/sales --confirm
 ```
 
 ## More information

package/docs/docs/cmd/spo/hubsite/hubsite-get.md

@@ -10,17 +10,19 @@ m365 spo hubsite get [options]
 
 ## Options
 
-`-i, --id <id>`
-: Hub site ID
+`-i, --id [id]`
+: ID of the hub site. Specify either `id`, `title` or `url` but not multiple.
 
---8<-- "docs/cmd/_global.md"
+`-t, --title [title]`
+: Title of the hub site. Specify either `id`, `title` or `url` but not multiple.
 
-## Remarks
+`-u, --url [url]`
+: URL of the hub site. Specify either `id`, `title` or `url` but not multiple.
 
-!!! attention
-    This command is based on a SharePoint API that is currently in preview and is subject to change once the API reached general availability.
+`--includeAssociatedSites`
+: Include the associated sites in the result (only in JSON output)
 
-If the specified `id` doesn't refer to an existing hub site, you will get a `ResourceNotFoundException` error.
+--8<-- "docs/cmd/_global.md"
 
 ## Examples
 
@@ -30,6 +32,36 @@ Get information about the hub site with ID _2c1ba4c4-cd9b-4417-832f-92a34bc34b2a
 m365 spo hubsite get --id 2c1ba4c4-cd9b-4417-832f-92a34bc34b2a
 ```
 
+Get information about the hub site with Title _My Hub Site_
+
+```sh
+m365 spo hubsite get --title 'My Hub Site'
+```
+
+Get information about the hub site with URL _https://contoso.sharepoint.com/sites/HubSite_
+
+```sh
+m365 spo hubsite get --url 'https://contoso.sharepoint.com/sites/HubSite'
+```
+
+Get information about the hub site with ID _2c1ba4c4-cd9b-4417-832f-92a34bc34b2a_, including its associated sites. Associated site info is only shown in JSON output.
+
+```sh
+m365 spo hubsite get --id 2c1ba4c4-cd9b-4417-832f-92a34bc34b2a --includeAssociatedSites --output json
+```
+
+Get information about the hub site with Title _My Hub Site_
+
+```sh
+m365 spo hubsite get --title "My Hub Site"
+```
+
+Get information about the hub site with URL _https://contoso.sharepoint.com/sites/HubSite_
+
+```sh
+m365 spo hubsite get --url "https://contoso.sharepoint.com/sites/HubSite"
+```
+
 ## More information
 
 - SharePoint hub sites new in Microsoft 365: [https://techcommunity.microsoft.com/t5/SharePoint-Blog/SharePoint-hub-sites-new-in-Office-365/ba-p/109547](https://techcommunity.microsoft.com/t5/SharePoint-Blog/SharePoint-hub-sites-new-in-Office-365/ba-p/109547)

package/docs/docs/cmd/spo/hubsite/hubsite-register.md

@@ -10,7 +10,7 @@ m365 spo hubsite register [options]
 
 ## Options
 
-`-u, --url <url>`
+`-u, --siteUrl <siteUrl>`
 : URL of the site collection to register as a hub site
 
 --8<-- "docs/cmd/_global.md"
@@ -27,7 +27,7 @@ If the specified site collection is already registered as a hub site, you will g
 Register the site collection with URL _https://contoso.sharepoint.com/sites/sales_ as a hub site
 
 ```sh
-m365 spo hubsite register --url https://contoso.sharepoint.com/sites/sales
+m365 spo hubsite register --siteUrl https://contoso.sharepoint.com/sites/sales
 ```
 
 ## More information

package/docs/docs/cmd/spo/hubsite/hubsite-rights-grant.md

@@ -10,7 +10,7 @@ m365 spo hubsite rights grant [options]
 
 ## Options
 
-`-u, --url <url>`
+`-u, --hubSiteUrl <hubSiteUrl>`
 : The URL of the hub site to grant rights on
 
 `-p, --principals <principals>`
@@ -34,19 +34,19 @@ m365 spo hubsite rights grant [options]
 Grant user with alias _PattiF_ permission to join sites to the hub site with URL _https://contoso.sharepoint.com/sites/sales_
 
 ```sh
-m365 spo hubsite rights grant --url https://contoso.sharepoint.com/sites/sales --principals PattiF --rights Join
+m365 spo hubsite rights grant --hubSiteUrl https://contoso.sharepoint.com/sites/sales --principals PattiF --rights Join
 ```
 
 Grant users with aliases _PattiF_ and _AdeleV_ permission to join sites to the hub site with URL _https://contoso.sharepoint.com/sites/sales_
 
 ```sh
-m365 spo hubsite rights grant --url https://contoso.sharepoint.com/sites/sales --principals "PattiF,AdeleV" --rights Join
+m365 spo hubsite rights grant --hubSiteUrl https://contoso.sharepoint.com/sites/sales --principals "PattiF,AdeleV" --rights Join
 ```
 
 Grant user with email _PattiF@contoso.com_ permission to join sites to the hub site with URL _https://contoso.sharepoint.com/sites/sales_
 
 ```sh
-m365 spo hubsite rights grant --url https://contoso.sharepoint.com/sites/sales --principals PattiF@contoso.com --rights Join
+m365 spo hubsite rights grant --hubSiteUrl https://contoso.sharepoint.com/sites/sales --principals PattiF@contoso.com --rights Join
 ```
 
 ## More information

package/docs/docs/cmd/spo/hubsite/hubsite-rights-revoke.md

@@ -10,7 +10,7 @@ m365 spo hubsite rights revoke [options]
 
 ## Options
 
-`-u, --url <url>`
+`-u, --hubSiteUrl <hubSiteUrl>`
 : The URL of the hub site to revoke rights on
 
 `-p, --principals <principals>`
@@ -34,13 +34,13 @@ m365 spo hubsite rights revoke [options]
 Revoke rights to join sites to the hub site with URL _https://contoso.sharepoint.com/sites/sales_ from user with alias _PattiF_. Will prompt for confirmation before revoking the rights
 
 ```sh
-m365 spo hubsite rights revoke --url https://contoso.sharepoint.com/sites/sales --principals PattiF
+m365 spo hubsite rights revoke --hubSiteUrl https://contoso.sharepoint.com/sites/sales --principals PattiF
 ```
 
 Revoke rights to join sites to the hub site with URL _https://contoso.sharepoint.com/sites/sales_ from user with aliases _PattiF_ and _AdeleV_ without prompting for confirmation
 
 ```sh
-m365 spo hubsite rights revoke --url https://contoso.sharepoint.com/sites/sales --principals "PattiF,AdeleV" --confirm
+m365 spo hubsite rights revoke --hubSiteUrl https://contoso.sharepoint.com/sites/sales --principals "PattiF,AdeleV" --confirm
 ```
 
 ## More information

package/docs/docs/cmd/spo/hubsite/hubsite-unregister.md

@@ -1,6 +1,6 @@
 # spo hubsite unregister
 
-Unregisters the specifies site collection as a hub site
+Unregisters the specified site collection as a hub site
 
 ## Usage
 
@@ -33,7 +33,7 @@ Unregister the site collection with URL _https://contoso.sharepoint.com/sites/sa
 m365 spo hubsite unregister --url https://contoso.sharepoint.com/sites/sales
 ```
 
-Unregister the site collection with URL _https://contoso.sharepoint.com/sites/sales_ as a hub site without prompting for confirmation
+Unregister the site collection with URL _https://contoso.sharepoint.com/sites/sales_ as a hub site without prompting for confirmation.
 
 ```sh
 m365 spo hubsite unregister --url https://contoso.sharepoint.com/sites/sales --confirm

package/docs/docs/cmd/spo/knowledgehub/knowledgehub-set.md

@@ -10,7 +10,7 @@ m365 spo knowledgehub set [options]
 
 ## Options
 
-`-u, --url <url>`
+`-u, --siteUrl <siteUrl>`
 : URL of the site to set as Knowledge Hub
 
 --8<-- "docs/cmd/_global.md"
@@ -27,5 +27,5 @@ If the specified url doesn't refer to an existing site collection, you will get
 Sets the Knowledge Hub Site for your tenant
 
 ```sh
-m365 spo knowledgehub set --url https://contoso.sharepoint.com/sites/knowledgesite
+m365 spo knowledgehub set --siteUrl https://contoso.sharepoint.com/sites/knowledgesite
 ```

package/docs/docs/cmd/spo/list/list-contenttype-add.md

@@ -19,7 +19,7 @@ m365 spo list contenttype add [options]
 `-t, --listTitle [listTitle]`
 : Title of the list to which to add the content type. Specify `listId` or `listTitle` but not both
 
-`-c, --contentTypeId <contentTypeId>`
+`-i, --id <id>`
 : ID of the content type to add to the list
 
 --8<-- "docs/cmd/_global.md"
@@ -29,11 +29,11 @@ m365 spo list contenttype add [options]
 Add existing content type with ID _0x0120_ to the list with ID _0cd891ef-afce-4e55-b836-fce03286cccf_ located in site _https://contoso.sharepoint.com/sites/project-x_
 
 ```sh
-m365 spo list contenttype add --webUrl https://contoso.sharepoint.com/sites/project-x --listId 0cd891ef-afce-4e55-b836-fce03286cccf --contentTypeId 0x0120
+m365 spo list contenttype add --webUrl https://contoso.sharepoint.com/sites/project-x --listId 0cd891ef-afce-4e55-b836-fce03286cccf --id 0x0120
 ```
 
 Add existing content type with ID _0x0120_ to the list with title _Documents_ located in site _https://contoso.sharepoint.com/sites/project-x_
 
 ```sh
-m365 spo list contenttype add --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle Documents --contentTypeId 0x0120
+m365 spo list contenttype add --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle Documents --id 0x0120
 ```

package/docs/docs/cmd/spo/list/list-contenttype-remove.md

@@ -19,7 +19,7 @@ m365 spo list contenttype remove [options]
 `-t, --listTitle [listTitle]`
 : Title of the list from which to remove the content type, specify `listId` or `listTitle` but not both
 
-`-c, --contentTypeId <contentTypeId>`
+`-i, --id <id>`
 : ID of the content type to remove from the list
 
 `--confirm`
@@ -32,11 +32,11 @@ m365 spo list contenttype remove [options]
 Remove content type with ID _0x010109010053EE7AEB1FC54A41B4D9F66ADBDC312A_ from the list with ID _0cd891ef-afce-4e55-b836-fce03286cccf_ located in site _https://contoso.sharepoint.com/sites/project-x_
 
 ```sh
-m365 spo list contenttype remove --webUrl https://contoso.sharepoint.com/sites/project-x --listId 0cd891ef-afce-4e55-b836-fce03286cccf --contentTypeId 0x010109010053EE7AEB1FC54A41B4D9F66ADBDC312A
+m365 spo list contenttype remove --webUrl https://contoso.sharepoint.com/sites/project-x --listId 0cd891ef-afce-4e55-b836-fce03286cccf --id 0x010109010053EE7AEB1FC54A41B4D9F66ADBDC312A
 ```
 
 Remove content type with ID _0x010109010053EE7AEB1FC54A41B4D9F66ADBDC312A_ from the list with title _Documents_ located in site _https://contoso.sharepoint.com/sites/project-x_
 
 ```sh
-m365 spo list contenttype remove --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle Documents --contentTypeId 0x010109010053EE7AEB1FC54A41B4D9F66ADBDC312A
+m365 spo list contenttype remove --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle Documents --id 0x010109010053EE7AEB1FC54A41B4D9F66ADBDC312A
 ```

package/docs/docs/cmd/spo/list/list-list.md

@@ -13,9 +13,6 @@ m365 spo list list [options]
 `-u, --webUrl <webUrl>`
 : URL of the site where the lists to retrieve are located
 
-`--executeWithLimitedPermissions`
-: Use this option to execute this command with site member or visitor permissions. Not specifying this option will require site owner (or admin) permissions.
-
 --8<-- "docs/cmd/_global.md"
 
 ## Examples

package/docs/docs/cmd/spo/list/list-roleassignment-add.md

@@ -0,0 +1,78 @@
+# spo list roleassignment add
+
+Adds a role assignment to list permissions
+
+## Usage
+
+```sh
+m365 spo list roleassignment add [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: URL of the site where the list is located
+
+`-i, --listId [listId]`
+: ID of the list. Specify either listId, listTitle or listUrl but not multiple.
+
+`-t, --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.
+
+`--principalId [principalId]`
+: SharePoint ID of principal it may be either user id or group id we want to add permissions to. Specify principalId only when upn or groupName are not used.
+
+`--upn [upn]`
+: Upn/email of user to assign role to. Specify either upn or principalId
+
+`--groupName [groupName]`
+: Enter group name of Azure AD or SharePoint group.. Specify either 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
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+add role assignment to list _someList_ located in site _https://contoso.sharepoint.com/sites/project-x_for principal id _11_ and role definition id _1073741829_
+
+```sh
+m365 spo list roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --principalId 11 --roleDefinitionId 1073741829
+```
+
+add role assignment to list _0CD891EF-AFCE-4E55-B836-FCE03286CCCF_ located in site _https://contoso.sharepoint.com/sites/project-x_for principal id _11_ and role definition id _1073741829_
+
+```sh
+m365 spo list roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listId "0CD891EF-AFCE-4E55-B836-FCE03286CCCF" --principalId 11 --roleDefinitionId 1073741829
+```
+
+add role assignment to list _sites/documents_ located in site _https://contoso.sharepoint.com/sites/project-x_for principal id _11_ and role definition id _1073741829_
+
+```sh
+m365 spo list roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listUrl "sites/documents" --principalId 11 --roleDefinitionId 1073741829
+```
+
+add role assignment to list _someList_ located in site _https://contoso.sharepoint.com/sites/project-x_for upn _someaccount@tenant.onmicrosoft.com_ and role definition id _1073741829_
+
+```sh
+m365 spo list roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --upn "someaccount@tenant.onmicrosoft.com" --roleDefinitionId 1073741829
+```
+
+add role assignment to list _someList_ located in site _https://contoso.sharepoint.com/sites/project-x_for group _someGroup_ and role definition id _1073741829_
+
+```sh
+m365 spo list roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --groupName "someGroup" --roleDefinitionId 1073741829
+```
+
+add role assignment to list _someList_ located in site _https://contoso.sharepoint.com/sites/project-x_for principal id _11_ and role definition name _Full Control_
+
+```sh
+m365 spo list roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --principalId 11 --roleDefinitionName "Full Control"
+```