@pnp/cli-microsoft365 6.3.0 → 6.4.0-beta.140530d

package/docs/docs/cmd/spo/tenant/tenant-settings-set.md

@@ -10,8 +10,6 @@ m365 spo tenant settings set [options]
 
 ## Options
 
---8<-- "docs/cmd/_global.md"
-
 `--MinCompatibilityLevel [MinCompatibilityLevel]`
 : Specifies the lower bound on the compatibility level for new sites
 
@@ -19,7 +17,7 @@ m365 spo tenant settings set [options]
 : Specifies the upper bound on the compatibility level for new sites
 
 `--ExternalServicesEnabled [ExternalServicesEnabled]`
-: Enables external services for a tenant. External services are defined as services that are not in the Microsoft 365 datacenters. Allowed values `true,false`
+: Enables external services for a tenant. External services are defined as services that are not in the Microsoft 365 data centers. Allowed values `true,false`
 
 `--NoAccessRedirectUrl [NoAccessRedirectUrl]`
 : Specifies the URL of the redirected site for those site collections which have the locked state "NoAccess"
@@ -34,43 +32,43 @@ m365 spo tenant settings set [options]
 : Specifies URL of the form to load in the Start a Site dialog. The valid values are: "" (default) - Blank by default, this will also remove or clear any value that has been set. Full URL - Example:"https://contoso.sharepoint.com/path/to/form"
 
 `--ShowEveryoneClaim [ShowEveryoneClaim]`
-: Enables the administrator to hide the Everyone claim in the People Picker. When users share an item with Everyone, it is accessible to all authenticated users in the tenant\'s Azure Active Directory, including any active external users who have previously accepted invitations. Note, that some SharePoint system resources such as templates and pages are required to be shared to Everyone and this type of sharing does not expose any user data or metadata. Allowed values `true,false`
+: Enables the administrator to hide the Everyone claim in the People Picker. When users share an item with Everyone, it is accessible to all authenticated users in the tenant's Azure Active Directory, including any active external users who have previously accepted invitations. Note, that some SharePoint system resources such as templates and pages are required to be shared with Everyone and this type of sharing does not expose any user data or metadata. Allowed values `true,false`
 
 `--ShowAllUsersClaim [ShowAllUsersClaim]`
-: Enables the administrator to hide the All Users claim groups in People Picker. When users share an item with "All Users (x)", it is accessible to all organization members in the tenant\'s Azure Active Directory who have authenticated with via this method. When users share an item with "All Users (x)" it is accessible to all organization members in the tenant that used NTLM to authentication with SharePoint. Allowed values `true,false`
+: Enables the administrator to hide the All Users claim groups in People Picker. When users share an item with "All Users (x)", it is accessible to all organization members in the tenant's Azure Active Directory who have authenticated via this method. When users share an item with "All Users (x)" it is accessible to all organization members in the tenant that used NTLM to authenticate with SharePoint. Allowed values `true,false`
 
 `--ShowEveryoneExceptExternalUsersClaim [ShowEveryoneExceptExternalUsersClaim]`
 : Enables the administrator to hide the "Everyone except external users" claim in the People Picker. When users share an item with "Everyone except external users", it is accessible to all organization members in the tenant's Azure Active Directory, but not to any users who have previously accepted invitations. Allowed values `true,false`
 
 `--SearchResolveExactEmailOrUPN [SearchResolveExactEmailOrUPN]`
-: Removes the search capability from People Picker. Note, recently resolved names will still appear in the list until browser cache is cleared or expired. SharePoint Administrators will still be able to use starts with or partial name matching when enabled. Allowed values `true,false`
+: Removes the search capability from People Picker. Note, recently resolved names will still appear in the list until the browser cache is cleared or expired. SharePoint Administrators will still be able to use starts with or partial name matching when enabled. Allowed values `true,false`
 
 `--OfficeClientADALDisabled [OfficeClientADALDisabled]`
 : When set to true this will disable the ability to use Modern Authentication that leverages ADAL across the tenant. Allowed values `true,false`
 
 `--LegacyAuthProtocolsEnabled [LegacyAuthProtocolsEnabled]`
