@pnp/cli-microsoft365 7.0.0-beta.68abdfc → 7.0.0-beta.7e7b4f8

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

@@ -16,22 +16,19 @@ m365 spo file list [options]
 
 ```md definition-list
 `-u, --webUrl <webUrl>`
-: The URL of the site where the folder from which to retrieve files is located
+: The URL of the site where the folder from which to retrieve files is located.
 
-`--folderUrl <folderUrl>`
-: The server- or site-relative URL of the parent folder from which to retrieve files
-
-`--folder <folder>`
-: (deprecated. Use `folderUrl` instead) The server- or site-relative URL of the folder from which to retrieve files
+`-f, --folderUrl <folderUrl>`
+: The server- or site-relative URL of the parent folder from which to retrieve files.
 
 `--fields [fields]`
 : Comma-separated list of fields to retrieve. Will retrieve all fields if not specified.
 
 `--filter [filter]`
-: OData filter to use to query the list of items with
+: OData filter to use to query the list of items with.
 
 `-r, --recursive`
-: Set to retrieve files from subfolders
+: Set to retrieve files from subfolders.
 ```
 
 <Global />
@@ -134,5 +131,4 @@ m365 spo file list --webUrl https://contoso.sharepoint.com/sites/project-x --fol
   ```
 
   </TabItem>
-</Tabs>
-
+</Tabs>

package/docs/docs/cmd/spo/list/list-retentionlabel-ensure.mdx

@@ -10,12 +10,6 @@ Sets a default retention label on the specified list or library.
 m365 spo list retentionlabel ensure [options]
 ```
 
-## Alias
-
-```sh
-m365 spo list label set [options]
-```
-
 ## Options
 
 ```md definition-list

package/docs/docs/cmd/spo/list/list-retentionlabel-get.mdx

@@ -12,12 +12,6 @@ Gets the default retention label set on the specified list or library.
 m365 spo list retentionlabel get [options]
 ```
 
-## Alias
-
-```sh
-m365 spo list label get [options]
-```
-
 ## Options
 
 ```md definition-list

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

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo site add
 
@@ -178,6 +180,39 @@ Create new classic site collection using the Team site template. Set time zone t
 m365 spo site add --type ClassicSite --url https://contoso.sharepoint.com/sites/team --title Team --owners admin@contoso.onmicrosoft.com --timeZone 4 --webTemplate STS#0 --removeDeletedSite --wait
 ```
 
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  "https://contoso.sharepoint.com/sites/marketing"
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  https://contoso.sharepoint.com/sites/marketing
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  https://contoso.sharepoint.com/sites/marketing
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  https://contoso.sharepoint.com/sites/marketing
+  ```
+
+  </TabItem>
+</Tabs>
+
 ## More information
 
 - Creating SharePoint Communication Site using REST: [https://docs.microsoft.com/en-us/sharepoint/dev/apis/communication-site-creation-rest](https://docs.microsoft.com/en-us/sharepoint/dev/apis/communication-site-creation-rest)

package/docs/docs/cmd/spo/site/site-appcatalog-add.mdx

@@ -32,9 +32,13 @@ To use this command you have to have permissions to access the tenant admin site
 Add a site collection app catalog to the specified site
 
 ```sh
-m365 spo site appcatalog add --siteUrl https://contoso.sharepoint/sites/site
+m365 spo site appcatalog add --siteUrl https://contoso.sharepoint.com/sites/site
 ```
 
+## Response
+
+The command won't return a response on success.
+
 ## More information
 
 - Use the site collection app catalog: [https://docs.microsoft.com/en-us/sharepoint/dev/general-development/site-collection-app-catalog](https://docs.microsoft.com/en-us/sharepoint/dev/general-development/site-collection-app-catalog)

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

@@ -64,6 +64,20 @@ m365 spo site appcatalog list
   https://contoso.sharepoint.com/sites/site1,9798e615-b586-455e-8486-84913f492c49
   ```
 
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # spo site appcatalog list
+
+  Date: 2023-06-21
+
+  Property | Value
+  ---------|-------
+  AbsoluteUrl | https://contoso.sharepoint.com/sites/site1
+  SiteID | 9798e615-b586-455e-8486-84913f492c49
+  ```
+
   </TabItem>
 </Tabs>
 

package/docs/docs/cmd/spo/site/site-appcatalog-remove.mdx

@@ -37,6 +37,10 @@ Remove the site collection app catalog from specified site
 m365 spo site appcatalog remove --siteUrl https://contoso.sharepoint/sites/site
 ```
 
