@pnp/cli-microsoft365 6.0.0-beta.e7c60af → 6.0.0-beta.eb11cbe

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

@@ -49,3 +49,124 @@ Gets a list view by name from a list located in site _https://contoso.sharepoint
 ```sh
 m365 spo list view get --webUrl https://contoso.sharepoint.com/sites/project-x --listId 330f29c5-5c4c-465f-9f4b-7903020ae1c1 --title 'All Items'
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "Aggregations": null,
+      "AggregationsStatus": null,
+      "AssociatedContentTypeId": null,
+      "BaseViewId": "1",
+      "CalendarViewStyles": null,
+      "ColumnWidth": null,
+      "ContentTypeId": {
+        "StringValue": "0x"
+      },
+      "CustomFormatter": null,
+      "CustomOrder": null,
+      "DefaultView": false,
+      "DefaultViewForContentType": false,
+      "EditorModified": false,
+      "Formats": null,
+      "GridLayout": null,
+      "Hidden": false,
+      "HtmlSchemaXml": "<View Name=\"{3CD2E934-F482-4D4A-A9B8-A13B49B3D226}\" Type=\"HTML\" DisplayName=\"All events\" Url=\"/Lists/Test/All events.aspx\" Level=\"1\" BaseViewID=\"1\" ContentTypeID=\"0x\" ImageUrl=\"/_layouts/15/images/generic.png?rev=47\"><ViewFields><FieldRef Name=\"Title\" /></ViewFields><Query><OrderBy><FieldRef Name=\"Created\" Ascending=\"FALSE\" /></OrderBy><Where><Eq><FieldRef Name=\"TextFieldName\" /><Value Type=\"Text\">Field value</Value></Eq></Where></Query><RowLimit Paged=\"TRUE\">30</RowLimit><XslLink Default=\"TRUE\">main.xsl</XslLink><JSLink>clienttemplates.js</JSLink><Toolbar Type=\"Standard\" /><ParameterBindings><ParameterBinding Name=\"NoAnnouncements\" Location=\"Resource(wss,noXinviewofY_LIST)\" /><ParameterBinding Name=\"NoAnnouncementsHowTo\" Location=\"Resource(wss,noXinviewofY_DEFAULT)\" /></ParameterBindings></View>",
+      "Id": "3cd2e934-f482-4d4a-a9b8-a13b49b3d226",
+      "ImageUrl": "/_layouts/15/images/generic.png?rev=47",
+      "IncludeRootFolder": false,
+      "ViewJoins": null,
+      "JSLink": "clienttemplates.js",
+      "ListViewXml": "<View Name=\"{3CD2E934-F482-4D4A-A9B8-A13B49B3D226}\" Type=\"HTML\" DisplayName=\"All events\" Url=\"/Lists/Test/All events.aspx\" Level=\"1\" BaseViewID=\"1\" ContentTypeID=\"0x\" ImageUrl=\"/_layouts/15/images/generic.png?rev=47\" ><Query><OrderBy><FieldRef Name=\"Created\" Ascending=\"FALSE\" /></OrderBy><Where><Eq><FieldRef Name=\"TextFieldName\" /><Value Type=\"Text\">Field value</Value></Eq></Where></Query><ViewFields><FieldRef Name=\"Title\" /></ViewFields><RowLimit Paged=\"TRUE\">30</RowLimit><JSLink>clienttemplates.js</JSLink><XslLink Default=\"TRUE\">main.xsl</XslLink><Toolbar Type=\"Standard\"/></View>",
+      "Method": null,
+      "MobileDefaultView": false,
+      "MobileView": false,
+      "ModerationType": null,
+      "NewDocumentTemplates": null,
+      "OrderedView": false,
+      "Paged": true,
+      "PersonalView": false,
+      "ViewProjectedFields": null,
+      "ViewQuery": "<OrderBy><FieldRef Name=\"Created\" Ascending=\"FALSE\" /></OrderBy><Where><Eq><FieldRef Name=\"TextFieldName\" /><Value Type=\"Text\">Field value</Value></Eq></Where>",
+      "ReadOnlyView": false,
+      "RequiresClientIntegration": false,
+      "RowLimit": 30,
+      "Scope": 0,
+      "ServerRelativePath": {
+        "DecodedUrl": "/Lists/Test/All events.aspx"
+      },
+      "ServerRelativeUrl": "/Lists/Test/All events.aspx",
+      "StyleId": null,
+      "TabularView": true,
+      "Threaded": false,
+      "Title": "All events",
+      "Toolbar": "",
+      "ToolbarTemplateName": null,
+      "ViewType": "HTML",
+      "ViewData": null,
+      "ViewType2": null,
+      "VisualizationInfo": null
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    Aggregations             : null
+    AggregationsStatus       : null
+    AssociatedContentTypeId  : null
+    BaseViewId               : 1
+    CalendarViewStyles       : null
+    ColumnWidth              : null
+    ContentTypeId            : {"StringValue":"0x"}
+    CustomFormatter          : null
+    CustomOrder              : null
+    DefaultView              : false
+    DefaultViewForContentType: false
+    EditorModified           : false
+    Formats                  : null
+    GridLayout               : null
+    Hidden                   : false
+    HtmlSchemaXml            : <View Name="{3CD2E934-F482-4D4A-A9B8-A13B49B3D226}" Type="HTML" DisplayName="All events" Url="/Lists/Test/All events.aspx" Level="1" BaseViewID="1" ContentTypeID="0x" ImageUrl="/_layouts/15/images/generic.png?rev=47"><ViewFields><FieldRef Name="Title" /></ViewFields><Query><OrderBy><FieldRef Name="Created" Ascending="FALSE" /></OrderBy><Where><Eq><FieldRef Name="TextFieldName" /><Value Type="Text">Field value</Value></Eq></Where></Query><RowLimit Paged="TRUE">30</RowLimit><XslLink Default="TRUE">main.xsl</XslLink><JSLink>clienttemplates.js</JSLink><Toolbar Type="Standard" /><ParameterBindings><ParameterBinding Name="NoAnnouncements" Location="Resource(wss,noXinviewofY_LIST)" /><ParameterBinding Name="NoAnnouncementsHowTo" Location="Resource(wss,noXinviewofY_DEFAULT)" /></ParameterBindings></View>
+    Id                       : 3cd2e934-f482-4d4a-a9b8-a13b49b3d226
+    ImageUrl                 : /_layouts/15/images/generic.png?rev=47
+    IncludeRootFolder        : false
+    JSLink                   : clienttemplates.js
+    ListViewXml              : <View Name="{3CD2E934-F482-4D4A-A9B8-A13B49B3D226}" Type="HTML" DisplayName="All events" Url="/Lists/Test/All events.aspx" Level="1" BaseViewID="1" ContentTypeID="0x" ImageUrl="/_layouts/15/images/generic.png?rev=47" ><Query><OrderBy><FieldRef Name="Created" Ascending="FALSE" /></OrderBy><Where><Eq><FieldRef Name="TextFieldName" /><Value Type="Text">Field value</Value></Eq></Where></Query><ViewFields><FieldRef Name="Title" /></ViewFields><RowLimit Paged="TRUE">30</RowLimit><JSLink>clienttemplates.js</JSLink><XslLink Default="TRUE">main.xsl</XslLink><Toolbar Type="Standard"/></View>
+    Method                   : null
+    MobileDefaultView        : false
+    MobileView               : false
+    ModerationType           : null
+    NewDocumentTemplates     : null
+    OrderedView              : false
+    Paged                    : true
+    PersonalView             : false
+    ReadOnlyView             : false
+    RequiresClientIntegration: false
+    RowLimit                 : 30
+    Scope                    : 0
+    ServerRelativePath       : {"DecodedUrl":"/Lists/Test/All events.aspx"}
+    ServerRelativeUrl        : /Lists/Test/All events.aspx
+    StyleId                  : null
+    TabularView              : true
+    Threaded                 : false
+    Title                    : All events
+    Toolbar                  :
+    ToolbarTemplateName      : null
+    ViewData                 : null
+    ViewJoins                : null
+    ViewProjectedFields      : null
+    ViewQuery                : <OrderBy><FieldRef Name="Created" Ascending="FALSE" /></OrderBy><Where><Eq><FieldRef Name="TextFieldName" /><Value Type="Text">Field value</Value></Eq></Where>
+    ViewType                 : HTML
+    ViewType2                : null
+    VisualizationInfo        : null
+    ```
+
+=== "CSV"
+
+    ```csv
+    Aggregations,AggregationsStatus,AssociatedContentTypeId,BaseViewId,CalendarViewStyles,ColumnWidth,ContentTypeId,CustomFormatter,CustomOrder,DefaultView,DefaultViewForContentType,EditorModified,Formats,GridLayout,Hidden,HtmlSchemaXml,Id,ImageUrl,IncludeRootFolder,ViewJoins,JSLink,ListViewXml,Method,MobileDefaultView,MobileView,ModerationType,NewDocumentTemplates,OrderedView,Paged,PersonalView,ViewProjectedFields,ViewQuery,ReadOnlyView,RequiresClientIntegration,RowLimit,Scope,ServerRelativePath,ServerRelativeUrl,StyleId,TabularView,Threaded,Title,Toolbar,ToolbarTemplateName,ViewType,ViewData,ViewType2,VisualizationInfo
+    ,,,1,,,"{""StringValue"":""0x""}",,,,,,,,,"<View Name=""{3CD2E934-F482-4D4A-A9B8-A13B49B3D226}"" Type=""HTML"" DisplayName=""All events"" Url=""/Lists/Test/All events.aspx"" Level=""1"" BaseViewID=""1"" ContentTypeID=""0x"" ImageUrl=""/_layouts/15/images/generic.png?rev=47""><ViewFields><FieldRef Name=""Title"" /></ViewFields><Query><OrderBy><FieldRef Name=""Created"" Ascending=""FALSE"" /></OrderBy><Where><Eq><FieldRef Name=""TextFieldName"" /><Value Type=""Text"">Field value</Value></Eq></Where></Query><RowLimit Paged=""TRUE"">30</RowLimit><XslLink Default=""TRUE"">main.xsl</XslLink><JSLink>clienttemplates.js</JSLink><Toolbar Type=""Standard"" /><ParameterBindings><ParameterBinding Name=""NoAnnouncements"" Location=""Resource(wss,noXinviewofY_LIST)"" /><ParameterBinding Name=""NoAnnouncementsHowTo"" Location=""Resource(wss,noXinviewofY_DEFAULT)"" /></ParameterBindings></View>",3cd2e934-f482-4d4a-a9b8-a13b49b3d226,/_layouts/15/images/generic.png?rev=47,,,clienttemplates.js,"<View Name=""{3CD2E934-F482-4D4A-A9B8-A13B49B3D226}"" Type=""HTML"" DisplayName=""All events"" Url=""/Lists/Test/All events.aspx"" Level=""1"" BaseViewID=""1"" ContentTypeID=""0x"" ImageUrl=""/_layouts/15/images/generic.png?rev=47"" ><Query><OrderBy><FieldRef Name=""Created"" Ascending=""FALSE"" /></OrderBy><Where><Eq><FieldRef Name=""TextFieldName"" /><Value Type=""Text"">Field value</Value></Eq></Where></Query><ViewFields><FieldRef Name=""Title"" /></ViewFields><RowLimit Paged=""TRUE"">30</RowLimit><JSLink>clienttemplates.js</JSLink><XslLink Default=""TRUE"">main.xsl</XslLink><Toolbar Type=""Standard""/></View>",,,,,,,1,,,"<OrderBy><FieldRef Name=""Created"" Ascending=""FALSE"" /></OrderBy><Where><Eq><FieldRef Name=""TextFieldName"" /><Value Type=""Text"">Field value</Value></Eq></Where>",,,30,0,"{""DecodedUrl"":""/Lists/Test/All events.aspx""}",/Lists/Test/All events.aspx,,1,,All events,,,HTML,,,
+    ```

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