-: By default this value is set to true. Setting this parameter prevents Office clients using non-modern authentication protocols from accessing SharePoint Online resources. A value of true - Enables Office clients using non-modern authentication protocols (such as, Forms-Based Authentication (FBA) or Identity Client Runtime Library (IDCRL)) to access SharePoint resources. Allowed values `true,false`
+: By default, this value is set to true. Setting this parameter prevents Office clients using non-modern authentication protocols from accessing SharePoint Online resources. A value of true - Enables Office clients using non-modern authentication protocols (such as Forms-Based Authentication (FBA) or Identity Client Runtime Library (IDCRL)) to access SharePoint resources. Allowed values `true,false`
 
 `--RequireAcceptingAccountMatchInvitedAccount [RequireAcceptingAccountMatchInvitedAccount]`
 : Ensures that an external user can only accept an external sharing invitation with an account matching the invited email address. Administrators who desire increased control over external collaborators should consider enabling this feature. Allowed values `true,false`
 
 `--ProvisionSharedWithEveryoneFolder [ProvisionSharedWithEveryoneFolder]`
-: Creates a Shared with Everyone folder in every user\'s new OneDrive for Business document library. The valid values are: True (default) - The Shared with Everyone folder is created. False - No folder is created when the site and OneDrive for Business document library is created. Allowed values `true,false`
+: Creates a Shared with Everyone folder in every user's new OneDrive for Business document library. The valid values are: True (default) - The Shared with Everyone folder is created. False - No folder is created when the site and OneDrive for Business document library are created. Allowed values `true,false`
 
 `--SignInAccelerationDomain [SignInAccelerationDomain]`
-: Specifies the home realm discovery value to be sent to Azure Active Directory (AAD) during the user sign-in process. When the organization uses a third-party identity provider, this prevents the user from seeing the Azure Active Directory Home Realm Discovery web page and ensures the user only sees their company's Identity Provider's portal. This value can also be used with Azure Active Directory Premium to customize the Azure Active Directory login page. Acceleration will not occur on site collections that are shared externally. This value should be configured with the login domain that is used by your company (that is, example@contoso.com). If your company has multiple third-party identity providers, configuring the sign-in acceleration value will break sign-in for your organization. The valid values are: "" (default) - Blank by default, this will also remove or clear any value that has been set. Login Domain - For example: "contoso.com". No value assigned by default
+: Specifies the home realm discovery value to be sent to Azure Active Directory (AAD) during the user sign-in process. When the organization uses a third-party identity provider, this prevents the user from seeing the Azure Active Directory Home Realm Discovery web page and ensures the user only sees their company's Identity Provider's portal. This value can also be used with Azure Active Directory Premium to customize the Azure Active Directory login page. Acceleration will not occur on-site collections that are shared externally. This value should be configured with the login domain that is used by your company (that is, example@contoso.com). If your company has multiple third-party identity providers, configuring the sign-in acceleration value will break sign-in for your organization. The valid values are: "" (default) - Blank by default, this will also remove or clear any value that has been set. Login Domain - For example: "contoso.com". No value assigned by default
 
 `--EnableGuestSignInAcceleration [EnableGuestSignInAcceleration]`
 : Accelerates guest-enabled site collections as well as member-only site collections when the SignInAccelerationDomain parameter is set. Allowed values `true,false`
 
 `--UsePersistentCookiesForExplorerView [UsePersistentCookiesForExplorerView]`
