@pnp/cli-microsoft365 6.0.0-beta.e7c60af → 6.0.0-beta.eb11cbe

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

@@ -19,12 +19,17 @@ m365 spo folder get [options]
 `-i, --id [id]`
 : The UniqueId (GUID) of the folder to retrieve. Specify either `url` or `id` but not both
 
+`--withPermissions`
+: Set if you want to return associated roles and permissions of the folder. 
+
 --8<-- "docs/cmd/_global.md"
 
 ## Remarks
 
 If no folder exists at the specified URL, you will get a `Please check the folder URL. Folder might not exist on the specified URL` error.
 
+If root level folder is passed, you will get a `Please ensure the specified folder URL or folder Id does not refer to a root folder. Use \'spo list get\' with withPermissions instead' error.` Please use the command 'spo list get'.
+
 ## Examples
 
 Get folder properties for folder with server-relative url _'/Shared Documents'_ located in site _https://contoso.sharepoint.com/sites/project-x_
@@ -38,3 +43,9 @@ Get folder properties for folder with id (UniqueId) _b2307a39-e878-458b-bc90-03b
 ```sh
 m365 spo folder get --webUrl https://contoso.sharepoint.com/sites/project-x --id "b2307a39-e878-458b-bc90-03bc578531d6"
 ```
+
+Get folder properties for folder with server-relative url _'/Shared Documents/Test1'_ located in site _https://contoso.sharepoint.com/sites/test
+
+```sh
+m365 spo folder get --webUrl https://contoso.sharepoint.com/sites/test --url "Shared Documents/Test1" --withPermissions
+```

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

@@ -16,6 +16,9 @@ m365 spo folder list [options]
 `-p, --parentFolderUrl <parentFolderUrl>`
 : Site-relative URL of the parent folder
 
+`-r, --recursive`
+: Set to retrieve nested folders
+
 --8<-- "docs/cmd/_global.md"
 
 ## Examples
@@ -25,3 +28,45 @@ Gets list of folders under a parent folder with site-relative url _/Shared Docum
 ```sh
 m365 spo folder list --webUrl https://contoso.sharepoint.com/sites/project-x --parentFolderUrl '/Shared Documents'
 ```
+
+Gets recursive list of folders under a specific folder on a specific site
+
+```sh
+m365 spo folder list --webUrl https://contoso.sharepoint.com/sites/project-x --parentFolderUrl '/Shared Documents' --recursive
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [  
+      {
+        "Exists": true,
+        "IsWOPIEnabled": false,
+        "ItemCount": 9,
+        "Name": "Folder A",
+        "ProgID": null,
+        "ServerRelativeUrl": "/Shared Documents/Folder A",
+        "TimeCreated": "2022-04-26T12:30:56Z",
+        "TimeLastModified": "2022-04-26T12:50:14Z",
+        "UniqueId": "20523746-971b-4488-aa6d-b45d645f61c5",
+        "WelcomePage": ""
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    Name     ServerRelativeUrl
+    -------  -------------------------
+    Folder A /Shared Documents/Folder A
+    ```
+
+=== "CSV"
+
+    ```csv
+    Name,ServerRelativeUrl
+    Folder A,/Shared Documents/Folder A
+    ```

package/docs/docs/cmd/spo/folder/folder-roleassignment-add.md

