@pnp/cli-microsoft365 6.0.0-beta.c5b75e1 → 6.0.0-beta.c63e3b2

package/docs/docs/cmd/spo/group/{group-user-list.md → group-member-list.md}

@@ -1,11 +1,11 @@
-# spo group user list
+# spo group member list
 
-List members of a SharePoint Group
+List the members of a SharePoint Group
 
 ## Usage
 
 ```sh
-m365 spo group user list [options]
+m365 spo group member list [options]
 ```
 
 ## Options
@@ -26,11 +26,11 @@ m365 spo group user list [options]
 List the members of the group with ID _5_ for web _https://contoso.sharepoint.com/sites/SiteA_
 
 ```sh
-m365 spo group user list --webUrl https://contoso.sharepoint.com/sites/SiteA --groupId 5
+m365 spo group member list --webUrl https://contoso.sharepoint.com/sites/SiteA --groupId 5
 ```
 
 List the members of the group with name _Contoso Site Members_ for web _https://contoso.sharepoint.com/sites/SiteA_
 
 ```sh
-m365 spo group user list --webUrl https://contoso.sharepoint.com/sites/SiteA --groupName "Contoso Site Members"
+m365 spo group member list --webUrl https://contoso.sharepoint.com/sites/SiteA --groupName "Contoso Site Members"
 ```

package/docs/docs/cmd/spo/group/group-member-remove.md

@@ -0,0 +1,39 @@
+# spo group member remove
+
+Removes the specified member from a SharePoint group
+
+## Usage
+
+```sh
+m365 spo group member remove [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: URL of the site where the SharePoint group is available
+
+`--groupId [groupId]`
+: Id of the SharePoint group from which the user has to be removed. Specify either `groupName` or `groupId`, but not both
+
+`--groupName  [groupName]`
+: Name of the SharePoint group from which user has to be removed. Specify either `groupName` or `groupId`, but not both
+
+`--userName <userName>`
+: The UPN of the user that needs to be removed (user principal name, eg. megan.bowen@contoso.com)
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Remove a user from SharePoint group with id _5_ available on the web _https://contoso.sharepoint.com/sites/SiteA_
+
+```sh
+m365 spo group member remove --webUrl https://contoso.sharepoint.com/sites/SiteA --groupId 5 --userName "Alex.Wilber@contoso.com"
+```
+
+Remove a user from SharePoint group with Name _Site A Visitors_ available on the web _https://contoso.sharepoint.com/sites/SiteA_
+
+```sh
+m365 spo group member remove --webUrl https://contoso.sharepoint.com/sites/SiteA --groupName "Site A Visitors" --userName "Alex.Wilber@contoso.com"
+```

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

@@ -1,6 +1,6 @@
 # spo hubsite connect
 
-Connects the specified site collection to the given hub site
+Connect a hub site to a parent hub site
 
 ## Usage
 
@@ -10,31 +10,53 @@ m365 spo hubsite connect [options]
 
 ## Options
 
-`-u, --siteUrl <siteUrl>`
-: The URL of the site collection to connect to the hub site
+`-i, --id [id]`
+: ID of the hub site. Specify either `id`, `title` or `url` but not multiple.
 
-`-i, --id <id>`
-: The ID of the hub site to which to connect the site collection
+`-t, --title [title]`
+: Title of the hub site. Specify either `id`, `title` or `url` but not multiple.
+
+`-u, --url [url]`
+: Absolute or server-relative URL of the hub site. Specify either `id`, `title` or `url` but not multiple.
+
+`--parentId [parentId]`
+: ID of the parent hub site. Specify either `parentId`, `parentTitle` or `parentUrl` but not multiple.
+
+`--parentTitle [parentTitle]`
+: Title of the parent hub site. Specify either `parentId`, `parentTitle` or `parentUrl` but not multiple.
+
+`--parentUrl [parentUrl]`
+: Absolute or server-relative URL of the parent hub site. Specify either `parentId`, `parentTitle` or `parentUrl` but not multiple.
 
 --8<-- "docs/cmd/_global.md"
 
 ## Remarks
 
-!!! 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.
+!!! important
+    To use this command you must be a Global or SharePoint administrator.
 
-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 `id` doesn't point to a valid hub site, you will get a `ResourceNotFoundException` error.
+To connect a regular site to a hub site, use command [spo site hubsite connect](../site/site-hubsite-connect.md).
 
 ## 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_
+Connect a specific hub site to specific parent hub site by ID
+
+```sh
+m365 spo hubsite connect --id 2c1ba4c4-cd9b-4417-832f-92a34bc34b2a --parentId 637ed2ea-b65b-4a4b-a3d7-ad86953224a4
+```
+
+Connect a specific hub site to specific parent hub site by URL
+
+```sh
+m365 spo hubsite connect --url https://contoso.sharepoint.com/sites/project-x --parentUrl https://contoso.sharepoint.com/sites/projects
+```
+
+Connect a specific hub site with title to a parent hub site with ID
 
 ```sh
