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

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>

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/cdn/cdn-get.mdx

@@ -27,7 +27,7 @@ Using the `-t, --type` option you can choose whether you want to manage the sett
 
 :::info
 
-To use this command you have to have permissions to access the tenant admin site.
+To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
 
 :::
 

package/docs/docs/cmd/spo/cdn/cdn-origin-add.mdx

@@ -28,7 +28,7 @@ Using the `-t, --type` option you can choose whether you want to manage the sett
 
 :::info
 
-To use this command you have to have permissions to access the tenant admin site.
+To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
 
 :::
     

package/docs/docs/cmd/spo/cdn/cdn-origin-list.mdx

@@ -27,7 +27,7 @@ Using the `-t, --type` option you can choose whether you want to manage the sett
 
 :::info
 
-To use this command you have to have permissions to access the tenant admin site.
+To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
 
 :::
 

package/docs/docs/cmd/spo/cdn/cdn-origin-remove.mdx

@@ -31,7 +31,7 @@ Using the `-t, --type` option you can choose whether you want to manage the sett
 
 :::info
 
-To use this command you have to have permissions to access the tenant admin site.
+To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
 
 :::
     

package/docs/docs/cmd/spo/cdn/cdn-policy-list.mdx

@@ -27,7 +27,7 @@ Using the `-t, --cdnType` option you can choose whether you want to manage the s
 
 :::info
 
-To use this command you have to have permissions to access the tenant admin site.
+To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
 
 :::
 

package/docs/docs/cmd/spo/cdn/cdn-policy-set.mdx

@@ -31,7 +31,7 @@ Using the `-t, --cdnType` option you can choose whether you want to manage the s
 
 :::info
 
-To use this command you have to have permissions to access the tenant admin site.
+To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
 
 :::
     

package/docs/docs/cmd/spo/externaluser/externaluser-list.mdx

@@ -37,7 +37,7 @@ m365 spo externaluser list [options]
 
 :::info
 
-To use this command you have to have permissions to access the tenant admin site.
+To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
 
 :::
 

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

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo file move
 
@@ -31,21 +33,21 @@ m365 spo file move [options]
 `--nameConflictBehavior [nameConflictBehavior]`
 : Behavior when a file or folder with the same name is already present at the destination. Allowed values: `fail`, `replace`, `rename`. Defaults to `fail`.
 
-`--retainEditorAndModified`
-: Use this option to retain the editor and modified date. When not specified, these values are reset when moving to another library.
+`--includeItemPermissions`
+: Ensure that item-level permissions are preserved during the move.
 
 `--bypassSharedLock`
 : 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 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.
 - `rename` will add a suffix (e.g. Document1.pdf) when the destination file already exists.
@@ -70,16 +72,119 @@ Move a file to another document library and replace a file with the same name.
 m365 spo file move --webUrl https://contoso.sharepoint.com/sites/project-x --sourceUrl "/Shared Documents/Report project-x.pdf" --targetUrl "/sites/project-x/My Documents" --newName Report.pdf --nameConflictBehavior replace
 ```
 
-Move a file referenced by its ID to another document library and retain editor and modified date.
+Move a file referenced by its ID to another document library and retain item-level permissions.
 
 ```sh