-: Lets SharePoint issue a special cookie that will allow this feature to work even when "Keep Me Signed In" is not selected. "Open with Explorer" requires persisted cookies to operate correctly. When the user does not select "Keep Me Signed in" at the time of sign -in, "Open with Explorer" will fail. This special cookie expires after 30 minutes and cannot be cleared by closing the browser or signing out of SharePoint Online.To clear this cookie, the user must log out of their Windows session. The valid values are: False(default) - No special cookie is generated and the normal Microsoft 365 sign -in length / timing applies. True - Generates a special cookie that will allow "Open with Explorer" to function if the "Keep Me Signed In" box is not checked at sign -in. Allowed values `true,false`
+: Lets SharePoint issue a special cookie that will allow this feature to work even when "Keep Me Signed In" is not selected. "Open with Explorer" requires persisted cookies to operate correctly. When the user does not select "Keep Me Signed in" at the time of sign-in, "Open with Explorer" will fail. This special cookie expires after 30 minutes and cannot be cleared by closing the browser or signing out of SharePoint Online.To clear this cookie, the user must log out of their Windows session. The valid values are: False(default) - No special cookie is generated and the normal Microsoft 365 sign-in length/timing applies. True - Generates a special cookie that will allow "Open with Explorer" to function if the "Keep Me Signed In" box is not checked at sign-in. Allowed values `true,false`
 
 `--BccExternalSharingInvitations [BccExternalSharingInvitations]`
-: When the feature is enabled, all external sharing invitations that are sent will blind copy the e-mail messages listed in the BccExternalSharingsInvitationList. Allowed values `true,false`
+: When the feature is enabled, all external sharing invitations that are sent will blindly copy the e-mail messages listed in the BccExternalSharingsInvitationList. Allowed values `true,false`
 
 `--BccExternalSharingInvitationsList [BccExternalSharingInvitationsList]`
-: Specifies a list of e-mail addresses to be BCC'd when the BCC for External Sharing feature is enabled. Multiple addresses can be specified by creating a comma separated list with no spaces
+: Specifies a list of e-mail addresses to be BCC'd when the BCC for External Sharing feature is enabled. Multiple addresses can be specified by creating a comma-separated list with no spaces
 
 `--UserVoiceForFeedbackEnabled [UserVoiceForFeedbackEnabled]`
 : Enables or disables the User Voice Feedback button. Allowed values `true,false`
@@ -79,16 +77,16 @@ m365 spo tenant settings set [options]
 : Enables or disables the publish CDN. Allowed values `true,false`
 
 `--PublicCdnAllowedFileTypes [PublicCdnAllowedFileTypes]`
-: Sets public CDN allowed file types
+: Sets public CDN-allowed file types
 
 `--RequireAnonymousLinksExpireInDays [RequireAnonymousLinksExpireInDays]`
 : Specifies all anonymous links that have been created (or will be created) will expire after the set number of days. To remove the expiration requirement, set the value to zero (0)
 
 `--SharingAllowedDomainList [SharingAllowedDomainList]`
-: Specifies a list of email domains that is allowed for sharing with the external collaborators. Use the space character as the delimiter for entering multiple values. For example, "contoso.com fabrikam.com"
+: Specifies a list of email domains that are allowed for sharing with external collaborators. Use the space character as the delimiter for entering multiple values. For example, "contoso.com fabrikam.com"
 
 `--SharingBlockedDomainList [SharingBlockedDomainList]`
-: Specifies a list of email domains that is blocked or prohibited for sharing with the external collaborators. Use space character as the delimiter for entering multiple values. For example, "contoso.com fabrikam.com"
+: Specifies a list of email domains that are blocked or prohibited from sharing with external collaborators. Use space character as the delimiter for entering multiple values. For example, "contoso.com fabrikam.com"
 
 `--SharingDomainRestrictionMode [SharingDomainRestrictionMode]`
 : Specifies the external sharing mode for domains. Allowed values `None,AllowList,BlockList`
@@ -97,7 +95,7 @@ m365 spo tenant settings set [options]
 : Sets a default OneDrive for Business storage quota for the tenant. It will be used for new OneDrive for Business sites created. A typical use will be to reduce the amount of storage associated with OneDrive for Business to a level below what the License entitles the users. For example, it could be used to set the quota to 10 gigabytes (GB) by default
 
 `--OneDriveForGuestsEnabled [OneDriveForGuestsEnabled]`
-: Lets OneDrive for Business creation for administrator managed guest users. Administrator managed Guest users use credentials in the resource tenant to access the resources. Allowed values `true,false`
+: Lets OneDrive for Business creation for administrator-managed guest users. Administrator-managed Guest users use credentials in the resource tenant to access the resources. Allowed values `true,false`
 
 `--IPAddressEnforcement [IPAddressEnforcement]`
 : Allows access from network locations that are defined by an administrator. The values are true and false. The default value is false which means the setting is disabled. Before the iPAddressEnforcement parameter is set, make sure you add a valid IPv4 or IPv6 address to the iPAddressAllowList parameter. Allowed values `true,false`
