@pnp/cli-microsoft365 7.0.0-beta.7f98bac → 7.0.0-beta.8726fe8

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-add.mdx

@@ -98,7 +98,7 @@ Deleting and creating classic site collections is by default asynchronous and de
 
 The `--owners` option is mandatory for creating `CommunicationSite` sites with app-only permissions.
 
-When trying to create a team site using app-only permissions, you will get an _Insufficient privileges to complete the operation._ error. As a workaround, you can use the [`aad o365group add`](../../aad/o365group/o365group-add.mdx) command, followed by [`spo site set`](./site-set.mdx) to further configure the Team site.
+When trying to create a team site using app-only permissions, you will get an _Insufficient privileges to complete the operation._ error. As a workaround, you can use the [`aad m365group add`](../../aad/m365group/m365group-add.mdx) command, followed by [`spo site set`](./site-set.mdx) to further configure the Team site.
 
 ## Examples
 

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.

package/docs/docs/cmd/spo/site/site-ensure.mdx

@@ -103,7 +103,7 @@ If you set the type to `ClassicSite`, you should also set a value of the `webTem
 Ensure that a site exists at the specified URL. Create a modern team site if no site exists. If a site is found, don't check its type and update its title.
 
 ```sh
-m365 spo site ensure --url https://contoso.sharepoint.com/sites/team1 --alias team1 --title "Team 1"
+m365 spo site ensure --url https://contoso.sharepoint.com/teams/team1 --alias team1 --title "Team 1"
 ```
 
 Ensure that a communication site exists at the specified URL. Create a communication site if no site exists. If a site of different type is found, return an error.

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

@@ -26,9 +26,6 @@ m365 spo site list [options]
 
 `--includeOneDriveSites`
 : use this switch to include OneDrive sites in the result when retrieving sites. Do not specify the `type` or `webTemplate` options when using this.
-
-`--deleted`
-: use this switch to only return deleted sites
 ```
 
 <Global />
@@ -39,12 +36,14 @@ Using the `--filter` option you can specify which sites you want to retrieve. Fo
 
 When using the text output type, the command lists only the values of the `Title`, and `Url` properties of the site. When setting the output type to JSON, all available properties are included in the command output.
 
+If you wish to list deleted sites in your tenant, you should use the command [spo tenant recyclebinitem list](../tenant/tenant-recyclebinitem-list.mdx)
+
 :::info
 
 To use this command you have to have permissions to access the tenant admin site.
 
 :::
-    
+
 ## Examples
 
 List all sites in the currently connected tenant
