@pnp/cli-microsoft365 10.0.0-beta.c07d83f → 10.0.0-beta.d03ed9d

package/docs/docs/cmd/entra/user/user-add.mdx

@@ -12,12 +12,6 @@ Creates a new user
 m365 entra user add [options]
 ```
 
-## Alias
-
-```sh
-m365 aad user add [options]
-```
-
 ## Options
 
 ```md definition-list
@@ -95,25 +89,25 @@ If the specified option is not found, you will receive a `Resource 'xyz' does no
 
 ## Examples
 
-Create a user and let him/her update the password at first login
+Create a user and let him/her update the password at first login.
 
 ```sh
 m365 entra user add --displayName "John Doe" --userName "john.doe@contoso.com" --password "SomePassw0rd" --forceChangePasswordNextSignIn
 ```
 
-Create a user with job information
+Create a user with job information.
 
 ```sh
 m365 entra 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
+Create a user with language information.
 
 ```sh
 m365 entra user add --displayName "John Doe" --userName "john.doe@contoso.com" --preferredLanguage "nl-BE" --usageLocation BE --forceChangePasswordNextSignIn
 ```
 
-Create a user with a manager
+Create a user with a manager.
 
 ```sh
 m365 entra user add --displayName "John Doe" --userName "john.doe@contoso.com" --managerUserName "adele@contoso.com"

package/docs/docs/cmd/entra/user/user-get.mdx

@@ -12,12 +12,6 @@ Gets information about the specified user
 m365 entra user get [options]
 ```
 
-## Alias
-
-```sh
-m365 aad user get [options]
-```
-
 ## Options
 
 ```md definition-list
@@ -47,43 +41,43 @@ If the user with the specified id, user name, or email doesn't exist, you will g
 
 ## Examples
 
-Get information about the user with id _1caf7dcd-7e83-4c3a-94f7-932a1299c844_
+Get information about the user by id.
 
 ```sh
 m365 entra user get --id 1caf7dcd-7e83-4c3a-94f7-932a1299c844
 ```
 
-Get information about the user by user name
+Get information about the user by user name.
 
 ```sh
 m365 entra user get --userName AarifS@contoso.onmicrosoft.com
 ```
 
-Get information about the user by email
+Get information about the user by email.
 
 ```sh
 m365 entra user get --email AarifS@contoso.onmicrosoft.com
 ```
 
-For the user with id _1caf7dcd-7e83-4c3a-94f7-932a1299c844_ retrieve the user name, e-mail address and full name
+For the user with id _1caf7dcd-7e83-4c3a-94f7-932a1299c844_ retrieve the user name, e-mail address and full name.
 
 ```sh
 m365 entra user get --id 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --properties "userPrincipalName,mail,displayName"
 ```
 
-Get information about the currently logged user using the Id token
+Get information about the currently logged user using the Id token.
 
 ```sh
 m365 entra user get --id "@meId"
 ```
 
-Get information about the currently logged in user using the UserName token
+Get information about the currently logged in user using the UserName token.
 
 ```sh
 m365 entra user get --userName "@meUserName"
 ```
 
-Get information about a user with the manager's details
+Get information about a user with the manager's details.
 
 ```sh
 m365 entra user get --userName AarifS@contoso.onmicrosoft.com --withManager

package/docs/docs/cmd/entra/user/user-guest-add.mdx

@@ -12,12 +12,6 @@ Invite an external user to the organization
 m365 entra user guest add [options]
 ```
 
-## Alias
-
-```sh
-m365 aad user guest add [options]
-```
-
 ## Options
 
 ```md definition-list
@@ -47,19 +41,19 @@ m365 aad user guest add [options]
 
 ## Examples
 
-Invite a user via email and set the display name
+Invite a user via email and set the display name.
 
 ```sh
 m365 entra user guest add --emailAddress john.doe@contoso.com --displayName "John Doe" --sendInvitationMessage
 ```
 
-Invite a user with a custom email and custom redirect url
+Invite a user with a custom email and custom redirect url.
 
 ```sh
 m365 entra user guest add --emailAddress john.doe@contoso.com --welcomeMessage "Hi John, welcome to the organization!" --inviteRedirectUrl https://contoso.sharepoint.com --sendInvitationMessage
 ```
 
