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

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

@@ -0,0 +1,110 @@
+# spo group member add
+
+Add members to a SharePoint Group
+
+## Usage
+
+```sh
+m365 spo group member add [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: URL of the site where the SharePoint group is available
+
+`--groupId [groupId]`
+: 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 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 need to be added, they have to be comma separated (ex. megan.bowen@contoso.com,alex.wilber@contoso.com), specify either `userName`, `email` or `userId`
+
+`--email [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`, `email` or `userId`
+
+`--userId [userId]`
+: The user Id of the user to add as a member. (Id of the site user, for example: 14) If multiple users need to be added, the Id's have to be comma separated. Specify either `userName`, `email` or `userId`
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+For the `--userName` or `--email` options you can specify multiple values by separating them with a comma. If one of the specified entries is not valid, the command will fail with an error message showing the list invalid values.
+
+## Examples
+
+Add a user with the userName parameter to a SharePoint group with the groupId parameter
+
+```sh
+m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --groupId 5 --userName "Alex.Wilber@contoso.com"
+```
+
+Add multiple users with the userName parameter to a SharePoint group with the groupId parameter
+
+```sh
+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 the email parameter to a SharePoint group with the groupName parameter
+
+```sh
+m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --groupName "Contoso Site Owners" --email "Alex.Wilber@contoso.com"
+```
+
+Add multiple users with the email parameter to a SharePoint group with the groupName parameter
+
+```sh
+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"
+```
+
+Add a user with the userId parameter to a SharePoint group with the groupId parameter
+
+```sh
+m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --groupId 5 --userId 5
+```
+
+Add multiple users with the userId parameter to a SharePoint group with the groupId parameter
+
+```sh
+m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --groupId 5 --userId "5,12"
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "AllowedRoles": [
+          0
+        ],
+        "CurrentRole": 0,
+        "DisplayName": "John Doe",
+        "Email": "john.doe@contoso.onmicrosoft.com",
+        "InvitationLink": null,
+        "IsUserKnown": true,
+        "Message": null,
+        "Status": true,
+        "User": "i:0#.f|membership|john.doe@contoso.onmicrosoft.com"
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    DisplayName  Email
+    -----------  ---------------------------------
+    John Doe     john.doe@contoso.onmicrosoft.com
+    ```
+
+=== "CSV"
+
+    ```csv
+    DisplayName,Email
+    John Doe,john.doe@contoso.onmicrosoft.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,55 @@
+# 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 (user principal name, eg. megan.bowen@contoso.com) of the user that needs to be removed. Specify either `userName`, `email`, or `userId`, but not multiple.
+
+`--email [email]`
+: The email of the user to remove as a member. Specify either `userName`, `email`, or `userId`, but not multiple.
+
+`--userId [userId]`
+: The user Id (Id of the site user, eg. 14) of the user to remove as a member. Specify either `userName`, `email`, or `userId`, but not multiple.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Remove a user from a SharePoint group by userName.
+
+```sh
+m365 spo group member remove --webUrl https://contoso.sharepoint.com/sites/SiteA --groupId 5 --userName "Alex.Wilber@contoso.com"
+```
+
+Remove a user from a SharePoint group by email.
+
+```sh
+m365 spo group member remove --webUrl https://contoso.sharepoint.com/sites/SiteA --groupName "Site A Visitors" --email "Alex.Wilber@contoso.com"
+```
+
+Remove a user from a SharePoint group by id.
+
+```sh
+m365 spo group member remove --webUrl https://contoso.sharepoint.com/sites/SiteA --groupName "Site A Visitors" --userId 14
+```
+
+## Response
+
+The command won't return a response on success.

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, --url <url>`
-: 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, --hubSiteId <hubSiteId>`
-: 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 `hubSiteId` 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 --url https://contoso.sharepoint.com/sites/contoso-sales --hubSiteId 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 specifies 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, --url <url>`
-: 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 --url 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 --url 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.

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

@@ -11,13 +11,13 @@ m365 spo hubsite get [options]
 ## Options
 
 `-i, --id [id]`
-: ID of the hubsite. Specify either `id`, `title` or `url` but not multiple.
+: ID of the hub site. Specify either `id`, `title` or `url` but not multiple.
 
 `-t, --title [title]`
-: Title of the hubsite. Specify either `id`, `title` or `url` but not multiple.
+: Title of the hub site. Specify either `id`, `title` or `url` but not multiple.
 
 `-u, --url [url]`
-: URL of the hubsite. Specify either `id`, `title` or `url` but not multiple.
+: URL of the hub site. Specify either `id`, `title` or `url` but not multiple.
 
 `--includeAssociatedSites`
 : Include the associated sites in the result (only in JSON output)
@@ -62,6 +62,95 @@ Get information about the hub site with URL _https://contoso.sharepoint.com/site
 m365 spo hubsite get --url "https://contoso.sharepoint.com/sites/HubSite"
 ```
 
+## Response
+
+### Standard response
+
+=== "JSON"
+
+    ```json
+    {
+      "Description": "Intranet Hub Site",
+      "EnablePermissionsSync": false,
+      "EnforcedECTs": null,
+      "EnforcedECTsVersion": 0,
+      "HideNameInNavigation": false,
+      "ID": "af80c11f-0138-4d72-bb37-514542c3aabb",
+      "LogoUrl": "https://contoso.sharepoint.com/sites/intra/SiteAssets/work.png",
+      "ParentHubSiteId": "ec78f3aa-5a74-4f16-be49-3396df045f34",
+      "PermissionsSyncTag": 0,
+      "RequiresJoinApproval": false,
+      "SiteDesignId": "184644fb-90ed-4841-a7ad-6930cf819060",
+      "SiteId": "af80c11f-0138-4d72-bb37-514542c3aabb",
+      "SiteUrl": "https://contoso.sharepoint.com/sites/intra",
+      "Targets": null,
+      "TenantInstanceId": "5d128b52-7228-46b5-8765-5b338476054d",
+      "Title": "Intranet"
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    Description          : Intranet Hub Site
+    EnablePermissionsSync: false
+    EnforcedECTs         : null
+    EnforcedECTsVersion  : 0
+    HideNameInNavigation : false
+    ID                   : af80c11f-0138-4d72-bb37-514542c3aabb
+    LogoUrl              : https://contoso.sharepoint.com/sites/intra/SiteAssets/work.png
+    ParentHubSiteId      : ec78f3aa-5a74-4f16-be49-3396df045f34
+    PermissionsSyncTag   : 0
+    RequiresJoinApproval : false
+    SiteDesignId         : 184644fb-90ed-4841-a7ad-6930cf819060
+    SiteId               : af80c11f-0138-4d72-bb37-514542c3aabb
+    SiteUrl              : https://contoso.sharepoint.com/sites/intra
+    Targets              : null
+    TenantInstanceId     : 5d128b52-7228-46b5-8765-5b338476054d
+    Title                : Intranet
+    ```
+
+=== "CSV"
+
+    ```csv
+    Description,EnablePermissionsSync,EnforcedECTs,EnforcedECTsVersion,HideNameInNavigation,ID,LogoUrl,ParentHubSiteId,PermissionsSyncTag,RequiresJoinApproval,SiteDesignId,SiteId,SiteUrl,Targets,TenantInstanceId,Title
+    Intranet Hub Site,false,,0,false,af80c11f-0138-4d72-bb37-514542c3aabb,https://contoso.sharepoint.com/sites/intra/SiteAssets/work.png,ec78f3aa-5a74-4f16-be49-3396df045f34,0,false,184644fb-90ed-4841-a7ad-6930cf819060,af80c11f-0138-4d72-bb37-514542c3aabb,https://contoso.sharepoint.com/sites/intra,,5d128b52-7228-46b5-8765-5b338476054d,Intranet
+    ```
+
+### `includeAssociatedSites` response
+
+When we make use of the option `includeAssociatedSites` the response will differ. This command can only be executed using --output json or an error will be thrown.
+
+=== "JSON"
+
+    ```json
+    {
+      "Description": "Intranet Hub Site",
+      "EnablePermissionsSync": false,
+      "EnforcedECTs": null,
+      "EnforcedECTsVersion": 0,
+      "HideNameInNavigation": false,
+      "ID": "af80c11f-0138-4d72-bb37-514542c3aabb",
+      "LogoUrl": "https://contoso.sharepoint.com/sites/intra/SiteAssets/work.png",
+      "ParentHubSiteId": "ec78f3aa-5a74-4f16-be49-3396df045f34",
+      "PermissionsSyncTag": 0,
+      "RequiresJoinApproval": false,
+      "SiteDesignId": "184644fb-90ed-4841-a7ad-6930cf819060",
+      "SiteId": "af80c11f-0138-4d72-bb37-514542c3aabb",
+      "SiteUrl": "https://contoso.sharepoint.com/sites/intra",
+      "Targets": null,
+      "TenantInstanceId": "5d128b52-7228-46b5-8765-5b338476054d",
+      "Title": "Intranet",
+      "AssociatedSites": [
+        {
+          "Title": "About Us",
+          "SiteId": "1e1232eb-1a78-4726-8bb9-56af3640228d",
+          "SiteUrl": "https://contoso.sharepoint.com/sites/about-us"
+        }
+      ]
+    }
+    ```
+
 ## 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)