@@ -0,0 +1,59 @@
+# spo folder roleassignment add
+
+Adds a role assignment from the specified folder.
+
+## Usage
+
+```sh
+m365 spo folder roleassignment add [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: The URL of the site where the folder is located.
+
+`-f, --folderUrl <folderUrl>`
+: The server- or site-relative URL of the folder.
+
+`--principalId [principalId]`
+: The SharePoint principal id. It may be either an user id or group id for which the role assignment will be addd. Specify either upn, groupName or principalId but not multiple.
+
+`--upn [upn]`
+: The upn/email of the user. Specify either upn, groupName or principalId but not multiple.
+
+`--groupName [groupName]`
+: The Azure AD or SharePoint group name. Specify either upn, groupName or principalId but not multiple.
+
+`--roleDefinitionId [roleDefinitionId]`
+: ID of the role definition. Specify either roleDefinitionId or roleDefinitionName but not both.
+
+`--roleDefinitionName [roleDefinitionName]`
+: The name of the role definition. E.g. 'Contribute', 'Read'. Specify either roleDefinitionId or roleDefinitionName but not both
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Add the role assignment to the specified folder based on the group name and role definition name.
+
+```sh
+m365 spo folder roleassignment add --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --folderUrl  "/Shared Documents/FolderPermission" --groupName "saleGroup" --roleDefinitionName "Edit"
+```
+
+Add the role assignment to the specified folder based on the principal Id and role definition id
+
+```sh
+m365 spo folder roleassignment add --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --folderUrl "/Shared Documents/FolderPermission" --principalId 2 --roleDefinitionId 1073741827 
+```
+
+Add the role assignment to the specified folder based on the upn and role definition name
+
+```sh
+m365 spo folder roleassignment add --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --folderUrl "/Shared Documents/FolderPermission" --upn "test@contoso.onmicrosoft.com" --roleDefinitionName "Edit"
+```
+Add the role assignment to the root folder based on the upn and role definition name
+
+```sh
+m365 spo folder roleassignment add --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --folderUrl "/Shared Documents" --upn "test@contoso.onmicrosoft.com" --roleDefinitionName "Edit"
+```

package/docs/docs/cmd/spo/folder/folder-roleinheritance-break.md

@@ -37,3 +37,9 @@ Break the inheritance of a folder with a specified server-relative URL. It will
 ```sh
 m365 spo folder roleinheritance break --webUrl "https://contoso.sharepoint.com/sites/project-x" --folderUrl "/sites/project-x/Shared Documents/TestFolder" --clearExistingPermissions --confirm
 ```
+
+Break the inheritance of the specified root folder for the library with a specified server-relative URL. It will clear the existing permissions of the root folder. It will **not** prompt for confirmation before breaking the inheritance.
+
+```sh
+m365 spo folder roleinheritance break --webUrl "https://contoso.sharepoint.com/sites/project-x" --folderUrl "/sites/project-x/Shared Documents" --clearExistingPermissions --confirm
+```

package/docs/docs/cmd/spo/folder/folder-roleinheritance-reset.md

@@ -34,3 +34,9 @@ Reset inheritance of folder with server-relative url _/sites/project-x/Shared Do
 ```sh
 m365 spo folder roleinheritance reset --webUrl "https://contoso.sharepoint.com/sites/project-x" --folderUrl "/sites/project-x/Shared Documents/TestFolder" --confirm
 ```
+
+Reset inheritance of the specified root folder for the library with the server-relative url _/sites/project-x/Shared Documents located in site _https://contoso.sharepoint.com/sites/project-x_. It will **not** prompt for confirmation before resetting.
+
+```sh
+m365 spo folder roleinheritance reset --webUrl "https://contoso.sharepoint.com/sites/project-x" --folderUrl "/sites/project-x/Shared Documents" --confirm
+```

package/docs/docs/cmd/spo/group/{group-user-add.md → group-member-add.md}

@@ -1,11 +1,11 @@
-# spo group user add
+# spo group member add
 
-Add a user or multiple users to SharePoint Group
+Add members to a SharePoint Group
 
 ## Usage
 
 ```sh
-m365 spo group user add [options]
+m365 spo group member add [options]
 ```
 
 ## Options
@@ -14,16 +14,16 @@ m365 spo group user add [options]
 : URL of the site where the SharePoint group is available
 
 `--groupId [groupId]`
-: Id of the SharePoint Group to which 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 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 needs to be added, they have to be comma separated (ex. megan.bowen@contoso.com,alex.wilber@contoso.com), specify either `userName` or `email`
+: User's UPN (user principal name, eg. megan.bowen@contoso.com). If multiple users need to be added, they have to be comma separated (ex. megan.bowen@contoso.com,alex.wilber@contoso.com), specify either `userName` or `email`
 
 `--email [email]`
-: User's email (eg. megan.bowen@contoso.com). If multiple users needs to be added, they have to be comma separated (ex. megan.bowen@contoso.com,alex.wilber@contoso.com), specify either `userName` or `email`
+: User's email (eg. megan.bowen@contoso.com). If multiple users need to be added, they have to be comma separated (ex. megan.bowen@contoso.com,alex.wilber@contoso.com), specify either `userName` or `email`
 
 --8<-- "docs/cmd/_global.md"
 
@@ -36,23 +36,23 @@ For the `--userName` or `--email` options you can specify multiple values by sep
 Add a user with name _Alex.Wilber@contoso.com_ to the SharePoint group with id _5_ available on the web _https://contoso.sharepoint.com/sites/SiteA_
 
 ```sh