@@ -10,27 +10,114 @@ 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'
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "Aggregations": null,
+        "AggregationsStatus": null,
+        "AssociatedContentTypeId": null,
+        "BaseViewId": "1",
+        "CalendarViewStyles": null,
+        "ColumnWidth": null,
+        "ContentTypeId": {
+          "StringValue": "0x"
+        },
+        "CustomFormatter": null,
+        "CustomOrder": null,
+        "DefaultView": false,
+        "DefaultViewForContentType": false,
+        "EditorModified": false,
+        "Formats": null,
+        "GridLayout": null,
+        "Hidden": false,
+        "HtmlSchemaXml": "<View Name=\"{0F11C3F1-E174-4A85-93A9-B4AFB7BD41B6}\" Type=\"HTML\" DisplayName=\"All events\" Url=\"/Lists/Test/All events2.aspx\" Level=\"1\" BaseViewID=\"1\" ContentTypeID=\"0x\" ImageUrl=\"/_layouts/15/images/generic.png?rev=47\"><ViewFields><FieldRef Name=\"Title\" /></ViewFields><Query><OrderBy><FieldRef Name=\"Created\" Ascending=\"FALSE\" /></OrderBy><Where><Eq><FieldRef Name=\"TextFieldName\" /><Value Type=\"Text\">Field value</Value></Eq></Where></Query><RowLimit Paged=\"TRUE\">30</RowLimit><XslLink Default=\"TRUE\">main.xsl</XslLink><JSLink>clienttemplates.js</JSLink><Toolbar Type=\"Standard\" /><ParameterBindings><ParameterBinding Name=\"NoAnnouncements\" Location=\"Resource(wss,noXinviewofY_LIST)\" /><ParameterBinding Name=\"NoAnnouncementsHowTo\" Location=\"Resource(wss,noXinviewofY_DEFAULT)\" /></ParameterBindings></View>",
+        "Id": "0f11c3f1-e174-4a85-93a9-b4afb7bd41b6",
+        "ImageUrl": "/_layouts/15/images/generic.png?rev=47",
+        "IncludeRootFolder": false,
+        "ViewJoins": null,
+        "JSLink": "clienttemplates.js",
+        "ListViewXml": "<View Name=\"{0F11C3F1-E174-4A85-93A9-B4AFB7BD41B6}\" Type=\"HTML\" DisplayName=\"All events\" Url=\"/Lists/Test/All events2.aspx\" Level=\"1\" BaseViewID=\"1\" ContentTypeID=\"0x\" ImageUrl=\"/_layouts/15/images/generic.png?rev=47\" ><Query><OrderBy><FieldRef Name=\"Created\" Ascending=\"FALSE\" /></OrderBy><Where><Eq><FieldRef Name=\"TextFieldName\" /><Value Type=\"Text\">Field value</Value></Eq></Where></Query><ViewFields><FieldRef Name=\"Title\" /></ViewFields><RowLimit Paged=\"TRUE\">30</RowLimit><JSLink>clienttemplates.js</JSLink><XslLink Default=\"TRUE\">main.xsl</XslLink><Toolbar Type=\"Standard\"/></View>",
+        "Method": null,
+        "MobileDefaultView": false,
+        "MobileView": false,
+        "ModerationType": null,
+        "NewDocumentTemplates": null,
+        "OrderedView": false,
+        "Paged": true,
+        "PersonalView": false,
+        "ViewProjectedFields": null,
+        "ViewQuery": "<OrderBy><FieldRef Name=\"Created\" Ascending=\"FALSE\" /></OrderBy><Where><Eq><FieldRef Name=\"TextFieldName\" /><Value Type=\"Text\">Field value</Value></Eq></Where>",
+        "ReadOnlyView": false,
+        "RequiresClientIntegration": false,
+        "RowLimit": 30,
+        "Scope": 0,
+        "ServerRelativePath": {
+          "DecodedUrl": "/Lists/Test/All events2.aspx"
+        },
+        "ServerRelativeUrl": "/Lists/Test/All events2.aspx",
+        "StyleId": null,
+        "TabularView": true,
+        "Threaded": false,
+        "Title": "All events",
+        "Toolbar": "",
+        "ToolbarTemplateName": null,
+        "ViewType": "HTML",
+        "ViewData": null,
+        "ViewType2": null,
+        "VisualizationInfo": null
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    Id                                    Title       DefaultView  Hidden  BaseViewId
+    ------------------------------------  ----------  -----------  ------  ----------
+    3cd2e934-f482-4d4a-a9b8-a13b49b3d226  All events  false        false   1
+    ```
+
+=== "CSV"
+
+    ```csv
+    Id,Title,DefaultView,Hidden,BaseViewId
+    3cd2e934-f482-4d4a-a9b8-a13b49b3d226,All events,,,1
+    ```

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

@@ -14,10 +14,13 @@ 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`.
+
+ `--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listId` , `listTitle` or `listUrl`.
 
 `--id [id]`
 : ID of the view to remove. Specify either `id` or `title` but not both