+## Response
+
+The command won't return a response on success.
+
 ## More information
 
 - Use the site collection app catalog: [https://docs.microsoft.com/en-us/sharepoint/dev/general-development/site-collection-app-catalog](https://docs.microsoft.com/en-us/sharepoint/dev/general-development/site-collection-app-catalog)

package/docs/docs/cmd/spo/site/site-apppermission-add.mdx

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo site apppermission add
 
@@ -39,3 +41,69 @@ Grants the specified app the _read_ permission to site _https://contoso.sharepoi
 ```sh
 m365 spo site apppermission add --siteUrl https://contoso.sharepoint.com/sites/project-x --permission read --appDisplayName Foo
 ```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+  "id": "aTowaS50fG1zLnNwLmV4dHw1Yzg5ZmJiZi02NzBlLTQ4ZTctYTBiYy1mYTg5NDJjODk1YTJAMWU4NTJiNDktYmY0Yi00YmE1LWJjZDQtYThjNDcwNmM4ZWQ0",
+  "roles": [
+    "read"
+  ],
+  "grantedToIdentitiesV2": [
+    {
+      "application": {
+        "displayName": "Foo",
+        "id": "5c89fbbf-670e-48e7-a0bc-fa8942c895a2"
+      }
+    }
+  ],
+  "grantedToIdentities": [
+    {
+      "application": {
+        "displayName": "Foo",
+        "id": "5c89fbbf-670e-48e7-a0bc-fa8942c895a2"
+      }
+    }
+  ]
+}
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  grantedToIdentities  : [{"application":{"displayName":"Foo","id":"5c89fbbf-670e-48e7-a0bc-fa8942c895a2"}}]
+  grantedToIdentitiesV2: [{"application":{"displayName":"Foo","id":"5c89fbbf-670e-48e7-a0bc-fa8942c895a2"}}]
+  id                   : aTowaS50fG1zLnNwLmV4dHw1Yzg5ZmJiZi02NzBlLTQ4ZTctYTBiYy1mYTg5NDJjODk1YTJAMWU4NTJiNDktYmY0Yi00YmE1LWJjZDQtYThjNDcwNmM4ZWQ0
+  roles                : ["read"]
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id
+  aTowaS50fG1zLnNwLmV4dHw1Yzg5ZmJiZi02NzBlLTQ4ZTctYTBiYy1mYTg5NDJjODk1YTJAMWU4NTJiNDktYmY0Yi00YmE1LWJjZDQtYThjNDcwNmM4ZWQ0
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # spo site apppermission add --siteUrl "https://contoso.sharepoint.com/sites/team1" --permission "read" --appDisplayName "Foo"
+
+  Date: 2023-06-21
+
+  ## aTowaS50fG1zLnNwLmV4dHw1Yzg5ZmJiZi02NzBlLTQ4ZTctYTBiYy1mYTg5NDJjODk1YTJAMWU4NTJiNDktYmY0Yi00YmE1LWJjZDQtYThjNDcwNmM4ZWQ0
+
+  Property | Value
+  ---------|-------
+  id | aTowaS50fG1zLnNwLmV4dHw1Yzg5ZmJiZi02NzBlLTQ4ZTctYTBiYy1mYTg5NDJjODk1YTJAMWU4NTJiNDktYmY0Yi00YmE1LWJjZDQtYThjNDcwNmM4ZWQ0
+  ```
+
+  </TabItem>
+</Tabs>

package/docs/docs/cmd/spo/site/site-apppermission-get.mdx

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo site apppermission get
 
@@ -29,3 +31,56 @@ Return a specific application permissions for the _https://contoso.sharepoint.co
 ```sh
 m365 spo site apppermission get --siteUrl https://contoso.sharepoint.com/sites/project-x --id aTowaS50fG1zLnNwLmV4dHw4OWVhNWM5NC03NzM2LTRlMjUtOTVhZC0zZmE5NWY2MmI2NmVAZGUzNDhiYzctMWFlYi00NDA2LThjYjMtOTdkYjAyMWNhZGI0
 ```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "appDisplayName": "Foo",
+      "appId": "5c89fbbf-670e-48e7-a0bc-fa8942c895a2",
+      "permissionId": "aTowaS50fG1zLnNwLmV4dHw1Yzg5ZmJiZi02NzBlLTQ4ZTctYTBiYy1mYTg5NDJjODk1YTJAMWU4NTJiNDktYmY0Yi00YmE1LWJjZDQtYThjNDcwNmM4ZWQ0",
+      "roles": "read"
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  appDisplayName: Foo
+  appId         : 5c89fbbf-670e-48e7-a0bc-fa8942c895a2
+  permissionId  : aTowaS50fG1zLnNwLmV4dHw1Yzg5ZmJiZi02NzBlLTQ4ZTctYTBiYy1mYTg5NDJjODk1YTJAMWU4NTJiNDktYmY0Yi00YmE1LWJjZDQtYThjNDcwNmM4ZWQ0
+  roles         : read
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  appDisplayName,appId,permissionId,roles
+  Foo,5c89fbbf-670e-48e7-a0bc-fa8942c895a2,aTowaS50fG1zLnNwLmV4dHw1Yzg5ZmJiZi02NzBlLTQ4ZTctYTBiYy1mYTg5NDJjODk1YTJAMWU4NTJiNDktYmY0Yi00YmE1LWJjZDQtYThjNDcwNmM4ZWQ0,read
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # spo site apppermission get --siteUrl "https://contoso.sharepoint.com/sites/marketing" --id "aTowaS50fG1zLnNwLmV4dHw1Yzg5ZmJiZi02NzBlLTQ4ZTctYTBiYy1mYTg5NDJjODk1YTJAMWU4NTJiNDktYmY0Yi00YmE1LWJjZDQtYThjNDcwNmM4ZWQ0"
+
+  Date: 2023-06-21
+
+  Property | Value
+  ---------|-------
+  appDisplayName | Foo
+  appId | 5c89fbbf-670e-48e7-a0bc-fa8942c895a2
+  permissionId | aTowaS50fG1zLnNwLmV4dHw1Yzg5ZmJiZi02NzBlLTQ4ZTctYTBiYy1mYTg5NDJjODk1YTJAMWU4NTJiNDktYmY0Yi00YmE1LWJjZDQtYThjNDcwNmM4ZWQ0
+  roles | read
+  ```
+
+  </TabItem>
+</Tabs>

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

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo site apppermission list
 
