@pnp/cli-microsoft365 7.0.0-beta.f2e9fd9 → 7.1.0-beta.129c6c7

package/docs/docs/cmd/spo/report/report-activityuserdetail.mdx

@@ -21,7 +21,7 @@ m365 spo report activityuserdetail [options]
 `-p, --period [period]`
 : The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`. Specify either `date` or `period`, but not both.
 
-`-f, --outputFile [outputFile]`
+`--outputFile [outputFile]`
 : Path to the file where the Microsoft Teams device usage by user report should be stored in.
 ```
 

package/docs/docs/cmd/spo/report/report-siteusagedetail.mdx

@@ -21,7 +21,7 @@ m365 spo report siteusagedetail [options]
 `-p, --period [period]`
 : The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`. Specify either `date` or `period`, but not both.
 
-`-f, --outputFile [outputFile]`
+`--outputFile [outputFile]`
 : Path to the file where the report should be stored in.
 ```
 

package/docs/docs/cmd/spo/report/report-siteusagefilecounts.mdx

@@ -18,7 +18,7 @@ m365 spo report siteusagefilecounts [options]
 `-p, --period <period>`
 : The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`.
 
-`-f, --outputFile [outputFile]`
+`--outputFile [outputFile]`
 : Path to the file where the report should be stored in.
 ```
 

package/docs/docs/cmd/spo/report/report-siteusagepages.mdx

@@ -18,7 +18,7 @@ m365 spo report siteusagepages [options]
 `-p, --period <period>`
 : The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`.
 
-`-f, --outputFile [outputFile]`
+`--outputFile [outputFile]`
 : Path to the file where the report should be stored in.
 ```
 

package/docs/docs/cmd/spo/report/report-siteusagesitecounts.mdx

@@ -18,7 +18,7 @@ m365 spo report siteusagesitecounts [options]
 `-p, --period <period>`
 : The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`.
 
-`-f, --outputFile [outputFile]`
+`--outputFile [outputFile]`
 : Path to the file where the report should be stored in.
 ```
 

package/docs/docs/cmd/spo/report/report-siteusagestorage.mdx

@@ -18,7 +18,7 @@ m365 spo report siteusagestorage [options]
 `-p, --period <period>`
 : The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`.
 
-`-f, --outputFile [outputFile]`
+`--outputFile [outputFile]`
 : Path to the file where the report should be stored in.
 ```
 

package/docs/docs/cmd/spo/roledefinition/roledefinition-remove.mdx

@@ -19,7 +19,7 @@ m365 spo roledefinition remove [options]
 `-i, --id <id>`
 : ID of the role definition to remove.
 
-`--confirm`
+`-f, --force`
 : Don't prompt for confirming removing the role definition.
 ```
 
@@ -36,7 +36,7 @@ m365 spo roledefinition remove --webUrl https://contoso.sharepoint.com/sites/pro
 Remove the role definition from the given site and don't prompt for confirmation
 
 ```sh
-m365 spo roledefinition remove --webUrl https://contoso.sharepoint.com/sites/project-x --id 1 --confirm
+m365 spo roledefinition remove --webUrl https://contoso.sharepoint.com/sites/project-x --id 1 --force
 ```
 
 ## Response

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

@@ -24,7 +24,7 @@ m365 spo sp set
 `-e, --enabled <enabled>`
 : Set to `true` to enable the service principal or to `false` to disable it. Valid values are `true`, `false`.
 
-`--confirm`
+`-f, --force`
 : Don't prompt for confirming enabling/disabling the service principal.
 ```
 
@@ -57,7 +57,7 @@ m365 spo serviceprincipal set --enabled false
 Enable the service principal without prompting for confirmation
 
 ```sh
-m365 spo serviceprincipal set --enabled true --confirm
+m365 spo serviceprincipal set --enabled true --force
 ```
 
 ## Response

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
 
@@ -96,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
 
@@ -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

@@ -25,7 +25,7 @@ m365 spo site apppermission remove [options]
 `-i, --id [id]`
 : ID of the permission to remove
 
-`--confirm`
+`-f, --force`
 : Don't prompt for confirmation
 ```
 
@@ -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,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
+: 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 />
@@ -37,3 +40,19 @@ 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 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

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo site ensure
 
@@ -101,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.
@@ -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)