@@ -109,10 +107,10 @@ m365 spo tenant settings set [options]
 : Sets IP Address WAC token lifetime'
 
 `--UseFindPeopleInPeoplePicker [UseFindPeopleInPeoplePicker]`
-: Sets use find people in PeoplePicker to true or false. Note: When set to true, users aren\'t able to share with security groups or SharePoint groups. Allowed values `true,false`
+: Sets use to find people in PeoplePicker to true or false. Note: When set to true, users aren't able to share with security groups or SharePoint groups. Allowed values `true,false`
 
 `--DefaultSharingLinkType [DefaultSharingLinkType]`
-: Lets administrators choose what type of link appears is selected in the “Get a link” sharing dialog box in OneDrive for Business and SharePoint Online. Allowed values `None,Direct,Internal,AnonymousAccess`
+: Let's administrators choose what type of link appears is selected in the “Get a link” sharing dialog box in OneDrive for Business and SharePoint Online. Allowed values `None,Direct,Internal,AnonymousAccess`
 
 `--ODBMembersCanShare [ODBMembersCanShare]`
 : Lets administrators set policy on re-sharing behavior in OneDrive for Business. Allowed values `Unspecified,On,Off`
@@ -145,7 +143,7 @@ m365 spo tenant settings set [options]
 : Enables or disables notifications in SharePoint. Allowed values `true,false`
 
 `--OwnerAnonymousNotification [OwnerAnonymousNotification]`
-: Enables or disables owner anonymous notification. Allowed values `true,false`
+: Enables or disables owner-anonymous notification. Allowed values `true,false`
 
 `--CommentsOnSitePagesDisabled [CommentsOnSitePagesDisabled]`
 : Enables or disables comments on site pages. Allowed values `true,false`
@@ -160,19 +158,19 @@ m365 spo tenant settings set [options]
 : Prevents the Download button from being displayed on the Virus Found warning page. Allowed values `true,false`
 
 `--DefaultLinkPermission [DefaultLinkPermission]`
-: Choose the dafault permission that is selected when users share. This applies to anonymous access, internal and direct links. Allowed values `None,View,Edit`
+: Choose the default permission that is selected when users share. This applies to anonymous access, internal and direct links. Allowed values `None,View,Edit`
 
 `--ConditionalAccessPolicy [ConditionalAccessPolicy]`
 : Configures conditional access policy. Allowed values `AllowFullAccess,AllowLimitedAccess,BlockAccess`
 
 `--AllowDownloadingNonWebViewableFiles [AllowDownloadingNonWebViewableFiles]`
-: Allows downloading non web viewable files. The Allowed values `true,false`
+: Allows downloading non-web viewable files. The Allowed values `true,false`
 
 `--AllowEditing [AllowEditing]`
 : Allows editing. Allowed values `true,false`
 
 `--ApplyAppEnforcedRestrictionsToAdHocRecipients [ApplyAppEnforcedRestrictionsToAdHocRecipients]`
-: Applies app enforced restrictions to AdHoc recipients. Allowed values `true,false`
+: Applies app-enforced restrictions to AdHoc recipients. Allowed values `true,false`
 
 `--FilePickerExternalImageSearchEnabled [FilePickerExternalImageSearchEnabled]`
 : Enables file picker external image search. Allowed values `true,false`
@@ -190,7 +188,7 @@ m365 spo tenant settings set [options]
 : Blocks access on unmanaged devices. Allowed values `true,false`
 
 `--AllowLimitedAccessOnUnmanagedDevices [AllowLimitedAccessOnUnmanagedDevices]`
-: Allows limited access on unmanaged devices blocks. Allowed values `true,false`
+: Allows limited access on unmanaged device blocks. Allowed values `true,false`
 
 `--BlockDownloadOfAllFilesForGuests [BlockDownloadOfAllFilesForGuests]`
 : Blocks download of all files for guests. Allowed values `true,false`
