@pnp/cli-microsoft365 7.0.0-beta.093ef31 → 7.0.0-beta.18ce559

package/docs/docs/cmd/spo/group/group-member-add.mdx

@@ -16,72 +16,72 @@ m365 spo group member add [options]
 
 ```md definition-list
 `-u, --webUrl <webUrl>`
-: URL of the site where the SharePoint group is available
+: URL of the site where the SharePoint group is available.
 
 `--groupId [groupId]`
-: Id of the SharePoint Group to which the user needs to be added, specify either `groupId` or `groupName`
+: Id of the SharePoint Group to which the user needs to be added, specify either `groupId` or `groupName`.
 
 `--groupName [groupName]`
-: Name of the SharePoint Group to which the user needs to be added, specify either `groupId` or `groupName`
+: Name of the SharePoint Group to which the user needs to be added, specify either `groupId` or `groupName`.
 
-`--userName [userName]`
-: User's UPN (user principal name, eg. megan.bowen@contoso.com). If multiple users need to be added, they have to be comma-separated (e.g. megan.bowen@contoso.com,alex.wilber@contoso.com). Specify either `userId`, `userName`, `email`, `aadGroupId` or `aadGroupName`
+`--userNames [userNames]`
+: User's UPN (user principal name, eg. megan.bowen@contoso.com). If multiple users need to be added, they have to be comma-separated (e.g. megan.bowen@contoso.com,alex.wilber@contoso.com). Specify either `userIds`, `userNames`, `emails`, `aadGroupIds` or `aadGroupNames`.
 
-`--email [email]`
-: User's email (eg. megan.bowen@contoso.com). If multiple users need to be added, they have to be comma-separated (e.g. megan.bowen@contoso.com,alex.wilber@contoso.com). Specify either `userId`, `userName`, `email`, `aadGroupId` or `aadGroupName`
+`--emails [emails]`
+: User's email (eg. megan.bowen@contoso.com). If multiple users need to be added, they have to be comma-separated (e.g. megan.bowen@contoso.com,alex.wilber@contoso.com). Specify either `userIds`, `userNames`, `emails`, `aadGroupIds` or `aadGroupNames`.
 
-`--userId [userId]`
-: The user Id of the user to add as a member. (Id of the site user, for example: 14) If multiple users need to be added, the Ids have to be comma-separated. Specify either `userId`, `userName`, `email`, `aadGroupId` or `aadGroupName`
+`--userIds [userIds]`
+: The user Id of the user to add as a member. (Id of the site user, for example: 14) If multiple users need to be added, the Ids have to be comma-separated. Specify either `userIds`, `userNames`, `emails`, `aadGroupIds` or `aadGroupNames`.
 
-`--aadGroupId [aadGroupId]`
-: The object Id of the Azure AD group to add as a member. If multiple groups need to be added, the Ids have to be comma-separated. Specify either `userId`, `userName`, `email`, `aadGroupId` or `aadGroupName`
+`--aadGroupIds [aadGroupIds]`
+: The object Id of the Azure AD group to add as a member. If multiple groups need to be added, the Ids have to be comma-separated. Specify either `userIds`, `userNames`, `emails`, `aadGroupIds` or `aadGroupNames`.
 
-`--aadGroupName [aadGroupName]`
-: The name of the Azure AD group to add as a member. Specify either `userId`, `userName`, `email`, `aadGroupId` or `aadGroupName`
+`--aadGroupNames [aadGroupNames]`
+: The name of the Azure AD group to add as a member. If multiple groups need to be added, they have to be comma-separated. Specify either `userIds`, `userNames`, `emails`, `aadGroupIds` or `aadGroupNames`.
 ```
 
 <Global />
 
 ## Remarks
 