@@ -77,16 +76,8 @@ List all sites in the currently connected tenant including OneDrive sites
 m365 spo site list --includeOneDriveSites
 ```
 
-List all deleted sites in the tenant you're logged in to
-
-```sh
-m365 spo site list --deleted
-```
-
 ## Response
 
-### Standard response
-
 <Tabs>
   <TabItem value="JSON">
 
@@ -317,69 +308,3 @@ m365 spo site list --deleted
 
   </TabItem>
 </Tabs>
-
-### `deleted` response
-
-When we make use of the `--deleted` option, the response will differ. 
-
-<Tabs>
-  <TabItem value="JSON">
-
-  ```json
-  [
-    {
-      "_ObjectType_": "Microsoft.Online.SharePoint.TenantAdministration.DeletedSiteProperties",
-      "_ObjectIdentity_": "b805bfa0-805c-6000-b76d-bc01ecf6c67f|908bed80-a04a-4433-b4a0-883d9847d110:1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4\\\nDeletedSiteProperties\\\nhttps%3a%2f%2fcontoso.sharepoint.com%2fteams%2fteam1",
-      "DaysRemaining": 22,
-      "DeletionTime": "/Date(2023,3,12,8,9,55,260)/",
-      "SiteId": "/Guid(0031a568-a081-4157-a3ab-0946a9da7f6e)/",
-      "Status": "Recycled",
-      "StorageMaximumLevel": 1048576,
-      "Url": "https://contoso.sharepoint.com/teams/team1",
-      "UserCodeMaximumLevel": 300
-    }
-  ]
-  ```
-
-  </TabItem>
-  <TabItem value="Text">
-
-  ```text
-  Url
-  -------------------------------------------------
-  https://contoso.sharepoint.com/teams/team1
-  ```
-
-  </TabItem>
-  <TabItem value="CSV">
-
-  ```csv
-  ObjectType,ObjectIdentity,DaysRemaining,DeletionTime,SiteId,Status,StorageMaximumLevel,Url,UserCodeMaximumLevel
-  Microsoft.Online.SharePoint.TenantAdministration.DeletedSiteProperties,"fc05bfa0-80db-6000-a541-3d6844d4e148|908bed80-a04a-4433-b4a0-883d9847d110:1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4,DeletedSiteProperties,https%3a%2f%2fcontoso.sharepoint.com%2fteams%2fteam1",22,/Date(2023,3,12,8,9,55,260)/,/Guid(0031a568-a081-4157-a3ab-0946a9da7f6e)/,Recycled,1048576,https://contoso.sharepoint.com/teams/team1,300
-  ```
-
-  </TabItem>
-  <TabItem value="Markdown">
-
-  ```md
-  # spo site list --deleted "true"
-
-  Date: 2023-06-21
-
-  ## https://contoso.sharepoint.com/teams/team1
-
-  Property | Value
-  ---------|-------
-  \_ObjectType\_ | Microsoft.Online.SharePoint.TenantAdministration.DeletedSiteProperties
-  \_ObjectIdentity\_ | 3b06bfa0-40fd-6000-c2a5-1ef401300d74\|908bed80-a04a-4433-b4a0-883d9847d110:1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4<br>DeletedSiteProperties<br>https%3a%2f%2fcontoso.sharepoint.com%2fteams%2fteam1
-  DaysRemaining | 22
-  DeletionTime | /Date(2023,3,12,8,9,55,260)/
-  SiteId | /Guid(0031a568-a081-4157-a3ab-0946a9da7f6e)/
-  Status | Recycled
-  StorageMaximumLevel | 1048576
-  Url | https://contoso.sharepoint.com/teams/team1
-  UserCodeMaximumLevel | 300
-  ```
-
-  </TabItem>
-</Tabs>

package/docs/docs/cmd/spo/tenant/tenant-applicationcustomizer-add.mdx

@@ -2,7 +2,7 @@ import Global from '/docs/cmd/_global.mdx';
 
 # spo tenant applicationcustomizer add
 
-Add an application customizer as a tenant wide extension.
+Add an application customizer as a tenant wide extension
 
 ## Usage
 

package/docs/docs/cmd/spo/tenant/tenant-applicationcustomizer-get.mdx

@@ -19,7 +19,7 @@ m365 spo tenant applicationcustomizer get [options]
 : The title of the application customizer. Specify either `title`, `id`, or `clientSideComponentId`.
 
 `-i, --id [id]`
-: The product id of the application customizer. Specify either `title`, `id`, or `clientSideComponentId`.
+: The id of the application customizer. Specify either `title`, `id`, or `clientSideComponentId`.
 
 `-c, --clientSideComponentId  [clientSideComponentId]`
 : The Client Side Component Id (GUID) of the application customizer. Specify either `title`, `id`, or `clientSideComponentId`.
@@ -38,7 +38,7 @@ m365 spo tenant applicationcustomizer get --title "Some customizer"
 Retrieves an application customizer by id.
 
 ```sh
-m365 spo tenant applicationcustomizer get --id 14125658-a9bc-4ddf-9c75-1b5767c9a337
+m365 spo tenant applicationcustomizer get --id 3
 ```
 
 Retrieves an application customizer by clientSideComponentId.

package/docs/docs/cmd/spo/tenant/tenant-applicationcustomizer-list.mdx

@@ -4,7 +4,7 @@ import TabItem from '@theme/TabItem';
 
 # spo tenant applicationcustomizer list
 
-Retrieves a list of application customizers that are installed tenant-wide.
+Retrieves a list of application customizers that are installed tenant-wide
 
 ## Usage
 
@@ -36,7 +36,6 @@ m365 spo tenant applicationcustomizer list
       "Id": 8,
       "ServerRedirectedEmbedUri": null,
       "ServerRedirectedEmbedUrl": "",
-      "ID": 8,
       "ContentTypeId": "0x00693E2C487575B448BD420C12CEAE7EFE",
       "Title": "HelloWorld",
       "Modified": "2023-05-21T14:31:30Z",
@@ -73,8 +72,8 @@ m365 spo tenant applicationcustomizer list
   <TabItem value="CSV">
 
   ```csv