-m365 spo hubsite connect --siteUrl https://contoso.sharepoint.com/sites/contoso-sales --id 255a50b2-527f-4413-8485-57f4c17a24d1
+m365 spo hubsite connect --title "My hub site" --parentId 637ed2ea-b65b-4a4b-a3d7-ad86953224a4
 ```
 
-## More information
+## Response
 
-- 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)
+The command won't return a response on success.

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

@@ -20,9 +20,6 @@ m365 spo hubsite data get [options]
 
 ## Remarks
 
-!!! 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.
-
 By default, the hub site data is returned from the server's cache. To refresh the data with the latest updates, use the `-f, --forceRefresh` option. Use this option, if you just made changes and need to see them right
 away.
 

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
+Disconnect a hub site from its parent hub site
 
 ## Usage
 
@@ -10,33 +10,49 @@ m365 spo hubsite disconnect [options]
 
 ## Options
 
-`-u, --siteUrl <siteUrl>`
-: URL of the site collection to disconnect from its hub site
+`-i, --id [id]`
+: ID of the hub site. Specify either `id`, `title` or `url` but not multiple.
+
+`-t, --title [title]`
+: Title of the hub site. Specify either `id`, `title` or `url` but not multiple.
+
+`-u, --url [url]`
+: Absolute or server-relative URL of the hub site. Specify either `id`, `title` or `url` but not multiple.
 
 `--confirm`
-: Don't prompt for confirming disconnecting from the hub site
+: Don't prompt for confirmation.
 
 --8<-- "docs/cmd/_global.md"
 
 ## Remarks
 
-!!! 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.
+!!! important
+    To use this command you must be a Global or SharePoint administrator.
+
+To disconnect a regular site from a hub site, use command [spo site hubsite disconnect](../site/site-hubsite-disconnect.md).
+
+If the specified id doesn't point to a valid hub site, you will get a ResourceNotFoundException error.
 
 ## Examples
 
-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.
+Disconnect a specific hub site with id from its parent hub site
+
+```sh
+m365 spo hubsite disconnect --id 2c1ba4c4-cd9b-4417-832f-92a34bc34b2a
+```
+
+Disconnect a specific hub site with url from its parent hub site
 
 ```sh
-m365 spo hubsite disconnect --siteUrl https://contoso.sharepoint.com/sites/sales
+m365 spo hubsite disconnect --url https://contoso.sharepoint.com/sites/project-x
 ```
 
-Disconnect the site collection with URL _https://contoso.sharepoint.com/sites/sales_ from its hub site without prompting for confirmation
+Disconnect a specific hub site with title from its parent hub site
 
 ```sh
