@pnp/cli-microsoft365 6.0.0-beta.566a6b8 → 6.0.0-beta.636d726

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

@@ -0,0 +1,45 @@
+# 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
+```
+
+Break the inheritance of the specified root folder for the library with a specified server-relative URL. It will clear the existing permissions of the root 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" --clearExistingPermissions --confirm
+```

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

@@ -0,0 +1,42 @@
+# 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
+```
+
+Reset inheritance of the specified root folder for the library with the server-relative url _/sites/project-x/Shared Documents 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" --confirm
+```

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

@@ -13,12 +13,21 @@ m365 spo group list [options]
 `-u, --webUrl <webUrl>`
 : Url of the web to list the group within
 
+`--associatedGroupsOnly`
+: Get only the associated visitor, member and owner groups of the site.
+
 --8<-- "docs/cmd/_global.md"
 
 ## Examples
 
-Lists all the groups within specific web _https://contoso.sharepoint.com/sites/contoso_
+Lists all the groups within a specific web
 
 ```sh
 m365 spo group list --webUrl "https://contoso.sharepoint.com/sites/contoso"
 ```
+
+Lists the associated groups within a specific web
+
+```sh
+m365 spo group list --webUrl "https://contoso.sharepoint.com/sites/contoso" --associatedGroupsOnly
+```

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/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

@@ -75,4 +75,4 @@ add role assignment to list _someList_ located in site _https://contoso.sharepoi
 
 ```sh
 m365 spo list roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --principalId 11 --roleDefinitionName "Full Control"
-```
+```

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

@@ -54,4 +54,4 @@ Remove roleassignment from list by url based on principal Id
 
 ```sh
 m365 spo list roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --listUrl '/sites/contoso-sales/lists/Events' --principalId 2
-```
+```

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

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

@@ -11,13 +11,16 @@ m365 spo list roleinheritance reset [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 id or title but not both
+: ID of the list. Specify either `listTitle`, `listId` or `listUrl`.
 
 `-t, --listTitle [listTitle]`
-: Title of the list. 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`.
 
 `--confirm`
 : Do not prompt for confirmation before resetting role inheritance.
@@ -26,20 +29,26 @@ m365 spo list roleinheritance reset [options]
 
 ## Examples
 
-Restore role inheritance of list with ID _0cd891ef-afce-4e55-b836-fce03286cccf_ located in site _https://contoso.sharepoint.com/sites/project-x_
+Restores role inheritance of a specific list by id in a specific site
 
 ```sh
 m365 spo list roleinheritance reset --webUrl https://contoso.sharepoint.com/sites/project-x --listId 0cd891ef-afce-4e55-b836-fce03286cccf
 ```
 
-Restore role inheritance of list with title _test_ located in site _https://contoso.sharepoint.com/sites/project-x_
+Restores role inheritance of a specific list by title in a specific site
 
 ```sh
 m365 spo list roleinheritance reset --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle test
 ```
 
-Restore role inheritance of list with title _test_ located in site _https://contoso.sharepoint.com/sites/project-x_ without prompting for confirmation
+Restores role inheritance of a specific list by url in a specific site
+
+```sh
+m365 spo list roleinheritance reset --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl '/sites/project-x/lists/events'
+```
+
+Restores role inheritance of list a specific list by title without prompting for confirmation
 
 ```sh
 m365 spo list roleinheritance reset --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle test --confirm
-```
+```

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

@@ -33,6 +33,9 @@ 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
@@ -49,6 +52,14 @@ m365 spo list view set --webUrl https://contoso.sharepoint.com/sites/project-x -
 
 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' --title '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'
+```