@@ -32,7 +35,7 @@ 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 --id cc27a922-8224-4296-90a5-ebbc54da2e81
@@ -50,8 +53,18 @@ Remove view with title _MyView_ from a list with title _Documents_ located in si
 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 --id cc27a922-8224-4296-90a5-ebbc54da2e81 --confirm
 ```
+
+## Response
+
+The command won't return a response on success.

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

@@ -14,10 +14,13 @@ 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`.
+
+ `--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listId` , `listTitle` or `listUrl`.
 
 `--id [id]`
 : ID of the view to update. Specify `title` or `id` but not both
@@ -33,6 +36,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
@@ -44,11 +50,23 @@ m365 spo list view set --webUrl https://contoso.sharepoint.com/sites/project-x -
 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' --id 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' --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', '')\"}"
+    ```
+
+## Response
+
+The command won't return a response on success.

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

@@ -53,3 +53,36 @@ Add a web hook to the list retrieved by ID located in a specific site with a spe
 ```sh
 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!"
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "clientState": "random client state",
+      "expirationDateTime": "2019-05-29T23:00:00.000Z",
+      "id": "ef69c37d-cb0e-46d9-9758-5ebdeffd6959",
+      "notificationUrl": "https://contoso-funcions.azurewebsites.net/webhook",
+      "resource": "0987cfd9-f02c-479b-9fb4-3f0550462848",
+      "resourceData": null
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    clientState       : random client state
+    expirationDateTime: 2019-05-29T23:00:00.000Z
+    id                : ef69c37d-cb0e-46d9-9758-5ebdeffd6959
+    notificationUrl   : https://contoso-funcions.azurewebsites.net/webhook
+    resource          : 0987cfd9-f02c-479b-9fb4-3f0550462848
+    resourceData      : null
+    ```
+
+=== "CSV"
+
+    ```csv
+    clientState,expirationDateTime,id,notificationUrl,resource,resourceData
+    random client state,2019-05-29T23:00:00.000Z,ef69c37d-cb0e-46d9-9758-5ebdeffd6959,https://contoso-funcions.azurewebsites.net/webhook,0987cfd9-f02c-479b-9fb4-3f0550462848,
+    ```

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

@@ -22,7 +22,7 @@ m365 spo list webhook get [options]
 `--listUrl [listUrl]`
 : Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`.
 