@@ -42,3 +44,56 @@ Return list of application permissions for the _https://contoso.sharepoint.com/s
 ```sh
 m365 spo site apppermission list --siteUrl https://contoso.sharepoint.com/sites/project-x --appDisplayName Foo
 ```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "appDisplayName": "Foo",
+      "appId": "5c89fbbf-670e-48e7-a0bc-fa8942c895a2",
+      "permissionId": "aTowaS50fG1zLnNwLmV4dHw1Yzg5ZmJiZi02NzBlLTQ4ZTctYTBiYy1mYTg5NDJjODk1YTJAMWU4NTJiNDktYmY0Yi00YmE1LWJjZDQtYThjNDcwNmM4ZWQ0",
+      "roles": [
+        "manage"
+      ]
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  appDisplayName  appId                                 permissionId                                                                                                              roles
+  --------------  ------------------------------------  ------------------------------------------------------------------------------------------------------------------------  ------
+  Foo             5c89fbbf-670e-48e7-a0bc-fa8942c895a2  aTowaS50fG1zLnNwLmV4dHw1Yzg5ZmJiZi02NzBlLTQ4ZTctYTBiYy1mYTg5NDJjODk1YTJAMWU4NTJiNDktYmY0Yi00YmE1LWJjZDQtYThjNDcwNmM4ZWQ0  manage
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  appDisplayName,appId,permissionId
+  Foo,5c89fbbf-670e-48e7-a0bc-fa8942c895a2,aTowaS50fG1zLnNwLmV4dHw1Yzg5ZmJiZi02NzBlLTQ4ZTctYTBiYy1mYTg5NDJjODk1YTJAMWU4NTJiNDktYmY0Yi00YmE1LWJjZDQtYThjNDcwNmM4ZWQ0
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # spo site apppermission list --siteUrl "https://contoso.sharepoint.com/sites/team1"
+
+  Date: 2023-06-21
+
+  Property | Value
+  ---------|-------
+  appDisplayName | Foo
+  appId | 5c89fbbf-670e-48e7-a0bc-fa8942c895a2
+  permissionId | aTowaS50fG1zLnNwLmV4dHw1Yzg5ZmJiZi02NzBlLTQ4ZTctYTBiYy1mYTg5NDJjODk1YTJAMWU4NTJiNDktYmY0Yi00YmE1LWJjZDQtYThjNDcwNmM4ZWQ0
+  ```
+
+  </TabItem>
+</Tabs>

package/docs/docs/cmd/spo/site/site-apppermission-remove.mdx

@@ -50,3 +50,7 @@ Removes the application permission with the specified ID on site _https://contos
 ```sh
 m365 spo site apppermission remove --siteUrl https://contoso.sharepoint.com/sites/project-x --id aTowaS50fG1zLnNwLmV4dHw4OWVhNWM5NC03NzM2LTRlMjUtOTVhZC0zZmE5NWY2MmI2NmVAZGUzNDhiYzctMWFlYi00NDA2LThjYjMtOTdkYjAyMWNhZGI0
 ```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/spo/site/site-apppermission-set.mdx

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo site apppermission set
 
@@ -50,3 +52,67 @@ Updates a specific application permission to _read_ for the _https://contoso.sha
 ```sh
 m365 spo site apppermission set --siteUrl https://contoso.sharepoint.com/sites/project-x --appId 89ea5c94-7736-4e25-95ad-3fa95f62b66e --permission read
 ```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "id": "aTowaS50fG1zLnNwLmV4dHw1Yzg5ZmJiZi02NzBlLTQ4ZTctYTBiYy1mYTg5NDJjODk1YTJAMWU4NTJiNDktYmY0Yi00YmE1LWJjZDQtYThjNDcwNmM4ZWQ0",
+    "roles": [
+      "read"
+    ],
+    "grantedToIdentitiesV2": [
+      {
+        "application": {
+          "id": "5c89fbbf-670e-48e7-a0bc-fa8942c895a2"
+        }
+      }
+    ],
+    "grantedToIdentities": [
+      {
+        "application": {
+          "id": "5c89fbbf-670e-48e7-a0bc-fa8942c895a2"
+        }
+      }
+    ]
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  grantedToIdentities  : [{"application":{"id":"5c89fbbf-670e-48e7-a0bc-fa8942c895a2"}}]
+  grantedToIdentitiesV2: [{"application":{"id":"5c89fbbf-670e-48e7-a0bc-fa8942c895a2"}}]
+  id                   : aTowaS50fG1zLnNwLmV4dHw1Yzg5ZmJiZi02NzBlLTQ4ZTctYTBiYy1mYTg5NDJjODk1YTJAMWU4NTJiNDktYmY0Yi00YmE1LWJjZDQtYThjNDcwNmM4ZWQ0
+  roles                : ["read"]
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id
+  aTowaS50fG1zLnNwLmV4dHw1Yzg5ZmJiZi02NzBlLTQ4ZTctYTBiYy1mYTg5NDJjODk1YTJAMWU4NTJiNDktYmY0Yi00YmE1LWJjZDQtYThjNDcwNmM4ZWQ0
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # spo site apppermission set --siteUrl "https://contoso.sharepoint.com/sites/marketing" --appDisplayName "Foo" --permission "read"
+
+  Date: 2023-06-21
+
+  ## aTowaS50fG1zLnNwLmV4dHw1Yzg5ZmJiZi02NzBlLTQ4ZTctYTBiYy1mYTg5NDJjODk1YTJAMWU4NTJiNDktYmY0Yi00YmE1LWJjZDQtYThjNDcwNmM4ZWQ0
+
+  Property | Value
+  ---------|-------
+  id | aTowaS50fG1zLnNwLmV4dHw1Yzg5ZmJiZi02NzBlLTQ4ZTctYTBiYy1mYTg5NDJjODk1YTJAMWU4NTJiNDktYmY0Yi00YmE1LWJjZDQtYThjNDcwNmM4ZWQ0
+  ```
+
+  </TabItem>
+</Tabs>