-For the `userId`, `userName`, `email`, `aadGroupId` or `aadGroupName` options you can specify multiple values by separating them with a comma. If one of the specified entries is not valid, the command will fail with an error message showing the list of invalid values.
+For the `userIds`, `userNames`, `emails`, `aadGroupIds` or `aadGroupNames` options you can specify multiple values by separating them with a comma. If one of the specified entries is not valid, the command will fail with an error message showing the list of invalid values.
 
 ## Examples
 
-Add a user with the userName parameter to a SharePoint group with the groupId parameter
+Add a user with the userNames parameter to a SharePoint group with the groupId parameter
 
 ```sh
-m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --groupId 5 --userName "Alex.Wilber@contoso.com"
+m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --groupId 5 --userNames "Alex.Wilber@contoso.com"
 ```
 
-Add multiple users with the userName parameter to a SharePoint group with the groupId parameter
+Add multiple users with the userNames parameter to a SharePoint group with the groupId parameter
 
 ```sh
-m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --groupId 5 --userName "Alex.Wilber@contoso.com, Adele.Vance@contoso.com"
+m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --groupId 5 --userNames "Alex.Wilber@contoso.com, Adele.Vance@contoso.com"
 ```
 
-Add a user with the email parameter to a SharePoint group with the groupName parameter
+Add a user with the emails parameter to a SharePoint group with the groupName parameter
 
 ```sh
-m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --groupName "Contoso Site Owners" --email "Alex.Wilber@contoso.com"
+m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --groupName "Contoso Site Owners" --emails "Alex.Wilber@contoso.com"
 ```
 
-Add multiple users with the email parameter to a SharePoint group with the groupName parameter
+Add multiple users with the emails parameter to a SharePoint group with the groupName parameter
 
 ```sh
-m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --groupName "Contoso Site Owners" --email "Alex.Wilber@contoso.com, Adele.Vance@contoso.com"
+m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --groupName "Contoso Site Owners" --emails "Alex.Wilber@contoso.com, Adele.Vance@contoso.com"
 ```
 
-Add a user with the userId parameter to a SharePoint group with the groupId parameter
+Add a user with the userIds parameter to a SharePoint group with the groupId parameter
 
 ```sh
-m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --groupId 5 --userId 5
+m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --groupId 5 --userIds 5
 ```
 
-Add multiple users with the userId parameter to a SharePoint group with the groupId parameter
+Add multiple users with the userIds parameter to a SharePoint group with the groupId parameter
 
 ```sh
-m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --groupId 5 --userId "5,12"
+m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --groupId 5 --userIds "5,12"
 ```
 
 Add multiple users with the aadUserId parameter to a SharePoint group with the groupId parameter
@@ -140,7 +140,7 @@ m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --
   <TabItem value="Markdown">
 
   ```md
-  # spo group member add --webUrl "https://contoso.sharepoint.com" --groupId "5" --aadGroupId "f2fb2f10-cfd2-4054-8ffd-64533657a5ab"
+  # spo group member add --webUrl "https://contoso.sharepoint.com" --groupId "5" --aadGroupIds "f2fb2f10-cfd2-4054-8ffd-64533657a5ab"
 
   Date: 13/2/2023
 

package/docs/docs/cmd/spo/list/list-contenttype-remove.mdx

@@ -51,7 +51,7 @@ m365 spo list contenttype remove --webUrl https://contoso.sharepoint.com/sites/p
 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 --force
+m365 spo list contenttype remove --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl 'sites/project-x/Documents' --id 0x010109010053EE7AEB1FC54A41B4D9F66ADBDC312A --force
 ```
 
 ## Response

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

@@ -111,7 +111,6 @@ m365 spo listitem add --listTitle "Demo List" --webUrl https://contoso.sharepoin
     "Id": 234,
     "ServerRedirectedEmbedUri": null,
     "ServerRedirectedEmbedUrl": "",
-    "ID": 234,
     "ContentTypeId": "0x01003CDBEB7138618C47A98D56499135D6EE0004C0F5794DEBCC4BAC981AC4AE1BD803",
     "Title": "Test",
     "Modified": "2022-11-16T20:55:45Z",