@@ -211,7 +209,7 @@ m365 spo tenant settings set [options]
 : Disables report problem dialog. Allowed values `true,false`
 
 `--DisplayNamesOfFileViewers [DisplayNamesOfFileViewers]`
-: Displayes names of file viewers. Allowed values `true,false`
+: Displays names of file viewers. Allowed values `true,false`
 
 `--EnableMinimumVersionRequirement [EnableMinimumVersionRequirement]`
 : Enables minimum version requirement. Allowed values `true,false`
@@ -235,7 +233,7 @@ m365 spo tenant settings set [options]
 : Organization news site url'
 
 `--PermissiveBrowserFileHandlingOverride [PermissiveBrowserFileHandlingOverride]`
-: Permissive browser fileHandling override. Allowed values `true,false`
+: Permissive browser file handling override. Allowed values `true,false`
 
 `--ShowNGSCDialogForSyncOnODB [ShowNGSCDialogForSyncOnODB]`
 : Show NGSC dialog for sync on OneDrive for Business. Allowed values `true,false`
@@ -264,8 +262,12 @@ m365 spo tenant settings set [options]
 `--SyncAadB2BManagementPolicy [SyncAadB2BManagementPolicy]`
 : Syncs Azure B2B Management Policies. Allowed values `true,false`. For more information, see [SharePoint and OneDrive integration with Azure AD B2B](https://aka.ms/spo-b2b-integration).
 
+--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 have to have permission to access the tenant admin site.
 
 ## Examples
 

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

@@ -42,14 +42,14 @@ m365 spo term add [options]
 
 --8<-- "docs/cmd/_global.md"
 
-!!! important
-    To use this command you have to have permissions to access the tenant admin site.
-
 ## Remarks
 
 !!! warning "Escaping JSON in PowerShell"
     When using the `--customProperties` and/or `--localCustomProperties` options it's possible to enter a JSON string. In PowerShell 5 to 7.2 [specific escaping rules](./../../../user-guide/using-cli.md#escaping-double-quotes-in-powershell) apply due to an issue. Remember that you can also use [file tokens](./../../../user-guide/using-cli.md#passing-complex-content-into-cli-options) instead.
 
+!!! important
+    To use this command you have to have permissions to access the tenant admin site.
+
 ## Examples
 
 Add taxonomy term with the specified name to the term group and term set specified by their names

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

@@ -30,13 +30,13 @@ m365 spo term get [options]
 
 --8<-- "docs/cmd/_global.md"
 
-!!! important
-    To use this command you have to have permissions to access the tenant admin site.
-
 ## Remarks
 
 When retrieving term by its ID, it's sufficient to specify just the ID. When retrieving it by its name however, you need to specify the parent term group and term set using either their names or IDs.
 
+!!! important
+    To use this command you have to have permissions to access the tenant admin site.
+    
 ## Examples
 
 Get information about a taxonomy term using its ID

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

@@ -21,6 +21,8 @@ m365 spo term group add [options]
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
 !!! important
     To use this command you have to have permissions to access the tenant admin site.
 

package/docs/docs/cmd/spo/term/term-group-get.md

@@ -18,6 +18,8 @@ m365 spo term group get [options]
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
 !!! important
     To use this command you have to have permissions to access the tenant admin site.
 

package/docs/docs/cmd/spo/term/term-group-list.md

@@ -12,6 +12,8 @@ m365 spo term group list [options]
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
 !!! important
     To use this command you have to have permissions to access the tenant admin site.
 

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

@@ -27,6 +27,8 @@ m365 spo term list [options]
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
 !!! important
     To use this command you have to have permissions to access the tenant admin site.
 
@@ -145,7 +147,7 @@ When we make use of the option `includeChildTerms` the response will differ.
           "CustomProperties": {},
           "CustomSortOrder": null,
           "IsAvailableForTagging": true,
-          "Owner": "i:0#.f|membership|admin@mathijsdev2.onmicrosoft.com",
+          "Owner": "i:0#.f|membership|admin@contoso.onmicrosoft.com",
           "Description": "",
           "IsDeprecated": false,
           "IsKeyword": false,

package/docs/docs/cmd/spo/term/term-set-add.md

@@ -30,14 +30,14 @@ m365 spo term set add [options]
 
 --8<-- "docs/cmd/_global.md"
 
-!!! important
-    To use this command you have to have permissions to access the tenant admin site.
-
 ## Remarks
 
 !!! warning "Escaping JSON in PowerShell"
     When using the `--customProperties` option it's possible to enter a JSON string. In PowerShell 5 to 7.2 [specific escaping rules](./../../../user-guide/using-cli.md#escaping-double-quotes-in-powershell) apply due to an issue. Remember that you can also use [file tokens](./../../../user-guide/using-cli.md#passing-complex-content-into-cli-options) instead.
 
+!!! important
+    To use this command you have to have permissions to access the tenant admin site.
+
 ## Examples
 
 Add taxonomy term set to the term group specified by ID

package/docs/docs/cmd/spo/term/term-set-get.md

@@ -24,6 +24,8 @@ m365 spo term set get [options]
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
 !!! important
     To use this command you have to have permissions to access the tenant admin site.
 

package/docs/docs/cmd/spo/term/term-set-list.md

@@ -18,6 +18,8 @@ m365 spo term set list [options]
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
 !!! important
     To use this command you have to have permissions to access the tenant admin site.
 

package/docs/docs/cmd/spo/theme/theme-apply.md

@@ -21,13 +21,13 @@ m365 spo theme apply [options]
 
 --8<-- "docs/cmd/_global.md"
 
-!!! important
-    To use this command you have to have permissions to access the tenant admin site.
-
 ## Remarks
 
 Following standard SharePoint themes are supported by the CLI for Microsoft 365: Blue, Orange, Red, Purple, Green, Gray, Dark Yellow and Dark Blue.
 
+!!! important
+    To use this command you have to have permissions to access the tenant admin site.
+    
 ## Examples
 
 Apply theme to the specified site

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

@@ -15,6 +15,8 @@ m365 spo theme get [options]
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
 !!! important
     To use this command you have to have permissions to access the tenant admin site.
 

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

@@ -12,6 +12,8 @@ m365 spo theme list [options]
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
 !!! important
     To use this command you have to have permissions to access the tenant admin site.
 

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

@@ -18,6 +18,8 @@ m365 spo theme remove [options]
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
 !!! important
     To use this command you have to have permissions to access the tenant admin site.
 

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

@@ -21,9 +21,6 @@ m365 spo theme set [options]
 
 --8<-- "docs/cmd/_global.md"
 
-!!! important
-    To use this command you have to have permissions to access the tenant admin site.
-
 ## Remarks
 
 To prevent the accidental creation of invalid themes the CLI for Microsoft 365 implements a set of checks. These checks are executed against the provided json file. A valid theme JSON file is as follows:
@@ -64,6 +61,9 @@ When executing the `m365 spo theme set` command the following checks are execute
 
 If any of these checks fails you are presented with a `The specified theme is not valid` error.
 
+!!! important
+    To use this command you have to have permissions to access the tenant admin site.
+    
 ## Examples
 
 Add or update a theme from a theme JSON file

package/docs/docs/cmd/spo/user/user-ensure.md

@@ -0,0 +1,109 @@
+# spo user ensure
+
+Ensures that a user is available on a specific site
+
+## Usage
+
+```sh
+m365 spo user ensure [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: Absolute URL of the site.
+
+`--aadId [--aadId]`
+: Id of the user in Azure AD. Specify either `aadId` or `userName` but not both.
+
+`--userName [userName]`
+: User's UPN (user principal name, e.g. john@contoso.com). Specify either `aadId` or `userName` but not both.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Ensures a user by its Azure AD Id
+
+```sh
+m365 spo user ensure --webUrl https://contoso.sharepoint.com/sites/project --aadId e254750a-eaa4-44f6-9517-b74f65cdb747
+```
+
+Ensures a user by its user principal name
+
+```sh
+m365 spo user ensure --webUrl https://contoso.sharepoint.com/sites/project --userName john@contoso.com
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "Id": 35,
+      "IsHiddenInUI": false,
+      "LoginName": "i:0#.f|membership|john@contoso.com",
+      "Title": "John Doe",
+      "PrincipalType": 1,
+      "Email": "john@contoso.com",
+      "Expiration": "",
+      "IsEmailAuthenticationGuestUser": false,
+      "IsShareByEmailGuestUser": false,
+      "IsSiteAdmin": false,
+      "UserId": {
+        "NameId": "1003200274f51d2d",
+        "NameIdIssuer": "urn:federation:microsoftonline"
+      },
+      "UserPrincipalName": "john@contoso.com"
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    Email                         : john@contoso.com
+    Expiration                    :
+    Id                            : 35
+    IsEmailAuthenticationGuestUser: false
+    IsHiddenInUI                  : false
+    IsShareByEmailGuestUser       : false
+    IsSiteAdmin                   : false
+    LoginName                     : i:0#.f|membership|john@contoso.com
+    PrincipalType                 : 1
+    Title                         : John Doe
+    UserId                        : {"NameId":"1003200274f51d2d","NameIdIssuer":"urn:federation:microsoftonline"}
+    UserPrincipalName             : john@contoso.com
+    ```
+
+=== "CSV"
+
+    ```csv
+    Id,IsHiddenInUI,LoginName,Title,PrincipalType,Email,Expiration,IsEmailAuthenticationGuestUser,IsShareByEmailGuestUser,IsSiteAdmin,UserId,UserPrincipalName
+    35,,i:0#.f|membership|john@contoso.com,John Doe,1,john@contoso.com,,,,,"{""NameId"":""100320009d80e5de"",""NameIdIssuer"":""urn:federation:microsoftonline""}",john@contoso.com
+    ```
+
+=== "Markdown"
+
+    ```md
+    # spo user ensure --webUrl "https://mathijsdev2.sharepoint.com" --userName "john@contoso.com"
+
+    Date: 18/02/2023
+
+    ## John Doe (35)
+
+    Property | Value
+    ---------|-------
+    Id | 35
+    IsHiddenInUI | false
+    LoginName | i:0#.f\|membership\|john@contoso.com
+    Title | John Doe
+    PrincipalType | 1
+    Email | john@contoso.com
+    Expiration |
+    IsEmailAuthenticationGuestUser | false
+    IsShareByEmailGuestUser | false
+    IsSiteAdmin | false
+    UserId | {"NameId":"100320009d80e5de","NameIdIssuer":"urn:federation:microsoftonline"}
+    UserPrincipalName | john@contoso.com
+    ```

package/docs/docs/cmd/teams/channel/channel-get.md

@@ -71,7 +71,7 @@ m365 teams channel get --teamName "Team Name" --primary
     createdDateTime    : 2022-10-26T15:43:31.954Z
     description        : This team is about the Contoso
     displayName        : Channel Name
-    email              : TeamName@ordidev.onmicrosoft.com
+    email              : TeamName@contoso.onmicrosoft.com
     id                 : 19:493665404ebd4a18adb8a980a31b4986@thread.tacv2
     isFavoriteByDefault: null
     membershipType     : standard

package/docs/docs/cmd/teams/channel/channel-member-add.md

@@ -23,10 +23,10 @@ m365 teams channel member add [options]
 : The display name of the Microsoft Teams team channel. Specify either `channelId` or `channelName`, but not both.
 
 `--userId [userId]`
-: The user's ID or principal name. You can also pass a comma separated list of userIds.
+: The user's ID or principal name. You can also pass a comma-separated list of userIds.
 
 `--userDisplayName [userDisplayName]`
-: The display name of a user. You can also pass a comma separated list of display names.
+: The display name of a user. You can also pass a comma-separated list of display names.
 
 `--owner`
 : Assign the user the owner role. Defaults to member permissions.

package/docs/docs/cmd/teams/message/message-get.md

@@ -11,13 +11,13 @@ m365 teams message get [options]
 ## Options
 
 `-t, --teamId <teamId>`
-: The ID of the team where the channel is located
+: The ID of the team where the channel is located.
 
 `-c, --channelId <channelId>`
-: The ID of the channel that contains the message
+: The ID of the channel that contains the message.
 
 `-i, --id <id>`
-: The ID of the message to retrieve
+: The ID of the message to retrieve.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -27,7 +27,7 @@ You can only retrieve a message from a Microsoft Teams team if you are a member
 
 ## Examples
 
-Retrieve the specified message from a channel of the Microsoft Teams team
+Retrieve the specified message from a channel of the Microsoft Teams team.
 
 ```sh
 m365 teams message get --teamId 5f5d7b71-1161-44d8-bcc1-3da710eb4171 --channelId 19:88f7e66a8dfe42be92db19505ae912a8@thread.skype --id 1540747442203
@@ -112,3 +112,38 @@ m365 teams message get --teamId 5f5d7b71-1161-44d8-bcc1-3da710eb4171 --channelId
     id,replyToId,etag,messageType,createdDateTime,lastModifiedDateTime,lastEditedDateTime,deletedDateTime,subject,summary,chatId,importance,locale,webUrl,policyViolation,eventDetail,from,body,channelIdentity,attachments,mentions,reactions
     1540747442203,,1666799582385,message,2022-10-26T15:52:00.731Z,2022-10-26T15:53:02.385Z,2022-10-26T15:53:02.288Z,,Second message Title,,,normal,en-us,https://teams.microsoft.com/l/message/19%388f7e66a8dfe42be92db19505ae912a8%40thread.tacv2/1540747442203?groupId=5f5d7b71-1161-44d8-bcc1-3da710eb4171&tenantId=92e59666-257b-49c3-b1fa-1bae8107f6ba&createdTime=1540747442203&parentMessageId=1540747442203,,,"{""application"":null,""device"":null,""user"":{""id"":""78ccf530-bbf0-47e4-aae6-da5f8c6fb142"",""displayName"":""John Doe"",""userIdentityType"":""aadUser"",""tenantId"":""92e59666-257b-49c3-b1fa-1bae8107f6ba""}}","{""contentType"":""text"",""content"":""second message!""}","{""teamId"":""5f5d7b71-1161-44d8-bcc1-3da710eb4171"",""channelId"":""19:e2916df2b11046beba42d22da898383f@thread.tacv2""}",[],[],[]
     ```
+
+=== "Markdown"
+
+    ```md
+    # teams message get --teamId "5f5d7b71-1161-44d8-bcc1-3da710eb4171" --channelId "19:e2916df2b11046beba42d22da898383f@thread.tacv2" --id "1540747442203"
+
+    Date: 1/3/2023
+
+    ## undefined (1540747442203)
+
+    Property | Value
+    ---------|-------
+    id | 1540747442203
+    replyToId | null
+    etag | 1666799582385
+    messageType | message
+    createdDateTime | 2022-10-26T15:52:00.731Z
+    lastModifiedDateTime | 2022-10-26T15:53:02.385Z
+    lastEditedDateTime | 2022-10-26T15:53:02.288Z
+    deletedDateTime | null
+    subject | Second message Title
+    summary | null
+    chatId | null
+    importance | normal
+    locale | en-us
+    webUrl | https://teams.microsoft.com/l/message/19%388f7e66a8dfe42be92db19505ae912a8%40thread.tacv2/1540747442203?groupId=5f5d7b71-1161-44d8-bcc1-3da710eb4171&tenantId=92e59666-257b-49c3-b1fa-1bae8107f6ba&createdTime=1540747442203&parentMessageId=1540747442203
+    policyViolation | null
+    eventDetail | null
+    from | {"application":null,"device":null,"user":{"id":"78ccf530-bbf0-47e4-aae6-da5f8c6fb142","displayName":"John Doe","userIdentityType":"aadUser","tenantId":"92e59666-257b-49c3-b1fa-1bae8107f6ba"}}
+    body | {"contentType":"text","content":"second message!"}
+    channelIdentity | {"teamId":"5f5d7b71-1161-44d8-bcc1-3da710eb4171","channelId":"19:e2916df2b11046beba42d22da898383f@thread.tacv2"}
+    attachments | []
+    mentions | []
+    reactions | []
+    ```