@pnp/cli-microsoft365 6.3.0-beta.e0fa4e0 → 6.3.0-beta.e40d7b4

package/docs/docs/cmd/aad/user/user-add.md

@@ -0,0 +1,168 @@
+# aad user add
+
+Creates a new user
+
+## Usage
+
+```sh
+m365 aad user add [options]
+```
+
+## Options
+
+`--displayName <displayName>`
+: The name to display in the address book for the user.
+
+`--userName <userName>`
+: The user principal name (someuser@contoso.com).
+
+`--accountEnabled [accountEnabled]`
+: Whether the account is enabled. Possible values: `true`, `false`. Default value is `true`.
+
+`--mailNickname [mailNickname]`
+: The mail alias for the user. By default this value will be extracted from `userName`.
+
+`--password [password]`
+: The password for the user. When not specified, a password will be generated.
+
+`--firstName [firstName]`
+: The given name (first name) of the user. Maximum length is 64 characters.
+
+`--lastName [lastName]`
+: The user's surname (family name or last name). Maximum length is 64 characters.
+
+`--forceChangePasswordNextSignIn`
+: Whether the user should change his/her password on the next login.
+
+`--forceChangePasswordNextSignInWithMfa`
+: Whether the user should change his/her password on the next login and setup MFA.
+
+`--usageLocation [usageLocation]`
+: A two letter [country code](https://learn.microsoft.com/en-us/partner-center/commercial-marketplace-co-sell-location-codes#country-and-region-codes) (ISO standard 3166). Required for users that will be assigned licenses.
+
+`--officeLocation [officeLocation]` 
+: The office location in the user's place of business.
+
+`--jobTitle [jobTitle]`
+: The user's job title. Maximum length is 128 characters.
+
+`--companyName [companyName]`
+: The company name which the user is associated. The maximum length is 64 characters.
+
+`--department [department]`
+: The name for the department in which the user works. Maximum length is 64 characters.
+
+`--preferredLanguage [preferredLanguage]`
+: The preferred language for the user. Should follow [ISO 639-1 Code](https://learn.microsoft.com/en-us/openspecs/office_standards/ms-oe376/6c085406-a698-4e12-9d4d-c3b0ee3dbc4a). Example: `en-US`.
+
+`--managerUserId [managerUserId]`
+: User ID of the user's manager. Specify `managerUserId` or `managerUserName` but not both.
+
+`--managerUserName [managerUserName]`
+: User principal name of the manager. Specify `managerUserId` or `managerUserName` but not both.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+!!! important
+    To use this command you must be a Global administrator, User administrator or Privileged Authentication administrator
+
+!!! note
+    After running this command, it may take a minute before the user is effectively created in the tenant.
+
+## Examples
+
+Create a user and let him/her update the password at first login
+
+```sh
+m365 aad user add --displayName "John Doe" --userName "john.doe@contoso.com" --password "SomePassw0rd" --forceChangePasswordNextSignIn
+```
+
+Create a user with job information
+
+```sh
+m365 aad user add --displayName "John Doe" --userName "john.doe@contoso.com" --password "SomePassw0rd" --firstName John --lastName Doe --jobTitle "Sales Manager" --companyName Contoso --department Sales --officeLocation Vosselaar --forceChangePasswordNextSignIn
+```
+
+Create a user with language information
+
+```sh
+m365 aad user add --displayName "John Doe" --userName "john.doe@contoso.com" --preferredLanguage "nl-BE" --usageLocation BE --forceChangePasswordNextSignIn
+```
+
+Create a user with a manager
+
+```sh
+m365 aad user add --displayName "John Doe" --userName "john.doe@contoso.com" --managerUserName "adele@contoso.com"
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "id": "990e2425-f595-43bc-85ed-b89a44093793",
+      "businessPhones": [],
+      "displayName": "John Doe",
+      "givenName": "John",
+      "jobTitle": "Sales Manager",
+      "mail": null,
+      "mobilePhone": null,
+      "officeLocation": "Vosselaar",
+      "preferredLanguage": "nl-BE",
+      "surname": "Doe",
+      "userPrincipalName": "john.doe@contoso.com",
+      "password": "SomePassw0rd"
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    businessPhones   : []
+    displayName      : John Doe
+    givenName        : John
+    id               : 990e2425-f595-43bc-85ed-b89a44093793
+    jobTitle         : Sales Manager
+    mail             : null
+    mobilePhone      : null
+    officeLocation   : Vosselaar
+    password         : SomePassw0rd
+    preferredLanguage: nl-BE
+    surname          : Doe
+    userPrincipalName: john.doe@contoso.com
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,businessPhones,displayName,givenName,jobTitle,mail,mobilePhone,officeLocation,preferredLanguage,surname,userPrincipalName,password
+    990e2425-f595-43bc-85ed-b89a44093793,[],John Doe,John,Sales Manager,,,Vosselaar,nl-BE,Doe,john.doe@contoso.com,SomePassw0rd
+    ```
+
+=== "Markdown"
+
+    ```md
+    # aad user add --displayName "John Doe" --userName "john.doe@contoso.com" --password "SomePassw0rd" --firstName "John" --lastName "Doe" --jobTitle "Sales Manager" --officeLocation "Vosselaar" --preferredLanguage "nl-BE"
+
+    Date: 16/02/2023
+
+    ## John Doe (990e2425-f595-43bc-85ed-b89a44093793)
+
+    Property | Value
+    ---------|-------
+    id | 990e2425-f595-43bc-85ed-b89a44093793
+    businessPhones | []
+    displayName | John Doe
+    givenName | John
+    jobTitle | Sales Manager
+    mail | null
+    mobilePhone | null
+    officeLocation | Vosselaar
+    preferredLanguage | nl-BE
+    surname | Doe
+    userPrincipalName | john.doe@contoso.com
+    password | SomePassw0rd
+    ```

package/docs/docs/cmd/aad/user/user-license-list.md

@@ -0,0 +1,98 @@
+# aad user license list
+
+Lists the license details for a given user
+
+## Usage
+
+```sh
+m365 aad user license list [options]
+```
+
+## Options
+
+`--userId [userId]`
+: The ID of the user. Specify either `userId` or `userName` but not both.
+
+`--userName [userName]`
+: User principal name of the user. Specify either `userId` or `userName` but not both.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+!!! tip
+    If you don't specify any option, the command will list the license details of the current logged in user. This does not work when using application permissions.
+
+## Examples
+
+List license details of the current logged in user.
+
+```sh
+m365 aad user license list
+```
+
+List license details of a specific user by its UPN.
+
+```sh
+m365 aad user license list --userName john.doe@contoso.com
+```
+
+List license details of a specific user by its ID.
+
+```sh
+m365 aad user license list --userId 59f80e08-24b1-41f8-8586-16765fd830d3
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "id": "x4s03usaBkSMs5fbAhyttK6cK8RP6rdKlxeBV2I1zKw",
+        "skuId": "c42b9cae-ea4f-4ab7-9717-81576235ccac",
+        "skuPartNumber": "DEVELOPERPACK_E5",
+        "servicePlans": [
+          {
+            "servicePlanId": "7547a3fe-08ee-4ccb-b430-5077c5041653",
+            "servicePlanName": "YAMMER_ENTERPRISE",
+            "provisioningStatus": "Success",
+            "appliesTo": "User"
+          }
+        ]
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    id           : x4s03usaBkSMs5fbAhyttK6cK8RP6rdKlxeBV2I1zKw
+    skuId        : c42b9cae-ea4f-4ab7-9717-81576235ccac
+    skuPartNumber: DEVELOPERPACK_E5
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,skuId,skuPartNumber
+    x4s03usaBkSMs5fbAhyttK6cK8RP6rdKlxeBV2I1zKw,c42b9cae-ea4f-4ab7-9717-81576235ccac,DEVELOPERPACK_E5
+    ```
+
+=== "Markdown"
+
+    ```md
+    # aad user license list --userId "0c9c625f-faa9-4c3b-8cd8-d874b869f78c"
+
+    Date: 2/19/2023
+
+    ## x4s03usaBkSMs5fbAhyttK6cK8RP6rdKlxeBV2I1zKw
+
+    Property | Value
+    ---------|-------
+    id | x4s03usaBkSMs5fbAhyttK6cK8RP6rdKlxeBV2I1zKw
+    skuId | c42b9cae-ea4f-4ab7-9717-81576235ccac
+    skuPartNumber | DEVELOPERPACK\_E5
+    servicePlans | [{"servicePlanId":"7547a3fe-08ee-4ccb-b430-5077c5041653","servicePlanName":"YAMMER\_ENTERPRISE","provisioningStatus":"Success","appliesTo":"User"}]
+    ```

package/docs/docs/cmd/aad/user/user-recyclebinitem-clear.md

@@ -18,7 +18,7 @@ m365 aad user recyclebinitem clear [options]
 ## Remarks
 
 !!! important
-    To use this command you must be a Global administrator, User administrator or Privileged Authentication administrator
+    To use this command you must be a Global administrator, User administrator or Privileged Authentication administrator.
 
 !!! note
     After running this command, it may take a minute before all deleted users are effectively removed from the tenant.

package/docs/docs/cmd/aad/user/user-recyclebinitem-list.md

@@ -0,0 +1,82 @@
+# aad user recyclebinitem list
+
+Lists users from the recycle bin in the current tenant
+
+## Usage
+
+```sh
+m365 aad user recyclebinitem list [options]
+```
+
+## Options
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+List all removed users
+
+```sh
+m365 aad user recyclebinitem list
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "businessPhones": [],
+        "displayName": "John Doe",
+        "givenName": "John Doe",
+        "jobTitle": "Developer",
+        "mail": "john@contoso.com",
+        "mobilePhone": "0476345130",
+        "officeLocation": "Washington",
+        "preferredLanguage": "nl-BE",
+        "surname": "John",
+        "userPrincipalName": "7e06b56615f340138bf879874d52e68ajohn@contoso.com",
+        "id": "7e06b566-15f3-4013-8bf8-79874d52e68a"
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    id                                    displayName  userPrincipalName
+    ------------------------------------  -----------  -----------------------------------------------
+    7e06b566-15f3-4013-8bf8-79874d52e68a  John Doe     7e06b56615f340138bf879874d52e68ajohn@contoso.com
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,displayName,userPrincipalName
+    7e06b566-15f3-4013-8bf8-79874d52e68a,John Doe,7e06b56615f340138bf879874d52e68ajohn@contoso.com
+    ```
+
+=== "Markdown"
+
+    ```md
+    # aad user recyclebinitem list
+
+    Date: 14/02/2023
+
+    ## John Doe (7e06b566-15f3-4013-8bf8-79874d52e68a)
+
+    Property | Value
+    ---------|-------
+    businessPhones | []
+    displayName | John Doe
+    givenName | John Doe
+    jobTitle | Developer
+    mail | john@contoso.com
+    mobilePhone | 0476345130
+    officeLocation | Washington
+    preferredLanguage | nl-BE
+    surname | John
+    userPrincipalName | 7e06b56615f340138bf879874d52e68ajohn@contoso.com
+    id | 7e06b566-15f3-4013-8bf8-79874d52e68a
+    ```

package/docs/docs/cmd/aad/user/user-recyclebinitem-remove.md

@@ -21,7 +21,7 @@ m365 aad user recyclebinitem remove [options]
 ## Remarks
 
 !!! important
-    To use this command you must be a Global administrator, User administrator or Privileged Authentication administrator
+    To use this command you must be a Global administrator, User administrator or Privileged Authentication administrator.
 
 !!! note
     After running this command, it may take a minute before the deleted user is effectively removed from the tenant.

package/docs/docs/cmd/aad/user/user-remove.md

@@ -0,0 +1,51 @@
+# aad user remove
+
+Removes a specific user
+
+## Usage
+
+```sh
+m365 aad user remove [options]
+```
+
+## Options
+
+`--id [id]`
+: The ID of the user. Specify either `id` or `userName` but not both.
+
+`--userName [userName]`
+:	User principal name of the user. Specify either `id` or `userName` but not both.
+
+`--confirm`
+: Don't prompt for confirmation.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+!!! important
+    If the user with the specified id or user name doesn't exist, you will get a `Resource 'xyz' does not exist or one of its queried reference-property objects are not present.` error.
+
+!!! important
+    To use this command you must be a Global administrator, User administrator or Privileged Authentication administrator.
+
+!!! note
+    After running this command, it may take a minute before the user is effectively moved to the recycle bin.
+
+## Examples
+
+Removes a specific user by id
+
+```sh
+m365 aad user remove --id a33bd401-9117-4e0e-bb7b-3f61c1539e10
+```
+
+Removes a specific user by its UPN
+
+```sh
+m365 aad user remove --name john.doe@contoso.com
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/aad/user/user-set.md

@@ -74,7 +74,7 @@ m365 aad user set --objectId 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --accountEnabl
 Reset password of a given user by userPrincipalName and require the user to change the password on the next sign in
 
 ```sh
-m365 aad user set --userPrincipalName steve@contoso.onmicrosoft.com --resetPassword --password 6NLUId79Lc24 --forceChangePasswordNextSignIn
+m365 aad user set --userPrincipalName steve@contoso.onmicrosoft.com --resetPassword --newPassword 6NLUId79Lc24 --forceChangePasswordNextSignIn
 ```
 
 Change password of the currently logged in user

package/docs/docs/cmd/flow/environment/environment-get.md

@@ -10,8 +10,8 @@ m365 flow environment get [options]
 
 ## Options
 
-`-n, --name <name>`
-: The name of the environment to get information about
+`-n, --name [name]`
+: The name of the environment to get information about. When not specified, the default environment is retrieved.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -24,12 +24,17 @@ If the environment with the name you specified doesn't exist, you will get the `
 
 ## Examples
 
-Get information about the Microsoft Flow environment named _Default-d87a7535-dd31-4437-bfe1-95340acd55c5_
+Get information about a Microsoft Flow environment specified by name
 
 ```sh
 m365 flow environment get --name Default-d87a7535-dd31-4437-bfe1-95340acd55c5
 ```
 
+Get information about the default Microsoft Flow environment
+```sh
+m365 flow environment get
+```
+
 ## Response
 
 ### Standard response
@@ -129,3 +134,26 @@ m365 flow environment get --name Default-d87a7535-dd31-4437-bfe1-95340acd55c5
     name,id,location,displayName,provisioningState,environmentSku,azureRegionHint,isDefault
     Default-d87a7535-dd31-4437-bfe1-95340acd55c5,/providers/Microsoft.ProcessSimple/environments/Default-d87a7535-dd31-4437-bfe1-95340acd55c5,india,contoso (default),Succeeded,Default,centralindia,1  
     ```
+
+=== "Markdown"
+
+    ```md
+    # flow environment get
+
+    Date: 8/2/2023
+
+    ## contoso (default) (/providers/Microsoft.ProcessSimple/environments/Default-d87a7535-dd31-4437-bfe1-95340acd55c5)
+
+    Property | Value
+    ---------|-------
+    name | Default-d87a7535-dd31-4437-bfe1-95340acd55c5
+    location | india
+    type | Microsoft.ProcessSimple/environments
+    id | /providers/Microsoft.ProcessSimple/environments/Default-d87a7535-dd31-4437-bfe1-95340acd55c5
+    properties | {"displayName":"contoso (default)","createdTime":"2019-12-21T18:32:11.8708704Z","createdBy":{"id":"SYSTEM","displayName": "SYSTEM","type": "NotSpecified"},"provisioningState":"Succeeded","creationType":"DefaultTenant","environmentSku":"Default","environmentType":"NotSpecified","states":{"management":{"id":"NotSpecified"},"runtime":{"runtimeReasonCode":"NotSpecified","requestedBy":{"displayName":"SYSTEM","type":"NotSpecified"},"id":"Enabled"}},"isDefault":true,"isPayAsYouGoEnabled":false,"azureRegionHint":"centralindia","runtimeEndpoints":{"microsoft.BusinessAppPlatform":"https://india.api.bap.microsoft.com","microsoft.CommonDataModel":"https://india.api.cds.microsoft.com","microsoft.PowerApps":"https://india.api.powerapps.com",microsoft.PowerAppsAdvisor":"https://india.api.advisor.powerapps.com","microsoft.PowerVirtualAgents":"https://powervamg.in-il101.gateway.prod.island.powerapps.com","microsoft.ApiManagement":"https://management.INDIA.azure-apihub.net","microsoft.Flow":"https://india.api.flow.microsoft.com"},"linkedEnvironmentMetadata":{"type":"NotSpecified","resourceId":"3aa550bf-52ac-42fc-98f7-5d1833c1501c","friendlyName":"contoso (default)","uniqueName":"orgfc80770f","domainName":"orgfc80770f","version":"9.2.22105.00154","instanceUrl":"https://orgfc80770f.crm8.dynamics.com/","instanceApiUrl":"https://orgfc80770f.api.crm8.dynamics.com","baseLanguage":1033,"instanceState":"Ready","createdTime":"2019-12-25T15:46:14.433Z"},"environmentFeatures":{"isOpenApiEnabled":false},"cluster":{"category":"Prod","number":"101","uriSuffix":"in-il101.gateway.prod.island","geoShortName":"IN","environment":"Prod"},"governanceConfiguration":{"protectionLevel":"Basic"}}
+    displayName | contoso (default)
+    provisioningState | Succeeded
+    environmentSku | Default
+    azureRegionHint | centralindia
+    isDefault | true
+    ```

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

@@ -14,7 +14,7 @@ m365 spo homesite get [options]
 
 ## Examples
 
-Get information about the Home Site
+Get information about the Home Site.
 
 ```sh
 m365 spo homesite get
@@ -51,6 +51,25 @@ m365 spo homesite get
     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
     ```
 
+=== "Markdown"
+
+    ```md
+    # spo homesite get
+
+    Date: 2/20/2023
+
+    ## Intranet (https://contoso.sharepoint.com/sites/intra)
+
+    Property | Value
+    ---------|-------
+    IsInDraftMode | false
+    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
+    ```
+
 ## 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

@@ -11,7 +11,7 @@ m365 spo homesite remove [options]
 ## Options
 
 `--confirm`
-: Do not prompt for confirmation before removing the Home Site
+: Do not prompt for confirmation before removing the Home Site.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -20,7 +20,7 @@ m365 spo homesite remove [options]
 
 ## Examples
 
-Removes the current Home Site without confirmation
+Removes the current Home Site without confirmation.
 
 ```sh
 m365 spo homesite remove --confirm
@@ -46,6 +46,12 @@ m365 spo homesite remove --confirm
     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.
     ```
 
+=== "Markdown"
+
+    ```md
+    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

@@ -11,7 +11,7 @@ m365 spo homesite set [options]
 ## Options
 
 `-u, --siteUrl <siteUrl>`
-: The URL of the site to set as Home Site
+: The URL of the site to set as Home Site.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -20,7 +20,7 @@ m365 spo homesite set [options]
 
 ## Examples
 
-Set the specified site as the Home Site
+Set the specified site as the Home Site.
 
 ```sh
 m365 spo homesite set --siteUrl https://contoso.sharepoint.com/sites/comms
@@ -46,6 +46,12 @@ m365 spo homesite set --siteUrl https://contoso.sharepoint.com/sites/comms
     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.
     ```
 
+=== "Markdown"
+
+    ```md
+    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

@@ -11,22 +11,22 @@ m365 spo hubsite connect [options]
 ## Options
 
 `-i, --id [id]`
-: ID of the hub site. 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 hub site. 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]`
-: Absolute or server-relative URL of the hub site. Specify either `id`, `title` or `url` but not multiple.
+: 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.
+: 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.
+: 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.
+: Absolute or server-relative URL of the parent hub site. Specify either `parentId`, `parentTitle`, or `parentUrl` but not multiple.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -39,19 +39,19 @@ To connect a regular site to a hub site, use command [spo site hubsite connect](
 
 ## Examples
 
-Connect a specific hub site to specific parent hub site by ID
+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
+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
+Connect a specific hub site with title to a parent hub site with ID.
 
 ```sh
 m365 spo hubsite connect --title "My hub site" --parentId 637ed2ea-b65b-4a4b-a3d7-ad86953224a4