-m365 spo file move --webUrl https://contoso.sharepoint.com/sites/project-x --sourceId b8cc341b-9c11-4f2d-aa2b-0ce9c18bcba2 --targetUrl "/sites/project-x/My Documents" --retainEditorAndModified
+m365 spo file move --webUrl https://contoso.sharepoint.com/sites/project-x --sourceId b8cc341b-9c11-4f2d-aa2b-0ce9c18bcba2 --targetUrl "/sites/project-x/My Documents" --includeItemPermissions
 ```
 
 ## Response
 
-The command won't return a response on success.
-
-## More information
+### Standard Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "CheckInComment": "",
+    "CheckOutType": 2,
+    "ContentTag": "{03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1,1",
+    "CustomizedPageStatus": 0,
+    "ETag": "\"{03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1\"",
+    "Exists": true,
+    "IrmEnabled": false,
+    "Length": "5987",
+    "Level": 1,
+    "LinkingUri": null,
+    "LinkingUrl": "",
+    "MajorVersion": 1,
+    "MinorVersion": 0,
+    "Name": "Test1.docx",
+    "ServerRelativeUrl": "/sites/project-x/documents/Test1.docx",
+    "TimeCreated": "2022-10-30T10:16:18Z",
+    "TimeLastModified": "2022-10-30T10:16:18Z",
+    "Title": null,
+    "UIVersion": 512,
+    "UIVersionLabel": "1.0",
+    "UniqueId": "b2307a39-e878-458b-bc90-03bc578531d6"
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  CheckInComment      :
+  CheckOutType        : 2
+  ContentTag          : {03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1,1
+  CustomizedPageStatus: 0
+  ETag                : "{03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1"
+  Exists              : true
+  IrmEnabled          : false
+  Length              : 5987
+  Level               : 1
+  LinkingUri          : null
+  LinkingUrl          :
+  MajorVersion        : 1
+  MinorVersion        : 0
+  Name                : Test1.docx
+  ServerRelativeUrl   : /sites/project-x/documents/Test1.docx
+  TimeCreated         : 2022-10-30T10:16:18Z
+  TimeLastModified    : 2022-10-30T10:16:18Z
+  Title               : null
+  UIVersion           : 512
+  UIVersionLabel      : 1.0
+  UniqueId            : b2307a39-e878-458b-bc90-03bc578531d6
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  CheckInComment,CheckOutType,ContentTag,CustomizedPageStatus,ETag,Exists,IrmEnabled,Length,Level,LinkingUri,LinkingUrl,MajorVersion,MinorVersion,Name,ServerRelativeUrl,TimeCreated,TimeLastModified,Title,UIVersion,UIVersionLabel,UniqueId
+  ,2,"{03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1,1",0,"""{03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1""",1,,5987,1,,,1,0,Test1.docx,/sites/project-x/documents/Test1.docx,2022-10-30T10:16:18Z,2022-10-30T10:16:18Z,,512,1.0,b2307a39-e878-458b-bc90-03bc578531d6
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # spo file move --webUrl "https://contoso.sharepoint.com/sites/IT" --sourceUrl "/Shared Documents/Document.docx" --targetUrl "/sites/project-x/Shared Documents"
+
+  Date: 10/3/2023
+
+  ## b2307a39-e878-458b-bc90-03bc578531d6
+
+  Property | Value
+  ---------|-------
+  CheckInComment |
+  CheckOutType | 2
+  ContentTag | {03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1,1
+  CustomizedPageStatus | 0
+  ETag | "{03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1"
+  Exists | true
+  ExistsAllowThrowForPolicyFailures | true
+  IrmEnabled | false
+  Length | 5987
+  Level | 1
+  LinkingUri | https://contoso.sharepoint.com/sites/project-x/shared%20documents/Document.docx?d=w59d4e6fcf6f94ce78bea0273cedb1a19
+  LinkingUrl | https://contoso.sharepoint.com/sites/project-x/shared documents/Document.docx?d=w59d4e6fcf6f94ce78bea0273cedb1a19
+  MajorVersion | 1
+  MinorVersion | 0
+  Name | Document.docx
+  ServerRelativeUrl | /sites/project-x/shared documents/Document.docx
+  TimeCreated | 2023-05-23T09:51:34Z
+  TimeLastModified | 2023-05-23T10:13:01Z
+  Title |
+  UIVersion | 1536
+  UIVersionLabel | 1.0
+  UniqueId | b2307a39-e878-458b-bc90-03bc578531d6
+  ```
+
+  </TabItem>
+</Tabs>
+
+### `skipWait` response
 
-- Move 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.

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

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo folder move
 
@@ -31,19 +33,14 @@ m365 spo folder move [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`.
 
-`--retainEditorAndModified`
-: Use this option to retain the editor and modified date. When not specified, these values are reset.
-
-`--bypassSharedLock`
-: This indicates whether a folder with a share lock can still be moved. Use this option to move a folder that is locked.
+`--skipWait`
+: Don't wait for the move operation to complete.
 ```
 
 <Global />
 
 ## Remarks
 
-All folder versions are retained while moving a folder.
-
 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 @@ Move a folder to another location and use a new name on conflict.
 m365 spo folder move --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
 ```
 
-Move a folder referenced by its ID to another document library and retain editor and modified date.
+Move a folder referenced by its ID to another document library and don't wait for the move job to finish.
 
 ```sh
-m365 spo folder move --webUrl https://contoso.sharepoint.com/sites/project-x --sourceId b8cc341b-9c11-4f2d-aa2b-0ce9c18bcba2 --targetUrl "/sites/project-x/Project files" --retainEditorAndModified
+m365 spo folder move --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 move --webUrl "https://contoso.sharepoint.com/sites/Marketing" --sourceUrl "/Logos/Contoso" --targetUrl "/sites/Sales/Logos"
+
+  Date: 27/09/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
-
-- Move 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.