-Invite a user and send an invitation mail in Dutch
+Invite a user and send an invitation mail in Dutch.
 
 ```sh
 m365 entra user guest add --emailAddress john.doe@contoso.com --messageLanguage nl-BE --sendInvitationMessage

package/docs/docs/cmd/entra/user/user-hibp.mdx

@@ -12,12 +12,6 @@ Allows you to retrieve all accounts that have been pwned with the specified user
 m365 entra user hibp [options]
 ```
 
-## Alias
-
-```sh
-m365 aad user hibp [options]
-```
-
 ## Options
 
 ```md definition-list
@@ -41,13 +35,13 @@ If `API Key` is invalid, you will get a `Required option apiKey not specified` e
 
 ## Examples
 
-Check if user with by a user name is in a data breach
+Check if user with by a user name is in a data breach.
 
 ```sh
 m365 entra user hibp --userName account-exists@hibp-integration-tests.com --apiKey _YOUR-API-KEY_
 ```
 
-Check if user by a user name is in a data breach against the domain specified
+Check if user by a user name is in a data breach against the domain specified.
 
 ```sh
 m365 entra user hibp --userName account-exists@hibp-integration-tests.com --apiKey _YOUR-API-KEY_ --domain adobe.com

package/docs/docs/cmd/entra/user/user-license-add.mdx

@@ -12,12 +12,6 @@ Assigns a license to a user
 m365 entra user license add [options]
 ```
 
-## Alias
-
-```sh
-m365 aad user license add [options]
-```
-
 ## Options
 
 ```md definition-list

package/docs/docs/cmd/entra/user/user-license-list.mdx

@@ -12,12 +12,6 @@ Lists the license details for a given user
 m365 entra user license list [options]
 ```
 
-## Alias
-
-```sh
-m365 aad user license list [options]
-```
-
 ## Options
 
 ```md definition-list

package/docs/docs/cmd/entra/user/user-license-remove.mdx

@@ -10,12 +10,6 @@ Removes a license from a user
 m365 entra user license remove [options]
 ```
 
-## Alias
-
-```sh
-m365 aad user license remove [options]
-```
-
 ## Options
 
 ```md definition-list
@@ -36,13 +30,13 @@ m365 aad user license remove [options]
 
 ## Examples
 
-Remove specific licenses from a specific user by UPN
+Remove specific licenses from a specific user by UPN.
 
 ```sh
 m365 entra user license remove --userName "john.doe@contoso.com" --ids "45715bb8-13f9-4bf6-927f-ef96c102d394,bea13e0c-3828-4daa-a392-28af7ff61a0f"
 ```
 
-Remove specific licenses from a specific user by ID
+Remove specific licenses from a specific user by ID.
 
 ```sh
 m365 entra user license remove --userId 5c241023-2ba5-4ea8-a516-a2481a3e6c51 --ids "45715bb8-13f9-4bf6-927f-ef96c102d394,bea13e0c-3828-4daa-a392-28af7ff61a0f"

package/docs/docs/cmd/entra/user/user-list.mdx

@@ -12,12 +12,6 @@ Lists users matching specified criteria
 m365 entra user list [options]
 ```
 
-## Alias
-
-```sh
-m365 aad user list [options]
-```
-
 ## Options
 
 ```md definition-list
@@ -25,7 +19,7 @@ m365 aad user list [options]
 : Filter the results to only users of a given type: `Member` or `Guest`. By default, all users are listed.
 
 `-p, --properties [properties]`
-: Comma-separated list of properties to retrieve
+: Comma-separated list of properties to retrieve.
 ```
 
 <Global />

package/docs/docs/cmd/entra/user/user-password-validate.mdx

@@ -12,12 +12,6 @@ Check a user's password against the organization's password validation policy
 m365 entra user password validate [options]
 ```
 
-## Alias
-
-```sh
-m365 aad user password validate [options]
-```
-
 ## Options
 
 ```md definition-list
@@ -37,7 +31,7 @@ This command is based on an API that is currently in preview and is subject to c
 
 ## Examples
 
-Validate password _cli365P@ssW0rd_ against the organization's password validation policy
+Validate password _cli365P@ssW0rd_ against the organization's password validation policy.
 
 ```sh
 m365 entra user password validate --password "cli365P@ssW0rd"

package/docs/docs/cmd/entra/user/user-recyclebinitem-clear.mdx

@@ -10,12 +10,6 @@ Removes all users from the tenant recycle bin
 m365 entra user recyclebinitem clear [options]
 ```
 
