@pnp/cli-microsoft365 10.0.0-beta.0b765ef → 10.0.0-beta.303b62c

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/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/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.

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

@@ -31,6 +31,9 @@ m365 spo page template remove
 `--recycle`
 : Recycle the file instead of actually deleting it.
 
+`--bypassSharedLock`
+: Remove the file even if it is locked for shared use.
+
 `-f, --force`
 : Don't prompt for confirming removing the file.
 ```
@@ -39,22 +42,28 @@ m365 spo page template remove
 
 ## Examples
 
-Remove file by ID.
+Remove a file by ID.
 
 ```sh
 m365 spo file remove --webUrl https://contoso.sharepoint.com/sites/project-x --id 0cd891ef-afce-4e55-b836-fce03286cccf
 ```
 
-Remove the file by site-relative URL.
+Remove a file by site-relative URL.
 
 ```sh
 m365 spo file remove --webUrl https://contoso.sharepoint.com/sites/project-x --url "/Shared Documents/Test.docx"
 ```
 
-Move the file by server-relative URL to the recycle bin.
+Remove a file by server-relative URL to the recycle bin.
+
+```sh
+m365 spo file remove --webUrl https://contoso.sharepoint.com/sites/project-x --url "/sites/project-x/Shared Documents/Test.docx" --recycle
+```
+
+Remove a file that is locked
 
 ```sh
-m365 spo file remove --webUrl https://contoso.sharepoint.com/sites/project-x --url "/sites/project-x/SharedDocuments/Test.docx" --recycle
+m365 spo file remove --webUrl https://contoso.sharepoint.com/sites/project-x --url "/Shared Documents/Test.docx" --bypassSharedLock
 ```
 
 Remove a page template by site-relative URL.

package/docs/docs/cmd/spo/folder/folder-copy.mdx

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo folder copy
 
@@ -31,19 +33,14 @@ m365 spo folder copy [options]
 `--nameConflictBehavior [nameConflictBehavior]`
 : Behavior when a file or folder with the same name is already present at the destination. Allowed values: `fail`, `rename`. Defaults to `fail`.
 
-`--resetAuthorAndCreated`
-: Use this option to clear the author and created date. When not specified, the values from the source folder are used.
-
-`--bypassSharedLock`
-: This indicates whether a folder with a shared lock can still be moved. Use this option to copy a folder that is locked.
+`--skipWait`
+: Don't wait for the copy operation to complete.
 ```
 
 <Global />
 
 ## Remarks
 
-When you copy a folder with documents that have version history, only the latest document version is copied.
-
 When you specify a value for `nameConflictBehavior`, consider the following:
 
 - `fail` will throw an error when the destination folder already exists.
@@ -69,16 +66,90 @@ Copy a folder to another location and use new name on conflict
 m365 spo folder copy --webUrl https://contoso.sharepoint.com/sites/project-x --sourceUrl "/sites/project-x/Shared Documents/Reports" --targetUrl "/sites/project-y/Shared Documents/Project files" --nameConflictBehavior rename
 ```
 
-Copy a folder referenced by its ID to another document library and reset author and created date
+Copy a folder referenced by its ID to another document library and don't wait for the copy operation to finish
 
 ```sh
-m365 spo folder copy --webUrl https://contoso.sharepoint.com/sites/project-x --sourceId b8cc341b-9c11-4f2d-aa2b-0ce9c18bcba2 --targetUrl "/sites/project-x/Project files" --retainEditorAndModified
+m365 spo folder copy --webUrl https://contoso.sharepoint.com/sites/project-x --sourceId b8cc341b-9c11-4f2d-aa2b-0ce9c18bcba2 --targetUrl "/sites/project-x/Project files" --skipWait
 ```
 
 ## Response
 
-The command won't return a response on success.
+### Standard Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "Exists": true,
+    "ExistsAllowThrowForPolicyFailures": true,
+    "ExistsWithException": true,
+    "IsWOPIEnabled": false,
+    "ItemCount": 6,
+    "Name": "Company",
+    "ProgID": null,
+    "ServerRelativeUrl": "/sites/Sales/Icons/Company",
+    "TimeCreated": "2024-09-26T22:08:53Z",
+    "TimeLastModified": "2024-09-26T22:09:31Z",
+    "UniqueId": "d3a37396-ca16-467b-b968-48f5fc41f2b6",
+    "WelcomePage": ""
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  Exists                           : true
+  ExistsAllowThrowForPolicyFailures: true
+  ExistsWithException              : true
+  IsWOPIEnabled                    : false
+  ItemCount                        : 6
+  Name                             : Company
+  ProgID                           : null
+  ServerRelativeUrl                : /sites/Sales/Icons/Company
+  TimeCreated                      : 2024-09-26T22:08:53Z
+  TimeLastModified                 : 2024-09-26T22:09:31Z
+  UniqueId                         : d3a37396-ca16-467b-b968-48f5fc41f2b6
+  WelcomePage                      :
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  Exists,ExistsAllowThrowForPolicyFailures,ExistsWithException,IsWOPIEnabled,ItemCount,Name,ProgID,ServerRelativeUrl,TimeCreated,TimeLastModified,UniqueId,WelcomePage
+  1,1,1,0,6,Company,,/sites/Sales/Icons/Company,2024-09-26T22:08:53Z,2024-09-26T22:09:31Z,d3a37396-ca16-467b-b968-48f5fc41f2b6,
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # spo folder copy --webUrl "https://contoso.sharepoint.com/sites/Marketing" --sourceUrl "/Logos/Contoso" --targetUrl "/sites/Sales/Logos"
+
+  Date: 18/10/2024
+
+  ## Company (d3a37396-ca16-467b-b968-48f5fc41f2b6)
+
+  Property | Value
+  ---------|-------
+  Exists | true
+  ExistsAllowThrowForPolicyFailures | true
+  ExistsWithException | true
+  IsWOPIEnabled | false
+  ItemCount | 6
+  Name | Company
+  ServerRelativeUrl | /sites/Sales/Icons/Company
+  TimeCreated | 2024-09-26T22:08:53Z
+  TimeLastModified | 2024-09-26T22:09:31Z
+  UniqueId | d3a37396-ca16-467b-b968-48f5fc41f2b6
+  WelcomePage | 
+  ```
+
+  </TabItem>
+</Tabs>
+
+### `skipWait` response
 
-## More information
-
-- Copy items from a SharePoint document library: [https://support.office.com/en-us/article/move-or-copy-items-from-a-sharepoint-document-library-00e2f483-4df3-46be-a861-1f5f0c1a87bc](https://support.office.com/en-us/article/move-or-copy-items-from-a-sharepoint-document-library-00e2f483-4df3-46be-a861-1f5f0c1a87bc)
+The command won't return a response on success.