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

package/docs/docs/cmd/spo/list/list-view-field-add.md

@@ -14,10 +14,13 @@ m365 spo list view field add [options]
 : URL of the site where the list is located
 
 `--listId [listId]`
-: ID of the list where the view is located. Specify `listTitle` or `listId` but not both
+: ID of the list where the view is located. Specify either `listId`, `listTitle`, or `listUrl`.
 
 `--listTitle [listTitle]`
-: Title of the list where the view is located. Specify `listTitle` or `listId` but not both
+: Title of the list where the view is located. Specify either `listId`, `listTitle`, or `listUrl`.
+
+ `--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listId` , `listTitle` or `listUrl`.
 
 `--viewId [viewId]`
 : ID of the view to update. Specify `viewTitle` or `viewId` but not both
@@ -25,13 +28,13 @@ m365 spo list view field add [options]
 `--viewTitle [viewTitle]`
 : Title of the view to update. Specify `viewTitle` or `viewId` but not both
 
-`--fieldId [fieldId]`
-: ID of the field to add. Specify `fieldId` or `fieldTitle` but not both
+`--id [id]`
+: ID of the field to add. Specify `id` or `title` but not both
 
-`--fieldTitle [fieldTitle]`
-: The **case-sensitive** internal name or display name of the field to add. Specify `fieldId` or `fieldTitle` but not both
+`--title [title]`
+: The **case-sensitive** internal name or display name of the field to add. Specify `id` or `title` but not both
 
-`--fieldPosition [fieldPosition]`
+`--position [position]`
 : The zero-based index of the position for the field
 
 --8<-- "docs/cmd/_global.md"
@@ -41,17 +44,24 @@ m365 spo list view field add [options]
 Add field with ID _330f29c5-5c4c-465f-9f4b-7903020ae1ce_ to view with ID _3d760127-982c-405e-9c93-e1f76e1a1110_ of the list with ID _1f187321-f086-4d3d-8523-517e94cc9df9_ located in site _https://contoso.sharepoint.com/sites/project-x_
 
 ```sh
-m365 spo list view field add --webUrl https://contoso.sharepoint.com/sites/project-x --listId 1f187321-f086-4d3d-8523-517e94cc9df9 --viewId 3d760127-982c-405e-9c93-e1f76e1a1110 --fieldId 330f29c5-5c4c-465f-9f4b-7903020ae1ce
+m365 spo list view field add --webUrl https://contoso.sharepoint.com/sites/project-x --listId 1f187321-f086-4d3d-8523-517e94cc9df9 --viewId 3d760127-982c-405e-9c93-e1f76e1a1110 --id 330f29c5-5c4c-465f-9f4b-7903020ae1ce
 ```
 
 Add field with title _Custom field_ to view with title _All Documents_ of the list with title _Documents_ located in site _https://contoso.sharepoint.com/sites/project-x_
 
 ```sh
-m365 spo list view field add --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle Documents --viewTitle 'All Documents' --fieldTitle 'Custom field'
+m365 spo list view field add --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle Documents --viewTitle 'All Documents' --title 'Custom field'
+```
+
+Add field with title _Custom field_ at the position _0_ to view with title _My Events_ of the list with url _/sites/project-x/lists/Events_ located in site _https://contoso.sharepoint.com/sites/project-x_
+
+```sh
+m365 spo list view field add --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl '/sites/project-x/lists/Events' --viewTitle 'My Events' --title 'Custom field' --fieldPosition 0
 ```
 
-Add field with title _Custom field_ at the position _0_ to view with title _All Documents_ of the list with title _Documents_ located in site _https://contoso.sharepoint.com/sites/project-x_
+Add field with title _Custom field_ to view with title _All Documents_ of the list with site-relative URL _/Shared Documents_ located in site _https://contoso.sharepoint.com/sites/project-x_
 
 ```sh
-m365 spo list view field add --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle Documents --viewTitle 'All Documents' --fieldTitle 'Custom field' --fieldPosition 0
+m365 spo list view field add --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl 'Shared Documents' --viewTitle 'All Documents' --fieldTitle 'Custom field'
 ```
+

package/docs/docs/cmd/spo/list/list-view-field-remove.md

@@ -14,10 +14,13 @@ m365 spo list view field remove [options]
 : URL of the site where the list is located
 
 `--listId [listId]`
