@pnp/cli-microsoft365 6.0.0-beta.dc71aa3 → 6.0.0-beta.dc8d53d

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

@@ -0,0 +1,61 @@
+# spo listitem batch add
+
+Creates list items in a batch
+
+## Usage
+
+```sh
+m365 spo listitem batch add [options]
+```
+
+## Options
+
+`-p, --filePath <filePath>`
+: The absolute or relative path to a flat file containing the list items.
+
+`-u, --webUrl <webUrl>`
+: URL of the site.
+
+`-l, --listId [listId]`
+: ID of the list. Specify either `listTitle`, `listId` or `listUrl`, but not multiple.
+
+`-t, --listTitle [listTitle]`
+: Title of the list. Specify either `listTitle`, `listId` or `listUrl`, but not multiple.
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`, but not multiple.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Add a batch of items to a list retrieved by title in a specific site
+
+```sh
+m365 spo listitem batch add --filePath "C:\Path\To\Csv\CsvFile.csv" --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle "Demo List"
+```
+
+Add a batch of items to a list retrieved by Id in a specific site
+
+```sh
+m365 spo listitem batch add --filePath "C:\Path\To\Csv\CsvFile.csv" --webUrl https://contoso.sharepoint.com/sites/project-x --listId fe54c47b-22e4-4cab-8a10-3fc54003fb4c
+```
+
+Add a batch of items to a list defined by server-relative URL in a specific site
+
+```sh
+m365 spo listitem batch add --filePath "C:\Path\To\Csv\CsvFile.csv" --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl "/sites/project-x/lists/Demo List"
+```
+
+## Remarks
+
+A sample CSV can be found below. The first line of the CSV-file should contain the internal column names that you wish to set.
+
+```csv
+ContentType,Title,SingleChoiceField,MultiChoiceField,SingleMetadataField,MultiMetadataField,SinglePeopleField,MultiPeopleField,CustomHyperlink,NumberField
+Item,Title A,Choice 1,Choice 1;#Choice 2,Engineering|4a3cc5f3-a4a6-433e-a07a-746978ff1760;,Engineering|4a3cc5f3-a4a6-433e-a07a-746978ff1760;Finance|f994a4ac-cf34-448e-a22c-2b35fd9bbffa;,[{'Key':'i:0#.f|membership|markh@contoso.com'}],"[{'Key':'i:0#.f|membership|markh@contoso.com'},{'Key':'i:0#.f|membership|adamb@contoso.com'}]","https://bing.com, URL",5
+```
+
+## Response
+
+The command won't return a response on success.

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

@@ -28,6 +28,9 @@ m365 spo listitem get [options]
 `-p, --properties [properties]`
 : Comma-separated list of properties to retrieve. Will retrieve all properties if not specified and json output is requested
 
+`--withPermissions`
+: Set if you want to return associated roles and permissions
+
 --8<-- "docs/cmd/_global.md"
 
 ## Remarks
@@ -36,26 +39,207 @@ If you want to specify a lookup type in the `properties` option, define which co
 
 ## Examples
 
-Get an item with ID _147_ from list with title _Demo List_ in site _https://contoso.sharepoint.com/sites/project-x_
+Get an item with the ID parameter from a given list in a given site
 
 ```sh
 m365 spo listitem get --listTitle "Demo List" --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x
 ```
 
-Get an items _Title_ and _Created_ column with ID _147_ from list with title _Demo List_ in site _https://contoso.sharepoint.com/sites/project-x_
+Get an item columns with the ID parameter from a given list in a given site
 
 ```sh
 m365 spo listitem get --listTitle "Demo List" --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --properties "Title,Created"
 ```
 
-Get an items _Title_, _Created_ column and lookup column _Company_ with ID _147_ from list with title _Demo List_ in site _https://contoso.sharepoint.com/sites/project-x_
+Get an item columns and lookup column with the ID parameter from a given list in a given site
 
 ```sh
 m365 spo listitem get --listTitle "Demo List" --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --properties "Title,Created,Company/Title"
 ```
 
-Get an item with specific properties from a list retrieved by server-relative URL in a specific site
+Get an item with specific properties from a given list based on the server-relative URL in a specific site
 
 ```sh
 m365 spo listitem get --listUrl /sites/project-x/documents --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --properties "Title,Created,Company/Title"
 ```
+
+Get an item with ID parameter from a given list based on the server-relative URL in a specific site with permissions
+
+```sh
+m365 spo listitem get --listTitle "Demo List" --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --withPermissions
+```
+
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "FileSystemObjectType": 0,
+      "Id": 147,
+      "ServerRedirectedEmbedUri": null,
+      "ServerRedirectedEmbedUrl": "",
+      "ContentTypeId": "0x010078BC2C6F12F0DB41BA554210A2BFA81600A320A11ABE6E90468525ECC747660126",
+      "Title": "Demo Item",
+      "Modified": "2022-10-30T10:55:37Z",
+      "Created": "2022-10-30T10:55:22Z",
+      "AuthorId": 10,
+      "EditorId": 10,
+      "OData__UIVersionString": "3.0",
+      "Attachments": false,
+      "GUID": "87f3138d-fac3-4126-97c0-543e55672261",
+      "ComplianceAssetId": null
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    Attachments             : false
+    AuthorId                : 10
+    ComplianceAssetId       : null
+    ContentTypeId           : 0x010078BC2C6F12F0DB41BA554210A2BFA81600A320A11ABE6E90468525ECC747660126
+    Created                 : 2022-10-30T10:55:22Z
+    EditorId                : 10
+    FileSystemObjectType    : 0
+    GUID                    : 87f3138d-fac3-4126-97c0-543e55672261
+    Id                      : 147
+    Modified                : 2022-10-30T10:55:37Z
+    OData__UIVersionString  : 3.0
+    ServerRedirectedEmbedUri: null
+    ServerRedirectedEmbedUrl:
+    Title                   : Demo Item
+    ```
+
+=== "CSV"
+
+    ```csv
+    FileSystemObjectType,Id,ServerRedirectedEmbedUri,ServerRedirectedEmbedUrl,ContentTypeId,Title,Modified,Created,AuthorId,EditorId,OData__UIVersionString,Attachments,GUID,ComplianceAssetId
+    0,147,,,0x010078BC2C6F12F0DB41BA554210A2BFA81600A320A11ABE6E90468525ECC747660126,Demo Item,2022-10-30T10:55:37Z,2022-10-30T10:55:22Z,10,10,3.0,,87f3138d-fac3-4126-97c0-543e55672261,
+    ```
+
+### `withPermissions` response
+
+When we make use of the option `withPermissions` the response will differ. 
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "FileSystemObjectType": 0,
+      "Id": 147,
+      "ServerRedirectedEmbedUri": null,
+      "ServerRedirectedEmbedUrl": "",
+      "ContentTypeId": "0x010078BC2C6F12F0DB41BA554210A2BFA81600A320A11ABE6E90468525ECC747660126",
+      "Title": "Demo Item",
+      "Modified": "2022-10-30T10:55:37Z",
+      "Created": "2022-10-30T10:55:22Z",
+      "AuthorId": 10,
+      "EditorId": 10,
+      "OData__UIVersionString": "3.0",
+      "Attachments": false,
+      "GUID": "87f3138d-fac3-4126-97c0-543e55672261",
+      "ComplianceAssetId": null,
+      "RoleAssignments": [
+        {
+          "Member": {
+            "Id": 3,
+            "IsHiddenInUI": false,
+            "LoginName": "Communication site Owners",
+            "Title": "Communication site Owners",
+            "PrincipalType": 8,
+            "AllowMembersEditMembership": false,
+            "AllowRequestToJoinLeave": false,
+            "AutoAcceptRequestToJoinLeave": false,
+            "Description": null,
+            "OnlyAllowMembersViewMembership": false,
+            "OwnerTitle": "Communication site Owners",
+            "RequestToJoinLeaveEmailSetting": ""
+          },
+          "RoleDefinitionBindings": [
+            {
+              "BasePermissions": {
+                "High": "2147483647",
+                "Low": "4294967295"
+              },
+              "Description": "Has full control.",
+              "Hidden": false,
+              "Id": 1073741829,
+              "Name": "Full Control",
+              "Order": 1,
+              "RoleTypeKind": 5,
+              "BasePermissionsValue": [
+                "ViewListItems",
+                "AddListItems",
+                "EditListItems",
+                "DeleteListItems",
+                "ApproveItems",
+                "OpenItems",
+                "ViewVersions",
+                "DeleteVersions",
+                "CancelCheckout",
+                "ManagePersonalViews",
+                "ManageLists",
+                "ViewFormPages",
+                "AnonymousSearchAccessList",
+                "Open",
+                "ViewPages",
+                "AddAndCustomizePages",
+                "ApplyThemeAndBorder",
+                "ApplyStyleSheets",
+                "ViewUsageData",
+                "CreateSSCSite",
+                "ManageSubwebs",
+                "CreateGroups",
+                "ManagePermissions",
+                "BrowseDirectories",
+                "BrowseUserInfo",
+                "AddDelPrivateWebParts",
+                "UpdatePersonalWebParts",
+                "ManageWeb",
+                "AnonymousSearchAccessWebLists",
+                "UseClientIntegration",
+                "UseRemoteAPIs",
+                "ManageAlerts",
+                "CreateAlerts",
+                "EditMyUserInfo",
+                "EnumeratePermissions"
+              ],
+              "RoleTypeKindValue": "Administrator"
+            }
+          ],
+          "PrincipalId": 3
+        }
+      ]
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    Attachments             : false
+    AuthorId                : 10
+    ComplianceAssetId       : null
+    ContentTypeId           : 0x010078BC2C6F12F0DB41BA554210A2BFA81600A320A11ABE6E90468525ECC747660126
+    Created                 : 2022-10-30T10:55:22Z
+    EditorId                : 10
+    FileSystemObjectType    : 0
+    GUID                    : 87f3138d-fac3-4126-97c0-543e55672261
+    Id                      : 147
+    Modified                : 2022-10-30T10:55:37Z
+    OData__UIVersionString  : 3.0
+    RoleAssignments         : [{"Member":{"Id":3,"IsHiddenInUI":false,"LoginName":"Communication site Owners","Title":"Communication site Owners","PrincipalType":8,"AllowMembersEditMembership":false,"AllowRequestToJoinLeave":false,"AutoAcceptRequestToJoinLeave":false,"Description":null,"OnlyAllowMembersViewMembership":false,"OwnerTitle":"Communication site Owners","RequestToJoinLeaveEmailSetting":""},"RoleDefinitionBindings":[{"BasePermissions":{"High":"2147483647","Low":"4294967295"},"Description":"Has full control.","Hidden":false,"Id":1073741829,"Name":"Full Control","Order":1,"RoleTypeKind":5,"BasePermissionsValue":["ViewListItems","AddListItems","EditListItems","DeleteListItems","ApproveItems","OpenItems","ViewVersions","DeleteVersions","CancelCheckout","ManagePersonalViews","ManageLists","ViewFormPages","AnonymousSearchAccessList","Open","ViewPages","AddAndCustomizePages","ApplyThemeAndBorder","ApplyStyleSheets","ViewUsageData","CreateSSCSite","ManageSubwebs","CreateGroups","ManagePermissions","BrowseDirectories","BrowseUserInfo","AddDelPrivateWebParts","UpdatePersonalWebParts","ManageWeb","AnonymousSearchAccessWebLists","UseClientIntegration","UseRemoteAPIs","ManageAlerts","CreateAlerts","EditMyUserInfo","EnumeratePermissions"],"RoleTypeKindValue":"Administrator"}],"PrincipalId":3}]
+    ServerRedirectedEmbedUri: null
+    ServerRedirectedEmbedUrl:
+    Title                   : Demo Item
+    ```
+
+=== "CSV"
+
+    ```csv
+    FileSystemObjectType,Id,ServerRedirectedEmbedUri,ServerRedirectedEmbedUrl,ContentTypeId,Title,Modified,Created,AuthorId,EditorId,OData__UIVersionString,Attachments,GUID,ComplianceAssetId,RoleAssignments
+    0,147,,,0x010078BC2C6F12F0DB41BA554210A2BFA81600A320A11ABE6E90468525ECC747660126,Demo Item,2022-10-30T10:55:37Z,2022-10-30T10:55:22Z,10,10,3.0,,87f3138d-fac3-4126-97c0-543e55672261,"[{""Member"":{""Id"":3,""IsHiddenInUI"":false,""LoginName"":""Communication site Owners"",""Title"":""Communication site Owners"",""PrincipalType"":8,""AllowMembersEditMembership"":false,""AllowRequestToJoinLeave"":false,""AutoAcceptRequestToJoinLeave"":false,""Description"":null,""OnlyAllowMembersViewMembership"":false,""OwnerTitle"":""Communication site Owners"",""RequestToJoinLeaveEmailSetting"":""""},""RoleDefinitionBindings"":[{""BasePermissions"":{""High"":""2147483647"",""Low"":""4294967295""},""Description"":""Has full control."",""Hidden"":false,""Id"":1073741829,""Name"":""Full Control"",""Order"":1,""RoleTypeKind"":5,""BasePermissionsValue"":[""ViewListItems"",""AddListItems"",""EditListItems"",""DeleteListItems"",""ApproveItems"",""OpenItems"",""ViewVersions"",""DeleteVersions"",""CancelCheckout"",""ManagePersonalViews"",""ManageLists"",""ViewFormPages"",""AnonymousSearchAccessList"",""Open"",""ViewPages"",""AddAndCustomizePages"",""ApplyThemeAndBorder"",""ApplyStyleSheets"",""ViewUsageData"",""CreateSSCSite"",""ManageSubwebs"",""CreateGroups"",""ManagePermissions"",""BrowseDirectories"",""BrowseUserInfo"",""AddDelPrivateWebParts"",""UpdatePersonalWebParts"",""ManageWeb"",""AnonymousSearchAccessWebLists"",""UseClientIntegration"",""UseRemoteAPIs"",""ManageAlerts"",""CreateAlerts"",""EditMyUserInfo"",""EnumeratePermissions""],""RoleTypeKindValue"":""Administrator""}],""PrincipalId"":3}]"
+    ```

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

@@ -47,3 +47,22 @@ Check whether a document with a specific id in a list retrieved by server-relati
 m365 spo listitem isrecord --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl /sites/project-x/documents --id 1
 ```
 
+## Response
+
+=== "JSON"
+
+    ```json
+    false
+    ```
+
+=== "Text"
+
+    ```text
+    false
+    ```
+
+=== "CSV"
+
+    ```csv
+    false
+    ```

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

@@ -94,3 +94,44 @@ Get all items from a list by server-relative URL
 ```sh
 m365 spo listitem list --listUrl /sites/project-x/documents --webUrl https://contoso.sharepoint.com/sites/project-x
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "FileSystemObjectType": 0,
+        "Id": 236,
+        "ServerRedirectedEmbedUri": null,
+        "ServerRedirectedEmbedUrl": "",
+        "ContentTypeId": "0x01003CDBEB7138618C47A98D56499135D6EE0004C0F5794DEBCC4BAC981AC4AE1BD803",
+        "Title": "Test",
+        "Modified": "2022-11-16T21:00:03Z",
+        "Created": "2022-11-16T20:56:31Z",
+        "AuthorId": 10,
+        "EditorId": 10,
+        "OData__UIVersionString": "6.0",
+        "Attachments": true,
+        "GUID": "cac57513-e870-4e7a-9f23-f4ea10e14f4e",
+        "ComplianceAssetId": null,
+        "OData__vti_ItemDeclaredRecord": null
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    Id   Title
+    ---  -----
+    236  Test
+    ```
+
+=== "CSV"
+
+    ```csv
+    FileSystemObjectType,Id,ServerRedirectedEmbedUri,ServerRedirectedEmbedUrl,ContentTypeId,Title,Modified,Created,AuthorId,EditorId,OData__UIVersionString,Attachments,GUID,ComplianceAssetId,OData__vti_ItemDeclaredRecord
+    0,236,,,0x01003CDBEB7138618C47A98D56499135D6EE0004C0F5794DEBCC4BAC981AC4AE1BD803,Test,2022-11-16T21:00:03Z,2022-11-16T20:56:31Z,10,10,6.0,1,cac57513-e870-4e7a-9f23-f4ea10e14f4e,,
+    ```

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

@@ -55,3 +55,32 @@ Declare a document with a specific id as a record with a record declaration date
 ```sh
 m365 spo listitem record declare --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl '/sites/project-x/Lists/Demo List' --listItemId 1 --date 2013-09-03
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "SchemaVersion": "15.0.0.0",
+      "LibraryVersion": "16.0.23102.12004",
+      "ErrorInfo": null,
+      "TraceCorrelationId": "064779a0-d05b-5000-843d-c36803e58f12"
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    ErrorInfo         : null
+    LibraryVersion    : 16.0.23102.12004
+    SchemaVersion     : 15.0.0.0
+    TraceCorrelationId: 0a4779a0-c0ca-5000-d29d-4321a1739425
+    ```
+
+=== "CSV"
+
+    ```csv
+    SchemaVersion,LibraryVersion,ErrorInfo,TraceCorrelationId
+    15.0.0.0,16.0.23102.12004,,0d4779a0-609c-5000-843d-c98e4764c937
+    ```

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

@@ -46,3 +46,7 @@ Undeclare a list item with a specific id as a record from a list retrieved by se
 ```sh
 m365 spo listitem record undeclare --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl '/sites/project-x/Lists/Lists 1' --id 1
 ```
+
+## Response
+
+The command won't return a response on success.

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

@@ -52,3 +52,7 @@ Remove the list item with a specific ID from a list retrieved by server-relative
 ```sh
 m365 spo listitem remove --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl /sites/project-x/lists/TestList --id 1
 ```
+
+## Response
+
+The command won't return a response on success.

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

@@ -78,4 +78,8 @@ Add role assignment to specified listitem in specified list located in specified
 
 ```sh
 m365 spo listitem roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --listItemId 1 --principalId 11 --roleDefinitionName "Full Control"
-```
+```
+
+## Response
+
+The command won't return a response on success.

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

@@ -65,3 +65,7 @@ Remove roleassignment from listitem getting list by url based on principal Id wi
 ```sh
 m365 spo listitem roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --listUrl '/sites/contoso-sales/lists/Events' --listItemId 1 --principalId 2 --confirm
 ```
+
+## Response
+
+The command won't return a response on success.

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

@@ -67,4 +67,8 @@ Break inheritance of list item _1_ in list with ID _202b8199-b9de-43fd-9737-7f21
 
 ```sh
 m365 spo listitem roleinheritance break --webUrl https://contoso.sharepoint.com/sites/project-x --listId 202b8199-b9de-43fd-9737-7f213f51c991 --listItemId 1 --clearExistingPermissions --confirm
-```
+```
+
+## Response
+
+The command won't return a response on success.

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

@@ -49,3 +49,7 @@ Restore role inheritance of a list item with a specific id in a list retrieved b
 ```sh
 m365 spo listitem roleinheritance reset --webUrl https://contoso.sharepoint.com/sites/project-x --listItemId 8 --listUrl /sites/project-x/lists/test --confirm
 ```
+
+## Response
+
+The command won't return a response on success.

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

@@ -70,3 +70,62 @@ Update the field _Title_ and _CustomHyperlink_ of an item with a specific id in
 ```sh
 m365 spo listitem set --listUrl '/sites/project-x/lists/Demo List' --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --Title "Demo Hyperlink Field" --CustomHyperlink "https://www.bing.com, Bing"
 ```
+
+Update an item with a specific Title and multi-choice value
+
+```sh
+m365 spo listitem set --listTitle "Demo List" --id 147 --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": 236,
+      "ServerRedirectedEmbedUri": null,
+      "ServerRedirectedEmbedUrl": "",
+      "ID": 236,
+      "ContentTypeId": "0x01003CDBEB7138618C47A98D56499135D6EE0004C0F5794DEBCC4BAC981AC4AE1BD803",
+      "Title": "Updated Title",
+      "Modified": "2022-11-16T21:10:06Z",
+      "Created": "2022-11-16T20:56:31Z",
+      "AuthorId": 10,
+      "EditorId": 10,
+      "OData__UIVersionString": "7.0",
+      "Attachments": true,
+      "GUID": "cac57513-e870-4e7a-9f23-f4ea10e14f4e",
+      "ComplianceAssetId": null,
+      "OData__vti_ItemDeclaredRecord": null
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    Attachments                  : true
+    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-16T21:10:37Z
+    OData__UIVersionString       : 8.0
+    OData__vti_ItemDeclaredRecord: null
+    ServerRedirectedEmbedUri     : null
+    ServerRedirectedEmbedUrl     :
+    Title                        : Updated Title
+    ```
+
+=== "CSV"
+
+    ```csv
+    FileSystemObjectType,Id,ServerRedirectedEmbedUri,ServerRedirectedEmbedUrl,ID,ContentTypeId,Title,Modified,Created,AuthorId,EditorId,OData__UIVersionString,Attachments,GUID,ComplianceAssetId,OData__vti_ItemDeclaredRecord
+    0,236,,,236,0x01003CDBEB7138618C47A98D56499135D6EE0004C0F5794DEBCC4BAC981AC4AE1BD803,Updated Title,2022-11-16T21:10:55Z,2022-11-16T20:56:31Z,10,10,9.0,1,cac57513-e870-4e7a-9f23-f4ea10e14f4e,,
+    ```

package/docs/docs/cmd/spo/mail/mail-send.md

@@ -59,3 +59,7 @@ Send an e-mail to _user@contoso.com_ with additional headers
 ```sh
 m365 spo mail send --webUrl https://contoso.sharepoint.com/sites/project-x --to "user@contoso.com" --subject "Email sent via CLI for Microsoft 365" --body "<h1>CLI for Microsoft 365</h1>Email sent via <b>command</b>." --additionalHeaders "'{\"X-MC-Tags\":\"CLI for Microsoft 365\"}'"
 ```
+
+## Response
+
+The command won't return a response on success.

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

@@ -49,3 +49,42 @@ Add a navigation node below an existing node
 ```sh
 m365 spo navigation node add --webUrl https://contoso.sharepoint.com/sites/team-a --parentNodeId 2010 --title About --url /sites/team-s/sitepages/about.aspx
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "AudienceIds": null,
+      "CurrentLCID": 1033,
+      "Id": 2030,
+      "IsDocLib": true,
+      "IsExternal": true,
+      "IsVisible": true,
+      "ListTemplateType": 0,
+      "Title": "Navigation Link",
+      "Url": "https://contoso.sharepoint.com"
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    AudienceIds     : null
+    CurrentLCID     : 1033
+    Id              : 2031
+    IsDocLib        : true
+    IsExternal      : true
+    IsVisible       : true
+    ListTemplateType: 0
+    Title           : Navigation Link
+    Url             : https://contoso.sharepoint.com
+    ```
+
+=== "CSV"
+
+    ```csv
+    AudienceIds,CurrentLCID,Id,IsDocLib,IsExternal,IsVisible,ListTemplateType,Title,Url
+    ,1033,2032,1,1,1,0,Navigation Link,https://contoso.sharepoint.com
+    ```

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

@@ -31,3 +31,32 @@ Retrieve nodes from the quick launch
 ```sh
 m365 spo navigation node list --webUrl https://contoso.sharepoint.com/sites/team-a --location QuickLaunch
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "Id": 2032,
+        "Title": "Navigation Link",
+        "Url": "https://contoso.sharepoint.com"
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    Id    Title            Url
+    ----  ---------------  ------------------------------
+    2032  Navigation Link  https://contoso.sharepoint.com
+    ```
+
+=== "CSV"
+
+    ```csv
+    Id,Title,Url
+    2032,Navigation Link,https://contoso.sharepoint.com
+    ```

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

@@ -37,3 +37,7 @@ Remove a node from the quick launch without prompting for confirmation
 ```sh
 m365 spo navigation node remove --webUrl https://contoso.sharepoint.com/sites/team-a --location QuickLaunch --id 2003 --confirm
 ```
+
+## Response
+
+The command won't return a response on success.

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

@@ -20,10 +20,10 @@ m365 spo page add [options]
 : Title of the page to create. If not specified, will use the page name as its title
 
 `-l, --layoutType [layoutType]`
-: Layout of the page. Allowed values `Article`, `Home`, `SingleWebPartAppPage`, `RepostPage`,`HeaderlessSearchResults`, `Spaces`, `Topic`. Default `Article`
+: Layout of the page. Allowed values `Article`, `Home`, `SingleWebPartAppPage`, `RepostPage`, `HeaderlessSearchResults`, `Spaces`, `Topic`. Default `Article`
 
 `-p, --promoteAs [promoteAs]`
-: Create the page for a specific purpose. Allowed values `HomePage`, `NewsPage`
+: Create the page for a specific purpose. Allowed values `HomePage`, `NewsPage`, `Template`
 
 `--commentsEnabled`
 : Set to enable comments on the page

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

@@ -17,10 +17,13 @@ m365 spo page set [options]
 : URL of the site where the page to update is located
 
 `-l, --layoutType [layoutType]`
-: Layout of the page. Allowed values `Article`, `Home`, `SingleWebPartAppPage`, `RepostPage`,`HeaderlessSearchResults`, `Spaces`, `Topic`
+: Layout of the page. Allowed values `Article`, `Home`, `SingleWebPartAppPage`, `RepostPage`, `HeaderlessSearchResults`, `Spaces`, `Topic`
 
 `-p, --promoteAs [promoteAs]`
-: Update the page purpose. Allowed values `HomePage`, `NewsPage`
+: Update the page purpose. Allowed values `HomePage`, `NewsPage`, `Template`
+
+`--demoteFrom [demoteFrom]`
+: Update the page purpose back to a regular article. Allowed values `NewsPage`
 
 `--commentsEnabled [commentsEnabled]`
 : Set to `true`, to enable comments on the page. Allowed values `true`, `false`
@@ -65,6 +68,12 @@ Promote the existing article page as a template
 m365 spo page set --name page.aspx --webUrl https://contoso.sharepoint.com/sites/a-team --promoteAs Template
 ```
 
+Demote the existing newspage
+
+```sh
+m365 spo page set --name page.aspx --webUrl https://contoso.sharepoint.com/sites/a-team --demoteFrom NewsPage
+```
+
 Change the page's layout to Home and set it as the site's home page
 
 ```sh
@@ -88,3 +97,7 @@ Set page description
 ```sh
 m365 spo page set --name page.aspx --webUrl https://contoso.sharepoint.com/sites/a-team --description "Description to add for the page"
 ```
+
+## Response
+
+The command won't return a response on success.