-m365 spo group user 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 --userName "Alex.Wilber@contoso.com"
 ```
 
 Add multiple users by name to the SharePoint group with id _5_ available on the web _https://contoso.sharepoint.com/sites/SiteA_
 
 ```sh
-m365 spo group user 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 --userName "Alex.Wilber@contoso.com, Adele.Vance@contoso.com"
 ```
 
 Add a user with email _Alex.Wilber@contoso.com_ to the SharePoint group with name _Contoso Site Owners_ available on the web _https://contoso.sharepoint.com/sites/SiteA_
 
 ```sh
-m365 spo group user 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" --email "Alex.Wilber@contoso.com"
 ```
 
 Add multiple users by email to the SharePoint group with name _Contoso Site Owners_ available on the web _https://contoso.sharepoint.com/sites/SiteA_
 
 ```sh
-m365 spo group user 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" --email "Alex.Wilber@contoso.com, Adele.Vance@contoso.com"
 ```

package/docs/docs/cmd/spo/group/{group-user-list.md → group-member-list.md}

@@ -1,11 +1,11 @@
-# spo group user list
+# spo group member list
 
-List members of a SharePoint Group
+List the members of a SharePoint Group
 
 ## Usage
 
 ```sh
-m365 spo group user list [options]
+m365 spo group member list [options]
 ```
 
 ## Options
@@ -26,11 +26,11 @@ m365 spo group user list [options]
 List the members of the group with ID _5_ for web _https://contoso.sharepoint.com/sites/SiteA_
 
 ```sh
-m365 spo group user list --webUrl https://contoso.sharepoint.com/sites/SiteA --groupId 5
+m365 spo group member list --webUrl https://contoso.sharepoint.com/sites/SiteA --groupId 5
 ```
 
 List the members of the group with name _Contoso Site Members_ for web _https://contoso.sharepoint.com/sites/SiteA_
 
 ```sh