-m365 spo hubsite disconnect --siteUrl https://contoso.sharepoint.com/sites/sales --confirm
+m365 spo hubsite disconnect --title "My hub site"
 ```
 
-## More information
+## Response
 
-- 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)
+The command won't return a response on success.

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

@@ -11,13 +11,13 @@ m365 spo hubsite get [options]
 ## Options
 
 `-i, --id [id]`
-: ID of the hubsite. Specify either `id`, `title` or `url` but not multiple.
+: ID of the hub site. Specify either `id`, `title` or `url` but not multiple.
 
 `-t, --title [title]`
-: Title of the hubsite. Specify either `id`, `title` or `url` but not multiple.
+: Title of the hub site. Specify either `id`, `title` or `url` but not multiple.
 
 `-u, --url [url]`
-: URL of the hubsite. Specify either `id`, `title` or `url` but not multiple.
+: URL of the hub site. Specify either `id`, `title` or `url` but not multiple.
 
 `--includeAssociatedSites`
 : Include the associated sites in the result (only in JSON output)

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

@@ -17,8 +17,8 @@ m365 spo hubsite register [options]
 
 ## Remarks
 
-!!! 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.
+!!! important
+    To use this command you must be a Global or SharePoint administrator.
 
 If the specified site collection is already registered as a hub site, you will get a `This site is already a HubSite.` error.
 

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

@@ -21,13 +21,10 @@ m365 spo hubsite rights grant [options]
 
 --8<-- "docs/cmd/_global.md"
 
-!!! important
-    To use this command you have to have permissions to access the tenant admin site.
-
 ## Remarks
 
-!!! 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.
+!!! important
+    To use this command you must be a Global or SharePoint administrator.
 
 ## Examples
 

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

@@ -21,13 +21,10 @@ m365 spo hubsite rights revoke [options]
 
 --8<-- "docs/cmd/_global.md"
 
-!!! important
-    To use this command you have to have permissions to access the tenant admin site.
-
 ## Remarks
 
-!!! 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.
+!!! important
+    To use this command you must be a Global or SharePoint administrator.
 
 ## Examples
 

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

@@ -24,13 +24,10 @@ m365 spo hubsite set [options]
 
 --8<-- "docs/cmd/_global.md"
 
-!!! important
-    To use this command you have to have permissions to access the tenant admin site.
-
 ## Remarks
 
-!!! 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.
+!!! important
+    To use this command you must be a Global or SharePoint administrator.
 
 If the specified `id` doesn't refer to an existing hub site, you will get an `Unknown Error` error.
 

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

@@ -20,8 +20,8 @@ m365 spo hubsite unregister [options]
 
 ## Remarks
 
-!!! 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.
+!!! important
+    To use this command you must be a Global or SharePoint administrator.
 
 If the specified site collection is not registered as a hub site, you will get a `hubSiteId` error.
 

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

@@ -11,13 +11,16 @@ m365 spo list contenttype add [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: URL of the site where the list is located
+: URL of the site where the list is located.
 
-`-l, --listId [listId]`
-: ID of the list to which to add the content type. Specify `listId` or `listTitle` but not both
+`-i, --listId [listId]`
+: ID of the list. Specify either `listTitle`, `listId` or `listUrl`.
 
 `-t, --listTitle [listTitle]`
-: Title of the list to which to add the content type. Specify `listId` or `listTitle` but not both
+: Title of the list. Specify either `listTitle`, `listId` or `listUrl`.
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`.
 
 `-i, --id <id>`
 : ID of the content type to add to the list
@@ -26,14 +29,20 @@ m365 spo list contenttype add [options]
 
 ## Examples
 
-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_
+Adds a specific existing content type to a list retrieved by id in a specific site.
 
 ```sh
 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_
+Adds a specific existing content type to a list retrieved by title in a specific site.
 
 ```sh
 m365 spo list contenttype add --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle Documents --id 0x0120
 ```
+
+Adds a specific existing content type to a list retrieved by server relative URL in a specific site.
+
+```sh
+m365 spo list contenttype add --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl 'sites/project-x/Documents' --contentTypeId 0x0120
+```

package/docs/docs/cmd/spo/list/list-contenttype-default-set.md

@@ -11,29 +11,38 @@ m365 spo list contenttype default set [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: URL of the site where the list is located
+: URL of the site where the list is located.
 
-`-l, --listId [listId]`
-: ID of the list on which to set default content type, specify `listId` or `listTitle` but not both
+`-i, --listId [listId]`
+: ID of the list. Specify either `listTitle`, `listId` or `listUrl`.
 
 `-t, --listTitle [listTitle]`
-: Title of the list on which to set default content type, specify `listId` or `listTitle` but not both
+: Title of the list. Specify either `listTitle`, `listId` or `listUrl`.
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`.
 
 `-c, --contentTypeId <contentTypeId>`
-: ID of the content type to set as default on the list
+: ID of the content type
 
 --8<-- "docs/cmd/_global.md"
 
 ## Examples
 
-Set content type with ID _0x0120_ as default in the list with ID _0cd891ef-afce-4e55-b836-fce03286cccf_ located in site _https://contoso.sharepoint.com/sites/project-x_
+Set a content type with a specific id as default a list retrieved by id located in a specific site.
 
 ```sh
 m365 spo list contenttype default set --webUrl https://contoso.sharepoint.com/sites/project-x --listId 0cd891ef-afce-4e55-b836-fce03286cccf --contentTypeId 0x0120
 ```
 