-`-i, --id [id]`
+`-i, --id <id>`
 : ID of the webhook.
 
 --8<-- "docs/cmd/_global.md"
@@ -50,3 +50,36 @@ Return information about a specific webhook which belongs to a list retrieved by
 ```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
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "clientState": "system-managed:8082D436-D8DA-458D-96AD-34C902B73F37",
+      "expirationDateTime": "2022-11-16T20:25:12.2735056Z",
+      "id": "b8838bbb-9ddb-44fb-9016-0aacb9e02b77",
+      "notificationUrl": "https://northeurope1-0.pushnp.svc.ms/notifications?token=1e263e06-4bea-4db1-9f9f-5c8f713eef76",
+      "resource": "97d19285-b8a6-4c7f-9c6c-d6b850a6561a",
+      "resourceData": null
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    clientState       : system-managed:8082D436-D8DA-458D-96AD-34C902B73F37
+    expirationDateTime: 2022-11-16T20:25:12.2735056Z
+    id                : b8838bbb-9ddb-44fb-9016-0aacb9e02b77
+    notificationUrl   : https://northeurope1-0.pushnp.svc.ms/notifications?token=1e263e06-4bea-4db1-9f9f-5c8f713eef76
+    resource          : 97d19285-b8a6-4c7f-9c6c-d6b850a6561a
+    resourceData      : null
+    ```
+
+=== "CSV"
+
+    ```csv
+    clientState,expirationDateTime,id,notificationUrl,resource,resourceData
+    system-managed:8082D436-D8DA-458D-96AD-34C902B73F37,2022-11-16T20:25:12.2735056Z,b8838bbb-9ddb-44fb-9016-0aacb9e02b77,https://northeurope1-0.pushnp.svc.ms/notifications?token=1e263e06-4bea-4db1-9f9f-5c8f713eef76,97d19285-b8a6-4c7f-9c6c-d6b850a6561a,
+    ```

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