-: ID of the list where the view is located. Specify `listTitle` or `listId` but not both
+: ID of the list where the view is located. Specify either `listId`, `listTitle`, or `listUrl`.
 
 `--listTitle [listTitle]`
-: Title of the list where the view is located. Specify `listTitle` or `listId` but not both
+: Title of the list where the view is located. Specify either `listId`, `listTitle`, or `listUrl`.
+
+ `--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listId` , `listTitle` or `listUrl`.
 
 `--viewId [viewId]`
 : ID of the view to update. Specify `viewTitle` or `viewId` but not both
@@ -25,11 +28,11 @@ m365 spo list view field remove [options]
 `--viewTitle [viewTitle]`
 : Title of the view to update. Specify `viewTitle` or `viewId` but not both
 
-`--fieldId [fieldId]`
-: ID of the field to remove. Specify fieldId or fieldTitle but not both
+`--id [id]`
+: ID of the field to remove. Specify id or title but not both
 
-`--fieldTitle [fieldTitle]`
-: The **case-sensitive** internal name or display name of the field to remove. Specify `fieldId` or `fieldTitle` but not both
+`--title [title]`
+: The **case-sensitive** internal name or display name of the field to remove. Specify `id` or `title` but not both
 
 --8<-- "docs/cmd/_global.md"
 
@@ -38,11 +41,17 @@ m365 spo list view field remove [options]
 Remove field with ID _330f29c5-5c4c-465f-9f4b-7903020ae1ce_ from view with ID _3d760127-982c-405e-9c93-e1f76e1a1110_ from the list with ID _1f187321-f086-4d3d-8523-517e94cc9df9_ located in site _https://contoso.sharepoint.com/sites/project-x_
 
 ```sh
-m365 spo list view field remove --webUrl https://contoso.sharepoint.com/sites/project-x --listId 1f187321-f086-4d3d-8523-517e94cc9df9 --viewId 3d760127-982c-405e-9c93-e1f76e1a1110 --fieldId 330f29c5-5c4c-465f-9f4b-7903020ae1ce
+m365 spo list view field remove --webUrl https://contoso.sharepoint.com/sites/project-x --listId 1f187321-f086-4d3d-8523-517e94cc9df9 --viewId 3d760127-982c-405e-9c93-e1f76e1a1110 --id 330f29c5-5c4c-465f-9f4b-7903020ae1ce
 ```
 
 Remove field with title _Custom field_ from view with title _Custom view_ from the list with title _Documents_ located in site _https://contoso.sharepoint.com/sites/project-x_
 
 ```sh
-m365 spo list view field remove --webUrl https://contoso.sharepoint.com/sites/project-x --fieldTitle 'Custom field' --listTitle Documents --viewTitle 'Custom view'
+m365 spo list view field remove --webUrl https://contoso.sharepoint.com/sites/project-x --title 'Custom field' --listTitle Documents --viewTitle 'Custom view'
+```
+
+Remove field with title _Custom field_ from view with title _Custom view_ from the list with url _/sites/project-x/lists/Events_ located in site _https://contoso.sharepoint.com/sites/project-x_
+
+```sh
+m365 spo list view field remove --webUrl https://contoso.sharepoint.com/sites/project-x --fieldTitle 'Custom field' --listUrl '/sites/project-x/lists/Events' --viewTitle 'Custom view'
 ```

package/docs/docs/cmd/spo/list/list-view-field-set.md

@@ -14,10 +14,13 @@ m365 spo list view field set [options]
 : URL of the site where the list is located
 
 `--listId [listId]`
-: ID of the list where the view is located. Specify `listTitle` or `listId` but not both
+: ID of the list where the view is located. Specify either `listId`, `listTitle`, or `listUrl`.
 
 `--listTitle [listTitle]`
-: Title of the list where the view is located. Specify `listTitle` or `listId` but not both
+: Title of the list where the view is located. Specify either `listId`, `listTitle`, or `listUrl`.
+
+ `--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listId` , `listTitle` or `listUrl`.
 
 `--viewId [viewId]`
 : ID of the view to update. Specify `viewTitle` or `viewId` but not both
@@ -25,13 +28,13 @@ m365 spo list view field set [options]
 `--viewTitle [viewTitle]`
 : Title of the view to update. Specify `viewTitle` or `viewId` but not both
 
-`--fieldId [fieldId]`
-: ID of the field to update. Specify `fieldId` or `fieldTitle` but not both
+`--id [id]`
+: ID of the field to update. Specify `id` or `title` but not both
 
