@pnp/cli-microsoft365 6.0.0-beta.e1e0a1b → 6.0.0-beta.e45a1f2

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

@@ -11,22 +11,28 @@ m365 spo list webhook set [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: URL of the site where the list which contains the webhook is located
+: URL of the site where the list is located.
 
 `-l, --listId [listId]`
-: ID of the list which contains the webhook which should be updated. Specify either `listId` or `listTitle` but not both
+: ID of the list. Specify either `listId`, `listTitle` or `listUrl`.
 
 `-t, --listTitle [listTitle]`
-: Title of the list which contains the webhook which should be updated. Specify either `listId` or `listTitle` but not both
+: Title of the list. Specify either `listId`, `listTitle` or `listUrl`.
 
-`-i, --id [id]`
-: ID of the webhook to update
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listId`, `listTitle` or `listUrl`.
+
+`-i, --id <id>`
+: ID of the webhook to update.
 
 `-n, --notificationUrl [notificationUrl]`
-: The new notification url
+: The new notification url.
 
 `-e, --expirationDateTime [expirationDateTime]`
-: The new expiration date
+: The new expiration date. _Note: Expiration Time cannot be more than 6 months in future_
+
+`-c, --clientState [clientState]`
+: A client state information that will be passed through notifications.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -36,21 +42,24 @@ If the specified `id` doesn't refer to an existing webhook, you will get a `404
 
 ## Examples
 
-Update the notification url of a webhook with ID _cc27a922-8224-4296-90a5-ebbc54da2e81_ which belongs to a list with ID _0cd891ef-afce-4e55-b836-fce03286cccf_ located in site _https://contoso.sharepoint.com/sites/ninja_ to _https://contoso-functions.azurewebsites.net/webhook_
+Update the notification url of a webhook with a specific ID attached to a list with a specific ID in a specific site to a specific URL
 
 ```sh
 m365 spo list webhook set --webUrl https://contoso.sharepoint.com/sites/ninja --listId 0cd891ef-afce-4e55-b836-fce03286cccf --id cc27a922-8224-4296-90a5-ebbc54da2e81 --notificationUrl https://contoso-functions.azurewebsites.net/webhook
 ```
 
-Update the expiration date of a webhook with ID _cc27a922-8224-4296-90a5-ebbc54da2e81_ which belongs to a list with title _Documents_ located in site _https://contoso.sharepoint.com/sites/ninja_ to _October 9th, 2018 at 6:15 PM_
+Update the expiration date of a webhook with a specific ID attached to a list with a specific title in a specific site to a specfic date
 
 ```sh
 m365 spo list webhook set --webUrl https://contoso.sharepoint.com/sites/ninja --listTitle Documents --id cc27a922-8224-4296-90a5-ebbc54da2e81 --expirationDateTime 2018-10-09T18:15
 ```
 
-From the webhook with ID _cc27a922-8224-4296-90a5-ebbc54da2e81_ which belongs to a list with title _Documents_ located in site _https://contoso.sharepoint.com/sites/ninja_ update the notification url to _https://contoso-functions.azurewebsites.net/webhook_
-and the expiration date to _March 2nd, 2019_
+Update the notification url and clientState of a webhook with a specific ID attached to a list with a specific URL in a specific site to a specific URL and the expiration date to a specific date
 
 ```sh
-m365 spo list webhook set --webUrl https://contoso.sharepoint.com/sites/ninja --listTitle Documents --id cc27a922-8224-4296-90a5-ebbc54da2e81 --notificationUrl https://contoso-functions.azurewebsites.net/webhook --expirationDateTime 2019-03-02
+m365 spo list webhook set --webUrl https://contoso.sharepoint.com/sites/ninja --listUrl '/sites/ninja/Documents' --id cc27a922-8224-4296-90a5-ebbc54da2e81 --notificationUrl https://contoso-functions.azurewebsites.net/webhook --expirationDateTime 2019-03-02 --clientState 'My client state'
 ```
+
+## Respone
+
+The command won't return a response on success.

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

@@ -14,10 +14,13 @@ m365 spo listitem add [options]
 : URL of the site where the item should be added
 
 `-l, --listId [listId]`
-: ID of the list where the item should be added. Specify `listId` or `listTitle` but not both
+: ID of the list where the item should be added. Specify either `listTitle`, `listId` or `listUrl`
 
 `-t, --listTitle [listTitle]`
-: Title of the list where the item should be added. Specify `listId` or `listTitle` but not both
+: Title of the list where the item should be added. Specify either `listTitle`, `listId` or `listUrl`
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`
 
 `-c, --contentType [contentType]`
 : The name or the ID of the content type to associate with the new item
@@ -64,3 +67,9 @@ Add an item with Title _Demo Hyperlink Field_ and a hyperlink field named _Custo
 ```sh
 m365 spo listitem add --listTitle "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x --Title "Demo Hyperlink Field" --CustomHyperlink "https://www.bing.com, Bing"
 ```
+
+Add an item with a specific title to a list retrieved by server-relative URL in a specific site
+
+```sh
+m365 spo listitem add --contentType Item --listUrl /sites/project-x/Documents --webUrl https://contoso.sharepoint.com/sites/project-x --Title "Demo Item"
+```

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

@@ -14,10 +14,13 @@ m365 spo listitem attachment list [options]
 URL of the site from which the item should be retrieved
 
 `--listId [listId]`
-: ID of the list from which to retrieve the item. Specify listId or listTitle but not both
+: ID of the list where the item should be added. Specify either `listTitle`, `listId` or `listUrl`
 
 `--listTitle [listTitle]`
-: Title of the list from which to retrieve the item. Specify listId or listTitle but not both
+: Title of the list where the item should be added. Specify either `listTitle`, `listId` or `listUrl`
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`
 
 `--itemId <itemId>`
 ID of the list item to in question
@@ -37,3 +40,9 @@ Gets the attachments from list item with itemId _147_ in list with id _0cd891ef-
 ```sh
 m365 spo listitem attachment list --webUrl https://contoso.sharepoint.com/sites/project-x --listId 0cd891ef-afce-4e55-b836-fce03286cccf --itemId 147
 ```
+
+Gets the attachments from a specific list item in a specific list obtained by server-relative URL in a specific site
+
+```sh
+m365 spo listitem attachment list --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl /sites/project-x/Documents --itemId 147
+```

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

@@ -17,10 +17,13 @@ m365 spo listitem get [options]
 : ID of the item to retrieve.
 
 `-l, --listId [listId]`
-: ID of the list from which to retrieve the item. Specify `listId` or `listTitle` but not both
+: ID of the list where the item should be added. Specify either `listTitle`, `listId` or `listUrl`
 
 `-t, --listTitle [listTitle]`
-: Title of the list from which to retrieve the item. Specify `listId` or `listTitle` but not both
+: Title of the list where the item should be added. Specify either `listTitle`, `listId` or `listUrl`
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`
 
 `-p, --properties [properties]`
 : Comma-separated list of properties to retrieve. Will retrieve all properties if not specified and json output is requested
@@ -50,3 +53,9 @@ Get an items _Title_, _Created_ column and lookup column _Company_ with ID _147_
 ```sh
 m365 spo listitem get --listTitle "Demo List" --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --properties "Title,Created,Company/Title"
 ```
+
+Get an item with specific properties from a list retrieved by server-relative URL in a specific site
+
+```sh
+m365 spo listitem get --listUrl /sites/project-x/documents --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --properties "Title,Created,Company/Title"
+```

package/docs/docs/cmd/spo/listitem/listitem-isrecord.md

@@ -17,10 +17,13 @@ m365 spo listitem isrecord [options]
 : The ID of the list item to check if it is a record
 
 `-l, --listId [listId]`
-: The ID of the list where the item is located. Specify `listId` or `listTitle` but not both
+: ID of the list where the item should be added. Specify either `listTitle`, `listId` or `listUrl`
 
 `-t, --listTitle [listTitle]`
-: The title of the list where the item is located. Specify `listId` or `listTitle` but not both
+: Title of the list where the item should be added. 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"
 
@@ -37,3 +40,10 @@ Check whether the document with id _1_ in list with id _0cd891ef-afce-4e55-b836-
 ```sh
 m365 spo listitem isrecord --webUrl https://contoso.sharepoint.com/sites/project-x --listId 0cd891ef-afce-4e55-b836-fce03286cccf --id 1
 ```
+
+Check whether a document with a specific id in a list retrieved by server-relative URL in a specific site is a record
+
+```sh
+m365 spo listitem isrecord --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl /sites/project-x/documents --id 1
+```
+

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

@@ -11,28 +11,31 @@ m365 spo listitem list [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: URL of the site from which the item should be retrieved
+: URL of the site from which the item should be retrieved.
 
 `-i, --listId [listId]`
-: ID of the list to retrieve items from. Specify `listId` or `listTitle` but not both
+: ID of the list to retrieve items from. Specify `listId` or `listTitle` but not both.
+
+`-l, --listId [listId]`
+: ID of the list where the item should be added. Specify either `listTitle`, `listId`, or `listUrl` but not multiple.
 
 `-t, --listTitle [listTitle]`
-: Title of the list to retrieve items from. Specify `listId` or `listTitle` but not both
+: Title of the list where the item should be added. Specify either `listTitle`, `listId`, or `listUrl` but not multiple.
 
 `-q, --camlQuery [camlQuery]`
-: CAML query to use to query the list of items with
+: CAML query to use to query the list of items with.
 
 `-f, --fields [fields]`
-: Comma-separated list of fields to retrieve. Will retrieve all fields if not specified and json output is requested. Specify `camlQuery` or `fields` but not both
+: Comma-separated list of fields to retrieve. Will retrieve all fields if not specified and json output is requested. Specify `camlQuery` or `fields` but not both.
 
 `-l, --filter [filter]`
-: OData filter to use to query the list of items with. Specify `camlQuery` or `filter` but not both
+: OData filter to use to query the list of items with. Specify `camlQuery` or `filter` but not both.
 
 `-p, --pageSize [pageSize]`
-: Number of list items to return. Specify `camlQuery` or `pageSize` but not both
+: Number of list items to return. Specify `camlQuery` or `pageSize` but not both.
 
 `-n, --pageNumber [pageNumber]`
-: Page number to return if `pageSize` is specified (first page is indexed as value of 0)
+: Page number to return if `pageSize` is specified (first page is indexed as value of 0).
 
 --8<-- "docs/cmd/_global.md"
 
@@ -85,3 +88,9 @@ From a list named _Demo List_ get the second batch of 10 items
 ```sh
 m365 spo listitem list --listTitle "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x --pageSize 10 --pageNumber 2
 ```
+
+Get all items from a list by server-relative URL
+
+```sh
+m365 spo listitem list --listUrl /sites/project-x/documents --webUrl https://contoso.sharepoint.com/sites/project-x
+```

package/docs/docs/cmd/spo/listitem/listitem-record-declare.md

@@ -14,12 +14,15 @@ m365 spo listitem record declare [options]
 : URL of the site where the list is located
 
 `-l, --listId [listId]`
-: The ID of the list where the item is located. Specify `listId` or `listTitle` but not both
+: The ID of the list where the item is located. Specify either `listTitle`, `listId` or `listUrl`
 
 `-t, --listTitle [listTitle]`
-: The title of the list where the item is located. Specify `listId` or `listTitle` but not both
+: The title of the list where the item is located. Specify either `listTitle`, `listId` or `listUrl`
 
-`-i, --id <id>`
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`
+
+`-i, --listItemId <listItemId>`
 : The ID of the list item to declare as record
 
 `-d, --date [date]`
@@ -32,23 +35,23 @@ m365 spo listitem record declare [options]
 Declare a document with id _1_ as a record in list with title _Demo List_ located in site _https://contoso.sharepoint.com/sites/project-x_
 
 ```sh
-m365 spo listitem record declare --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle "Demo List" --id 1
+m365 spo listitem record declare --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle "Demo List" --listItemId 1
 ```
 
 Declare a document with id _1_ as a record in list with id _ea8e1109-2013-1a69-bc05-1403201257fc_ located in site _https://contoso.sharepoint.com/sites/project-x_
 
 ```sh
-m365 spo listitem record declare --webUrl https://contoso.sharepoint.com/sites/project-x --listId ea8e1109-2013-1a69-bc05-1403201257fc --id 1
+m365 spo listitem record declare --webUrl https://contoso.sharepoint.com/sites/project-x --listId ea8e1109-2013-1a69-bc05-1403201257fc --listItemId 1
 ```
 
 Declare a document with id _1_ as a record with record declaration date _March 14, 2012_ in list with title _Demo List_ located in site _https://contoso.sharepoint.com/sites/project-x_
 
 ```sh
-m365 spo listitem record declare --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle "Demo List" --id 1 --date 2012-03-14
+m365 spo listitem record declare --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle "Demo List" --listItemId 1 --date 2012-03-14
 ```
 
-Declare a document with id _1_ as a record with record declaration date _September 3, 2013_ in list with id _ea8e1356-5910-abc9-bc05-2408198057fc_ located in site _https://contoso.sharepoint.com/sites/project-x_
+Declare a document with a specific id as a record with a record declaration date a list retrieved by server-relative URL located in a specific site
 
 ```sh
-m365 spo listitem record declare --webUrl https://contoso.sharepoint.com/sites/project-x --listId ea8e1356-5910-abc9-bc05-2408198057fc --id 1 --date 2013-09-03
+m365 spo listitem record declare --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl '/sites/project-x/Lists/Demo List' --listItemId 1 --date 2013-09-03
 ```

package/docs/docs/cmd/spo/listitem/listitem-record-undeclare.md

@@ -13,14 +13,17 @@ m365 spo listitem record undeclare [options]
 `-u, --webUrl <webUrl>`
 : The URL of the site where the list is located
 
-`-i, --id <id>`
+`-i, --listItemId <listItemId>`
 : ID of the list item to be undeclared as a record.
 
 `-l, --listId [listId]`
-: The ID of the list where the item is located. Specify `listId` or `listTitle` but not both
+: The ID of the list where the item is located. Specify either `listTitle`, `listId` or `listUrl`
 
 `-t, --listTitle [listTitle]`
-: The title of the list where the item is located. Specify `listId` or `listTitle` but not both
+: The title of the list where the item is located. Specify either `listTitle`, `listId` or `listUrl`
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list where the item is located. Specify either `listTitle`, `listId` or `listUrl`
 
 --8<-- "docs/cmd/_global.md"
 
@@ -29,11 +32,17 @@ m365 spo listitem record undeclare [options]
 Undeclare the list item as a record with ID _1_ from list with ID _0cd891ef-afce-4e55-b836-fce03286cccf_ located in site _https://contoso.sharepoint.com/sites/project-x
 
 ```sh_
-spo listitem record undeclare --webUrl https://contoso.sharepoint.com/sites/project-x --listId 0cd891ef-afce-4e55-b836-fce03286cccf --id 1
+spo listitem record undeclare --webUrl https://contoso.sharepoint.com/sites/project-x --listId 0cd891ef-afce-4e55-b836-fce03286cccf --listItemId 1
 ```
 
 Undeclare the list item as a record with ID _1_ from list with title _List 1_ located in site _https://contoso.sharepoint.com/sites/project-x_
 
 ```sh
-m365 spo listitem record undeclare --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle 'List 1' --id 1
+m365 spo listitem record undeclare --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle 'List 1' --listItemId 1
+```
+
+Undeclare a list item with a specific id as a record from a list retrieved by server-relative URL located in a specific site
+
+```sh
+m365 spo listitem record undeclare --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl '/sites/project-x/Lists/Lists 1' --id 1
 ```

package/docs/docs/cmd/spo/listitem/listitem-remove.md

@@ -17,10 +17,13 @@ m365 spo listitem remove [options]
 : The ID of the list item to remove.
 
 `-l, --listId [listId]`
-: List id of the list to remove. Specify either `listId` or `listTitle` but not both
+: ID of the list where the item should be added. Specify either `listTitle`, `listId` or `listUrl`
 
 `-t, --listTitle [listTitle]`
-: Title of the list to remove. Specify either `listId` or `listTitle` but not both
+: Title of the list where the item should be added. Specify either `listTitle`, `listId` or `listUrl`
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`
 
 `--recycle`
 : Recycle the list item
@@ -43,3 +46,9 @@ Remove the list item with ID _1_ from list with title _List 1_ located in site _
 ```sh
 m365 spo listitem remove --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle 'List 1' --id 1
 ```
+
+Remove the list item with a specific ID from a list retrieved by server-relative URL located in a specific site
+
+```sh
+m365 spo listitem remove --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl /sites/project-x/lists/TestList --id 1
+```

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

@@ -0,0 +1,81 @@
+# spo listitem roleassignment add
+
+Adds a role assignment to a listitem.
+
+## Usage
+
+```sh
+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
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Add role assignment to specified listitem in specified list located in specified site for specified principal id and specified role definition id.
+
+```sh
+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.
+
+```sh
+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.
+
+```sh
+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.
+
+```sh
+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.
+
+```sh
+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.
+
+```sh
+m365 spo listitem roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --listItemId 1 --principalId 11 --roleDefinitionName "Full Control"
+```

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

@@ -0,0 +1,67 @@
+# spo listitem roleassignment remove
+
+Removes a role assignment from a listitem.
+
+## Usage
+
+```sh
+m365 spo listitem roleassignment remove [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: URL of the site where the listitem 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.
+
+`--listItemId <listItemId>`
+: Id of the listitem to remove the role from.
+
+`--principalId [principalId]`
+: SharePoint ID of principal it may be either user id or group id we want to remove permissions. Specify either `principalId`, `upn`, or `groupName` but not multiple.
+
+`--upn [upn]`
+: 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 `principalId`, `upn`, or `groupName` but not multiple.
+
+`--confirm`
+: Don't prompt for confirming removing the role assignment.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Remove roleassignment from listitem getting list by title based on group name
+
+```sh
+m365 spo listitem roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --listTitle "someList" --listItemId 1 --groupName "saleGroup"
+```
+
+Remove roleassignment from listitem getting list by title based on principal Id
+
+```sh
+m365 spo listitem roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --listTitle "Events" --listItemId 1 --principalId 2
+```
+
+Remove roleassignment from listitem getting list by url based on principal Id
+
+```sh
+m365 spo listitem roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --listUrl '/sites/contoso-sales/lists/Events' --listItemId 1 --principalId 2
+```
+
+
+Remove roleassignment from listitem getting list by url based on principal Id without prompting for confirmation
+
+```sh
+m365 spo listitem roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --listUrl '/sites/contoso-sales/lists/Events' --listItemId 1 --principalId 2 --confirm
+```

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

@@ -17,14 +17,20 @@ m365 spo listitem roleinheritance break [options]
 : ID of the item for which to break role inheritance
 
 `-l, --listId [listId]`
-: ID of the list. Specify listId or listTitle but not both
+: ID of the list. Specify either `listTitle`, `listId` or `listUrl`
 
 `-t, --listTitle [listTitle]`
-: Title of the list. 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, --clearExistingPermissions`
 : Set to clear existing roles from the list item
 
+`--confirm`
+: Do not prompt for confirmation before breaking role inheritance.
+
 --8<-- "docs/cmd/_global.md"
 
 ## Remarks
@@ -36,23 +42,29 @@ By default, when breaking permissions inheritance, the list item will retain exi
 Break inheritance of list item _1_ in list _someList_ located in site _https://contoso.sharepoint.com/sites/project-x_
 
 ```sh
-m365 spo listitem roleinheritance break --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "_someList_" --id 1
+m365 spo listitem roleinheritance break --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "_someList_" --listItemId 1
 ```
 
 Break inheritance of list item _1_ in list with ID _202b8199-b9de-43fd-9737-7f213f51c991_ located in site _https://contoso.sharepoint.com/sites/project-x_
 
 ```sh
-m365 spo listitem roleinheritance break --webUrl https://contoso.sharepoint.com/sites/project-x --listId 202b8199-b9de-43fd-9737-7f213f51c991 --id 1
+m365 spo listitem roleinheritance break --webUrl https://contoso.sharepoint.com/sites/project-x --listId 202b8199-b9de-43fd-9737-7f213f51c991 --listItemId 1
 ```
 
-Break inheritance of list item _1_ in list _someList_ located in site _https://contoso.sharepoint.com/sites/project-x_ with clearing permissions 
+Break inheritance of list item _1_ in list _someList_ located in site _https://contoso.sharepoint.com/sites/project-x_ with clearing permissions
 
 ```sh
-m365 spo listitem roleinheritance break --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "_someList_" --id 1 --clearExistingPermissions
+m365 spo listitem roleinheritance break --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "_someList_" --listItemId 1 --clearExistingPermissions
 ```
 
-Break inheritance of list item _1_ in list with ID _202b8199-b9de-43fd-9737-7f213f51c991_ located in site _https://contoso.sharepoint.com/sites/project-x_ with clearing permissions 
+Break inheritance of a specific list item in a list retrieved by server-relative URL in a specific site and clear the existing permissions
 
 ```sh
-m365 spo listitem roleinheritance break --webUrl https://contoso.sharepoint.com/sites/project-x --listId 202b8199-b9de-43fd-9737-7f213f51c991 --id 1 --clearExistingPermissions
+m365 spo listitem roleinheritance break --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl /sites/project-x/Documents --listItemId 1 --clearExistingPermissions
 ```
+
+Break inheritance of list item _1_ in 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
+
+```sh
+m365 spo listitem roleinheritance break --webUrl https://contoso.sharepoint.com/sites/project-x --listId 202b8199-b9de-43fd-9737-7f213f51c991 --listItemId 1 --clearExistingPermissions --confirm
+```

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

@@ -17,10 +17,16 @@ m365 spo listitem roleinheritance reset [options]
 : ID of the item for which to reset role inheritance
 
 `--listId [listId]`
-: ID of the list. Specify listId or listTitle but not both
+: ID of the list. Specify either `listTitle`, `listId` or `listUrl`
 
 `--listTitle [listTitle]`
-: Title of the list. 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`
+
+`--confirm`
+: Do not prompt for confirmation before resetting role inheritance.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -37,3 +43,9 @@ Restore role inheritance of list item with id 8 from list with title _test_ loca
 ```sh
 m365 spo listitem roleinheritance reset --webUrl https://contoso.sharepoint.com/sites/project-x --listItemId 8 --listTitle test
 ```
+
+Restore role inheritance of a list item with a specific id in a list retrieved by server relative URL located in a specific site without prompting for confirmation
+
+```sh
+m365 spo listitem roleinheritance reset --webUrl https://contoso.sharepoint.com/sites/project-x --listItemId 8 --listUrl /sites/project-x/lists/test --confirm
+```

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

@@ -17,10 +17,13 @@ m365 spo listitem set [options]
 : ID of the list item to update.
 
 `-l, --listId [listId]`
-: ID of the list where the item should be updated. Specify `listId` or `listTitle` but not both
+: ID of the list where the item should be updated. Specify either `listTitle`, `listId` or `listUrl`
 
 `-t, --listTitle [listTitle]`
-: Title of the list where the item should be updated. Specify `listId` or `listTitle` but not both
+: Title of the list where the item should be updated. Specify either `listTitle`, `listId` or `listUrl`
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list where the item should be updated. Specify either `listTitle`, `listId` or `listUrl`
 
 `-c, --contentType [contentType]`
 : The name or the ID of the content type to associate with the updated item
@@ -62,8 +65,8 @@ Update an item with id _147_ with Title _Demo Multi Person Field_ and a multi-se
 m365 spo listitem set --listTitle "Demo List" --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --Title "Demo Multi Person Field" --MultiPeopleField "[{'Key':'i:0#.f|membership|markh@conotoso.com'},{'Key':'i:0#.f|membership|adamb@conotoso.com'}]"
 ```
 
-Update an item with id _147_ with Title _Demo Hyperlink Field_ and a hyperlink field named _CustomHyperlink_ to list with title _Demo List_ in site _https://contoso.sharepoint.com/sites/project-x_
+Update the field _Title_ and _CustomHyperlink_ of an item with a specific id in a list retrieved by server-relative URL in a specific site
 
 ```sh
-m365 spo listitem set --listTitle "Demo List" --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --Title "Demo Hyperlink Field" --CustomHyperlink "https://www.bing.com, Bing"
+m365 spo listitem set --listUrl '/sites/project-x/lists/Demo List' --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --Title "Demo Hyperlink Field" --CustomHyperlink "https://www.bing.com, Bing"
 ```

package/docs/docs/cmd/spo/navigation/navigation-node-add.md

@@ -13,7 +13,7 @@ m365 spo navigation node add [options]
 `-u, --webUrl <webUrl>`
 : Absolute URL of the site to which navigation should be modified
 
-`-l, --location <location>`
+`-l, --location [location]`
 : Navigation type where the node should be added. Available options: `QuickLaunch`, `TopNavigationBar`
 
 `-t, --title <title>`