-Set content type with ID _0x0120_ as default in the list with title _Documents_ located in site _https://contoso.sharepoint.com/sites/project-x_
+Set a content type with a specific id as default a list retrieved by title located in a specific site.
 
 ```sh
 m365 spo list contenttype default set --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle Documents --contentTypeId 0x0120
 ```
+
+Set a content type with a specific id as default a list retrieved by server relative URL located in a specific site.
+
+```sh
+m365 spo list contenttype default set --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl 'sites/project-x/Documents' --contentTypeId 0x0120
+```

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

@@ -11,26 +11,35 @@ m365 spo list contenttype list [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: URL of the site where the list is located
+: URL of the site where the list is located.
 
-`-l, --listId [listId]`
-: ID of the list for which to list configured content types. Specify `listId` or `listTitle` but not both
+`-i, --listId [listId]`
+: ID of the list. Specify either `listTitle`, `listId` or `listUrl`.
 
 `-t, --listTitle [listTitle]`
-: Title of the list for which to list configured content types. Specify `listId` or `listTitle` but not both
+: Title of the list. Specify either `listTitle`, `listId` or `listUrl`.
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`.
 
 --8<-- "docs/cmd/_global.md"
 
 ## Examples
 
-List all content types configured on the list with ID _0cd891ef-afce-4e55-b836-fce03286cccf_ located in site _https://contoso.sharepoint.com/sites/project-x_
+List all content types configured on a specific list retrieved by id in a specific site.
 
 ```sh
 m365 spo list contenttype list --webUrl https://contoso.sharepoint.com/sites/project-x --listId 0cd891ef-afce-4e55-b836-fce03286cccf
 ```
 
-List all content types configured on the list with title _Documents_ located in site _https://contoso.sharepoint.com/sites/project-x_
+List all content types configured on a specific list retrieved by title in a specific site.
 
 ```sh
 m365 spo list contenttype list --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle Documents
 ```
+
+List all content types configured on a specific list retrieved by server relative URL in a specific site.
+
+```sh
+m365 spo list contenttype list --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl 'sites/project-x/Documents'
+```

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

@@ -11,32 +11,41 @@ m365 spo list contenttype remove [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: URL of the site where the list is located
+: URL of the site where the list is located.
 
-`-l, --listId [listId]`
-: ID of the list from which to remove the content type, specify `listId` or `listTitle` but not both
+`-i, --listId [listId]`
+: ID of the list. Specify either `listTitle`, `listId` or `listUrl`.
 
 `-t, --listTitle [listTitle]`
-: Title of the list from which to remove the content type, specify `listId` or `listTitle` but not both
+: Title of the list. Specify either `listTitle`, `listId` or `listUrl`.
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`.
 
 `-i, --id <id>`
 : ID of the content type to remove from the list
 
 `--confirm`
-: Don't prompt for confirming removing the content type from the list
+: Don't prompt for confirmation
 
 --8<-- "docs/cmd/_global.md"
 
 ## Examples
 
-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_
+Remove content type with a specific id from the list retrieved by id in a specific site.
 
 ```sh
 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_
+Remove content type with a specific id from the list retrieved by title in a specific site.
 
 ```sh
 m365 spo list contenttype remove --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle Documents --id 0x010109010053EE7AEB1FC54A41B4D9F66ADBDC312A
 ```
+
+Remove content type with a specific id from the list retrieved by server relative URL in a specific site. This will not prompt for confirmation.
+
+```sh
+m365 spo list contenttype remove --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl 'sites/project-x/Documents' --contentTypeId 0x010109010053EE7AEB1FC54A41B4D9F66ADBDC312A --confirm
+```

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

@@ -11,31 +11,31 @@ m365 spo list roleassignment add [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: URL of the site where the list is located
+: 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.
+: 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.
+: 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.
+: 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.
+: SharePoint ID of principal it may be either user id or group id we want to add permissions to. Specify either `principalId`, `upn`, or `groupName` but not multiple.
 
 `--upn [upn]`
-: Upn/email of user to assign role to. Specify either upn or principalId
+: Upn/email of user to assign role to. Specify either `principalId`, `upn`, or `groupName` but not multiple.
 
 `--groupName [groupName]`
-: Enter group name of Azure AD or SharePoint group.. Specify either groupName or principalId
+: Enter group name of Azure AD or SharePoint group. Specify either `principalId`, `upn`, or `groupName` but not multiple.
 
 `--roleDefinitionId [roleDefinitionId]`
-: ID of role definition. Specify either roleDefinitionId or roleDefinitionName but not both
+: 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
+: Enter the name of a role definition, like 'Contribute', 'Read', etc. Specify either `roleDefinitionId` or `roleDefinitionName` but not both.
 
 --8<-- "docs/cmd/_global.md"
 

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

@@ -11,28 +11,28 @@ m365 spo list roleassignment remove [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: URL of the site where the list is located
+: 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.
+: 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.
+: 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.
+: 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 remove permissions Specify principalId only when upn or groupName are not used.
+: SharePoint ID of principal it may be either user id or group id you want to remove permissions. Specify either `principalId`, `upn`, or `groupName` but not multiple.
 
 `--upn [upn]`
-: upn/email of user. Specify either upn or principalId.
+: upn/email of user. Specify either `principalId`, `upn`, or `groupName` but not multiple.
 
 `--groupName [groupName]`
-: enter group name of Azure AD or SharePoint group. Specify either groupName or principalId.
+: enter group name of Azure AD or SharePoint group. Specify either `principalId`, `upn`, or `groupName` but not multiple.
 
 `--confirm`
-: Don't prompt for confirming removing the role assignment
+: Don't prompt for confirming removing the role assignment.
 
 --8<-- "docs/cmd/_global.md"
 

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

@@ -11,13 +11,16 @@ m365 spo list roleinheritance break [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: URL of the site where the list to retrieve is located
+: URL of the site where the list is located.
 
 `-i, --listId [listId]`
-: ID of the list to retrieve information for. Specify either id or title but not both
+: ID of the list. Specify either `listTitle`, `listId` or `listUrl`.
 
 `-t, --listTitle [listTitle]`
-: Title of the list to retrieve information for. Specify either id or title but not both
+: Title of the list. Specify either `listTitle`, `listId` or `listUrl`.
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`.
 
 `-c, --clearExistingPermissions`
 : Flag if used clears all roles from the list
@@ -33,28 +36,28 @@ By default, when breaking permissions inheritance, the list will retain existing
 
 ## Examples
 
-Break inheritance of list _someList_ located in site _https://contoso.sharepoint.com/sites/project-x_
+Break inheritance of list by title in a specific site
 
 ```sh
 m365 spo list roleinheritance break --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList"
 ```
 
-Break inheritance of list with ID _202b8199-b9de-43fd-9737-7f213f51c991_ located in site _https://contoso.sharepoint.com/sites/project-x_
+Break inheritance of list by id in a specific site
 
 ```sh
 m365 spo list roleinheritance break --webUrl "https://contoso.sharepoint.com/sites/project-x" --listId "202b8199-b9de-43fd-9737-7f213f51c991"
 ```
 
-Break inheritance of list _someList_ located in site _https://contoso.sharepoint.com/sites/project-x_ with clearing permissions 
+Break inheritance of list by title located in a specific site and clearing the existing permissions
 
 ```sh
 m365 spo list roleinheritance break --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --clearExistingPermissions
 ```
 
-Break inheritance of list with ID _202b8199-b9de-43fd-9737-7f213f51c991_ located in site _https://contoso.sharepoint.com/sites/project-x_ with clearing permissions
+Break inheritance of list by url in a specific site and clearing the existing permissions
 
 ```sh
-m365 spo list roleinheritance break --webUrl "https://contoso.sharepoint.com/sites/project-x" --listId "202b8199-b9de-43fd-9737-7f213f51c991" --clearExistingPermissions
+m365 spo list roleinheritance break --webUrl "https://contoso.sharepoint.com/sites/project-x" --listUrl '/sites/project-x/lists/events' --clearExistingPermissions
 ```
 
 Break inheritance of list with ID _202b8199-b9de-43fd-9737-7f213f51c991_ located in site _https://contoso.sharepoint.com/sites/project-x_ with clearing permissions without prompting for confirmation