package/docs/docs/cmd/spo/site/site-chrome-set.mdx

@@ -62,3 +62,7 @@ Disable the footer on the site
 ```sh
 m365 spo site chrome set --siteUrl https://contoso.sharepoint.com/sites/project-x --disableFooter true
 ```
+
+## Response
+
+The command won't return a response on success.

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

@@ -17,7 +17,7 @@ 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
+: 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)
 ```
 
 <Global />
@@ -37,3 +37,13 @@ Enable communication site features on an existing site
 ```sh
 m365 spo site commsite enable --url https://contoso.sharepoint.com
 ```
+
+Enable communication site features on an existing site and apply Showcase design package
+
+```sh
+m365 spo site commsite enable --url https://contoso.sharepoint.com --designPackageId 6142d2a0-63a5-4ba0-aede-d9fefca2c767
+```
+
+## Response
+
+The command won't return a response on success.

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

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo site ensure
 
@@ -122,6 +124,74 @@ Ensure that a site exists at the specified URL. Create a modern team site if no
 m365 spo site ensure --url https://contoso.sharepoint.com/sites/team1 --alias team1 --title "Team 1" --isPublic --shareByEmailEnabled
 ```
 
+## Response
+
+### Create a site if no site exists.
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  "\"https://contoso.sharepoint.com/teams/team1\""
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  "https://contoso.sharepoint.com/teams/team1"
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  "https://contoso.sharepoint.com/teams/team1"
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  "https://contoso.sharepoint.com/teams/team1"
+  ```
+
+  </TabItem>
+</Tabs>
+
+### If a site of different type is found
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  Error: Expected web template SITEPAGEPUBLISHING#0 but site found at https://contoso.sharepoint.com/teams/team1 is based on GROUP#0
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  Error: Expected web template SITEPAGEPUBLISHING#0 but site found at https://contoso.sharepoint.com/teams/team1 is based on GROUP#0
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  Error: Expected web template SITEPAGEPUBLISHING#0 but site found at https://contoso.sharepoint.com/teams/team1 is based on GROUP#0
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  Error: Expected web template SITEPAGEPUBLISHING#0 but site found at https://contoso.sharepoint.com/teams/team1 is based on GROUP#0
+  ```
+
+  </TabItem>
+</Tabs>
+
 ## More information
 
 - [`spo site add`](./site-add.mdx)