@@ -14,19 +14,13 @@ m365 spo list webhook list [options]
 : URL of the site where the list is located.
 
 `-i, --listId [listId]`
-: ID of the list. Specify either `id`, `title`, `listTitle`, `listId` or `listUrl`.
+: ID of the list. Specify either `listTitle`, `listId` or `listUrl`.
 
 `-t, --listTitle [listTitle]`
-: Title of the list. Specify either `id`, `title`, `listTitle`, `listId` or `listUrl`.
+: Title of the list. Specify either `listTitle`, `listId` or `listUrl`.
 
 `--listUrl [listUrl]`
-: Server- or site-relative URL of the list. Specify either `id`, `title`, `listTitle`, `listId` or `listUrl`.
-
-`--id [id]`
-: (deprecated. Use `listId` instead) ID of the list to retrieve all webhooks for. Specify either `id`, `title`, `listTitle`, `listId` or `listUrl`.
-
-`--title [title]`
-: (deprecated. Use `listTitle` instead) Title of the list to retrieve all webhooks for. Specify either `id`, `title`, `listTitle`, `listId` or `listUrl`.
+: Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -49,3 +43,35 @@ 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'
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "clientState": "system-managed:8082D436-D8DA-458D-96AD-34C902B73F37",
+        "expirationDateTime": "2022-11-16T20:25:12.2735056Z",
+        "id": "b8838bbb-9ddb-44fb-9016-0aacb9e02b77",
+        "notificationUrl": "https://northeurope1-0.pushnp.svc.ms/notifications?token=1e263e06-4bea-4da1-9f9f-5c8f713eef76",
+        "resource": "97d19285-b8a6-4c7f-9c6c-d6b850a6561a",
+        "resourceData": null
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    clientState                                          expirationDateTime            id                                    resource
+    ---------------------------------------------------  ----------------------------  ------------------------------------  ------------------------------------
+    system-managed:8082D436-D8DA-458D-96AD-34C902B73F37  2022-11-16T20:25:12.2735056Z  b8838bbb-9ddb-44fb-9016-0aacb9e02b77  97d19285-b8a6-4c7f-9c6c-d6b850a6561a
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,clientState,expirationDateTime,resource
+    b8838bbb-9ddb-44fb-9016-0aacb9e02b77,system-managed:8082D436-D8DA-458D-96AD-34C902B73F37,2022-11-16T20:25:12.2735056Z,97d19285-b8a6-4c7f-9c6c-d6b850a6561a
+    ```

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

@@ -52,3 +52,7 @@ Remove webhook with a specific ID from a list retrieved by URL in a specific sit
 ```sh
 m365 spo list webhook remove --webUrl https://contoso.sharepoint.com/sites/ninja --listUrl '/sites/ninja/Documents' --id cc27a922-8224-4296-90a5-ebbc54da2e81 --confirm
 ```
+
+## Response
+
+The command won't return a response on success.

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

@@ -22,14 +22,17 @@ m365 spo list webhook set [options]
 `--listUrl [listUrl]`
 : Server- or site-relative URL of the list. Specify either `listId`, `listTitle` or `listUrl`.
 
-`-i, --id [id]`
+`-i, --id <id>`
 : ID of the webhook to update.
 
 `-n, --notificationUrl [notificationUrl]`
 : 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"
 
@@ -51,8 +54,12 @@ Update the expiration date of a webhook with a specific ID attached to a list wi
 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
 ```
 