@@ -138,7 +137,6 @@ m365 spo listitem add --listTitle "Demo List" --webUrl https://contoso.sharepoin
   EditorId                     : 10
   FileSystemObjectType         : 0
   GUID                         : cac57513-e870-4e7a-9f23-f4ea10e14f4e
-  ID                           : 236
   Id                           : 236
   Modified                     : 2022-11-16T20:56:31Z
   OData__UIVersionString       : 1.0
@@ -152,8 +150,8 @@ m365 spo listitem add --listTitle "Demo List" --webUrl https://contoso.sharepoin
   <TabItem value="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,,
+  FileSystemObjectType,Id,ServerRedirectedEmbedUri,ServerRedirectedEmbedUrl,ContentTypeId,Title,Modified,Created,AuthorId,EditorId,OData__UIVersionString,Attachments,GUID,ComplianceAssetId,OData__vti_ItemDeclaredRecord
+  0,235,,,0x01003CDBEB7138618C47A98D56499135D6EE0004C0F5794DEBCC4BAC981AC4AE1BD803,Test,2022-11-16T20:56:09Z,2022-11-16T20:56:09Z,10,10,1.0,,7aa8f3bd-a0a2-4974-81c8-2ac7ddc8e2d8,,
   ```
 
   </TabItem>
@@ -176,7 +174,6 @@ m365 spo listitem add --listTitle "Demo List" --webUrl https://contoso.sharepoin
   Title | Test
   ComplianceAssetId | null
   FieldName1 | null
-  ID | 234
   Modified | 2022-11-16T20:55:45Z
   Created | 2022-11-16T20:55:45Z
   AuthorId | 10

package/docs/docs/cmd/spo/listitem/listitem-attachment-add.mdx

@@ -0,0 +1,110 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# spo listitem attachment add
+
+Adds an attachment to a list item
+
+## Usage
+
+```sh
+m365 spo listitem attachment add [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: URL of the site where the list item is located.
+
+`--listId [listId]`
+: ID of the list. Specify either `listTitle`, `listId` or `listUrl`.
+
+`--listTitle [listTitle]`
+: 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`.
+
+`--listItemId <listItemId>`
+: The ID of the list item.
+
+`-p, --filePath <filePath>`
+: Local path to the file that will be added as an attachment to the list item.
+
+`-n, --fileName [fileName]`
+: Name for the file. If no name is provided, the name from `filePath` will be utilized.
+```
+
+<Global />
+
+## Examples
+
+Add a new attachment to a list item from a local file by using list title
+
+```sh
+m365 spo listitem attachment add --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle "DemoList" --listItemId 147 --filePath "C:/Reports/File1.jpg"
+```
+
+Add a new attachment to a list item from a local file by using list URL with a different filename
+
+```sh
+m365 spo listitem attachment add --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl "/sites/project-x/Lists/DemoList" --listItemId 147 --filePath "C:/Reports/File1.jpg" --fileName "File2"
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "FileName": "File1.jpg",
+      "FileNameAsPath": {
+        "DecodedUrl": "File1.jpg"
+      },
+      "ServerRelativePath": {
+        "DecodedUrl": "/Lists/DemoList/Attachments/147/File1.jpg"
+      },
+      "ServerRelativeUrl": "/Lists/Test/Attachments/147/File1.jpg"
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  FileName          : File1.jpg
+  FileNameAsPath    : {"DecodedUrl":"File1jpg"}
+  ServerRelativePath: {"DecodedUrl":"/Lists/DemoList/Attachments/743/File1.jpg"}
+  ServerRelativeUrl : /Lists/DemoList/Attachments/147/File1.jpg
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  FileName,ServerRelativeUrl
+  File1.jpg,/Lists/DemoList/Attachments/147/File1.jpg
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # spo listitem attachment add --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle "DemoList" --listItemId 147 --filePath "C:/Reports/File1.jpg"
+
+  Date: 25/07/2023
+
+  Property | Value
+  ---------|-------
+  FileName | File1.jpg
+  ServerRelativeUrl | /Lists/DemoList/Attachments/147/File1.jpg
+  ```
+
+  </TabItem>
+</Tabs>
+

package/docs/docs/cmd/spo/listitem/listitem-attachment-get.mdx

@@ -0,0 +1,104 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# spo listitem attachment get
+
+Gets an attachment from a list item
+
+## Usage
+
+```sh
+m365 spo listitem attachment get [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: URL of the site where the list item is located.
+
+`--listId [listId]`
+: ID of the list. Specify either `listTitle`, `listId` or `listUrl`.
+
+`--listTitle [listTitle]`
+: 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`.
+
+`--listItemId <listItemId>`
+: The ID of the list item.
+
+`-n, --fileName <fileName>`
+: Name of the file to get.
+```
+
+<Global />
+
+## Examples
+
+Get an attachment from a list item by using list title.
+
+```sh
+m365 spo listitem attachment get --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle "Demo List" --listItemId 147 --fileName "File1.jpg"
+```
+
+Get an attachment from a list item by using list URL.
+
+```sh
+m365 spo listitem attachment get --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl "/sites/project-x/Lists/DemoList" --listItemId 147 --fileName "File1.jpg"
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "FileName": "File1.jpg",
+    "FileNameAsPath": {
+      "DecodedUrl": "File1.jpg"
+    },
+    "ServerRelativePath": {
+      "DecodedUrl": "/sites/project-x/Lists/DemoListAttachments/147/File1.jpg"
+    },
+    "ServerRelativeUrl": "/sites/project-x/Lists/DemoListAttachments/147/File1.jpg"
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  FileName          : File1.jpg
+  FileNameAsPath    : {"DecodedUrl":"File1.jpg"}
+  ServerRelativePath: {"DecodedUrl":"/sites/project-x/Lists/DemoListAttachments/147/File1.jpg"}
+  ServerRelativeUrl : /sites/project-x/Lists/DemoListAttachments/147/File1.jpg
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  FileName,ServerRelativeUrl
+  File1.jpg,/sites/project-x/Lists/DemoListAttachments/147/File1.jpg
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # spo listitem attachment get --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "PnP PowerShell List" --listItemId "1" --fileName "File1.jpg"
+
+  Date: 7/20/2023
+
+  Property | Value
+  ---------|-------
+  FileName | File1.jpg
+  ServerRelativeUrl | /sites/project-x/Lists/DemoListAttachments/147/File1.jpg
+  ```
+
+  </TabItem>
+</Tabs>

package/docs/docs/cmd/spo/listitem/listitem-attachment-remove.mdx

@@ -0,0 +1,58 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# spo listitem attachment remove
+
+Removes an attachment from a list item
+
+## Usage
+
+```sh
+m365 spo listitem attachment remove [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: URL of the site where the list item is located.
+
+`--listId [listId]`
+: ID of the list. Specify either `listTitle`, `listId` or `listUrl`.
+
+`--listTitle [listTitle]`
+: 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`.
+
+`--listItemId <listItemId>`
+: The ID of the list item.
+
+`-n, --fileName <fileName>`
+: Name of the file to remove.
+
+`-f, --force`
+: Don't prompt for confirmation.
+```
+
+<Global />
+
+## Examples
+
+Remove an attachment from a list item using list tile.
+
+```sh
+m365 spo listitem attachment remove --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle "Demo List" --listItemId 147 --fileName "File1.jpg"
+```
+
+Remove an attachment from a list item using list URL.
+
+```sh
+m365 spo listitem attachment remove --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl "/sites/project-x/Lists/DemoList" --listItemId 147 --fileName "File1.jpg"
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/spo/listitem/listitem-attachment-set.mdx

@@ -0,0 +1,58 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# spo listitem attachment set
+
+Updates an attachment from a list item
+
+## Usage
+
+```sh
+m365 spo listitem attachment set [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: URL of the site where the list item is located.
+
+`--listId [listId]`
+: ID of the list. Specify either `listTitle`, `listId` or `listUrl`.
+
+`--listTitle [listTitle]`
+: 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`.
+
+`--listItemId <listItemId>`
+: The ID of the list item.
+
+`-p, --filePath <filePath>`
+: Local path used for updating the attachment contents.
+
+`-n, --fileName <fileName>`
+: Name of the file to update.
+```
+
+<Global />
+
+## Examples
+
+Update an attachment from a list item by using list title
+
+```sh
+m365 spo listitem attachment set --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle "Demo List" --listItemId 147 --fileName "File1.jpg" --filePath "C:/Reports/File2.jpg"
+```
+
+Update an attachment from a list item by using list URL
+
+```sh
+m365 spo listitem attachment set --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl "/sites/project-x/Lists/DemoList" --listItemId 147 --fileName "File1.jpg" --filePath "C:/Reports/File2.jpg"
+```
+
+## Response
+
+The command won't return a response on success.

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

@@ -108,7 +108,6 @@ m365 spo listitem set --listTitle "Demo List" --id 147 --webUrl https://contoso.
     "Id": 236,
     "ServerRedirectedEmbedUri": null,
     "ServerRedirectedEmbedUrl": "",
-    "ID": 236,
     "ContentTypeId": "0x01003CDBEB7138618C47A98D56499135D6EE0004C0F5794DEBCC4BAC981AC4AE1BD803",
     "Title": "Updated Title",
     "Modified": "2022-11-16T21:10:06Z",
@@ -135,7 +134,6 @@ m365 spo listitem set --listTitle "Demo List" --id 147 --webUrl https://contoso.
   EditorId                     : 10
   FileSystemObjectType         : 0
   GUID                         : cac57513-e870-4e7a-9f23-f4ea10e14f4e
-  ID                           : 236
   Id                           : 236
   Modified                     : 2022-11-16T21:10:37Z
   OData__UIVersionString       : 8.0
@@ -149,8 +147,8 @@ m365 spo listitem set --listTitle "Demo List" --id 147 --webUrl https://contoso.
   <TabItem value="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,,
+  FileSystemObjectType,Id,ServerRedirectedEmbedUri,ServerRedirectedEmbedUrl,ContentTypeId,Title,Modified,Created,AuthorId,EditorId,OData__UIVersionString,Attachments,GUID,ComplianceAssetId,OData__vti_ItemDeclaredRecord
+  0,236,,,0x01003CDBEB7138618C47A98D56499135D6EE0004C0F5794DEBCC4BAC981AC4AE1BD803,Updated Title,2022-11-16T21:10:55Z,2022-11-16T20:56:31Z,10,10,9.0,1,cac57513-e870-4e7a-9f23-f4ea10e14f4e,,
   ```
 
   </TabItem>
@@ -173,7 +171,6 @@ m365 spo listitem set --listTitle "Demo List" --id 147 --webUrl https://contoso.
   Title | Updated Title
   ComplianceAssetId | null
   FieldName1 | null
-  ID | 236
   Modified | 2022-11-16T21:10:06Z
   Created | 2022-11-16T20:56:31Z
   AuthorId | 10

package/docs/docs/cmd/spo/page/page-get.mdx

@@ -85,7 +85,6 @@ m365 spo page get --webUrl https://contoso.sharepoint.com/sites/team-a --name ho
       "OData__OriginalSourceItemId": null,
       "OData__SPCallToAction": null,
       "OData__ModerationStatus": 3,
-      "ID": 21,
       "Created": "2022-11-26T01:51:46",
       "AuthorId": 7,
       "Modified": "2022-11-26T01:55:47",

package/docs/docs/cmd/spo/page/page-list.mdx

@@ -89,7 +89,6 @@ m365 spo page list --webUrl https://contoso.sharepoint.com/sites/team-a
         "OData__OriginalSourceItemId": null,
         "OData__SPCallToAction": null,
         "OData__ModerationStatus": 0,
-        "ID": 10,
         "Created": "2020-09-06T02:18:55-07:00",
         "AuthorId": 1073741823,
         "Modified": "2020-09-06T02:18:55-07:00",

package/docs/docs/cmd/spo/page/page-section-add.mdx

@@ -20,10 +20,16 @@ m365 spo page section add [options]
 : URL of the site where the page to retrieve is located.
 
 `-t, --sectionTemplate <sectionTemplate>`
-: Type of section to add. Allowed values `OneColumn`, `OneColumnFullWidth`, `TwoColumn`, `ThreeColumn`, `TwoColumnLeft`, `TwoColumnRight`.
+: Type of section to add. Allowed values `OneColumn`, `OneColumnFullWidth`, `TwoColumn`, `ThreeColumn`, `TwoColumnLeft`, `TwoColumnRight`, `Vertical`.
 
 `--order [order]`
 : Order of the section to add.
+
+`--zoneEmphasis [zoneEmphasis]`
+: Section background shading. Allowed values `None`, `Neutral`, `Soft`, `Strong`
+
+`--isLayoutReflowOnTop`
+: The position of the Vertical section for smaller screens. Applied only for Vertical section.
 ```
 
 <Global />
@@ -40,6 +46,24 @@ Add section to the modern page
 m365 spo page section add --pageName home.aspx --webUrl https://contoso.sharepoint.com/sites/newsletter --sectionTemplate OneColumn --order 1
 ```
 
+Add section with background shading to the modern page
+
+```sh
+m365 spo page section add --pageName home.aspx --webUrl https://contoso.sharepoint.com/sites/newsletter --sectionTemplate OneColumn --zoneEmphasis Strong 
+```
+
+Add a vertical section to the modern page. There can only be one vertical section per page. If a vertical section already exists on the page, the command will not have any effect.
+
+```sh
+m365 spo page section add --pageName home.aspx --webUrl https://contoso.sharepoint.com/sites/newsletter --sectionTemplate Vertical
+```
+
+Add Vertical section with background shading to the modern page with adjusting the position of this section for smaller screens to the top
+
+```sh
+m365 spo page section add --pageName home.aspx --webUrl https://contoso.sharepoint.com/sites/newsletter --sectionTemplate Vertical --zoneEmphasis Neutral --isLayoutReflowOnTop
+```
+
 ## Response
 
 The command won't return a response on success.

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

@@ -42,6 +42,9 @@ m365 spo page set [options]
 
 `--title [title]`
 : The title to set for the page.
+
+`--content [content]`
+: JSON string containing page content
 ```
 
 <Global />
@@ -52,6 +55,20 @@ If you try to create a page with a name of a page that already exists, you will
 
 If you choose to promote the page using the `promoteAs` option or enable page comments, you will see the result only after publishing the page.
 
+Running this command from the Windows Command Shell (cmd.exe) or PowerShell for Windows OS XP, 7, 8, 8.1 without bash installed might require additional formatting for command options that have JSON, XML or JavaScript values because the command shell treat quotes differently. For example, this is how you can add page content from the Windows cmd.exe:
+
+```sh
+m365 spo page set --name page.aspx --webUrl https://contoso.sharepoint.com/sites/a-team --content '[{\"controlType\": 4,\"id\": \"42b8afe8-dafe-4c11-bfbf-df5ef5b1feb7\",\"position\": {\"layoutIndex\": 1,\"zoneIndex\": 1,\"sectionIndex\": 1,\"sectionFactor\": 12,\"controlIndex\": 1},\"addedFromPersistedData\": true,\"innerHTML\":\"<p>Hello World</p>\"}]'
+```
+
+Note, how the content option has escaped double quotes `'[{\"controlType\": 4,\"id\": \"42b8afe8-dafe-4c11-bfbf-df5ef5b1feb7\",\"position\": {\"layoutIndex\": 1,\"zoneIndex\": 1,\"sectionIndex\": 1,\"sectionFactor\": 12,\"controlIndex\": 1},\"addedFromPersistedData\": true,\"innerHTML\":\"<p>Hello World</p>\"}]'` compared to execution from bash `''[{"controlType": 4,"id": "42b8afe8-dafe-4c11-bfbf-df5ef5b1feb7","position": {"layoutIndex": 1,"zoneIndex": 1,"sectionIndex": 1,"sectionFactor": 12,"controlIndex": 1},"addedFromPersistedData": true,"innerHTML":"<p>Hello World</p>"}]'`.
+
+:::caution Escaping JSON in PowerShell
+
+    When using the `--content` option it's possible to enter a JSON string. In PowerShell 5 to 7.2 [specific escaping rules](./../../../user-guide/using-cli.mdx#escaping-double-quotes-in-powershell) apply due to an issue. Remember that you can also use [file tokens](./../../../user-guide/using-cli.mdx#passing-complex-content-into-cli-options) instead.
+
+:::
+
 ## Examples
 
 Change the layout of the existing page to _Article_
@@ -102,6 +119,12 @@ Set page description
 m365 spo page set --name page.aspx --webUrl https://contoso.sharepoint.com/sites/a-team --description "Description to add for the page"
 ```
 
+Set page content
+
+```sh
+m365 spo page set --name page.aspx --webUrl https://contoso.sharepoint.com/sites/a-team --content '[{\"controlType\": 4,\"id\": \"42b8afe8-dafe-4c11-bfbf-df5ef5b1feb7\",\"position\": {\"layoutIndex\": 1,\"zoneIndex\": 1,\"sectionIndex\": 1,\"sectionFactor\": 12,\"controlIndex\": 1},\"addedFromPersistedData\": true,\"innerHTML\":\"<p>Hello World</p>\"}]'
+```
+
 ## Response
 
 The command won't return a response on success.

package/docs/docs/cmd/spo/site/site-commsite-enable.mdx

@@ -17,7 +17,10 @@ m365 spo site commsite enable [options]
 : The URL of the site to enable communication site features on
 
 `-i, --designPackageId [designPackageId]`
-: The ID of the site design to apply when enabling communication site features. Allowed values are `96c933ac-3698-44c7-9f4a-5fd17d71af9e` (Topic = default), `6142d2a0-63a5-4ba0-aede-d9fefca2c767` (Showcase), `f6cc5403-0d63-442e-96c0-285923709ffc` (Blank)
+: The ID of the site design to apply when enabling communication site features. Specify designPackageId or designPackage but not both.
+
+`-p, --designPackage [designPackage]`
+: The site design to apply when enabling communication site features. Valid values are: Topic, Showcase, or Blank. Defaults to Topic. Specify designPackageId or designPackage but not both.
 ```
 
 <Global />
@@ -38,12 +41,18 @@ Enable communication site features on an existing site
 m365 spo site commsite enable --url https://contoso.sharepoint.com
 ```
 
-Enable communication site features on an existing site and apply Showcase design package
+Enable communication site features on an existing site and apply the Showcase design package using its ID.
 
 ```sh
 m365 spo site commsite enable --url https://contoso.sharepoint.com --designPackageId 6142d2a0-63a5-4ba0-aede-d9fefca2c767
 ```
 
+Enable communication site features on an existing site and apply the Showcase design package using its friendly name.
+
+```sh
+m365 spo site commsite enable --url https://contoso.sharepoint.com --designPackage Showcase
+```
+
 ## Response
 
 The command won't return a response on success.