-`--fieldTitle [fieldTitle]`
-: The **case-sensitive** internal name or display name of the field to update. Specify `fieldId` or `fieldTitle` but not both
+`--title [title]`
+: The **case-sensitive** internal name or display name of the field to update. Specify `id` or `title` but not both
 
-`--fieldPosition <fieldPosition>`
+`--position <position>`
 : The zero-based index of the position to which to move the field
 
 --8<-- "docs/cmd/_global.md"
@@ -41,11 +44,24 @@ m365 spo list view field set [options]
 Move field with ID _330f29c5-5c4c-465f-9f4b-7903020ae1ce_ to the front in view with ID _3d760127-982c-405e-9c93-e1f76e1a1110_ of list with ID _1f187321-f086-4d3d-8523-517e94cc9df9_ located in site _https://contoso.sharepoint.com/sites/project-x_
 
 ```sh
-m365 spo list view field set --webUrl https://contoso.sharepoint.com/sites/project-x --listId 1f187321-f086-4d3d-8523-517e94cc9df9 --viewId 3d760127-982c-405e-9c93-e1f76e1a1110 --fieldId 330f29c5-5c4c-465f-9f4b-7903020ae1ce --fieldPosition 0
+m365 spo list view field set --webUrl https://contoso.sharepoint.com/sites/project-x --listId 1f187321-f086-4d3d-8523-517e94cc9df9 --viewId 3d760127-982c-405e-9c93-e1f76e1a1110 --id 330f29c5-5c4c-465f-9f4b-7903020ae1ce --position 0
 ```
 
 Move field with title _Custom field_ to position _1_ in view with title _All Documents_ of the list with title _Documents_ located in site _https://contoso.sharepoint.com/sites/project-x_
 
 ```sh
-m365 spo list view field set --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle Documents --viewTitle 'All Documents' --fieldTitle 'Custom field' --fieldPosition 1
+m365 spo list view field set --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle Documents --viewTitle 'All Documents' --title 'Custom field' --position 1
+```
+
+Move field with title _Custom field_ to position _1_ in view with title _All Documents_ of the list with url _/sites/project-x/lists/Events_ located in site _https://contoso.sharepoint.com/sites/project-x_
+
+```sh
+m365 spo list view field set --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl '/sites/project-x/lists/Events' --viewTitle 'All Documents' --fieldTitle 'Custom field' --fieldPosition 1
 ```
+
+Move field with title _Custom field_ to position _1_ in view with title _All Documents_ of the list with site-relative URL _/Shared Documents_ located in site _https://contoso.sharepoint.com/sites/project-x_
+
+```sh
+m365 spo list view field set --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl '/Shared Documents' --viewTitle 'All Documents' --fieldTitle 'Custom field' --fieldPosition 1
+```
+

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

@@ -22,11 +22,11 @@ m365 spo list view get [options]
 `--listUrl [listUrl]`
 : Server- or web-relative URL of the list where the view is located. Specify only one of `listTitle`, `listId` or `listUrl`
 
-`--viewId [viewId]`
-: ID of the view to get. Specify `viewTitle` or `viewId` but not both
+`--id [id]`
+: ID of the view to get. Specify `title` or `id` but not both
 
-`--viewTitle [viewTitle]`
-: Title of the view to get. Specify `viewTitle` or `viewId` but not both
+`--title [title]`
+: Title of the view to get. Specify `title` or `id` but not both
 
 --8<-- "docs/cmd/_global.md"
 
@@ -35,17 +35,17 @@ m365 spo list view get [options]
 Gets a list view by name from a list located in site _https://contoso.sharepoint.com/sites/project-x_
 
 ```sh
-m365 spo list view get --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle 'My List' --viewTitle 'All Items'
+m365 spo list view get --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle 'My List' --title 'All Items'
 ```
 
 Gets a list view by ID from a list located in site _https://contoso.sharepoint.com/sites/project-x_
 
 ```sh
-m365 spo list view get --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl 'Lists/My List' --viewId 330f29c5-5c4c-465f-9f4b-7903020ae1ce
+m365 spo list view get --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl 'Lists/My List' --id 330f29c5-5c4c-465f-9f4b-7903020ae1ce
 ```
 
 Gets a list view by name from a list located in site _https://contoso.sharepoint.com/sites/project-x_. Retrieve the list by its ID
 
 ```sh
-m365 spo list view get --webUrl https://contoso.sharepoint.com/sites/project-x --listId 330f29c5-5c4c-465f-9f4b-7903020ae1c1 --viewTitle 'All Items'
+m365 spo list view get --webUrl https://contoso.sharepoint.com/sites/project-x --listId 330f29c5-5c4c-465f-9f4b-7903020ae1c1 --title 'All Items'
 ```

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