-m365 spo group user list --webUrl https://contoso.sharepoint.com/sites/SiteA --groupName "Contoso Site Members"
+m365 spo group member list --webUrl https://contoso.sharepoint.com/sites/SiteA --groupName "Contoso Site Members"
 ```

package/docs/docs/cmd/spo/group/group-member-remove.md

@@ -0,0 +1,39 @@
+# spo group member remove
+
+Removes the specified member from a SharePoint group
+
+## Usage
+
+```sh
+m365 spo group member remove [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: URL of the site where the SharePoint group is available
+
+`--groupId [groupId]`
+: Id of the SharePoint group from which the user has to be removed. Specify either `groupName` or `groupId`, but not both
+
+`--groupName  [groupName]`
+: Name of the SharePoint group from which user has to be removed. Specify either `groupName` or `groupId`, but not both
+
+`--userName <userName>`
+: The UPN of the user that needs to be removed (user principal name, eg. megan.bowen@contoso.com)
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Remove a user from SharePoint group with id _5_ available on the web _https://contoso.sharepoint.com/sites/SiteA_
+
+```sh
+m365 spo group member remove --webUrl https://contoso.sharepoint.com/sites/SiteA --groupId 5 --userName "Alex.Wilber@contoso.com"
+```
+
+Remove a user from SharePoint group with Name _Site A Visitors_ available on the web _https://contoso.sharepoint.com/sites/SiteA_
+
+```sh
+m365 spo group member remove --webUrl https://contoso.sharepoint.com/sites/SiteA --groupName "Site A Visitors" --userName "Alex.Wilber@contoso.com"
+```

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

@@ -20,6 +20,37 @@ Get information about the Home Site
 m365 spo homesite get
 ```
 
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "SiteId": "af80c11f-0138-4d72-bb37-514542c3aabb",
+      "WebId": "6f90666d-b0e7-40c3-991f-4ab051d00a70",
+      "LogoUrl": "https://contoso.sharepoint.com/sites/intra/siteassets/work.png",
+      "Title": "Intranet",
+      "Url": "https://contoso.sharepoint.com/sites/intra"
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    LogoUrl: https://contoso.sharepoint.com/sites/intra/siteassets/work.png
+    SiteId : af80c11f-0138-4d72-bb37-514542c3aabb
+    Title  : Intranet
+    Url    : https://contoso.sharepoint.com/sites/intra
+    WebId  : 6f90666d-b0e7-40c3-991f-4ab051d00a70
+    ```
+
+=== "CSV"
+
+    ```csv
+    SiteId,WebId,LogoUrl,Title,Url
+    af80c11f-0138-4d72-bb37-514542c3aabb,6f90666d-b0e7-40c3-991f-4ab051d00a70,https://contoso.sharepoint.com/sites/intra/siteassets/work.png,Intranet,https://contoso.sharepoint.com/sites/intra
+    ```
+
 ## More information
 
 - SharePoint home sites: a landing for your organization on the intelligent intranet: [https://techcommunity.microsoft.com/t5/Microsoft-SharePoint-Blog/SharePoint-home-sites-a-landing-for-your-organization-on-the/ba-p/621933](https://techcommunity.microsoft.com/t5/Microsoft-SharePoint-Blog/SharePoint-home-sites-a-landing-for-your-organization-on-the/ba-p/621933)

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

@@ -26,6 +26,26 @@ Removes the current Home Site without confirmation
 m365 spo homesite remove --confirm
 ```
 
+## Response
+
+=== "JSON"
+
+    ```json
+    "https://contoso.sharepoint.com has been removed as a Home site. It may take some time for the change to apply. Check aka.ms/homesites for details."
+    ```
+
+=== "Text"
+
+    ```text
+    https://contoso.sharepoint.com has been removed as a Home site. It may take some time for the change to apply. Check aka.ms/homesites for details.
+    ```
+
+=== "CSV"
+
+    ```csv
+    https://contoso.sharepoint.com has been removed as a Home site. It may take some time for the change to apply. Check aka.ms/homesites for details.
+    ```
+
 ## More information
 
 - SharePoint home sites, a landing for your organization on the intelligent intranet: [https://techcommunity.microsoft.com/t5/Microsoft-SharePoint-Blog/SharePoint-home-sites-a-landing-for-your-organization-on-the/ba-p/621933](https://techcommunity.microsoft.com/t5/Microsoft-SharePoint-Blog/SharePoint-home-sites-a-landing-for-your-organization-on-the/ba-p/621933)

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

@@ -26,6 +26,26 @@ Set the specified site as the Home Site
 m365 spo homesite set --siteUrl https://contoso.sharepoint.com/sites/comms
 ```
 
+## Response
+
+=== "JSON"
+
+    ```json
+    "The Home site has been set to https://contoso.sharepoint.com. It may take some time for the change to apply. Check aka.ms/homesites for details."
+    ```
+
+=== "Text"
+
+    ```text
+    The Home site has been set to https://contoso.sharepoint.com. It may take some time for the change to apply. Check aka.ms/homesites for details.
+    ```
+
+=== "CSV"
+
+    ```csv
+    The Home site has been set to https://contoso.sharepoint.com. It may take some time for the change to apply. Check aka.ms/homesites for details.
+    ```
+
 ## More information
 
 - SharePoint home sites: a landing for your organization on the intelligent intranet: [https://techcommunity.microsoft.com/t5/Microsoft-SharePoint-Blog/SharePoint-home-sites-a-landing-for-your-organization-on-the/ba-p/621933](https://techcommunity.microsoft.com/t5/Microsoft-SharePoint-Blog/SharePoint-home-sites-a-landing-for-your-organization-on-the/ba-p/621933)

package/docs/docs/cmd/spo/hubsite/hubsite-connect.md

@@ -1,6 +1,6 @@
 # spo hubsite connect
 
-Connects the specified site collection to the given hub site
+Connect a hub site to a parent hub site
 
 ## Usage
 
@@ -10,31 +10,53 @@ m365 spo hubsite connect [options]
 
 ## Options
 
-`-u, --siteUrl <siteUrl>`
-: The URL of the site collection to connect to the hub site
+`-i, --id [id]`
+: ID of the hub site. Specify either `id`, `title` or `url` but not multiple.
 
-`-i, --id <id>`
-: The ID of the hub site to which to connect the site collection
+`-t, --title [title]`
+: Title of the hub site. Specify either `id`, `title` or `url` but not multiple.
+
+`-u, --url [url]`
+: Absolute or server-relative URL of the hub site. Specify either `id`, `title` or `url` but not multiple.
+
+`--parentId [parentId]`
+: ID of the parent hub site. Specify either `parentId`, `parentTitle` or `parentUrl` but not multiple.
+
+`--parentTitle [parentTitle]`
+: Title of the parent hub site. Specify either `parentId`, `parentTitle` or `parentUrl` but not multiple.
+
+`--parentUrl [parentUrl]`
+: Absolute or server-relative URL of the parent hub site. Specify either `parentId`, `parentTitle` or `parentUrl` but not multiple.
 
 --8<-- "docs/cmd/_global.md"
 
 ## Remarks
 
-!!! attention
-    This command is based on a SharePoint API that is currently in preview and is subject to change once the API reached general availability.
+!!! important
+    To use this command you must be a Global or SharePoint administrator.
 
-If the specified site collection is already connected to a hub site, it will be disconnected and connected to the newly specified hub site.
-
-If the specified `id` doesn't point to a valid hub site, you will get a `ResourceNotFoundException` error.
+To connect a regular site to a hub site, use command [spo site hubsite connect](../site/site-hubsite-connect.md).
 
 ## Examples
 
-Connect the site collection with URL _https://contoso.sharepoint.com/sites/contoso-sales_ to the hub site with ID _255a50b2-527f-4413-8485-57f4c17a24d1_
+Connect a specific hub site to specific parent hub site by ID
+
+```sh
+m365 spo hubsite connect --id 2c1ba4c4-cd9b-4417-832f-92a34bc34b2a --parentId 637ed2ea-b65b-4a4b-a3d7-ad86953224a4
+```
+
+Connect a specific hub site to specific parent hub site by URL
+
+```sh
+m365 spo hubsite connect --url https://contoso.sharepoint.com/sites/project-x --parentUrl https://contoso.sharepoint.com/sites/projects
+```
+
+Connect a specific hub site with title to a parent hub site with ID
 
 ```sh
-m365 spo hubsite connect --siteUrl https://contoso.sharepoint.com/sites/contoso-sales --id 255a50b2-527f-4413-8485-57f4c17a24d1
+m365 spo hubsite connect --title "My hub site" --parentId 637ed2ea-b65b-4a4b-a3d7-ad86953224a4
 ```
 
-## More information
+## Response
 
-- SharePoint hub sites new in Microsoft 365: [https://techcommunity.microsoft.com/t5/SharePoint-Blog/SharePoint-hub-sites-new-in-Office-365/ba-p/109547](https://techcommunity.microsoft.com/t5/SharePoint-Blog/SharePoint-hub-sites-new-in-Office-365/ba-p/109547)
+The command won't return a response on success.

package/docs/docs/cmd/spo/hubsite/hubsite-data-get.md

@@ -20,9 +20,6 @@ m365 spo hubsite data get [options]
 
 ## Remarks
 
-!!! attention
-    This command is based on a SharePoint API that is currently in preview and is subject to change once the API reached general availability.
-
 By default, the hub site data is returned from the server's cache. To refresh the data with the latest updates, use the `-f, --forceRefresh` option. Use this option, if you just made changes and need to see them right
 away.
 
@@ -36,6 +33,63 @@ Get information about the hub site data for a site with URL https://contoso.shar
 m365 spo hubsite data get --webUrl https://contoso.sharepoint.com/sites/project-x
 ```
 
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "headerEmphasis": "None",
+      "themeKey": "7EDE94FF",
+      "name": "Intranet",
+      "url": "https://contoso.sharepoint.com/sites/intra",
+      "logoUrl": "https://contoso.sharepoint.com/sites/intra/SiteAssets/work.png",
+      "logoFileHash": 637696294610000000,
+      "usesMetadataNavigation": false,
+      "megaMenuEnabled": true,
+      "navigation": [],
+      "isNavAudienceTargeted": false,
+      "siteDesignId": "184644fb-90ed-4841-a7ad-6930cf819060",
+      "requiresJoinApproval": false,
+      "hideNameInNavigation": false,
+      "parentHubSiteId": "1e1232eb-1a78-4726-8bb9-56af3640228d",
+      "relatedHubSiteIds": [
+        "af80c11f-0138-4d72-bb37-514542c3aabb"
+      ],
+      "tenantInstanceId": "4d128b52-7228-46b5-8765-5b338476054d",
+      "isSameTenantInstance": true
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    headerEmphasis        : None
+    hideNameInNavigation  : false
+    isNavAudienceTargeted : false
+    isSameTenantInstance  : true
+    logoFileHash          : 637696294610000000
+    logoUrl               : https://contoso.sharepoint.com/sites/intra/SiteAssets/work.png
+    megaMenuEnabled       : true
+    name                  : Intranet
+    navigation            : []
+    parentHubSiteId       : 1e1232eb-1a78-4726-8bb9-56af3640228d
+    relatedHubSiteIds     : ["af80c11f-0138-4d72-bb37-514542c3aabb"]
+    requiresJoinApproval  : false
+    siteDesignId          : 184644fb-90ed-4841-a7ad-6930cf819060
+    tenantInstanceId      : 4d128b52-7228-46b5-8765-5b338476054d
+    themeKey              : 7EDE94FF
+    url                   : https://contoso.sharepoint.com/sites/intra
+    usesMetadataNavigation: false
+    ```
+
+=== "CSV"
+
+    ```csv
+    headerEmphasis,themeKey,name,url,logoUrl,logoFileHash,usesMetadataNavigation,megaMenuEnabled,navigation,isNavAudienceTargeted,siteDesignId,requiresJoinApproval,hideNameInNavigation,parentHubSiteId,relatedHubSiteIds,tenantInstanceId,isSameTenantInstance
+    None,7EDE94FF,Intranet,https://contoso.sharepoint.com/sites/intra,https://contoso.sharepoint.com/sites/intra/SiteAssets/work.png,637696294610000000,false,1,[],false,184644fb-90ed-4841-a7ad-6930cf819060,,,1e1232eb-1a78-4726-8bb9-56af3640228d,"[""af80c11f-0138-4d72-bb37-514542c3aabb""]",4d128b52-7228-46b5-8765-5b338476054d,1
+    ```
+
 ## More information
 
 - SharePoint hub sites new in Microsoft 365: [https://techcommunity.microsoft.com/t5/SharePoint-Blog/SharePoint-hub-sites-new-in-Office-365/ba-p/109547](https://techcommunity.microsoft.com/t5/SharePoint-Blog/SharePoint-hub-sites-new-in-Office-365/ba-p/109547)

package/docs/docs/cmd/spo/hubsite/hubsite-disconnect.md

@@ -1,6 +1,6 @@
 # spo hubsite disconnect
 
-Disconnects the specified site collection from its hub site
+Disconnect a hub site from its parent hub site
 
 ## Usage
 
@@ -10,33 +10,49 @@ m365 spo hubsite disconnect [options]
 
 ## Options
 
-`-u, --siteUrl <siteUrl>`
-: URL of the site collection to disconnect from its hub site
+`-i, --id [id]`
+: ID of the hub site. Specify either `id`, `title` or `url` but not multiple.
+
+`-t, --title [title]`
+: Title of the hub site. Specify either `id`, `title` or `url` but not multiple.
+
+`-u, --url [url]`
+: Absolute or server-relative URL of the hub site. Specify either `id`, `title` or `url` but not multiple.
 
 `--confirm`
-: Don't prompt for confirming disconnecting from the hub site
+: Don't prompt for confirmation.
 
 --8<-- "docs/cmd/_global.md"
 
 ## Remarks
 
-!!! attention
-    This command is based on a SharePoint API that is currently in preview and is subject to change once the API reached general availability.
+!!! important
+    To use this command you must be a Global or SharePoint administrator.
+
+To disconnect a regular site from a hub site, use command [spo site hubsite disconnect](../site/site-hubsite-disconnect.md).
+
+If the specified id doesn't point to a valid hub site, you will get a ResourceNotFoundException error.
 
 ## Examples
 
-Disconnect the site collection with URL _https://contoso.sharepoint.com/sites/sales_ from its hub site. Will prompt for confirmation before disconnecting from the hub site.
+Disconnect a specific hub site with id from its parent hub site
+
+```sh
+m365 spo hubsite disconnect --id 2c1ba4c4-cd9b-4417-832f-92a34bc34b2a
+```
+
+Disconnect a specific hub site with url from its parent hub site
 
 ```sh
-m365 spo hubsite disconnect --siteUrl https://contoso.sharepoint.com/sites/sales
+m365 spo hubsite disconnect --url https://contoso.sharepoint.com/sites/project-x
 ```
 
-Disconnect the site collection with URL _https://contoso.sharepoint.com/sites/sales_ from its hub site without prompting for confirmation
+Disconnect a specific hub site with title from its parent hub site
 
 ```sh
-m365 spo hubsite disconnect --siteUrl https://contoso.sharepoint.com/sites/sales --confirm
+m365 spo hubsite disconnect --title "My hub site"
 ```
 
-## More information
+## Response
 
-- SharePoint hub sites new in Microsoft 365: [https://techcommunity.microsoft.com/t5/SharePoint-Blog/SharePoint-hub-sites-new-in-Office-365/ba-p/109547](https://techcommunity.microsoft.com/t5/SharePoint-Blog/SharePoint-hub-sites-new-in-Office-365/ba-p/109547)
+The command won't return a response on success.