-  FileSystemObjectType,Id,ServerRedirectedEmbedUrl,ID,ContentTypeId,Title,Modified,Created,AuthorId,EditorId,OData__UIVersionString,Attachments,GUID,TenantWideExtensionComponentId,TenantWideExtensionComponentProperties,TenantWideExtensionListTemplate,TenantWideExtensionLocation,TenantWideExtensionSequence,TenantWideExtensionDisabled
-  0,8,,8,0x00693E2C487575B448BD420C12CEAE7EFE,HelloWorld,2023-05-21T14:31:30Z,2023-05-21T14:31:30Z,9,9,1.0,,23951a41-f613-440e-8119-8f1e87df1d1a,d54e75e7-af4d-455f-9101-a5d906692ecd,"{""testMessage"":""Test message""}",0,ClientSideExtension.ApplicationCustomizer,0,
+  FileSystemObjectType,Id,ServerRedirectedEmbedUrl,ContentTypeId,Title,Modified,Created,AuthorId,EditorId,OData__UIVersionString,Attachments,GUID,TenantWideExtensionComponentId,TenantWideExtensionComponentProperties,TenantWideExtensionListTemplate,TenantWideExtensionLocation,TenantWideExtensionSequence,TenantWideExtensionDisabled
+  0,8,,0x00693E2C487575B448BD420C12CEAE7EFE,HelloWorld,2023-05-21T14:31:30Z,2023-05-21T14:31:30Z,9,9,1.0,,23951a41-f613-440e-8119-8f1e87df1d1a,d54e75e7-af4d-455f-9101-a5d906692ecd,"{""testMessage"":""Test message""}",0,ClientSideExtension.ApplicationCustomizer,0,
   ```
 
   </TabItem>
@@ -92,7 +91,6 @@ m365 spo tenant applicationcustomizer list
   FileSystemObjectType | 0
   Id | 8
   ServerRedirectedEmbedUrl |
-  ID | 8
   ContentTypeId | 0x00693E2C487575B448BD420C12CEAE7EFE
   Title | HelloWorld
   Modified | 2023-05-21T14:31:30Z

package/docs/docs/cmd/spo/tenant/tenant-applicationcustomizer-remove.mdx

@@ -2,7 +2,7 @@ import Global from '/docs/cmd/_global.mdx';
 
 # spo tenant applicationcustomizer remove
 
-Removes an application customizer that is installed tenant wide.
+Removes an application customizer that is installed tenant wide
 
 ## Usage
 

package/docs/docs/cmd/spo/tenant/tenant-commandset-add.mdx

@@ -4,7 +4,7 @@ import TabItem from '@theme/TabItem';
 
 # spo tenant commandset add
 
-Add a ListView Command Set as a tenant-wide extension.
+Add a ListView Command Set as a tenant-wide extension
 
 ## Usage
 

package/docs/docs/cmd/spo/tenant/tenant-commandset-list.mdx

@@ -36,7 +36,6 @@ m365 spo tenant commandset list
       "Id": 9,
       "ServerRedirectedEmbedUri": null,
       "ServerRedirectedEmbedUrl": "",
-      "ID": 9,
       "ContentTypeId": "0x00693E2C487575B448BD420C12CEAE7EFE",
       "Title": "HelloWorld",
       "Modified": "2023-05-25T12:11:21Z",
@@ -73,8 +72,8 @@ m365 spo tenant commandset list
   <TabItem value="CSV">
 
   ```csv
-  FileSystemObjectType,Id,ServerRedirectedEmbedUrl,ID,ContentTypeId,Title,Modified,Created,AuthorId,EditorId,OData__UIVersionString,Attachments,GUID,TenantWideExtensionComponentId,TenantWideExtensionComponentProperties,TenantWideExtensionListTemplate,TenantWideExtensionLocation,TenantWideExtensionSequence,TenantWideExtensionDisabled
-  0,9,,9,0x00693E2C487575B448BD420C12CEAE7EFE,HelloWorld,2023-05-25T12:11:21Z,2023-05-25T12:11:21Z,9,9,1.0,,6c47dd94-f5d5-4ea8-8b39-920385a56c37,f61d4ae8-3480-4541-930b-d641233c4fea,"{""sampleTextOne"":""One item is selected in the list."", ""sampleTextTwo"":""This command is always visible.""}",100,ClientSideExtension.ListViewCommandSet.CommandBar,0,
+  FileSystemObjectType,Id,ServerRedirectedEmbedUrl,ContentTypeId,Title,Modified,Created,AuthorId,EditorId,OData__UIVersionString,Attachments,GUID,TenantWideExtensionComponentId,TenantWideExtensionComponentProperties,TenantWideExtensionListTemplate,TenantWideExtensionLocation,TenantWideExtensionSequence,TenantWideExtensionDisabled
+  0,9,,0x00693E2C487575B448BD420C12CEAE7EFE,HelloWorld,2023-05-25T12:11:21Z,2023-05-25T12:11:21Z,9,9,1.0,,6c47dd94-f5d5-4ea8-8b39-920385a56c37,f61d4ae8-3480-4541-930b-d641233c4fea,"{""sampleTextOne"":""One item is selected in the list."", ""sampleTextTwo"":""This command is always visible.""}",100,ClientSideExtension.ListViewCommandSet.CommandBar,0,
   ```
 
   </TabItem>
@@ -92,7 +91,6 @@ m365 spo tenant commandset list
   FileSystemObjectType | 0
   Id | 9
   ServerRedirectedEmbedUrl |
-  ID | 9
   ContentTypeId | 0x00693E2C487575B448BD420C12CEAE7EFE
   Title | HelloWorld
   Modified | 2023-05-25T12:11:21Z

package/docs/docs/cmd/spo/tenant/tenant-commandset-remove.mdx

@@ -2,7 +2,7 @@ import Global from '/docs/cmd/_global.mdx';
 
 # spo tenant commandset remove
 
-Removes a ListView Command Set that is installed tenant wide.
+Removes a ListView Command Set that is installed tenant wide
 
 ## Usage
 

package/docs/docs/cmd/spo/tenant/tenant-commandset-set.mdx

@@ -2,7 +2,7 @@ import Global from '/docs/cmd/_global.mdx';
 
 # spo tenant commandset set
 
-Updates a ListView Command Set that is installed tenant wide.
+Updates a ListView Command Set that is installed tenant wide
 
 ## Usage
 

package/docs/docs/cmd/teams/app/app-remove.mdx

@@ -13,11 +13,14 @@ m365 teams app remove [options]
 ## Options
 
 ```md definition-list
