@pnp/cli-microsoft365 10.0.0-beta.e925c1c → 10.0.0-beta.fd332f4

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/file/file-move.mdx

@@ -0,0 +1,79 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# file move
+
+Moves a file to another location using the Microsoft Graph
+
+## Usage
+
+```sh
+m365 file move [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: The URL of the site where the file is located.
+
+`-s, --sourceUrl <sourceUrl>`
+: Server-relative or absolute URL of the file.
+
+`-t, --targetUrl <targetUrl>`
+: Server-relative or absolute URL of the location.
+
+`--newName [newName]`
+: New name of the destination file.
+
+`--nameConflictBehavior [nameConflictBehavior]`
+: Behavior when a document with the same name is already present at the destination. Possible values: `fail`, `replace`, `rename`. Default is `fail`.
+```
+
+<Global />
+
+## Remarks
+
+- If the source and target locations are within the same document library or drive, the command will utilize the Move DriveItem API, preserving the version history of the file.
+- If the source and target locations are in different document libraries or drives, the command will use a copy-and-delete combination to move the file. Please note that in this case, version history will not be retained.
+
+## Examples
+
+Move a file by server-relative URL to a folder in the same document library
+
+```sh
+m365 file move --webUrl "https://contoso.sharepoint.com/sites/project" --sourceUrl "/sites/project/Shared Documents/Document.pdf" --targetUrl "/sites/project/Shared Documents/NewFolder"
+```
+
+Move a file by server-relative URL to a document library in another site collection with server relative URL
+
+```sh
+m365 file move --webUrl "https://contoso.sharepoint.com/sites/project" --sourceUrl "/sites/project/Shared Documents/Document.pdf" --targetUrl "/sites/IT/Shared Documents"
+```
+
+Move a file by absolute URL to a document library in another site collection with absolute URL
+
+```sh
+m365 file move --webUrl "https://contoso.sharepoint.com" --sourceUrl "https://contoso.sharepoint.com/Shared Documents/Document.pdf" --targetUrl "https://contoso.sharepoint.com/sites/IT/Shared Documents"
+```
+
+Move a file to a document library in another site collection and rename the file
+
+```sh
+m365 file move --webUrl "https://contoso.sharepoint.com" --sourceUrl "/Shared Documents/Document.pdf" --targetUrl "/sites/IT/Shared Documents" --newName "newName"
+```
+
+Move a file to a document library in another site collection and rename the file if a file with the same name already exists.
+
+```sh
+m365 file move --webUrl "https://contoso.sharepoint.com" --sourceUrl "/Shared Documents/Document.pdf" --targetUrl "/sites/IT/Shared Documents" --nameConflictBehavior rename
+```
+
+Move a file to Onedrive for business 
+
+```sh
+m365 file move --webUrl "https://contoso.sharepoint.com" --sourceUrl "/Shared Documents/Document.pdf" --targetUrl "https://contoso-my.sharepoint.com/personal/john_contoso_onmicrosoft_com/documents"
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/flow/recyclebinitem/recyclebinitem-list.mdx

@@ -0,0 +1,132 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# flow recyclebinitem list
+
+Lists all soft-deleted Power Automate flows within an environment
+
+## Usage
+
+```sh
+m365 flow recyclebinitem list [options]
+```
+
+## Options
+
+```md definition-list
+`-e, --environmentName <environmentName>`
+: The name of the environment.
+```
+
+<Global />
+
+## Remarks
+
+:::warning
+
+This command is based on an API that is currently in preview and is subject to change once the API reaches general availability.
+
+:::
+
+:::info
+
+To use this command, you must be a Global or Power Platform administrator.
+
+:::
+
+A Power Automate flow is soft-deleted when:
+- It's a non-solution flow.
+- It's been deleted less than 21 days ago.
+
+If the environment with the name you specified doesn't exist, you will get the `Access to the environment 'xyz' is denied.` error.
+
+## Examples
+
+List all soft-deleted flows within a specific environment
+
+```sh
+m365 flow recyclebinitem list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "name": "26a9a283-af42-4c09-aa3e-60c3cc166b90",
+      "id": "/providers/Microsoft.ProcessSimple/environments/Default-d87a7535-dd31-4437-bfe1-95340acd55c5/flows/26a9a283-af42-4c09-aa3e-60c3cc166b90",
+      "type": "Microsoft.ProcessSimple/environments/flows",
+      "properties": {
+        "apiId": "/providers/Microsoft.PowerApps/apis/shared_logicflows",
+        "displayName": "Invoicing flow",
+        "state": "Deleted",
+        "createdTime": "2024-08-05T23:13:54Z",
+        "lastModifiedTime": "2024-08-05T23:14:00Z",
+        "flowSuspensionReason": "None",
+        "environment": {
+          "name": "Default-d87a7535-dd31-4437-bfe1-95340acd55c5",
+          "type": "Microsoft.ProcessSimple/environments",
+          "id": "/providers/Microsoft.ProcessSimple/environments/Default-d87a7535-dd31-4437-bfe1-95340acd55c5"
+        },
+        "definitionSummary": {
+          "triggers": [],
+          "actions": []
+        },
+        "creator": {
+          "tenantId": "a16e76a1-837f-4bf9-82dc-78874d18e434",
+          "objectId": "bd51c64d-c262-4184-ba3f-5361ea553820",
+          "userId": "bd51c64d-c262-4184-ba3f-5361ea553820",
+          "userType": "ActiveDirectory"
+        },
+        "flowFailureAlertSubscribed": false,
+        "isManaged": false,
+        "machineDescriptionData": {},
+        "flowOpenAiData": {
+          "isConsequential": false,
+          "isConsequentialFlagOverwritten": false
+        }
+      }
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  name                                  displayName
+  ------------------------------------  --------------
+  26a9a283-af42-4c09-aa3e-60c3cc166b90  Invoicing flow
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  name,id,type
+  26a9a283-af42-4c09-aa3e-60c3cc166b90,/providers/Microsoft.ProcessSimple/environments/Default-d87a7535-dd31-4437-bfe1-95340acd55c5/flows/26a9a283-af42-4c09-aa3e-60c3cc166b90,Microsoft.ProcessSimple/environments/flows
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # flow recyclebinitem list --environmentName "Default-d87a7535-dd31-4437-bfe1-95340acd55c5"
+
+  Date: 06/08/2024
+
+  ## 26a9a283-af42-4c09-aa3e-60c3cc166b90 (/providers/Microsoft.ProcessSimple/environments/Default-d87a7535-dd31-4437-bfe1-95340acd55c5/flows/26a9a283-af42-4c09-aa3e-60c3cc166b90)
+
+  Property | Value
+  ---------|-------
+  name | 26a9a283-af42-4c09-aa3e-60c3cc166b90
+  id | /providers/Microsoft.ProcessSimple/environments/Default-d87a7535-dd31-4437-bfe1-95340acd55c5/flows/26a9a283-af42-4c09-aa3e-60c3cc166b90
+  type | Microsoft.ProcessSimple/environments/flows
+  ```
+
+  </TabItem>
+</Tabs>

package/docs/docs/cmd/flow/recyclebinitem/recyclebinitem-restore.mdx

@@ -0,0 +1,55 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# flow recyclebinitem restore
+
+Restores a soft-deleted Power Automate flow
+
+## Usage
+
+```sh
+m365 flow recyclebinitem restore [options]
+```
+
+## Options
+
+```md definition-list
+`-e, --environmentName <environmentName>`
+: The name of the environment where the flow is located.
+
+`-n, --flowName <flowName>`
+: The name of the Power Automate flow.
+```
+
+<Global />
+
+## Remarks
+
+:::warning
+
+This command is based on an API that is currently in preview and is subject to change once the API reaches general availability.
+
+:::
+
+:::info
+
+To use this command, you must be a Global or Power Platform administrator.
+
+:::
+
+When a Power Automate flow is restored, it will be automatically disabled. To make it operational again, you must [enable](../flow-enable.mdx) it.
+
+If the environment with the name you specified doesn't exist, you will get the `Access to the environment 'xyz' is denied.` error.
+
+## Examples
+
+Restores a soft-deleted flow within a specific environment
+
+```sh
+m365 flow recyclebinitem restore --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a
+```
+
+## Response
+
+The command won't return a response on success.

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>