-## Alias
-
-```sh
-m365 aad user recyclebinitem clear [options]
-```
-
 ## Options
 
 ```md definition-list
@@ -41,13 +35,13 @@ After running this command, it may take a minute before all deleted users are ef
 
 ## Examples
 
-Removes all users from the tenant recycle bin
+Removes all users from the tenant recycle bin.
 
 ```sh
 m365 entra user recyclebinitem clear
 ```
 
-Removes all users from the tenant recycle bin without confirmation prompt
+Removes all users from the tenant recycle bin without confirmation prompt.
 
 ```sh
 m365 entra user recyclebinitem clear --force

package/docs/docs/cmd/entra/user/user-recyclebinitem-list.mdx

@@ -12,12 +12,6 @@ Lists users from the recycle bin in the current tenant
 m365 entra user recyclebinitem list [options]
 ```
 
-## Alias
-
-```sh
-m365 aad user recyclebinitem list [options]
-```
-
 ## Options
 
 <Global />

package/docs/docs/cmd/entra/user/user-recyclebinitem-remove.mdx

@@ -10,12 +10,6 @@ Removes a user from the recycle bin in the current tenant
 m365 entra user recyclebinitem remove [options]
 ```
 
-## Alias
-
-```sh
-m365 aad user recyclebinitem remove [options]
-```
-
 ## Options
 
 ```md definition-list
@@ -44,13 +38,13 @@ After running this command, it may take a minute before the deleted user is effe
 
 ## Examples
 
-Removes a specific user from the recycle bin
+Removes a specific user from the recycle bin.
 
 ```sh
 m365 entra user recyclebinitem remove --id 59f80e08-24b1-41f8-8586-16765fd830d3
 ```
 
-Removes a specific user from the recycle bin without confirmation prompt
+Removes a specific user from the recycle bin without confirmation prompt.
 
 ```sh
 m365 entra user recyclebinitem remove --id 59f80e08-24b1-41f8-8586-16765fd830d3 --force

package/docs/docs/cmd/entra/user/user-recyclebinitem-restore.mdx

@@ -12,12 +12,6 @@ Restores a user from the recycle bin in the current tenant
 m365 entra user recyclebinitem restore [options]
 ```
 
-## Alias
-
-```sh
-m365 aad user recyclebinitem restore [options]
-```
-
 ## Options
 
 ```md definition-list

package/docs/docs/cmd/entra/user/user-registrationdetails-list.mdx

@@ -12,12 +12,6 @@ Retrieves a list of the authentication methods registered for users
 m365 entra user registrationdetails list [options]
 ```
 
-## Alias
-
-```sh
-m365 aad user registrationdetails list [options]
-```
-
 ## Options
 
 ```md definition-list
@@ -85,43 +79,43 @@ When multiple values are specified for `--registeredMethods` option, the command
 
 ## Examples
 
-Retrieve registration details for all users
+Retrieve registration details for all users.
 
 ```sh
 m365 entra user registrationdetails list
 ```
 
-Retrieve user registration details and returns only specific properties
+Retrieve user registration details and returns only specific properties.
 
 ```sh
 m365 entra user registrationdetails list --properties 'id,isAdmin'
 ```
 
-Retrieve registration details for admins
+Retrieve registration details for admins.
 
 ```sh
 m365 entra user registrationdetails list --isAdmin true
 ```
 
-Retrieve registration details for guest users
+Retrieve registration details for guest users.
 
 ```sh
 m365 entra user registrationdetails list --userType guest
 ```
 
-Retrieve registration details for users who selected either sms or push authentication method as the default second-factor for performing multifactor authentication
+Retrieve registration details for users who selected either sms or push authentication method as the default second-factor for performing multifactor authentication.
 
 ```sh
 m365 entra user registrationdetails list --userPreferredMethodForSecondaryAuthentication 'sms,push'
 ```
 
-Retrieve registration details for users with push authentication method as the most secure authentication method among the registered methods for second factor authentication determined by the system
+Retrieve registration details for users with push authentication method as the most secure authentication method among the registered methods for second factor authentication determined by the system.
 
 ```sh
 m365 entra user registrationdetails list --systemPreferredAuthenticationMethods push
 ```
 