@@ -10,27 +10,36 @@ m365 spo list view list [options]
 
 ## Options
 
-`-u, --webUrl <webUrl>`
+ `-u, --webUrl <webUrl>`
 : URL of the site where the list is located
 
-`-i, --listId [listId]`
-: ID of the list for which to list configured views. Specify `listId` or `listTitle` but not both
+ `-i, --listId [listId]`
+: ID of the list for which to list configured views. Specify either `listId`, `listTitle`, or `listUrl`.
 
-`-t, --listTitle [listTitle]`
-: Title of the list for which to list configured views. Specify `listId` or `listTitle` but not both
+ `-t, --listTitle [listTitle]`
+: Title of the list for which to list configured views. Specify either `listId`, `listTitle`, or `listUrl`.
+
+ `--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listId` , `listTitle` or `listUrl`.
 
 --8<-- "docs/cmd/_global.md"
 
 ## Examples
 
-List all views for a list with title *Documents* located in site *https://contoso.sharepoint.com/sites/project-x*
+List all views for a list by title
 
 ```sh
 m365 spo list view list --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle Documents
 ```
 
-List all views for a list with ID *0cd891ef-afce-4e55-b836-fce03286cccf* located in site *https://contoso.sharepoint.com/sites/project-x*
+List all views for a list by ID
 
 ```sh
 m365 spo list view list --webUrl https://contoso.sharepoint.com/sites/project-x --listId 0cd891ef-afce-4e55-b836-fce03286cccf
 ```
+
+List all views for a list by URL
+
+```sh
+m365 spo list view list --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl '/sites/project-x/lists/Events'
+```

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

@@ -14,16 +14,19 @@ m365 spo list view remove [options]
 : URL of the site where the list to remove the view from is located
 
 `--listId [listId]`
-: ID of the list from which the view should be removed. Specify either `listId` or `listTitle` but not both
+: ID of the list from which the view should be removed. Specify either `listId`, `listTitle`, or `listUrl`.
 
 `--listTitle [listTitle]`
-: Title of the list from which the view should be removed. Specify either `listId` or `listTitle` but not both
+: Title of the list from which the view should be removed. Specify either `listId`, `listTitle`, or `listUrl`.
 
-`--viewId [viewId]`
-: ID of the view to remove. Specify either `viewId` or `viewTitle` but not both
+ `--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listId` , `listTitle` or `listUrl`.
 
-`--viewTitle [viewTitle]`
-: Title of the view to remove. Specify either `viewId` or `viewTitle` but not both
+`--id [id]`
+: ID of the view to remove. Specify either `id` or `title` but not both
+
+`--title [title]`
+: Title of the view to remove. Specify either `id` or `title` but not both
 
 `--confirm`
 : Don't prompt for confirming removing the view
@@ -32,26 +35,32 @@ m365 spo list view remove [options]
 
 ## Examples
 
