@pnp/cli-microsoft365 6.0.0-beta.ff232be → 6.1.0-beta.11542c0

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

@@ -1,6 +1,6 @@
 # spo roledefinition get
 
-Gets specified role definition from web by id
+Gets specified role definition from web
 
 ## Usage
 
@@ -11,7 +11,7 @@ m365 spo roledefinition get [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: URL of the site for which to retrieve the role definition
+: URL of the site for which to retrieve the role definition.
 
 `-i, --id <id>`
 : The Id of the role definition to retrieve.
@@ -20,8 +20,86 @@ m365 spo roledefinition get [options]
 
 ## Examples
 
-Retrieve the role definition for site _https://contoso.sharepoint.com/sites/project-x_ with id _1_
+Retrieve the role definition for the given site
 
 ```sh
 m365 spo roledefinition get --webUrl https://contoso.sharepoint.com/sites/project-x --id 1
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "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"
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    BasePermissions     : {"High":"2147483647","Low":"4294967295"}
+    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"]
+    Description         : Has full control.
+    Hidden              : false
+    Id                  : 1073741829
+    Name                : Full Control
+    Order               : 1
+    RoleTypeKind        : 5
+    RoleTypeKindValue   : Administrator
+    ```
+
+=== "CSV"
+
+    ```csv
+    BasePermissions,Description,Hidden,Id,Name,Order,RoleTypeKind,BasePermissionsValue,RoleTypeKindValue
+    "{""High"":""2147483647"",""Low"":""4294967295""}",Has full control.,,1073741829,Full Control,1,5,"[""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""]",Administrator
+    ```

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

@@ -11,14 +11,88 @@ m365 spo roledefinition list [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: URL of the site for which to retrieve role definitions
+: URL of the site for which to retrieve role definitions.
 
 --8<-- "docs/cmd/_global.md"
 
 ## Examples
 
-Return list of role definitions for site _https://contoso.sharepoint.com/sites/project-x_
+Return list of role definitions for the given site
 
 ```sh
 m365 spo roledefinition list --webUrl https://contoso.sharepoint.com/sites/project-x
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "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"
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    Id          Name
+    ----------  -----------------------
+    1073741829  Full Control
+    ```
+
+=== "CSV"
+
+    ```csv
+    Id,Name
+    1073741829,Full Control
+    ```

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

@@ -11,26 +11,30 @@ m365 spo roledefinition remove [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: URL of the site from which role should be removed
+: URL of the site from which role should be removed.
 
 `-i, --id <id>`
-: ID of the role definition to remove
+: ID of the role definition to remove.
 
 `--confirm`
-: Don't prompt for confirming removing the role definition
+: Don't prompt for confirming removing the role definition.
 
 --8<-- "docs/cmd/_global.md"
 
 ## Examples
 
-Remove the role definition from site  _https://contoso.sharepoint.com/sites/project-x_ with id _1_
+Remove the role definition from the given site
 
 ```sh
 m365 spo roledefinition remove --webUrl https://contoso.sharepoint.com/sites/project-x --id 1
 ```
 
-Remove the role definition from site  _https://contoso.sharepoint.com/sites/project-x_ with id _1_ and don't prompt for confirmation
+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
 ```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/spo/serviceprincipal/serviceprincipal-grant-add.md

@@ -17,15 +17,17 @@ m365 spo sp grant add
 ## Options
 
 `-r, --resource <resource>`
-: The name of the resource for which permissions should be granted
+: The name of the resource for which permissions should be granted.
 
 `-s, --scope <scope>`
-: The name of the permission that should be granted
+: The name of the permission that should be granted.
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
 !!! important
-    To use this command you have to have permissions to access the tenant admin site.
+    To use this command you must be a Global administrator.
 
 ## Examples
 
@@ -40,3 +42,40 @@ Grant the service principal permission to a custom API
 ```sh
 m365 spo serviceprincipal grant add --resource 'contoso-api' --scope 'user_impersonation'
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "ClientId": "6004a642-185c-479a-992a-15d1c23e2229",
+      "ConsentType": "AllPrincipals",
+      "IsDomainIsolated": false,
+      "ObjectId": "QqYEYFwYmkeZKhXRwj4iKRcAa6TiIbFNvGnKY1dqONY",
+      "PackageName": null,
+      "Resource": "Microsoft Graph",
+      "ResourceId": "a46b0017-21e2-4db1-bc69-ca63576a38d6",
+      "Scope": "Mail.Read"
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    ClientId        : 6004a642-185c-479a-992a-15d1c23e2229
+    ConsentType     : AllPrincipals
+    IsDomainIsolated: false
+    ObjectId        : QqYEYFwYmkeZKhXRwj4iKRcAa6TiIbFNvGnKY1dqONY
+    PackageName     : null
+    Resource        : Microsoft Graph
+    ResourceId      : a46b0017-21e2-4db1-bc69-ca63576a38d6
+    Scope           : Mail.Read
+    ```
+
+=== "CSV"
+
+    ```csv
+    ClientId,ConsentType,IsDomainIsolated,ObjectId,PackageName,Resource,ResourceId,Scope
+    6004a642-185c-479a-992a-15d1c23e2229,AllPrincipals,,QqYEYFwYmkeZKhXRwj4iKRcAa6TiIbFNvGnKY1dqONY,,Microsoft Graph,a46b0017-21e2-4db1-bc69-ca63576a38d6,Mail.Read
+    ```

package/docs/docs/cmd/spo/serviceprincipal/serviceprincipal-grant-list.md

@@ -18,8 +18,10 @@ m365 spo sp grant list
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
 !!! important
-    To use this command you have to have permissions to access the tenant admin site.
+    To use this command you must be a Global administrator.
 
 ## Examples
 
@@ -28,3 +30,35 @@ List all permissions granted to the service principal
 ```sh
 m365 spo serviceprincipal grant list
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "IsDomainIsolated": false,
+        "ObjectId": "QqYEYFwYmkeZKhXRwj4iKV5QwbD60RVCo6xeMUG407E",
+        "PackageName": null,
+        "Resource": "Windows Azure Active Directory",
+        "ResourceId": "b0c1505e-d1fa-4215-a3ac-5e3141b8d3b1",
+        "Scope": "User.Read"
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    IsDomainIsolated  ObjectId                                     PackageName  Resource                        ResourceId                            Scope
+    ----------------  -------------------------------------------  -----------  ------------------------------  ------------------------------------  --------------------------
+    false             QqYEYFwYmkeZKhXRwj4iKV5QwbD60RVCo6xeMUG407E  null         Windows Azure Active Directory  b0c1505e-d1fa-4215-a3ac-5e3141b8d3b1  User.Read
+    ```
+
+=== "CSV"
+
+    ```csv
+    IsDomainIsolated,ObjectId,PackageName,Resource,ResourceId,Scope
+    ,QqYEYFwYmkeZKhXRwj4iKV5QwbD60RVCo6xeMUG407E,,Windows Azure Active Directory,b0c1505e-d1fa-4215-a3ac-5e3141b8d3b1,User.Read
+    ```

package/docs/docs/cmd/spo/serviceprincipal/serviceprincipal-grant-revoke.md

@@ -16,22 +16,26 @@ m365 spo sp grant revoke
 
 ## Options
 
-`-i, --grantId <grantId>`
-: `ObjectId` of the permission grant to revoke
+`-i, --id <id>`
+: `ObjectId` of the permission grant to revoke.
 
 --8<-- "docs/cmd/_global.md"
 
-!!! important
-    To use this command you have to have permissions to access the tenant admin site.
-
 ## Remarks
 
+!!! important
+    To use this command you must be a Global administrator.
+
 The permission grant you want to revoke is denoted using its `ObjectId`. You can retrieve it using the [spo serviceprincipal grant list](./serviceprincipal-grant-list.md) command.
 
 ## Examples
 
-Revoke permission grant with ObjectId _50NAzUm3C0K9B6p8ORLtIsQccg4rMERGvFGRtBsk2fA_
+Revoke permission grant
 
 ```sh
-m365 spo serviceprincipal grant revoke --grantId 50NAzUm3C0K9B6p8ORLtIsQccg4rMERGvFGRtBsk2fA
+m365 spo serviceprincipal grant revoke --id 50NAzUm3C0K9B6p8ORLtIsQccg4rMERGvFGRtBsk2fA
 ```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/spo/serviceprincipal/serviceprincipal-permissionrequest-approve.md

@@ -16,22 +16,65 @@ m365 spo sp permissionrequest approve
 
 ## Options
 
-`-i, --requestId <requestId>`
-: ID of the permission request to approve
+`-i, --id <id>`
+: ID of the permission request to approve.
 
---8<-- "docs/cmd/_global.md"
+`--all`
+: approve all pending permission requests.
 
-!!! important
-    To use this command you have to have permissions to access the tenant admin site.
+`--resource [resource]`
+: The resource of the permissions requests to approve.
+
+--8<-- "docs/cmd/_global.md"
 
 ## Remarks
 
+!!! important
+    The admin role that's required to approve permissions depends on the API. To approve permissions to any of the third-party APIs registered in the tenant, the application administrator role is sufficient. To approve permissions for Microsoft Graph or any other Microsoft API, the Global Administrator role is required.
+
 The permission request you want to approve is denoted using its `ID`. You can retrieve it using the [spo serviceprincipal permissionrequest list](./serviceprincipal-permissionrequest-list.md) command.
 
 ## Examples
 
-Approve permission request with id _4dc4c043-25ee-40f2-81d3-b3bf63da7538_
+Approve permission request
 
 ```sh
-m365 spo serviceprincipal permissionrequest approve --requestId 4dc4c043-25ee-40f2-81d3-b3bf63da7538
+m365 spo serviceprincipal permissionrequest approve --id 4dc4c043-25ee-40f2-81d3-b3bf63da7538
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "ClientId": "6004a642-185c-479a-992a-15d1c23e2229",
+      "ConsentType": "AllPrincipals",
+      "IsDomainIsolated": false,
+      "ObjectId": "QqYEYFwYmkeZKhXRwj4iKRcAa6TiIbFNvGnKY1dqONY",
+      "PackageName": null,
+      "Resource": "Microsoft Graph",
+      "ResourceId": "a46b0017-21e2-4db1-bc69-ca63576a38d6",
+      "Scope": "Reports.Read.All"
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    ClientId        : 6004a642-185c-479a-992a-15d1c23e2229
+    ConsentType     : AllPrincipals
+    IsDomainIsolated: false
+    ObjectId        : QqYEYFwYmkeZKhXRwj4iKRcAa6TiIbFNvGnKY1dqONY
+    PackageName     : null
+    Resource        : Microsoft Graph
+    ResourceId      : a46b0017-21e2-4db1-bc69-ca63576a38d6
+    Scope           : Directory.ReadWrite.All
+    ```
+
+=== "CSV"
+
+    ```csv
+    ClientId,ConsentType,IsDomainIsolated,ObjectId,PackageName,Resource,ResourceId,Scope
+    6004a642-185c-479a-992a-15d1c23e2229,AllPrincipals,false,QqYEYFwYmkeZKhXRwj4iKRcAa6TiIbFNvGnKY1dqONY,null,Microsoft Graph,a46b0017-21e2-4db1-bc69-ca63576a38d6,Directory.ReadWrite.All
+    ```

package/docs/docs/cmd/spo/serviceprincipal/serviceprincipal-permissionrequest-deny.md

@@ -16,22 +16,26 @@ m365 spo sp permissionrequest deny
 
 ## Options
 
-`-i, --requestId <requestId>`
-: ID of the permission request to deny
+`-i, --id <id>`
+: ID of the permission request to deny.
 
 --8<-- "docs/cmd/_global.md"
 
-!!! important
-    To use this command you have to have permissions to access the tenant admin site.
-
 ## Remarks
 
+!!! important
+    The admin role that's required to deny permissions depends on the API. To approve permissions to any of the third-party APIs registered in the tenant, the application administrator role is sufficient. To approve permissions for Microsoft Graph or any other Microsoft API, the Global Administrator role is required.
+
 The permission request you want to approve is denoted using its `ID`. You can retrieve it using the [spo serviceprincipal permissionrequest list](./serviceprincipal-permissionrequest-list.md) command.
 
 ## Examples
 
-Deny permission request with id _4dc4c043-25ee-40f2-81d3-b3bf63da7538_
+Deny permission request
 
 ```sh
-m365 spo serviceprincipal permissionrequest deny --requestId 4dc4c043-25ee-40f2-81d3-b3bf63da7538
+m365 spo serviceprincipal permissionrequest deny --id 4dc4c043-25ee-40f2-81d3-b3bf63da7538
 ```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/spo/serviceprincipal/serviceprincipal-permissionrequest-list.md

@@ -18,8 +18,10 @@ m365 spo sp permissionrequest list
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
 !!! important
-    To use this command you have to have permissions to access the tenant admin site.
+    The admin role that's required to list permissions depends on the API. To approve permissions to any of the third-party APIs registered in the tenant, the application administrator role is sufficient. To approve permissions for Microsoft Graph or any other Microsoft API, the Global Administrator role is required.
 
 ## Examples
 
@@ -28,3 +30,33 @@ List all pending permission requests
 ```sh
 m365 spo serviceprincipal permissionrequest list
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "Id": "6eceed61-77e4-424d-ae1d-696a0de4d768",
+        "Resource": "Microsoft Graph",
+        "ResourceId": "Microsoft Graph",
+        "Scope": "Reports.Read.All"
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    Id                                    Resource         ResourceId       Scope
+    ------------------------------------  ---------------  ---------------  -----------------------
+    6eceed61-77e4-424d-ae1d-696a0de4d768  Microsoft Graph  Microsoft Graph  Reports.Read.All
+    ```
+
+=== "CSV"
+
+    ```csv
+    Id,Resource,ResourceId,Scope
+    6eceed61-77e4-424d-ae1d-696a0de4d768,Microsoft Graph,Microsoft Graph,Reports.Read.All
+    ```

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

@@ -17,18 +17,18 @@ m365 spo sp set
 ## Options
 
 `-e, --enabled <enabled>`
-: Set to `true` to enable the service principal or to `false` to disable it. Valid values are `true,false`
+: Set to `true` to enable the service principal or to `false` to disable it. Valid values are `true`, `false`.
 
 `--confirm`
-: Don't prompt for confirming enabling/disabling the service principal
+: Don't prompt for confirming enabling/disabling the service principal.
 
 --8<-- "docs/cmd/_global.md"
 
-!!! important
-    To use this command you have to have permissions to access the tenant admin site.
-
 ## Remarks
 
+!!! important
+    To use this command you must be a Global administrator.
+
 Using the `-e, --enabled` option you can specify whether the service principal should be enabled or disabled. Use `true` to enable the service principal and `false` to disable it.
 
 ## Examples
@@ -50,3 +50,37 @@ Enable the service principal without prompting for confirmation
 ```sh
 m365 spo serviceprincipal set --enabled true --confirm
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "AccountEnabled": true,
+      "AppId": "48535560-3cc0-442e-a1b4-94c084b3ff59",
+      "ReplyUrls": [
+        "https://fluidpreview.office.net/spfxsinglesignon",
+        "https://dev.fluidpreview.office.net/spfxsinglesignon",
+        "https://contoso.sharepoint.com/",
+        "https://contoso.sharepoint.com/_forms/spfxsinglesignon.aspx",
+        "https://contoso.sharepoint.com/_forms/spfxsinglesignon.aspx?redirect",
+        "https://contoso-admin.sharepoint.com/_forms/spfxsinglesignon.aspx"
+      ]
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    AccountEnabled: true
+    AppId         : 48535560-3cc0-442e-a1b4-94c084b3ff59
+    ReplyUrls     : ["https://fluidpreview.office.net/spfxsinglesignon","https://dev.fluidpreview.office.net/spfxsinglesignon","https://contoso.sharepoint.com/","https://contoso.sharepoint.com/_forms/spfxsinglesignon.aspx","https://contoso.sharepoint.com/_forms/spfxsinglesignon.aspx?redirect","https://contoso-admin.sharepoint.com/_forms/spfxsinglesignon.aspx"]
+    ```
+
+=== "CSV"
+
+    ```csv
+    AccountEnabled,AppId,ReplyUrls
+    1,48535560-3cc0-442e-a1b4-94c084b3ff59,"[""https://fluidpreview.office.net/spfxsinglesignon"",""https://dev.fluidpreview.office.net/spfxsinglesignon"",""https://contoso.sharepoint.com/"",""https://contoso.sharepoint.com/_forms/spfxsinglesignon.aspx"",""https://contoso.sharepoint.com/_forms/spfxsinglesignon.aspx?redirect"",""https://contoso-admin.sharepoint.com/_forms/spfxsinglesignon.aspx""]"
+    ```

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

@@ -46,9 +46,6 @@ m365 spo site add [options]
 `--siteDesignId [siteDesignId]`
 : Id of the custom site design to use to create the site. When creating a communication site, specify either `siteDesign` or `siteDesignId` (applies to type CommunicationSite)
 
-`--allowFileSharingForGuestUsers`
-: (deprecated. Use `shareByEmailEnabled` instead) Determines whether it's allowed to share file with guests (applies to type CommunicationSite)
-
 `--shareByEmailEnabled`
 : Determines whether it's allowed to share file with guests (applies to type CommunicationSite)
 
@@ -87,9 +84,9 @@ The value of the `--storageQuota` option must not exceed the company's available
 
 The value of the `--storageQuotaWarningLevel` option must not exceed the the value of the `--storageQuota` option.
 
-If you try to create a site with the same URL as a site that has been previously moved to the recycle bin, you will get an error. To avoid this error, you can use the `--removeDeletedSite` option. Prior to creating the site, the spo site classic add command will check if the site with the specified URL has been previously moved to the recycle bin and if so, will remove it. Because removing sites from the recycle bin might take a moment, it should be used in conjunction with the `--wait` option so that the new site is not created before the old site is fully removed.
+If you try to create a site with the same URL as a site that has been previously moved to the recycle bin, you will get an error. To avoid this error, you can use the `--removeDeletedSite` option. Prior to creating the site, the spo site add command will check if the site with the specified URL has been previously moved to the recycle bin and if so, will remove it. Because removing sites from the recycle bin might take a moment, it should be used in conjunction with the `--wait` option so that the new site is not created before the old site is fully removed.
 
-Deleting and creating classic site collections is by default asynchronous and depending on the current state of Office 365, might take up to few minutes. If you're building a script with steps that require the site to be fully provisioned, you should use the `--wait` flag. When using this flag, the spo site classic add command will keep running until it received confirmation from Office 365 that the site has been fully provisioned.
+Deleting and creating classic site collections is by default asynchronous and depending on the current state of Office 365, might take up to few minutes. If you're building a script with steps that require the site to be fully provisioned, you should use the `--wait` flag. When using this flag, the spo site add command will keep running until it received confirmation from Office 365 that the site has been fully provisioned.
 
 ## Remarks for modern sites
 

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

@@ -10,7 +10,7 @@ m365 spo site appcatalog add [options]
 
 ## Options
 
-`-u, --url <url>`
+`-u, --siteUrl <siteUrl>`
 : URL of the site collection where the app catalog should be added
 
 --8<-- "docs/cmd/_global.md"
@@ -23,7 +23,7 @@ m365 spo site appcatalog add [options]
 Add a site collection app catalog to the specified site
 
 ```sh
-m365 spo site appcatalog add --url https://contoso.sharepoint/sites/site
+m365 spo site appcatalog add --siteUrl https://contoso.sharepoint/sites/site
 ```
 
 ## More information