-Retrieve registration details for users who have used either Microsoft Authenticator app or mobile phone during registration
+Retrieve registration details for users who have used either Microsoft Authenticator app or mobile phone during registration.
 
 ```sh
 m365 entra user registrationdetails list --methodsRegistered 'microsoftAuthenticatorPush,mobilePhone'

package/docs/docs/cmd/entra/user/user-remove.mdx

@@ -10,12 +10,6 @@ Removes a specific user
 m365 entra user remove [options]
 ```
 
-## Alias
-
-```sh
-m365 aad user remove [options]
-```
-
 ## Options
 
 ```md definition-list
@@ -53,13 +47,13 @@ After running this command, it may take a minute before the user is effectively
 
 ## Examples
 
-Removes a specific user by id
+Removes a specific user by id.
 
 ```sh
 m365 entra user remove --id a33bd401-9117-4e0e-bb7b-3f61c1539e10
 ```
 
-Removes a specific user by its UPN
+Removes a specific user by its UPN.
 
 ```sh
 m365 entra user remove --userName john.doe@contoso.com

package/docs/docs/cmd/entra/user/user-set.mdx

@@ -10,12 +10,6 @@ Updates information of the specified user
 m365 entra user set [options]
 ```
 
-## Alias
-
-```sh
-m365 aad user set [options]
-```
-
 ## Options
 
 ```md definition-list

package/docs/docs/cmd/entra/user/user-signin-list.mdx

@@ -12,12 +12,6 @@ Retrieves the Entra ID user sign-ins for the tenant
 m365 entra user signin list [options]
 ```
 
-## Alias
-
-```sh
-m365 aad user signin list [options]
-```
-
 ## Options
 
 ```md definition-list
@@ -38,55 +32,55 @@ m365 aad user signin list [options]
 
 ## Examples
 
-Get all user's sign-ins in your tenant
+Get all user's sign-ins in your tenant.
 
 ```sh
 m365 entra user signin list
 ```
 
-Get all user's sign-ins filter by given user's UPN in the tenant
+Get all user's sign-ins filter by given user's UPN in the tenant.
 
 ```sh
 m365 entra user signin list --userName 'johndoe@example.com'
 ```
 
-Get all user's sign-ins filter by given user's Id in the tenant
+Get all user's sign-ins filter by given user's Id in the tenant.
 
 ```sh
 m365 entra user signin list --userId '11111111-1111-1111-1111-111111111111'
 ```
 
-Get all user's sign-ins filter by given application display name in the tenant
+Get all user's sign-ins filter by given application display name in the tenant.
 
 ```sh
 m365 entra user signin list --appDisplayName 'Graph explorer'
 ```
 
-Get all user's sign-ins filter by given application identifier in the tenant
+Get all user's sign-ins filter by given application identifier in the tenant.
 
 ```sh
 m365 entra user signin list --appId '00000000-0000-0000-0000-000000000000'
 ```
 
-Get all user's sign-ins filter by given user's UPN and application display name in the tenant
+Get all user's sign-ins filter by given user's UPN and application display name in the tenant.
 
 ```sh
 m365 entra user signin list --userName 'johndoe@example.com' --appDisplayName 'Graph explorer'
 ```
 
-Get all user's sign-ins filter by given user's Id and application display name in the tenant
+Get all user's sign-ins filter by given user's Id and application display name in the tenant.
 
 ```sh
 m365 entra user signin list --userId '11111111-1111-1111-1111-111111111111' --appDisplayName 'Graph explorer'
 ```
 
-Get all user's sign-ins filter by given user's UPN and application identifier in the tenant
+Get all user's sign-ins filter by given user's UPN and application identifier in the tenant.
 
 ```sh
 m365 entra user signin list --userName 'johndoe@example.com' --appId '00000000-0000-0000-0000-000000000000'
 ```
 
-Get all user's sign-ins filter by given user's Id and application identifier in the tenant
+Get all user's sign-ins filter by given user's Id and application identifier in the tenant.
 
 ```sh
 m365 entra user signin list --userId '11111111-1111-1111-1111-111111111111' --appId '00000000-0000-0000-0000-000000000000'

package/docs/docs/cmd/external/item/item-add.mdx

@@ -63,13 +63,13 @@ For more information about using these options, see the Microsoft Graph API docu
 Creates an external item with simple properties that everyone is allowed to access
 
 ```sh