-Remove view with ID _cc27a922-8224-4296-90a5-ebbc54da2e81_ from the list with ID _0cd891ef-afce-4e55-b836-fce03286cccf_ located in site _https://contoso.sharepoint.com/sites/project-x_
+Remove view from the list by ID _0cd891ef-afce-4e55-b836-fce03286cccf_ located in site _https://contoso.sharepoint.com/sites/project-x_
 
 ```sh
-m365 spo list view remove --webUrl https://contoso.sharepoint.com/sites/project-x --listId 0cd891ef-afce-4e55-b836-fce03286cccf --viewId cc27a922-8224-4296-90a5-ebbc54da2e81
+m365 spo list view remove --webUrl https://contoso.sharepoint.com/sites/project-x --listId 0cd891ef-afce-4e55-b836-fce03286cccf --id cc27a922-8224-4296-90a5-ebbc54da2e81
 ```
 
 Remove view with ID _cc27a922-8224-4296-90a5-ebbc54da2e81_ from the list with title _Documents_ located in site _https://contoso.sharepoint.com/sites/project-x_
 
 ```sh
-m365 spo list view remove --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle Documents --viewId cc27a922-8224-4296-90a5-ebbc54da2e81
+m365 spo list view remove --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle Documents --id cc27a922-8224-4296-90a5-ebbc54da2e81
 ```
 
 Remove view with title _MyView_ from a list with title _Documents_ located in site _https://contoso.sharepoint.com/sites/project-x_
 
 ```sh
-m365 spo list view remove --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle Documents --viewTitle MyView
+m365 spo list view remove --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle Documents --title MyView
+```
+
+Remove view with title _MyView_ from a list with url _/sites/project-x/lists/Events_ located in site _https://contoso.sharepoint.com/sites/project-x_
+
+```sh
+m365 spo list view remove --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl '/sites/project-x/lists/Events' --viewTitle MyView
 ```
 
 Remove view with ID _cc27a922-8224-4296-90a5-ebbc54da2e81_ from a list with title _Documents_ located in site _https://contoso.sharepoint.com/sites/project-x_ without being asked for confirmation
 
 ```sh
-m365 spo list view remove --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle Documents --viewId cc27a922-8224-4296-90a5-ebbc54da2e81 --confirm
+m365 spo list view remove --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle Documents --id cc27a922-8224-4296-90a5-ebbc54da2e81 --confirm
 ```

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

@@ -14,16 +14,19 @@ m365 spo list view set [options]
 : URL of the site where the list is located
 
 `--listId [listId]`
-: ID of the list where the view is located. Specify `listTitle` or `listId` but not both
+: ID of the list where the view is located. Specify either `listId`, `listTitle`, or `listUrl`.
 
 `--listTitle [listTitle]`
-: Title of the list where the view is located. Specify `listTitle` or `listId` but not both
+: Title of the list where the view is located. Specify either `listId`, `listTitle`, or `listUrl`.
 
-`--viewId [viewId]`
-: ID of the view to update. Specify `viewTitle` or `viewId` but not both
+ `--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listId` , `listTitle` or `listUrl`.
 
-`--viewTitle [viewTitle]`
-: Title of the view to update. Specify `viewTitle` or `viewId` but not both
+`--id [id]`
+: ID of the view to update. Specify `title` or `id` but not both
+
+`--title [title]`
+: Title of the view to update. Specify `title` or `id` but not both
 
 --8<-- "docs/cmd/_global.md"
 
@@ -33,22 +36,33 @@ Specify properties to update using their names, eg. `--Title 'New Title' --JSLin
 
 When updating list formatting, the value of the CustomFormatter property must be XML-escaped, eg. `&lt;` instead of `<`.
 
+!!! warning "Escaping JSON in PowerShell"
+    When updating list view formatting for a view with the `--CustomFormatter` option, it's possible to enter a JSON string. In PowerShell 5 to 7.2 [specific escaping rules](./../../../user-guide/using-cli.md#escaping-double-quotes-in-powershell) apply due to an issue. Remember that you can also use [file tokens](./../../../user-guide/using-cli.md#passing-complex-content-into-cli-options) instead.
+
 ## Examples
 
 Update the title of the list view specified by its name
 
 ```sh
-m365 spo list view set --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle 'My List' --viewTitle 'All items' --Title 'All events'
+m365 spo list view set --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle 'My List' --title 'All items' --Title 'All events'
 ```
 
 Update the title of the list view specified by its ID
 
 ```sh
