@pnp/cli-microsoft365 6.7.0-beta.54db310 → 6.7.0-beta.872b0f5

package/docs/docs/cmd/aad/user/user-set.md

@@ -25,17 +25,56 @@ m365 aad user set [options]
 `--forceChangePasswordNextSignIn`
 : If specified, the user will have to change his password the next time they log in. Can only be set in combination with `resetPassword`.
 
+`--forceChangePasswordNextSignInWithMfa`
+: Whether the user should change his/her password on the next login and setup MFA. Can only be set in combination with `resetPassword`.
+
 `--currentPassword [currentPassword]`
 : Current password of the user that is signed in. If this parameter is set, `newPassword` is mandatory. Can't be combined with `resetPassword`.
 
 `--newPassword [newPassword]`
 : New password to be set. Must be set when specifying either `resetPassword` or `currentPassword`.
 
+`--displayName [displayName]`
+: The name to display in the address book for the user.
+
+`--firstName [firstName]`
+: The given name (first name) of the user. Maximum length is 64 characters.
+
+`--lastName [lastName]`
+: The user's surname (family name or last name). Maximum length is 64 characters.
+
+`--usageLocation [usageLocation]`
+: A two letter [country code](https://learn.microsoft.com/en-us/partner-center/commercial-marketplace-co-sell-location-codes#country-and-region-codes) (ISO standard 3166). Required for users that will be assigned licenses.
+
+`--officeLocation [officeLocation]` 
+: The office location in the user's place of business.
+
+`--jobTitle [jobTitle]`
+: The user's job title. Maximum length is 128 characters.
+
+`--companyName [companyName]`
+: The company name which the user is associated. The maximum length is 64 characters.
+
+`--department [department]`
+: The name for the department in which the user works. Maximum length is 64 characters.
+
+`--preferredLanguage [preferredLanguage]`
+: The preferred language for the user. Should follow [ISO 639-1 Code](https://learn.microsoft.com/en-us/openspecs/office_standards/ms-oe376/6c085406-a698-4e12-9d4d-c3b0ee3dbc4a). Example: `en-US`.
+
+`--managerUserId [managerUserId]`
+: User ID of the user's manager. Specify `managerUserId`, `managerUserName` or `removeManager` but not both.
+
+`--managerUserName [managerUserName]`
+: User principal name of the manager. Specify `managerUserId`, `managerUserName` or `removeManager` but not both.
+
+`--removeManager`
+: Remove currently set manager. The user will have no manager when this flag is set. Specify `managerUserId`, `managerUserName` or `removeManager` but not both.
+
 --8<-- "docs/cmd/_global.md"
 
 ## Remarks
 
-You can update information of a user, either by specifying that user's id (`objectId`) or user name (`userPrincipalName`), but not both.
+This command allows using unknown options.
 
 If the user with the specified id or user name doesn't exist, you will get a `Resource 'xyz' does not exist or one of its queried reference-property objects are not present.` error.
 
@@ -50,7 +89,7 @@ m365 aad user set --objectId 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --Department I
 Update multiple properties of user with name _steve@contoso.onmicrosoft.com_
 
 ```sh
-m365 aad user set --userPrincipalName steve@contoso.onmicrosoft.com --Department "Sales & Marketing" --CompanyName Contoso
+m365 aad user set --userPrincipalName steve@contoso.onmicrosoft.com --firstName John --lastName Doe --jobTitle "Sales Manager" --companyName Contoso --department Sales --officeLocation "New York"
 ```
 
 Enable user with id _1caf7dcd-7e83-4c3a-94f7-932a1299c844_
@@ -65,12 +104,6 @@ Disable user with id _1caf7dcd-7e83-4c3a-94f7-932a1299c844_
 m365 aad user set --objectId 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --accountEnabled false
 ```
 
-Enable user with id _1caf7dcd-7e83-4c3a-94f7-932a1299c844_
-
-```sh
-m365 aad user set --objectId 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --accountEnabled true
-```
-
 Reset password of a given user by userPrincipalName and require the user to change the password on the next sign in
 
 ```sh
@@ -83,6 +116,18 @@ Change password of the currently logged in user
 m365 aad user set --objectId 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --currentPassword SLBF5gnRtyYc --newPassword 6NLUId79Lc24
 ```
 
+Updates a user with a manager
+
+```sh
+m365 aad user set --displayName "John Doe" --userName "john.doe@contoso.com" --managerUserName "adele@contoso.com"
+```
+
+Updates a user by removing its manager
+
+```sh
+m365 aad user set --userName "john.doe@contoso.com" --removeManager
+```
+
 ## Response
 
 The command won't return a response on success.

package/docs/docs/cmd/flow/run/run-get.md

@@ -19,6 +19,9 @@ m365 flow run get [options]
 `-e, --environmentName <environmentName>`
 : The name of the environment where the flow is located
 
+`--includeTriggerInformation`
+: If specified, include information about the trigger details
+
 --8<-- "docs/cmd/_global.md"
 
 ## Remarks
@@ -32,6 +35,8 @@ If the Microsoft Flow with the name you specified doesn't exist, you will get th
 
 If the run with the name you specified doesn't exist, you will get the `The provided workflow run name is not valid.` error.
 
+If the option `includeTriggerInformation` is specified, but the trigger does not contain an outputsLink such as for example with a `Recurrence` trigger, this option will be ignored.
+
 ## Examples
 
 Get information about the given run of the specified Power Automate flow
@@ -40,6 +45,11 @@ Get information about the given run of the specified Power Automate flow
 m365 flow run get --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a --name 08586653536760200319026785874CU62
 ```
 
+Get information about the given run of the specified Power Automate flow including trigger information
+
+```sh
+m365 flow run get --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a --name 08586653536760200319026785874CU62 --includeTriggerInformation
+```
 
 ## Response
 
@@ -61,7 +71,7 @@ m365 flow run get --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5
         "trigger": {
           "name": "When_a_new_response_is_submitted",
           "inputsLink": {
-            "uri": "https://prod-08.centralindia.logic.azure.com:443/workflows/f7bf8f6b5c494e63bfc21b54087a596e/runs/08585329112602833828909892130CU17/contents/TriggerInputs?api-version=2016-06-01&se=2022-11-17T18%3A00%3A00.0000000Z&sp=%2Fruns%2F08585329112602833828909892130CU17%2Fcontents%2FTriggerInputs%2Fread&sv=1.0&sig=jmdMRWvY7uGoxTmqd3_a2bJtegXuVyuKTKKUVLiwh38",
+            "uri": "https://prod-08.centralindia.logic.azure.com:443/workflows/f7bf8f6b5c494e63bfc21b54087a596e/runs/08585329112602833828909892130CU17/contents/TriggerInputs?api-version=2016-06-01&se=2022-11-17T18%3A00%3A00.0000000Z&sp=%2Fruns%2F08585329112602833828909892130CU17%2Fcontents%2FTriggerInputs%2Fread&sv=1.0&sig=",
             "contentVersion": "6ZrBBE+MJg7IvhMgyJLMmA==",
             "contentSize": 349,
             "contentHash": {
@@ -70,7 +80,7 @@ m365 flow run get --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5
             }
           },
           "outputsLink": {
-            "uri": "https://prod-08.centralindia.logic.azure.com:443/workflows/f7bf8f6b5c494e63bfc21b54087a596e/runs/08585329112602833828909892130CU17/contents/TriggerOutputs?api-version=2016-06-01&se=2022-11-17T18%3A00%3A00.0000000Z&sp=%2Fruns%2F08585329112602833828909892130CU17%2Fcontents%2FTriggerOutputs%2Fread&sv=1.0&sig=Y3qqjuWrrcQJrmF7uvm6LVzQy5w-dNOFWJ8Yt8khXvA",
+            "uri": "https://prod-08.centralindia.logic.azure.com:443/workflows/f7bf8f6b5c494e63bfc21b54087a596e/runs/08585329112602833828909892130CU17/contents/TriggerOutputs?api-version=2016-06-01&se=2022-11-17T18%3A00%3A00.0000000Z&sp=%2Fruns%2F08585329112602833828909892130CU17%2Fcontents%2FTriggerOutputs%2Fread&sv=1.0&sig=",
             "contentVersion": "Z/4a8tfYygNAR1xpc44iww==",
             "contentSize": 493,
             "contentHash": {
@@ -97,17 +107,108 @@ m365 flow run get --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5
 === "Text"
 
     ```text
-    endTime    :
-    name       : 08585329112602833828909892130CU17
-    startTime  : 2022-11-17T14:33:45.2763872Z
-    status     : Running
-    triggerName: When_a_new_response_is_submitted
+    endTime    : 2023-03-04T09:05:22.5880202Z
+    name       : 08585236861638480597867166179CU104
+    startTime  : 2023-03-04T09:05:21.8066368Z
+    status     : Succeeded
+    triggerName: When_an_email_is_flagged_(V4)
     ```
 
 === "CSV"
 
     ```csv
     name,startTime,endTime,status,triggerName
-    08585329112602833828909892130CU17,2022-11-17T14:33:45.2763872Z,,Running,When_a_new_response_is_submitted
+    08585236861638480597867166179CU104,2023-03-04T09:05:21.8066368Z,2023-03-04T09:05:22.5880202Z,Succeeded,When_an_email_is_flagged_(V4)
+    ```
+
+=== "Markdown"
+
+    ```md
+    # flow run get --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a --name 08586653536760200319026785874CU62
+
+    Date: 04/03/2023
+
+    ## 08586653536760200319026785874CU62 (/providers/Microsoft.ProcessSimple/environments/Default-d87a7535-dd31-4437-bfe1-95340acd55c5/flows/5923cb07-ce1a-4a5c-ab81-257ce820109a/runs/08586653536760200319026785874CU62)
+
+    Property | Value
+    ---------|-------
+    name | 08586653536760200319026785874CU62
+    id | /providers/Microsoft.ProcessSimple/environments/Default-e1dd4023-a656-480a-8a0e-c1b1eec51e1d/flows/c3c707b5-fefd-4f7a-a96c-b8e0d5ca3cc1/runs/08585208964855963748594654409CU47
+    type | Microsoft.ProcessSimple/environments/flows/runs
+    startTime | 2023-03-04T09:05:21.8066368Z
+    endTime | 2023-03-04T09:05:22.5880202Z
+    status | Succeeded
+    triggerName | When\_an\_email\_is\_flagged\_(V4)
+    ```
+
+### `includeTriggerInformation` response
+
+When using the option `includeTriggerInformation`, the response for the json-output will differ.
+
+=== "JSON"
+
+    ```json
+    {
+      "name": "08585236861638480597867166179CU104",
+      "id": "/providers/Microsoft.ProcessSimple/environments/Default-e1dd4023-a656-480a-8a0e-c1b1eec51e1d/flows/24335774-daf6-4183-acb7-f5155c2cd2fe/runs/08585236861638480597867166179CU104",
+      "type": "Microsoft.ProcessSimple/environments/flows/runs",
+      "properties": {
+        "startTime": "2023-03-04T09:05:21.8066368Z",
+        "endTime": "2023-03-04T09:05:22.5880202Z",
+        "status": "Succeeded",
+        "correlation": {
+          "clientTrackingId": "08585236861638480598867166179CU131"
+        },
+        "trigger": {
+          "name": "When_an_email_is_flagged_(V4)",
+          "inputsLink": {
+            "uri": "https://prod-130.westeurope.logic.azure.com:443/workflows/3ebadb794f6641e0b7f4fda131cdfb0b/runs/08585236861638480597867166179CU104/contents/TriggerInputs?api-version=2016-06-01&se=2023-03-04T14%3A00%3A00.0000000Z&sp=%2Fruns%2F08585236861638480597867166179CU104%2Fcontents%2FTriggerInputs%2Fread&sv=1.0&sig=",
+            "contentVersion": "2v/VLXFrKV6JvwSdcN7aHg==",
+            "contentSize": 343,
+            "contentHash": {
+              "algorithm": "md5",
+              "value": "2v/VLXFrKV6JvwSdcN7aHg=="
+            }
+          },
+          "outputsLink": {
+            "uri": "https://prod-130.westeurope.logic.azure.com:443/workflows/3ebadb794f6641e0b7f4fda131cdfb0b/runs/08585236861638480597867166179CU104/contents/TriggerOutputs?api-version=2016-06-01&se=2023-03-04T14%3A00%3A00.0000000Z&sp=%2Fruns%2F08585236861638480597867166179CU104%2Fcontents%2FTriggerOutputs%2Fread&sv=1.0&sig=",
+            "contentVersion": "AHZEeWNlQ0bLe48yDmpzrQ==",
+            "contentSize": 3478,
+            "contentHash": {
+              "algorithm": "md5",
+              "value": "AHZEeWNlQ0bLe48yDmpzrQ=="
+            }
+          },
+          "startTime": "2023-03-04T09:05:21.6192576Z",
+          "endTime": "2023-03-04T09:05:21.7442626Z",
+          "scheduledTime": "2023-03-04T09:05:21.573561Z",
+          "originHistoryName": "08585236861638480598867166179CU131",
+          "correlation": {
+            "clientTrackingId": "08585236861638480598867166179CU131"
+          },
+          "code": "OK",
+          "status": "Succeeded"
+        }
+      },
+      "startTime": "2023-03-04T09:05:21.8066368Z",
+      "endTime": "2023-03-04T09:05:22.5880202Z",
+      "status": "Succeeded",
+      "triggerName": "When_an_email_is_flagged_(V4)",
+      "triggerInformation": {
+        "from": "john@contoso.com",
+        "toRecipients": "doe@contoso.com",
+        "subject": "Dummy email",
+        "body": "<html><head>\r\\\n<meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\"></head><body><p>This is dummy content</p></body></html>",
+        "importance": "normal",
+        "bodyPreview": "This is dummy content",
+        "hasAttachments": false,
+        "id": "AAMkADgzN2Q1NThiLTI0NjYtNGIxYS05MDdjLTg1OWQxNzgwZGM2ZgBGAAAAAAC6jQfUzacTSIHqMw2yacnUBwBiOC8xvYmdT6G2E_hLMK5kAAAAAAEMAABiOC8xvYmdT6G2E_hLMK5kAALUqy81AAA=",
+        "internetMessageId": "<DB7PR03MB5018879914324FC65695809FE1AD9@DB7PR03MB5018.eurprd03.prod.outlook.com>",
+        "conversationId": "AAQkADgzN2Q1NThiLTI0NjYtNGIxYS05MDdjLTg1OWQxNzgwZGM2ZgAQAMqP9zsK8a1CnIYEgHclLTk=",
+        "receivedDateTime": "2023-03-01T15:06:57+00:00",
+        "isRead": false,
+        "attachments": [],
+        "isHtml": true
+      }
+    }
     ```
-	

package/docs/docs/cmd/login.md

@@ -37,6 +37,9 @@ m365 login [options]
 `--tenant [tenant]`
 : ID of the tenant from which accounts should be able to authenticate. Use `common` or `organization` if the app is multitenant. If not specified, use the tenant specified in the `CLIMICROSOFT365_TENANT` environment variable. If the environment variable is not defined, use `common` as the tenant identifier
 
+`--cloud [cloud]`
+: Cloud to connect to. Allowed values `Public`, `USGov`, `USGovHigh`, `USGovDoD` and `China`. Default `Public`
+
 --8<-- "docs/cmd/_global.md"
 
 ## Remarks
@@ -45,8 +48,6 @@ Using the `login` command you can log in to Microsoft 365.
 
 By default, the `login` command uses device code OAuth flow to log in to Microsoft 365. Alternatively, you can authenticate using a user name and password or certificate, which are convenient for CI/CD scenarios, but which come with their own [limitations](../user-guide/connecting-office-365.md).
 
-When logging in to Microsoft 365, the `login` command stores in memory the access token and the refresh token. Both tokens are cleared from memory after exiting the CLI or by calling the [logout](logout.md) command.
-
 When logging in to Microsoft 365 using the user name and password, next to the access and refresh token, the CLI for Microsoft 365 will store the user credentials so that it can automatically re-authenticate if necessary. Similarly to the tokens, the credentials are removed by re-authenticating using the device code or by calling the [logout](logout.md) command.
 
 When logging in to Microsoft 365 using a certificate, the CLI for Microsoft 365 will store the contents of the certificate so that it can automatically re-authenticate if necessary. The contents of the certificate are removed by re-authenticating using the device code or by calling the [logout](logout.md) command.  
@@ -55,6 +56,8 @@ To log in to Microsoft 365 using a certificate or secret, you will typically [cr
 
 Managed identity in Azure Cloud Shell is the identity of the user. It is neither system- nor user-assigned and it can't be configured. To log in to Microsoft 365 using managed identity in Azure Cloud Shell, set `authType` to `identity` and don't specify the `userName` option.
 
+When connecting to clouds other than `Public`, you'll need to use an Azure AD application registered in a directory provisioned in that cloud. If you try to login using the default Azure AD application, login will fail.
+
 ## Examples
 
 Log in to Microsoft 365 using the device code

package/docs/docs/cmd/planner/task/task-add.md

@@ -50,7 +50,7 @@ m365 planner task add [options]
 : Hint used to order items of this type in a list view. The format is defined as outlined [here](https://docs.microsoft.com/graph/api/resources/planner-order-hint-format?view=graph-rest-1.0).
 
 `--description [description]`
-: Description of the task
+: Description of the task.
 
 `--appliedCategories [appliedCategories]`
 : Comma-separated categories that should be added to the task. The possible options are: `category1`, `category2`, `category3`, `category4`, `category5` and/or `category6`. Additional info defined [here](https://docs.microsoft.com/graph/api/resources/plannerappliedcategories?view=graph-rest-1.0).
@@ -81,6 +81,8 @@ When you specify an integer value for `priority`, consider the following:
 - values 5, 6 and 7 are interpreted as _Medium_
 - values 8, 9 and 10 are interpreted as _Low_
 
+When using `description` with a multiple lines value, use the new line character of the shell you are using to indicate line breaks. For PowerShell this is `` `n ``. For Zsh or Bash use `\n` with a `$` in front. E.g. `$"Line 1\nLine 2"`.
+
 ## Examples
 
 Adds a Microsoft Planner task with the name _My Planner Task_ for plan with the ID _8QZEH7b3wkSbGQobscsM5gADCBa_ and for the bucket with the ID _IK8tuFTwQEa5vTonM7ZMRZgAKdna_

package/docs/docs/cmd/planner/task/task-set.md

@@ -50,16 +50,16 @@ m365 planner task set [options]
 : Comma-separated UPNs of the assignees that should be added to the task assignment. Specify either `assignedToUserIds` or `assignedToUserNames` but not both.
 
 `--description [description]`
-: Description of the task
+: Description of the task.
 
 `--orderHint [orderHint]`
-: Hint used to order items of this type in a list view
+: Hint used to order items of this type in a list view.
 
 `--assigneePriority [assigneePriority]`
-: Hint used to order items of this type in a list view
+: Hint used to order items of this type in a list view.
 
 `--appliedCategories [appliedCategories]`
-: Comma-separated categories that should be added to the task
+: Comma-separated categories that should be added to the task.
 
 `--priority [priority]`
 : Priority of the task: Urgent, Important, Medium, Low. Or an integer between 0 and 10 (check remarks section for more info).
@@ -83,6 +83,8 @@ When you specify an integer value for `priority`, consider the following:
 
 You can add up to 6 categories to the task. An example to add _category1_ and _category3_ would be `category1,category3`.
 
+When using `description` with a multiple lines value, use the new line character of the shell you are using to indicate line breaks. For PowerShell this is `` `n ``. For Zsh or Bash use `\n` with a `$` in front. E.g. `$"Line 1\nLine 2"`.
+
 ## Examples
 
 Updates a Microsoft Planner task name to _My Planner Task_ for the task with the ID _Z-RLQGfppU6H3663DBzfs5gAMD3o_

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

@@ -16,21 +16,106 @@ m365 spo file list [options]
 `-f, --folder <folder>`
 : The server- or site-relative URL of the folder from which to retrieve files
 
+`--fields [fields]`
+: Comma-separated list of fields to retrieve. Will retrieve all fields if not specified.
+
+`--filter [filter]`
+: OData filter to use to query the list of items with
+
 `-r, --recursive`
 : Set to retrieve files from subfolders
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
+When the `fields` option includes values with a `/`, for example: `ListItemAllFields/Id`, an additional `$expand` query parameter will be included on `ListItemAllFields`.
+
 ## Examples
 
-Return all files from folder _Shared Documents_ located in site _https://contoso.sharepoint.com/sites/project-x_
+Return all files from a folder
 
 ```sh
 m365 spo file list --webUrl https://contoso.sharepoint.com/sites/project-x --folder 'Shared Documents'
 ```
 
-Return all files from the folder _Shared Documents_ and all the sub-folders of _Shared Documents_ located in site _https://contoso.sharepoint.com/sites/project-x_
+Return all files from a folder and all the sub-folders
 
 ```sh
 m365 spo file list --webUrl https://contoso.sharepoint.com/sites/project-x --folder 'Shared Documents' --recursive
 ```
+
+Return the files from a folder with specific fields which will be expanded
+
+```sh
+m365 spo file list --webUrl https://contoso.sharepoint.com/sites/project-x --folder 'Shared Documents' --fields "Title,Length"
+```
+
+Return the files from a folder that meet the criteria of the filter with specific fields which will be expanded
+
+```sh
+m365 spo file list --webUrl https://contoso.sharepoint.com/sites/project-x --folder 'Shared Documents' --fields ListItemAllFields/Id --filter "Name eq 'document.docx'"
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "CheckInComment": "",
+        "CheckOutType": 2,
+        "ContentTag": "{F09C4EFE-B8C0-4E89-A166-03418661B89B},9,12",
+        "CustomizedPageStatus": 0,
+        "ETag": "\"{F09C4EFE-B8C0-4E89-A166-03418661B89B},9\"",
+        "Exists": true,
+        "IrmEnabled": false,
+        "Length": 331673,
+        "Level": 1,
+        "LinkingUri": "https://contoso.sharepoint.com/sites/project-x/Shared Documents/Document.docx?d=wf09c4efeb8c04e89a16603418661b89b",
+        "LinkingUrl": "https://contoso.sharepoint.com/sites/project-x/Shared Documents/Document.docx?d=wf09c4efeb8c04e89a16603418661b89b",
+        "MajorVersion": 3,
+        "MinorVersion": 0,
+        "Name": "Document.docx",
+        "ServerRelativeUrl": "/sites/project-x/Shared Documents/Document.docx",
+        "TimeCreated": "2018-02-05T08:42:36Z",
+        "TimeLastModified": "2018-02-05T08:44:03Z",
+        "Title": "",
+        "UIVersion": 1536,
+        "UIVersionLabel": "3.0",
+        "UniqueId": "f09c4efe-b8c0-4e89-a166-03418661b89b"
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    Name                               ServerRelativeUrl                                UniqueId
+    ---------------------------------  -----------------------------------------------  ------------------------------------
+    Document.docx                      /sites/project-x/Shared Documents/Document.docx  5eb97525-2167-4d26-94b8-092a97d65716
+    ```
+
+=== "CSV"
+
+    ```csv
+    Name,ServerRelativeUrl,UniqueId
+    Document.docx,/sites/project-x/Shared Documents/Document.docx,5eb97525-2167-4d26-94b8-092a97d65716
+    ```
+
+=== "Markdown"
+
+    ```md
+    # spo file list --webUrl "https://contoso.sharepoint.com" --folder "Shared Documents"
+
+    Date: 23/3/2023
+
+    ## Document.docx (5eb97525-2167-4d26-94b8-092a97d65716)
+
+    Property | Value
+    ---------|-------
+    Name | Document.docx
+    ServerRelativeUrl | /sites/project-x/Shared Documents/Document.docx
+    UniqueId | 5eb97525-2167-4d26-94b8-092a97d65716
+    ```

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

@@ -32,7 +32,7 @@ m365 spo listitem list [options]
 : OData filter to use to query the list of items with. Specify `camlQuery` or `filter` but not both.
 
 `-p, --pageSize [pageSize]`
-: Number of list items to return. Specify `camlQuery` or `pageSize` but not both.
+: Number of list items to return. Specify `camlQuery` or `pageSize` but not both. The default value is 5000.
 
 `-n, --pageNumber [pageNumber]`
 : Page number to return if `pageSize` is specified (first page is indexed as value of 0).
@@ -41,6 +41,8 @@ m365 spo listitem list [options]
 
 ## Remarks
 
+This command retrieves all items in the list, even if there are more than 5000. Use the `pageSize` and `pageNumber` options if you only want a specific amount of items. When using a CAML query, include a `RowLimit`-node to get all items. If you run into list view threshold exceptions, remove any Query-conditions or filters and also include a `RowLimit`-node.
+
 `pageNumber` is specified as a 0-based index. A value of `2` returns the third page of items.
 
 If you want to specify a lookup type in the `properties` option, define which columns from the related list should be returned.
@@ -53,12 +55,6 @@ Get all items from a list named Demo List
 m365 spo listitem list --listTitle "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x
 ```
 
-From a list named _Demo List_ get all items with title _Demo list item_ using a CAML query
-
-```sh
-m365 spo listitem list --listTitle "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x --camlQuery "<View><Query><Where><Eq><FieldRef Name='Title' /><Value Type='Text'>Demo list item</Value></Eq></Where></Query></View>"
-```
-
 Get all items from a list with ID _935c13a0-cc53-4103-8b48-c1d0828eaa7f_
 
 ```sh
@@ -83,10 +79,16 @@ From a list named _Demo List_ get all items with title _Demo list item_ using an
 m365 spo listitem list --listTitle "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x --filter "Title eq 'Demo list item'"
 ```
 
+From a list named _Demo List_ get the first 100 items
+
+```sh
+m365 spo listitem list --listTitle "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x --pageSize 100 --pageNumber 0
+```
+
 From a list named _Demo List_ get the second batch of 10 items
 
 ```sh
-m365 spo listitem list --listTitle "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x --pageSize 10 --pageNumber 2
+m365 spo listitem list --listTitle "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x --pageSize 10 --pageNumber 1
 ```
 
 Get all items from a list by server-relative URL
@@ -95,6 +97,18 @@ Get all items from a list by server-relative URL
 m365 spo listitem list --listUrl /sites/project-x/documents --webUrl https://contoso.sharepoint.com/sites/project-x
 ```
 
+From a list named _Demo List_ get all items with title _Demo list item_ using a CAML query
+
+```sh
+m365 spo listitem list --listTitle "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x --camlQuery "<View><Query><Where><Eq><FieldRef Name='Title' /><Value Type='Text'>Demo list item</Value></Eq></Where></Query><RowLimit Paged='TRUE'>5000</RowLimit></View>"
+```
+
+From a library named _Demo Library_ with 5000+ files and folders, get all items recursively without running into a list view threshold exception, using a CAML query
+
+```sh
+m365 spo listitem list --listTitle "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x --camlQuery "<View Scope='RecursiveAll'><Query></Query><ViewFields><FieldRef Name='Title'/></ViewFields><RowLimit Paged='TRUE'>5000</RowLimit></View>"
+```
+
 ## Response
 
 === "JSON"

package/docs/docs/cmd/spo/site/site-recyclebinitem-clear.md

@@ -0,0 +1,45 @@
+# spo site recyclebinitem clear
+
+Permanently removes all items in a site recycle bin
+
+## Usage
+
+```sh
+m365 spo site recyclebinitem clear [options]
+```
+
+## Options
+
+`-u, --siteUrl <siteUrl>`
+: URL of the site where the recycle bin is located.
+
+`--secondary`
+: Remove all items from the second-stage recycle bin. When not specified, items from the first-stage recycle bin will be cleared.
+
+`--confirm`
+: Don't prompt for confirmation.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+!!! warning
+    Items in the recycle bin will be permanently removed without the ability to restore them.
+
+## Examples
+
+Clear all items from the first-stage recycle bin
+
+```sh
+m365 spo site recyclebinitem clear --siteUrl https://contoso.sharepoint.com/sites/sales
+```
+
+Clear all items from the second-stage recycle bin
+
+```sh
+m365 spo site recyclebinitem clear --siteUrl https://contoso.sharepoint.com/sites/sales --secondary
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/tenant/id/id-get.md

@@ -52,3 +52,9 @@ m365 tenant id get
     ```csv
     e65b162c-6f87-4eb1-a24e-1b37d3504663
     ```
+
+=== "Markdown"
+
+    ```md
+    e65b162c-6f87-4eb1-a24e-1b37d3504663
+    ```

package/docs/docs/cmd/tenant/report/report-activeusercounts.md

@@ -72,3 +72,10 @@ m365 tenant report activeusercounts --period D7 --output json > "activeusercount
     Report Refresh Date,Office 365,Exchange,OneDrive,SharePoint,Skype For Business,Yammer,Teams,Report Date,Report Period
     2022-10-25,1,5,4,3,2,3,1,2022-10-19,7
     ```
+
+=== "Markdown"
+
+    ```md
+    Report Refresh Date,Office 365,Exchange,OneDrive,SharePoint,Skype For Business,Yammer,Teams,Report Date,Report Period
+    2022-10-25,1,5,4,3,2,3,1,2022-10-19,7
+    ```

package/docs/docs/cmd/tenant/report/report-activeuserdetail.md

@@ -99,3 +99,10 @@ m365 tenant report activeuserdetail --period D7 --output json > "activeuserdetai
     Report Refresh Date,User Principal Name,Display Name,Is Deleted,Deleted Date,Has Exchange License,Has OneDrive License,Has SharePoint License,Has Skype For Business License,Has Yammer License,Has Teams License,Exchange Last Activity Date,OneDrive Last Activity Date,SharePoint Last Activity Date,Skype For Business Last Activity Date,Yammer Last Activity Date,Teams Last Activity Date,Exchange License Assign Date,OneDrive License Assign Date,SharePoint License Assign Date,Skype For Business License Assign Date,Yammer License Assign Date,Teams License Assign Date,Assigned Products
     2022-10-23,77E5979DD60BA6EAA53E814DBEEEFA5F,4291DA7C39EE3263E97336B42734A667,False,,True,True,True,True,True,True,,2022-09-12,2020-09-12,2022-09-12,2021-10-30,2020-10-30,2019-04-21,2017-09-20,2021-01-10,2021-01-10,2021-01-10,2021-01-10,2021-01-10,2021-01-10,MICROSOFT 365 E5 DEVELOPER (WITHOUT WINDOWS AND AUDIO CONFERENCING)
     ```
+
+=== "Markdown"
+
+    ```md
+    Report Refresh Date,User Principal Name,Display Name,Is Deleted,Deleted Date,Has Exchange License,Has OneDrive License,Has SharePoint License,Has Skype For Business License,Has Yammer License,Has Teams License,Exchange Last Activity Date,OneDrive Last Activity Date,SharePoint Last Activity Date,Skype For Business Last Activity Date,Yammer Last Activity Date,Teams Last Activity Date,Exchange License Assign Date,OneDrive License Assign Date,SharePoint License Assign Date,Skype For Business License Assign Date,Yammer License Assign Date,Teams License Assign Date,Assigned Products
+    2022-10-23,77E5979DD60BA6EAA53E814DBEEEFA5F,4291DA7C39EE3263E97336B42734A667,False,,True,True,True,True,True,True,,2022-09-12,2020-09-12,2022-09-12,2021-10-30,2020-10-30,2019-04-21,2017-09-20,2021-01-10,2021-01-10,2021-01-10,2021-01-10,2021-01-10,2021-01-10,MICROSOFT 365 E5 DEVELOPER (WITHOUT WINDOWS AND AUDIO CONFERENCING)
+    ```

package/docs/docs/cmd/tenant/report/report-office365activationcounts.md

@@ -51,3 +51,10 @@ m365 tenant report office365activationcounts
     Report Refresh Date,Product Type,Windows,Mac,Android,iOS,Windows 10 Mobile
     2022-10-25,MICROSOFT 365 APPS FOR ENTERPRISE,5,0,0,0,0
     ```
+
+=== "Markdown"
+
+    ```md
+    Report Refresh Date,Product Type,Windows,Mac,Android,iOS,Windows 10 Mobile
+    2022-10-25,MICROSOFT 365 APPS FOR ENTERPRISE,5,0,0,0,0
+    ```

package/docs/docs/cmd/tenant/report/report-office365activationsusercounts.md

@@ -49,3 +49,10 @@ m365 tenant report office365activationsusercounts
     Report Refresh Date,Product Type,Assigned,Activated,Shared Computer Activation
     2022-10-25,MICROSOFT 365 APPS FOR ENTERPRISE,24,5,0
     ```
+
+=== "Markdown"
+
+    ```md
+    Report Refresh Date,Product Type,Assigned,Activated,Shared Computer Activation
+    2022-10-25,MICROSOFT 365 APPS FOR ENTERPRISE,24,5,0
+    ```

package/docs/docs/cmd/tenant/report/report-office365activationsuserdetail.md

@@ -55,3 +55,10 @@ m365 tenant report office365activationsuserdetail
     Report Refresh Date,User Principal Name,Display Name,Product Type,Last Activated Date,Windows,Mac,Windows 10 Mobile,iOS,Android,Activated On Shared Computer
     2022-10-25,77E5979DD60BA6EAA53E814DBEEEFA5F,4291DA7C39EE3263E97336B42734A667,MICROSOFT 365 APPS FOR ENTERPRISE,2021-01-10,1,0,0,0,0,False
     ```
+
+=== "Markdown"
+
+    ```md
+    Report Refresh Date,User Principal Name,Display Name,Product Type,Last Activated Date,Windows,Mac,Windows 10 Mobile,iOS,Android,Activated On Shared Computer
+    2022-10-25,77E5979DD60BA6EAA53E814DBEEEFA5F,4291DA7C39EE3263E97336B42734A667,MICROSOFT 365 APPS FOR ENTERPRISE,2021-01-10,1,0,0,0,0,False
+    ```

package/docs/docs/cmd/tenant/report/report-servicesusercounts.md

@@ -78,3 +78,10 @@ m365 tenant report servicesusercounts --period D7 --output json > "servicesuserc
     Report Refresh Date,Exchange Active,Exchange Inactive,OneDrive Active,OneDrive Inactive,SharePoint Active,SharePoint Inactive,Skype For Business Active,Skype For Business Inactive,Yammer Active,Yammer Inactive,Teams Active,Teams Inactive,Office 365 Active,Office 365 Inactive,Report Period
     2022-10-23,1,23,1,23,1,23,0,24,0,24,1,23,2,22,7
     ```
+
+=== "Markdown"
+
+    ```md
+    Report Refresh Date,Exchange Active,Exchange Inactive,OneDrive Active,OneDrive Inactive,SharePoint Active,SharePoint Inactive,Skype For Business Active,Skype For Business Inactive,Yammer Active,Yammer Inactive,Teams Active,Teams Inactive,Office 365 Active,Office 365 Inactive,Report Period
+    2022-10-23,1,23,1,23,1,23,0,24,0,24,1,23,2,22,7
+    ```