-`-i, --id <id>`
-: ID of the Teams app to remove. Needs to be available in your organization\'s app catalog.
+`-i, --id [id]`
+: ID of the Teams app to remove. Needs to be available in your organization\'s app catalog. Specify either `id` or `name`.
+
+`-n, --name [name]`
+: Name of the Teams app to remove. Needs to be available in your organization\'s app catalog. Specify either `id` or `name`.
 
 `-f, --force`
-: Don't prompt for confirming removing the app
+: Don't prompt for confirming removing the app.
 ```
 
 <Global />
@@ -28,16 +31,16 @@ You can only remove a Teams app as a global administrator.
 
 ## Examples
 
-Remove the Teams app with ID _83cece1e-938d-44a1-8b86-918cf6151957_ from the organization's app catalog. Will prompt for confirmation before actually removing the app.
+Remove the Teams app by ID from the organization's app catalog. Will prompt for confirmation before actually removing the app.
 
 ```sh
 m365 teams app remove --id 83cece1e-938d-44a1-8b86-918cf6151957
 ```
 
-Remove the Teams app with ID _83cece1e-938d-44a1-8b86-918cf6151957_ from the organization's app catalog. Don't prompt for confirmation.
+Remove the Teams app by name from the organization's app catalog. Don't prompt for confirmation.
 
 ```sh
-m365 teams app remove --id 83cece1e-938d-44a1-8b86-918cf6151957 --force
+m365 teams app remove --name HelloWorld --force
 ```
 
 ## Response

package/docs/docs/cmd/teams/channel/channel-member-add.mdx

@@ -25,10 +25,10 @@ m365 teams channel member add [options]
 `--channelName [channelName]`
 : The display name of the Microsoft Teams team channel. Specify either `channelId` or `channelName`, but not both.
 
-`--userId [userId]`
+`--userIds [userIds]`
 : The user's ID or principal name. You can also pass a comma-separated list of userIds.
 
-`--userDisplayName [userDisplayName]`
+`--userDisplayNames [userDisplayNames]`
 : The display name of a user. You can also pass a comma-separated list of display names.
 
 `--owner`
@@ -48,13 +48,13 @@ You can only add members and owners of a team to a private channel.
 Add members to a channel based on their id or user principal name
 
 ```sh
-m365 teams channel member add --teamId 47d6625d-a540-4b59-a4ab-19b787e40593 --channelId 19:586a8b9e36c4479bbbd378e439a96df2@thread.skype --userId "85a50aa1-e5b8-48ac-b8ce-8e338033c366,john.doe@contoso.com"
+m365 teams channel member add --teamId 47d6625d-a540-4b59-a4ab-19b787e40593 --channelId 19:586a8b9e36c4479bbbd378e439a96df2@thread.skype --userIds "85a50aa1-e5b8-48ac-b8ce-8e338033c366,john.doe@contoso.com"
 ```
 
 Add owners to a channel based on their display names
 
 ```sh
-m365 teams channel member add --teamName "Human Resources" --channelName "Private Channel" --userDisplayName "Anne Matthews,John Doe" --owner
+m365 teams channel member add --teamName "Human Resources" --channelName "Private Channel" --userDisplayNames "Anne Matthews,John Doe" --owner
 ```
 
 ## Response