-m365 spo list view set --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle 'My List' --viewId 330f29c5-5c4c-465f-9f4b-7903020ae1ce --Title 'All events'
+m365 spo list view set --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl '/sites/project-x/lists/Events' --id 330f29c5-5c4c-465f-9f4b-7903020ae1ce --Title 'All events'
 ```
 
 Update view formatting of the specified list view
 
-```sh
-m365 spo list view set --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle 'My List' --viewTitle 'All items' --CustomFormatter '`{"schema":"https://developer.microsoft.com/json-schemas/sp/view-formatting.schema.json","additionalRowClass": "=if([$DueDate] &lt;= @now, 'sp-field-severity--severeWarning', '')"}`'
-```
+=== "PowerShell"
+
+    ```sh
+    m365 spo list view set --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle 'My List' --viewTitle 'All items' --CustomFormatter '{\"schema\":\"https://developer.microsoft.com/json-schemas/sp/view-formatting.schema.json\",\"additionalRowClass\": \"=if([$DueDate] &lt;= @now, ''sp-field-severity--severeWarning'', '''')\"}'
+    ```
+
+=== "Bash"
+
+    ```sh
+    m365 spo list view set --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle 'My List' --viewTitle 'All items' --CustomFormatter "{\"schema\":\"https://developer.microsoft.com/json-schemas/sp/view-formatting.schema.json\",\"additionalRowClass\": \"=if([$DueDate] &lt;= @now, 'sp-field-severity--severeWarning', '')\"}"
+    ```

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

@@ -11,46 +11,45 @@ m365 spo list webhook add [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: URL of the site where the list to add the webhook to is located
+: URL of the site where the list is located.
 
 `-l, --listId [listId]`
-: ID of the list to which the webhook which should be added. Specify either `listId` or `listTitle` but not both
+: ID of the list. Specify either `listTitle`, `listId` or `listUrl`.
 
 `-t, --listTitle [listTitle]`
-: Title of the list to which the webhook which should be added. Specify either `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`.
 
 `-n, --notificationUrl <notificationUrl>`
-: The notification url
+: The notification URL.
 
 `-e, --expirationDateTime [expirationDateTime]`
-: The expiration date. Will be set to max (6 months from today) if not provided
+: The expiration date. Will be set to max (6 months from today) if not provided.
 
 `-c, --clientState [clientState]`
-: A client state information that will be passed through notifications
+: A client state information that will be passed through notifications.
 
 --8<-- "docs/cmd/_global.md"
 
 ## Examples
 
-Add a web hook to the list Documents located in site _https://contoso.sharepoint.com/sites/ninja_ with the notification url
-_https://contoso-funcions.azurewebsites.net/webhook_ and the default expiration
-date
+Add a web hook to the list retrieved by Title located in a specific site with a specific notification url and the default expiration date
 
 ```sh
 m365 spo list webhook add --webUrl https://contoso.sharepoint.com/sites/ninja --listTitle Documents --notificationUrl https://contoso-funcions.azurewebsites.net/webhook
 ```
 
-Add a web hook to the list Documents located in site _https://contoso.sharepoint.com/sites/ninja_ with the notification url
-_https://contoso-funcions.azurewebsites.net/webhook_ and an expiration date of _January 21st, 2019_
+Add a web hook to the list retrieved by URL located in a specific site with a specific notification url and a specific expiration date
 
 ```sh
-m365 spo list webhook add --webUrl https://contoso.sharepoint.com/sites/ninja --listTitle Documents --notificationUrl https://contoso-funcions.azurewebsites.net/webhook --expirationDateTime 2019-01-21
+m365 spo list webhook add --webUrl https://contoso.sharepoint.com/sites/ninja --listUrl '/sites/ninja/Documents' --notificationUrl https://contoso-funcions.azurewebsites.net/webhook --expirationDateTime 2019-01-21
 ```
 
-Add a web hook to the list Documents located in site _https://contoso.sharepoint.com/sites/ninja_ with the notification url
-_https://contoso-funcions.azurewebsites.net/webhook_, a very specific expiration date of _6:15 PM on March 2nd, 2019_ and
-a client state
+Add a web hook to the list retrieved by ID located in a specific site with a specific notification url, a specific expiration date and a client state
+
 
 ```sh
-m365 spo list webhook add --webUrl https://contoso.sharepoint.com/sites/ninja --listTitle Documents --notificationUrl https://contoso-funcions.azurewebsites.net/webhook --expirationDateTime '2019-03-02T18:15' --clientState "Hello State!"
+m365 spo list webhook add --webUrl https://contoso.sharepoint.com/sites/ninja --listId '3d6aefa0-f438-4789-b0cd-6e865f5d65b5' --notificationUrl https://contoso-funcions.azurewebsites.net/webhook --expirationDateTime '2019-03-02T18:15' --clientState "Hello State!"
 ```

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

@@ -11,16 +11,19 @@ m365 spo list webhook get [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: URL of the site where the list to retrieve the webhook info for is located
+: URL of the site where the list is located.
 
 `-l, --listId [listId]`
-: ID of the list from which to retrieve the webhook. Specify either `listId` or `listTitle` but not both
+: ID of the list. Specify either `listTitle`, `listId` or `listUrl`.
 
 `-t, --listTitle [listTitle]`
-: Title of the list from which to retrieve the webhook. Specify either `listId` or `listTitle` but not both
+: Title of the list. Specify either `listTitle`, `listId` or `listUrl`.
 
-`-i, --id [id]`
-: ID of the webhook to retrieve
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`.
+
+`-i, --id <id>`
+: ID of the webhook.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -30,14 +33,20 @@ If the specified `id` doesn't refer to an existing webhook, you will get a `404
 
 ## Examples
 
-Return information about a webhook with ID _cc27a922-8224-4296-90a5-ebbc54da2e85_ which belongs to a list with ID _0cd891ef-afce-4e55-b836-fce03286cccf_ located in site _https://contoso.sharepoint.com/sites/project-x_
+Return information about a specific webhook which belongs to a list retrieved by ID in a specific site
 
 ```sh
 m365 spo list webhook get --webUrl https://contoso.sharepoint.com/sites/project-x --listId 0cd891ef-afce-4e55-b836-fce03286cccf --id cc27a922-8224-4296-90a5-ebbc54da2e85
 ```
 
-Return information about a webhook with ID _cc27a922-8224-4296-90a5-ebbc54da2e85_ which belongs to a list with title _Documents_ located in site _https://contoso.sharepoint.com/sites/project-x_
+Return information about a specific webhook which belongs to a list retrieved by Title in a specific site
 
 ```sh
 m365 spo list webhook get --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle Documents --id cc27a922-8224-4296-90a5-ebbc54da2e85
 ```
+
+Return information about a specific webhook which belongs to a list retrieved by URL in a specific site
+
+```sh
+m365 spo list webhook get --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl '/sites/project-x/Documents' --id cc27a922-8224-4296-90a5-ebbc54da2e85
+```

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

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

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

@@ -11,19 +11,22 @@ m365 spo list webhook remove [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: URL of the site where the list to remove the webhook from is located
+: URL of the site where the list is located.
 
 `-l, --listId [listId]`
-: ID of the list from which the webhook should be removed. 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 from which the webhook should be removed. Specify either `listId` or `listTitle` but not both
+: Title of the list. Specify either `listId`, `listTitle` or `listUrl`.
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listId`, `listTitle` or `listUrl`.
 
 `-i, --id <id>`
-: ID of the webhook to remove
+: ID of the webhook.
 
 `--confirm`
-: Don't prompt for confirming removing the webhook
+: Don't prompt for confirmation.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -33,20 +36,19 @@ If the specified id doesn't refer to an existing webhook, you will get a `404 -
 
 ## Examples
 
-Remove webhook with ID _cc27a922-8224-4296-90a5-ebbc54da2e81_ from a list with ID _0cd891ef-afce-4e55-b836-fce03286cccf_ located in site _https://contoso.sharepoint.com/sites/ninja_
+Remove webhook with a specific ID from a list retrieved by ID in a specific site
 
 ```sh
 m365 spo list webhook remove --webUrl https://contoso.sharepoint.com/sites/ninja --listId 0cd891ef-afce-4e55-b836-fce03286cccf --id cc27a922-8224-4296-90a5-ebbc54da2e81
 ```
 
-Remove webhook with ID _cc27a922-8224-4296-90a5-ebbc54da2e81_ from a list with title _Documents_ located in site _https://contoso.sharepoint.com/sites/ninja_
-
+Remove webhook with a specific ID from a list retrieved by Title in a specific site
 ```sh
 m365 spo list webhook remove --webUrl https://contoso.sharepoint.com/sites/ninja --listTitle Documents --id cc27a922-8224-4296-90a5-ebbc54da2e81
 ```
 
-Remove webhook with ID _cc27a922-8224-4296-90a5-ebbc54da2e81_ from a list with title _Documents_ located in site _https://contoso.sharepoint.com/sites/ninja_ without being asked for confirmation
+Remove webhook with a specific ID from a list retrieved by URL in a specific site without being asked for confirmation
 
 ```sh
-m365 spo list webhook remove --webUrl https://contoso.sharepoint.com/sites/ninja --listTitle Documents --id cc27a922-8224-4296-90a5-ebbc54da2e81 --confirm
+m365 spo list webhook remove --webUrl https://contoso.sharepoint.com/sites/ninja --listUrl '/sites/ninja/Documents' --id cc27a922-8224-4296-90a5-ebbc54da2e81 --confirm
 ```