-Update the notification url 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
+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 --listUrl '/sites/ninja/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,68 @@ 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"
+```
+
+Add an item with a specific Title and multi-choice value
+
+```sh
+m365 spo listitem add --listTitle "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x --Title "Demo Hyperlink Field" --MultiChoiceField "Choice 1;#Choice 2;#Choice 3"
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "FileSystemObjectType": 0,
+      "Id": 234,
+      "ServerRedirectedEmbedUri": null,
+      "ServerRedirectedEmbedUrl": "",
+      "ID": 234,
+      "ContentTypeId": "0x01003CDBEB7138618C47A98D56499135D6EE0004C0F5794DEBCC4BAC981AC4AE1BD803",
+      "Title": "Test",
+      "Modified": "2022-11-16T20:55:45Z",
+      "Created": "2022-11-16T20:55:45Z",
+      "AuthorId": 10,
+      "EditorId": 10,
+      "OData__UIVersionString": "1.0",
+      "Attachments": false,
+      "GUID": "352e3855-56fa-4b68-b6be-4644d6adf204",
+      "ComplianceAssetId": null,
+      "OData__vti_ItemDeclaredRecord": null,
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    Attachments                  : false
+    AuthorId                     : 10
+    ComplianceAssetId            : null
+    ContentTypeId                : 0x01003CDBEB7138618C47A98D56499135D6EE0004C0F5794DEBCC4BAC981AC4AE1BD803
+    Created                      : 2022-11-16T20:56:31Z
+    EditorId                     : 10
+    FileSystemObjectType         : 0
+    GUID                         : cac57513-e870-4e7a-9f23-f4ea10e14f4e
+    ID                           : 236
+    Id                           : 236
+    Modified                     : 2022-11-16T20:56:31Z
+    OData__UIVersionString       : 1.0
+    OData__vti_ItemDeclaredRecord: null
+    ServerRedirectedEmbedUri     : null
+    ServerRedirectedEmbedUrl     :
+    Title                        : Test
+    ```
+
+=== "CSV"
+
+    ```csv
+    FileSystemObjectType,Id,ServerRedirectedEmbedUri,ServerRedirectedEmbedUrl,ID,ContentTypeId,Title,Modified,Created,AuthorId,EditorId,OData__UIVersionString,Attachments,GUID,ComplianceAssetId,OData__vti_ItemDeclaredRecord
+    0,235,,,235,0x01003CDBEB7138618C47A98D56499135D6EE0004C0F5794DEBCC4BAC981AC4AE1BD803,Test,2022-11-16T20:56:09Z,2022-11-16T20:56:09Z,10,10,1.0,,7aa8f3bd-a0a2-4974-81c8-2ac7ddc8e2d8,,
+    ```