-m365 external item add --id "pnp-ensure-siteassets-library" --connectionId "samplesolutiongallery" --content "Ensure that the Site Assets library is created." --title "Ensure the Site Assets Library is created" --description "Ensure that the Site Assets library is created." --authors "Phil Harding" --acls "grant,everyone,everyone"
+m365 external item add --id "pnp-ensure-siteassets-library" --externalConnectionId "samplesolutiongallery" --content "Ensure that the Site Assets library is created." --title "Ensure the Site Assets Library is created" --description "Ensure that the Site Assets library is created." --authors "Phil Harding" --acls "grant,everyone,everyone"
 ```
 
 Creates an external item with multi-value properties accessible only to users from the specified Entra group
 
 ```sh
-m365 external item add --id "pnp-ensure-siteassets-library" --connectionId "samplesolutiongallery" --content "Ensure that the Site Assets library is created." --title "Ensure the Site Assets Library is created" --description "Ensure that the Site Assets library is created." --authors@odata.type "Collection(String)" --authors "Phil Harding;#Steve Smith" --acls "grant,group,Super users"
+m365 external item add --id "pnp-ensure-siteassets-library" --externalConnectionId "samplesolutiongallery" --content "Ensure that the Site Assets library is created." --title "Ensure the Site Assets Library is created" --description "Ensure that the Site Assets library is created." --authors@odata.type "Collection(String)" --authors "Phil Harding;#Steve Smith" --acls "grant,group,Super users"
 ```
 
 ## Response
@@ -123,7 +123,7 @@ m365 external item add --id "pnp-ensure-siteassets-library" --connectionId "samp
   <TabItem value="Markdown">
 
   ```md
-  # m365 external item add --id "pnp-ensure-siteassets-library" --connectionId "samplesolutiongallery" --content "Ensure that the Site Assets library is created." --title "Ensure the Site Assets Library is created" --description "Ensure that the Site Assets library is created." --authors "Phil Harding" --acls "grant,everyone,everyone"
+  # m365 external item add --id "pnp-ensure-siteassets-library" --externalConnectionId "samplesolutiongallery" --content "Ensure that the Site Assets library is created." --title "Ensure the Site Assets Library is created" --description "Ensure that the Site Assets library is created." --authors "Phil Harding" --acls "grant,everyone,everyone"
 
   Date: 2023-10-28
 

package/docs/docs/cmd/login.mdx

@@ -47,6 +47,9 @@ m365 login [options]
 
 `--connectionName [connectionName]`
 : Specify an optional name to make switching between connections easier.
+
+`--ensure`
+: Ensures that the user is signed in. if the user isn't signed in, it initiates the login flow
 ```
 
 <Global />
@@ -190,6 +193,12 @@ Log in to Microsoft 365 using a client secret.
 m365 login --authType secret --secret topSeCr3t@007
 ```
 
+Ensures that the user is signed in, initiates the login flow if the user isn't signed in
+
+```sh
+m365 login --ensure
+```
+
 ## Response
 
 <Tabs>

package/docs/docs/cmd/spfx/project/project-upgrade.mdx

@@ -35,7 +35,7 @@ m365 spfx project upgrade [options]
 
 ## Remarks
 
-The `spfx project upgrade` command helps you upgrade your SharePoint Framework project to the specified version. If no version is specified, the command will upgrade to the latest version of the SharePoint Framework it supports (v1.19.0).
+The `spfx project upgrade` command helps you upgrade your SharePoint Framework project to the specified version. If no version is specified, the command will upgrade to the latest version of the SharePoint Framework it supports (v1.20.0).
 
 This command doesn't change your project files. Instead, it gives you a report with all steps necessary to upgrade your project to the specified version of the SharePoint Framework. Changing project files is error-prone, especially when it comes to updating your solution's code. This is why at this moment, this command produces a report that you can use yourself to perform the necessary updates and verify that everything is working as expected.
 

package/docs/docs/cmd/spo/file/file-move.mdx

@@ -40,15 +40,13 @@ m365 spo file move [options]
 : This indicates whether a file with a share lock can still be moved. Use this option to move a file that is locked.
 
 `--skipWait`
-: Don't wait for the copy operation to complete.
+: Don't wait for the move operation to complete.
 ```
 
 <Global />
 
 ## Remarks
 
-All file versions are retained while moving a file.
-
 When you specify a value for `nameConflictBehavior`, consider the following:
 - `fail` will throw an error when the destination file already exists.
 - `replace` will replace the destination file if it already exists.