@pnp/cli-microsoft365 6.4.0-beta.3946b02 → 6.4.0-beta.39e5130

package/dist/utils/spo.js

@@ -536,6 +536,38 @@ exports.spo = {
             const customActionOnSite = yield getById(webUrl, id, "Site");
             return customActionOnSite;
         });
+    },
+    getTenantAppCatalogUrl(logger, debug) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const spoUrl = yield exports.spo.getSpoUrl(logger, debug);
+            const requestOptions = {
+                url: `${spoUrl}/_api/SP_TenantSettings_Current`,
+                headers: {
+                    accept: 'application/json;odata=nometadata'
+                },
+                responseType: 'json'
+            };
+            const result = yield request_1.default.get(requestOptions);
+            return result.CorporateCatalogUrl;
+        });
+    },
+    /**
+     * Retrieves the Azure AD ID from a SP user.
+     * @param webUrl Web url
+     * @param id The Id of the user
+     */
+    getUserAzureIdBySpoId(webUrl, id) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = {
+                url: `${webUrl}/_api/web/siteusers/GetById('${formatting_1.formatting.encodeQueryParameter(id)}')?$select=AadObjectId`,
+                headers: {
+                    accept: 'application/json;odata=nometadata'
+                },
+                responseType: 'json'
+            };
+            const res = yield request_1.default.get(requestOptions);
+            return res.AadObjectId.NameId;
+        });
     }
 };
 //# sourceMappingURL=spo.js.map

package/docs/docs/cmd/cli/completion/completion-clink-update.md

@@ -12,16 +12,16 @@ m365 cli completion clink update [options]
 
 --8<-- "docs/cmd/_global.md"
 
-!!! important
-    Before running this command, change the working directory to where your shell stores completion plugins. For cmder, it's `%CMDER_ROOT%\vendor\clink-completions`, where `%CMDER_ROOT%` is the folder where you installed cmder. After running this command, restart your terminal to load the completion.
-
 ## Remarks
 
 This commands updates the list of commands and their options used by command completion in Clink (cmder). You should run this command each time after upgrading the CLI for Microsoft 365.
 
+!!! important
+    Before running this command, change the working directory to where your shell stores completion plugins. For cmder, it's `%CMDER_ROOT%\vendor\clink-completions`, where `%CMDER_ROOT%` is the folder where you installed cmder. After running this command, restart your terminal to load the completion.
+
 ## Examples
 
-Write the list of commands for Clink (cmder) command completion to a file named `m365.lua` in the current directory
+Write the list of commands for Clink (cmder) command completion to a file named `m365.lua` in the current directory.
 
 ```powershell
 m365 cli completion clink update > m365.lua

package/docs/docs/cmd/flow/owner/owner-add.md

@@ -0,0 +1,61 @@
+# flow owner add
+
+Assigns permissions to a Power Automate flow
+
+## Usage
+
+```sh
+m365 flow owner add [options]
+```
+
+## Options
+
+`-e, --environmentName <environmentName>`
+: The name of the environment.
+
+`-f, --flowName <flowName>`
+: The name of the Power Automate flow.
+
+`--userId [userId]`
+: The ID of the user. Specify either `userId`, `userName`, `groupId` or `groupName`.
+
+`--userName [userName]`
+: User principal name of the user. Specify either `userId`, `userName`, `groupId` or `groupName`.
+
+`--groupId [groupId]`
+: The ID of the group. Specify either `userId`, `userName`, `groupId` or `groupName`.
+
+`--groupName [groupName]`
+: The name of the group. Specify either `userId`, `userName`, `groupId` or `groupName`.
+
+`--roleName <roleName>`
+: Access level for the user on the flow. Valid options are `CanView` or `CanEdit`.
+
+`--asAdmin`
+: Run the command as admin.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Assign owner permissions to a specific Power Automate flow for a user with ID
+
+```sh
+m365 flow owner add --userId 5c241023-2ba5-4ea8-a516-a2481a3e6c51 --environmentName Default-c5a5d746-3520-453f-8a69-780f8e44917e --flowName 72f2be4a-78c1-4220-a048-dbf557296a72 --roleName CanEdit
+```
+
+Assign owner permissions to a specific Power Automate flow for a user with UPN
+
+```sh
+m365 flow owner add --userName "john.doe@contoso.com" --environmentName Default-c5a5d746-3520-453f-8a69-780f8e44917e --flowName 72f2be4a-78c1-4220-a048-dbf557296a72 --roleName CanEdit
+```
+
+Assign owner permissions to a specific Power Automate flow for a group
+
+```sh
+m365 flow owner add --groupId 8d4d9f32-1ab0-4f81-9054-efbb1759e8e6 --environmentName Default-c5a5d746-3520-453f-8a69-780f8e44917e --flowName 72f2be4a-78c1-4220-a048-dbf557296a72 --roleName CanEdit
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/flow/owner/owner-remove.md

@@ -0,0 +1,67 @@
+# flow owner remove
+
+Removes owner permissions to a Power Automate flow
+
+## Usage
+
+```sh
+m365 flow owner remove [options]
+```
+
+## Options
+
+`-e, --environmentName <environmentName>`
+: The name of the environment.
+
+`-f, --flowName <flowName>`
+: The name of the Power Automate flow.
+
+`--userId [userId]`
+: The ID of the user. Specify either `userId`, `userName`, `groupId` or `groupName`.
+
+`--userName [userName]`
+: User principal name of the user. Specify either `userId`, `userName`, `groupId` or `groupName`.
+
+`--groupId [groupId]`
+: The ID of the group. Specify either `userId`, `userName`, `groupId` or `groupName`.
+
+`--groupName [groupName]`
+: The name of the group. Specify either `userId`, `userName`, `groupId` or `groupName`.
+
+`--asAdmin`
+: Run the command as admin.
+
+`--confirm`
+: Don't prompt for confirmation.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Remove owner permissions from a specific Power Automate flow for a user by ID without prompting for confirmation
+
+```sh
+m365 flow owner remove --userId 5c241023-2ba5-4ea8-a516-a2481a3e6c51 --environmentName Default-c5a5d746-3520-453f-8a69-780f8e44917e --flowName 72f2be4a-78c1-4220-a048-dbf557296a72 --confirm
+```
+
+Remove owner permissions from a specific Power Automate flow for a user by UPN as admin
+
+```sh
+m365 flow owner remove --userName john.doe@contoso.com --environmentName Default-c5a5d746-3520-453f-8a69-780f8e44917e --flowName 72f2be4a-78c1-4220-a048-dbf557296a72 --asAdmin
+```
+
+Remove owner permissions from a specific Power Automate flow for a group by ID
+
+```sh
+m365 flow owner remove --groupId 5c241023-2ba5-4ea8-a516-a2481a3e6c51 --environmentName Default-c5a5d746-3520-453f-8a69-780f8e44917e --flowName 72f2be4a-78c1-4220-a048-dbf557296a72
+```
+
+Remove owner permissions from a specific Power Automate flow for a group by name as admin
+
+```sh
+m365 flow owner remove --groupName "Test group" --environmentName Default-c5a5d746-3520-453f-8a69-780f8e44917e --flowName 72f2be4a-78c1-4220-a048-dbf557296a72 --asAdmin
+```
+
+## Response
+
+The command won't return a response on success.

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

@@ -25,6 +25,9 @@ m365 flow run list [options]
 `--triggerEndTime [triggerEndTime]`
 : Time indicating the exclusive end of a time range of flow runs to return. This should be defined as a valid ISO 8601 string (2021-12-16T18:28:48.6964197Z).
 
+`--asAdmin`
+: Run the command as admin. Use this flag when targeting flows you don't own.
+
 --8<-- "docs/cmd/_global.md"
 
 ## Remarks
@@ -56,6 +59,12 @@ List runs of the specified Microsoft Flow between a specific time range
 m365 flow run list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a --triggerStartTime 2023-01-21T18:19:00Z --triggerEndTime 2023-01-22T00:00:00Z
 ```
 
+List runs of the specified Microsoft Flow owned by another user
+
+```sh
+m365 flow run list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a --asAdmin
+```
+
 ## Response
 
 ### Standard response
@@ -123,3 +132,22 @@ m365 flow run list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c
     name,startTime,status
     08585329112602833828909892130CU17,2022-11-17T14:33:45.2763872Z,Running
     ```
+
+=== "Markdown"
+
+    ```md
+    # flow run list --environmentName "Default-de348bc7-1aeb-4406-8cb3-97db021cadb4" --flowName "08585329112602833828909892130CU17"
+
+    Date: 1/3/2023
+
+    ## 08585329112602833828909892130CU17 (/providers/Microsoft.ProcessSimple/environments/Default-de348bc7-1aeb-4406-8cb3-97db021cadb4/flows/170fb67e-a514-4d84-8727-582022bd13a9/runs/08585329112602833828909892130CU17)
+
+    Property | Value
+    ---------|-------
+    name | 08585329112602833828909892130CU17
+    id | /providers/Microsoft.ProcessSimple/environments/Default-de348bc7-1aeb-4406-8cb3-97db021cadb4/flows/170fb67e-a514-4d84-8727-582022bd13a9/runs/08585329112602833828909892130CU17
+    type | Microsoft.ProcessSimple/environments/flows/runs
+    properties | {"startTime":"2022-11-17T14:33:45.2763872Z","status":"Running","correlation":{"clientTrackingId":"08585329112602833829909892130CU00"},"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","contentVersion":"6ZrBBE+MJg7IvhMgyJLMmA==","contentSize":349,"contentHash":{"algorithm":"md5","value":"6ZrBBE+MJg7IvhMgyJLMmA=="}},"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","contentVersion":"Z/4a8tfYygNAR1xpc44iww==","contentSize":493,"contentHash":{"algorithm":"md5","value":"Z/4a8tfYygNAR1xpc44iww=="}},"startTime":"2022-11-17T14:33:45.1914506Z","endTime":"2022-11-17T14:33:45.1914506Z","originHistoryName":"08585329112602833829909892130CU00","correlation":{"clientTrackingId":"08585329112602833829909892130CU00"},"status":"Succeeded"}}
+    startTime | 2022-11-17T14:33:45.2763872Z
+    status | Running
+    ```

package/docs/docs/cmd/onenote/page/page-list.md

@@ -118,7 +118,7 @@ m365 onenote page list --webUrl https://contoso.sharepoint.com/sites/testsite
 === "Markdown"
 
     ```md
-    # onenote page list --userName "mathijs@mathijsdev2.onmicrosoft.com"
+    # onenote page list --userName "john.doe@contoso.onmicrosoft.com"
 
     Date: 07/01/2023
 

package/docs/docs/cmd/outlook/mail/mail-send.md

@@ -11,7 +11,7 @@ m365 outlook mail send [options]
 ## Options
 
 `-s, --subject <subject>`
-: Email subject
+: Email subject.
 
 `-t, --to <to>`
 : Comma-separated list of emails to send the message to.
@@ -32,10 +32,10 @@ m365 outlook mail send [options]
 : String containing the body of the email to send.
 
 `--bodyContentType [bodyContentType]`
-: Type of the body content. Available options: `Text,HTML`. Default `Text`.
+: Type of the body content. Available options: `Text`, `HTML`. Default is `Text`.
 
 `--importance [importance]`
-: The importance of the message. Available options: `low`, `normal` or `high`. Default is `normal`.
+: The importance of the message. Available options: `low`, `normal`, or `high`. Default is `normal`.
 
 `--attachment [attachment]`
 : Path to the file that will be added as attachment to the email. This option can be used multiple times to attach multiple attachments.
@@ -123,3 +123,7 @@ Send an email with multiple attachments
 ```sh
 m365 outlook mail send --to chris@contoso.com --subject "Monthly reports" --bodyContents "Here are the reports of this month." --attachment "C:/Reports/File1.jpg" --attachment "C:/Reports/File2.docx" --attachment "C:/Reports/File3.xlsx"
 ```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/outlook/message/message-get.md

@@ -46,3 +46,146 @@ Get a specific message from a specific user retrieved by user principal name usi
 ```sh
 m365 outlook message get --id AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYmY4OABGAAAAAAAiQ8W967B7TKBjgx9rVEURBwAiIsqMbYjsT5e-T7KzowPTAAAAAAEMAAAiIsqMbYjsT5e-T7KzowPTAALvuv07AAA= --userPrincipalName user@tenant.com
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "id": "AAMkAGUzZWVmZWU4LTM5ZmItNDA4My04OTIzLWY1MGUxNzdiYTQ0MQBGAAAAAABn1FpEFqPeR7YAnkzP_VgXBwAhebtol4HnTZCmNsr9Gnh6AAAAAAEMAAAhebtol4HnTZCmNsr9Gnh6AAPfHbtVAAA=",
+      "createdDateTime": "2023-01-26T19:22:44Z",
+      "lastModifiedDateTime": "2023-01-26T19:22:46Z",
+      "changeKey": "CQAAABYAAAAhebtol4HnTZCmNsr9Gnh6AAPehsHb",
+      "categories": [],
+      "receivedDateTime": "2023-01-26T19:22:45Z",
+      "sentDateTime": "2023-01-26T19:22:42Z",
+      "hasAttachments": true,
+      "internetMessageId": "<HE1P190MB032953D4D9C86FCEF5FFA8C4CECF9@HE1P190MB0329.EURP190.PROD.OUTLOOK.COM>",
+      "subject": "Lorem ipsum",
+      "bodyPreview": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Duis vel diam gravida, auctor mauris nec, posuere tellus. Vivamus placerat, nunc ac cursus feugiat, arcu tellus mattis nisl, id cursus nisl lectus eu lacus. Praesent malesuada ut orci vitae viverra.",
+      "importance": "normal",
+      "parentFolderId": "AAMkAGUzZWVmZWU4LTM5ZmItNDA4My04OTIzLWY1MGUxNzdiYTQ0MQAuAAAAAABn1FpEFqPeR7YAnkzP_VgXAQAhebtol4HnTZCmNsr9Gnh6AAAAAAEMAAA=",
+      "conversationId": "AAQkAGUzZWVmZWU4LTM5ZmItNDA4My04OTIzLWY1MGUxNzdiYTQ0MQAQAJfvGq77YHxJvRN73_QiuVw=",
+      "conversationIndex": "AQHZMbuNl+8arvtgfEm9E3vf5CK5XA==",
+      "isDeliveryReceiptRequested": false,
+      "isReadReceiptRequested": false,
+      "isRead": false,
+      "isDraft": false,
+      "webLink": "https://outlook.office365.com/owa/?ItemID=AAMkAGUzZWVmZWU4LTM5ZmItNDA4My04OTIzLWY1MGUxNzdiYTQ0MQBGAAAAAABn1FpEFqPeR7YAnkzP%2BVgXBwAhebtol4HnTZCmNsr9Gnh6AAAAAAEMAAAhebtol4HnTZCmNsr9Gnh6AAPfHbtVAAA%3D&exvsurl=1&viewmodel=ReadMessageItem",
+      "inferenceClassification": "focused",
+      "body": {
+        "contentType": "html",
+        "content": "<html><head>\r\\\n<meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\"><style type=\"text/css\" style=\"display:none\">\r\\\n<!--\r\\\np\r\\\n\t{margin-top:0;\r\\\n\tmargin-bottom:0}\r\\\n-->\r\\\n</style></head><body dir=\"ltr\"><div class=\"elementToProof ContentPasted0\" style=\"font-family:Calibri,Arial,Helvetica,sans-serif; font-size:12pt; color:rgb(0,0,0); background-color:rgb(255,255,255)\">Lorem ipsum dolor sit amet, consectetur adipiscing elit. Duis vel diam gravida, auctor mauris nec, posuere tellus. Vivamus placerat, nunc ac cursus feugiat, arcu tellus mattis nisl, id cursus nisl lectus eu lacus. Praesent malesuada ut orci vitae viverra. Suspendisse cursus turpis vel urna volutpat congue. Etiam auctor nec nulla sed suscipit. Vestibulum rhoncus quis mi ac faucibus. Curabitur eget eleifend felis. Vestibulum ut dolor non elit molestie ornare. <br></div></body></html>"
+      },
+      "sender": {
+        "emailAddress": {
+          "name": "John Doe",
+          "address": "john.doe@contoso.com"
+        }
+      },
+      "from": {
+        "emailAddress": {
+          "name": "John Doe",
+          "address": "john.doe@contoso.com"
+        }
+      },
+      "toRecipients": [
+        {
+          "emailAddress": {
+            "name": "Megan Bowen",
+            "address": "megan.bowen@contoso.com"
+          }
+        }
+      ],
+      "ccRecipients": [],
+      "bccRecipients": [],
+      "replyTo": [],
+      "flag": {
+        "flagStatus": "notFlagged"
+      }
+    }
+    ```
+
+=== "Text"
+
+    ```txt
+    bccRecipients             : []
+    body                      : {"contentType":"html","content":"<html><head>\r\n<meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\"><style type=\"text/css\" style=\"display:none\">\r\n<!--\r\np\r\n\t{margin-top:0;\r\n\tmargin-bottom:0}\r\n-->\r\n</style></head><body dir=\"ltr\"><div class=\"elementToProof ContentPasted0\" style=\"font-family:Calibri,Arial,Helvetica,sans-serif; font-size:12pt; color:rgb(0,0,0); background-color:rgb(255,255,255)\">Lorem ipsum dolor sit amet, consectetur adipiscing elit. Duis vel diam gravida, auctor mauris nec, posuere tellus. Vivamus placerat, nunc ac cursus feugiat, arcu tellus mattis nisl, id cursus nisl lectus eu lacus. Praesent malesuada ut orci vitae viverra. Suspendisse cursus turpis vel urna volutpat congue. Etiam auctor nec nulla sed suscipit. Vestibulum rhoncus quis mi ac faucibus. Curabitur eget eleifend felis. Vestibulum ut dolor non elit molestie ornare. <br></div></body></html>"}
+    bodyPreview               : Lorem ipsum dolor sit amet, consectetur adipiscing elit. Duis vel diam gravida, auctor mauris nec, posuere tellus. Vivamus placerat, nunc ac cursus feugiat, arcu tellus mattis nisl, id cursus nisl lectus eu lacus. Praesent malesuada ut orci vitae viverra.
+    categories                : []
+    ccRecipients              : []
+    changeKey                 : CQAAABYAAAAhebtol4HnTZCmNsr9Gnh6AAPehsHb
+    conversationId            : AAQkAGUzZWVmZWU4LTM5ZmItNDA4My04OTIzLWY1MGUxNzdiYTQ0MQAQAJfvGq77YHxJvRN73_QiuVw=
+    conversationIndex         : AQHZMbuNl+8arvtgfEm9E3vf5CK5XA==
+    createdDateTime           : 2023-01-26T19:22:44Z
+    flag                      : {"flagStatus":"notFlagged"}
+    from                      : {"emailAddress":{"name":"John Doe","address":"john.doe@contoso.com"}}
+    hasAttachments            : true
+    id                        : AAMkAGUzZWVmZWU4LTM5ZmItNDA4My04OTIzLWY1MGUxNzdiYTQ0MQBGAAAAAABn1FpEFqPeR7YAnkzP_VgXBwAhebtol4HnTZCmNsr9Gnh6AAAAAAEMAAAhebtol4HnTZCmNsr9Gnh6AAPfHbtVAAA=
+    importance                : normal
+    inferenceClassification   : focused
+    internetMessageId         : <HE1P190MB032953D4D9C86FCEF5FFA8C4CECF9@HE1P190MB0329.EURP190.PROD.OUTLOOK.COM>
+    isDeliveryReceiptRequested: false
+    isDraft                   : false
+    isRead                    : false
+    isReadReceiptRequested    : false
+    lastModifiedDateTime      : 2023-01-26T19:22:46Z
+    parentFolderId            : AAMkAGUzZWVmZWU4LTM5ZmItNDA4My04OTIzLWY1MGUxNzdiYTQ0MQAuAAAAAABn1FpEFqPeR7YAnkzP_VgXAQAhebtol4HnTZCmNsr9Gnh6AAAAAAEMAAA=
+    receivedDateTime          : 2023-01-26T19:22:45Z
+    replyTo                   : []
+    sender                    : {"emailAddress":{"name":"John Doe","address":"john.doe@contoso.com"}}
+    sentDateTime              : 2023-01-26T19:22:42Z
+    subject                   : Lorem ipsum
+    toRecipients              : [{"emailAddress":{"name":"Megan Bowen","address":"megan.bowen@contoso.com"}}]
+    webLink                   : https://outlook.office365.com/owa/?ItemID=AAMkAGUzZWVmZWU4LTM5ZmItNDA4My04OTIzLWY1MGUxNzdiYTQ0MQBGAAAAAABn1FpEFqPeR7YAnkzP%2BVgXBwAhebtol4HnTZCmNsr9Gnh6AAAAAAEMAAAhebtol4HnTZCmNsr9Gnh6AAPfHbtVAAA%3D&exvsurl=1&viewmodel=ReadMessageItem
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,createdDateTime,lastModifiedDateTime,changeKey,categories,receivedDateTime,sentDateTime,hasAttachments,internetMessageId,subject,bodyPreview,importance,parentFolderId,conversationId,conversationIndex,isDeliveryReceiptRequested,isReadReceiptRequested,isRead,isDraft,webLink,inferenceClassification,body,sender,from,toRecipients,ccRecipients,bccRecipients,replyTo,flag
+    AAMkAGUzZWVmZWU4LTM5ZmItNDA4My04OTIzLWY1MGUxNzdiYTQ0MQBGAAAAAABn1FpEFqPeR7YAnkzP_VgXBwAhebtol4HnTZCmNsr9Gnh6AAAAAAEMAAAhebtol4HnTZCmNsr9Gnh6AAPfHbtVAAA=,2023-01-26T19:22:44Z,2023-01-26T19:22:46Z,CQAAABYAAAAhebtol4HnTZCmNsr9Gnh6AAPehsHb,[],2023-01-26T19:22:45Z,2023-01-26T19:22:42Z,1,<HE1P190MB032953D4D9C86FCEF5FFA8C4CECF9@HE1P190MB0329.EURP190.PROD.OUTLOOK.COM>,Lorem ipsum,"Lorem ipsum dolor sit amet, consectetur adipiscing elit. Duis vel diam gravida, auctor mauris nec, posuere tellus. Vivamus placerat, nunc ac cursus feugiat, arcu tellus mattis nisl, id cursus nisl lectus eu lacus. Praesent malesuada ut orci vitae viverra.",normal,AAMkAGUzZWVmZWU4LTM5ZmItNDA4My04OTIzLWY1MGUxNzdiYTQ0MQAuAAAAAABn1FpEFqPeR7YAnkzP_VgXAQAhebtol4HnTZCmNsr9Gnh6AAAAAAEMAAA=,AAQkAGUzZWVmZWU4LTM5ZmItNDA4My04OTIzLWY1MGUxNzdiYTQ0MQAQAJfvGq77YHxJvRN73_QiuVw=,AQHZMbuNl+8arvtgfEm9E3vf5CK5XA==,,,,,https://outlook.office365.com/owa/?ItemID=AAMkAGUzZWVmZWU4LTM5ZmItNDA4My04OTIzLWY1MGUxNzdiYTQ0MQBGAAAAAABn1FpEFqPeR7YAnkzP%2BVgXBwAhebtol4HnTZCmNsr9Gnh6AAAAAAEMAAAhebtol4HnTZCmNsr9Gnh6AAPfHbtVAAA%3D&exvsurl=1&viewmodel=ReadMessageItem,focused,"{""contentType"":""html"",""content"":""<html><head>\r\n<meta http-equiv=\""Content-Type\"" content=\""text/html; charset=utf-8\""><style type=\""text/css\"" style=\""display:none\"">\r\n<!--\r\np\r\n\t{margin-top:0;\r\n\tmargin-bottom:0}\r\n-->\r\n</style></head><body dir=\""ltr\""><div class=\""elementToProof ContentPasted0\"" style=\""font-family:Calibri,Arial,Helvetica,sans-serif; font-size:12pt; color:rgb(0,0,0); background-color:rgb(255,255,255)\"">Lorem ipsum dolor sit amet, consectetur adipiscing elit. Duis vel diam gravida, auctor mauris nec, posuere tellus. Vivamus placerat, nunc ac cursus feugiat, arcu tellus mattis nisl, id cursus nisl lectus eu lacus. Praesent malesuada ut orci vitae viverra. Suspendisse cursus turpis vel urna volutpat congue. Etiam auctor nec nulla sed suscipit. Vestibulum rhoncus quis mi ac faucibus. Curabitur eget eleifend felis. Vestibulum ut dolor non elit molestie ornare. <br></div></body></html>""}","{""emailAddress"":{""name"":""John Doe"",""address"":""john.doe@contoso.com""}}","{""emailAddress"":{""name"":""John Doe"",""address"":""john.doe@contoso.com""}}","[{""emailAddress"":{""name"":""Megan Bowen"",""address"":""megan.bowen@contoso.com""}}]",[],[],[],"{""flagStatus"":""notFlagged""}"
+    ```
+
+=== "Markdown"
+
+    ```md
+    # outlook message get --id "AAMkAGUzZWVmZWU4LTM5ZmItNDA4My04OTIzLWY1MGUxNzdiYTQ0MQBGAAAAAABn1FpEFqPeR7YAnkzP_VgXBwAhebtol4HnTZCmNsr9Gnh6AAAAAAEMAAAhebtol4HnTZCmNsr9Gnh6AAPfHbtVAAA="
+
+    Date: 4/2/2023
+
+    ## AAMkAGUzZWVmZWU4LTM5ZmItNDA4My04OTIzLWY1MGUxNzdiYTQ0MQBGAAAAAABn1FpEFqPeR7YAnkzP_VgXBwAhebtol4HnTZCmNsr9Gnh6AAAAAAEMAAAhebtol4HnTZCmNsr9Gnh6AAPfHbtVAAA=
+
+    Property | Value
+    ---------|-------
+    id | AAMkAGUzZWVmZWU4LTM5ZmItNDA4My04OTIzLWY1MGUxNzdiYTQ0MQBGAAAAAABn1FpEFqPeR7YAnkzP_VgXBwAhebtol4HnTZCmNsr9Gnh6AAAAAAEMAAAhebtol4HnTZCmNsr9Gnh6AAPfHbtVAAA=
+    createdDateTime | 2023-01-26T19:22:44Z
+    lastModifiedDateTime | 2023-01-26T19:22:46Z
+    changeKey | CQAAABYAAAAhebtol4HnTZCmNsr9Gnh6AAPk7Plc
+    categories | []
+    receivedDateTime | 2023-01-26T19:22:45Z
+    sentDateTime | 2023-01-26T19:22:42Z
+    hasAttachments | true
+    internetMessageId | <HE1P190MB032953D4D9C86FCEF5FFA8C4CECF9@HE1P190MB0329.EURP190.PROD.OUTLOOK.COM>
+    subject | Lorem ipsum
+    bodyPreview | Lorem ipsum dolor sit amet, consectetur adipiscing elit. Duis vel diam gravida, auctor mauris nec, posuere tellus. Vivamus placerat, nunc ac cursus feugiat, arcu tellus mattis nisl, id cursus nisl lectus eu lacus. Praesent malesuada ut orci vitae viverra.
+    importance | normal
+    parentFolderId | AAMkAGUzZWVmZWU4LTM5ZmItNDA4My04OTIzLWY1MGUxNzdiYTQ0MQAuAAAAAABn1FpEFqPeR7YAnkzP\_VgXAQAhebtol4HnTZCmNsr9Gnh6AAAAAAEMAAA=
+    conversationId | AAQkAGUzZWVmZWU4LTM5ZmItNDA4My04OTIzLWY1MGUxNzdiYTQ0MQAQAJfvGq77YHxJvRN73\_QiuVw=
+    conversationIndex | AQHZMbuNl+8arvtgfEm9E3vf5CK5XA==
+    isDeliveryReceiptRequested | false
+    isReadReceiptRequested | false
+    isRead | true
+    isDraft | false
+    webLink | https://outlook.office365.com/owa/?ItemID=AAMkAGUzZWVmZWU4LTM5ZmItNDA4My04OTIzLWY1MGUxNzdiYTQ0MQBGAAAAAABn1FpEFqPeR7YAnkzP%2BVgXBwAhebtol4HnTZCmNsr9Gnh6AAAAAAEMAAAhebtol4HnTZCmNsr9Gnh6AAPfHbtVAAA%3D&exvsurl=1&viewmodel=ReadMessageItem
+    inferenceClassification | focused
+    body | {"contentType":"html","content":"<html><head>\r\n<meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\"><style type=\"text/css\" style=\"display:none\">\r\n<!--\r\np\r\n\t{margin-top:0;\r\n\tmargin-bottom:0}\r\n-->\r\n</style></head><body dir=\"ltr\"><div class=\"elementToProof ContentPasted0\" style=\"font-family:Calibri,Arial,Helvetica,sans-serif; font-size:12pt; color:rgb(0,0,0); background-color:rgb(255,255,255)\">Lorem ipsum dolor sit amet, consectetur adipiscing elit. Duis vel diam gravida, auctor mauris nec, posuere tellus. Vivamus placerat, nunc ac cursus feugiat, arcu tellus mattis nisl, id cursus nisl lectus eu lacus. Praesent malesuada ut orci vitae viverra. Suspendisse cursus turpis vel urna volutpat congue. Etiam auctor nec nulla sed suscipit. Vestibulum rhoncus quis mi ac faucibus. Curabitur eget eleifend felis. Vestibulum ut dolor non elit molestie ornare. <br></div></body></html>"}
+    sender | {"emailAddress":{"name":"John Doe","address":"john.doe@contoso.com"}}
+    from | {"emailAddress":{"name":"John Doe","address":"john.doe@contoso.com"}}
+    toRecipients | [{"emailAddress":{"name":"Megan Bowen","address":"megan.bowen@contoso.com"}}]
+    ccRecipients | []
+    bccRecipients | []
+    replyTo | []
+    flag | {"flagStatus":"notFlagged"}
+    ```

package/docs/docs/cmd/outlook/message/message-list.md

@@ -38,6 +38,125 @@ List all messages in the folder with the specified well-known name
 m365 outlook message list --folderName inbox
 ```
 
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "id": "AAMkAGUzZWVmZWU4LTM5ZmItNDA4My04OTIzLWY1MGUxNzdiYTQ0MQBGAAAAAABn1FpEFqPeR7YAnkzP_VgXBwAhebtol4HnTZCmNsr9Gnh6AAAAAAEMAAAhebtol4HnTZCmNsr9Gnh6AAPfHbtVAAA=",
+        "createdDateTime": "2023-01-26T19:22:44Z",
+        "lastModifiedDateTime": "2023-01-26T19:22:46Z",
+        "changeKey": "CQAAABYAAAAhebtol4HnTZCmNsr9Gnh6AAPehsHb",
+        "categories": [],
+        "receivedDateTime": "2023-01-26T19:22:45Z",
+        "sentDateTime": "2023-01-26T19:22:42Z",
+        "hasAttachments": true,
+        "internetMessageId": "<HE1P190MB032953D4D9C86FCEF5FFA8C4CECF9@HE1P190MB0329.EURP190.PROD.OUTLOOK.COM>",
+        "subject": "Lorem ipsum",
+        "bodyPreview": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Duis vel diam gravida, auctor mauris nec, posuere tellus. Vivamus placerat, nunc ac cursus feugiat, arcu tellus mattis nisl, id cursus nisl lectus eu lacus. Praesent malesuada ut orci vitae viverra.",
+        "importance": "normal",
+        "parentFolderId": "AAMkAGUzZWVmZWU4LTM5ZmItNDA4My04OTIzLWY1MGUxNzdiYTQ0MQAuAAAAAABn1FpEFqPeR7YAnkzP_VgXAQAhebtol4HnTZCmNsr9Gnh6AAAAAAEMAAA=",
+        "conversationId": "AAQkAGUzZWVmZWU4LTM5ZmItNDA4My04OTIzLWY1MGUxNzdiYTQ0MQAQAJfvGq77YHxJvRN73_QiuVw=",
+        "conversationIndex": "AQHZMbuNl+8arvtgfEm9E3vf5CK5XA==",
+        "isDeliveryReceiptRequested": false,
+        "isReadReceiptRequested": false,
+        "isRead": false,
+        "isDraft": false,
+        "webLink": "https://outlook.office365.com/owa/?ItemID=AAMkAGUzZWVmZWU4LTM5ZmItNDA4My04OTIzLWY1MGUxNzdiYTQ0MQBGAAAAAABn1FpEFqPeR7YAnkzP%2BVgXBwAhebtol4HnTZCmNsr9Gnh6AAAAAAEMAAAhebtol4HnTZCmNsr9Gnh6AAPfHbtVAAA%3D&exvsurl=1&viewmodel=ReadMessageItem",
+        "inferenceClassification": "focused",
+        "body": {
+          "contentType": "html",
+          "content": "<html><head>\r\\\n<meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\"><style type=\"text/css\" style=\"display:none\">\r\\\n<!--\r\\\np\r\\\n\t{margin-top:0;\r\\\n\tmargin-bottom:0}\r\\\n-->\r\\\n</style></head><body dir=\"ltr\"><div class=\"elementToProof ContentPasted0\" style=\"font-family:Calibri,Arial,Helvetica,sans-serif; font-size:12pt; color:rgb(0,0,0); background-color:rgb(255,255,255)\">Lorem ipsum dolor sit amet, consectetur adipiscing elit. Duis vel diam gravida, auctor mauris nec, posuere tellus. Vivamus placerat, nunc ac cursus feugiat, arcu tellus mattis nisl, id cursus nisl lectus eu lacus. Praesent malesuada ut orci vitae viverra. Suspendisse cursus turpis vel urna volutpat congue. Etiam auctor nec nulla sed suscipit. Vestibulum rhoncus quis mi ac faucibus. Curabitur eget eleifend felis. Vestibulum ut dolor non elit molestie ornare. <br></div></body></html>"
+        },
+        "sender": {
+          "emailAddress": {
+            "name": "John Doe",
+            "address": "john.doe@contoso.com"
+          }
+        },
+        "from": {
+          "emailAddress": {
+            "name": "John Doe",
+            "address": "john.doe@contoso.com"
+          }
+        },
+        "toRecipients": [
+          {
+            "emailAddress": {
+              "name": "Megan Bowen",
+              "address": "megan.bowen@contoso.com"
+            }
+          }
+        ],
+        "ccRecipients": [],
+        "bccRecipients": [],
+        "replyTo": [],
+        "flag": {
+          "flagStatus": "notFlagged"
+        }
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```txt
+    subject      receivedDateTime    
+    -----------  --------------------
+    Lorem ipsum  2023-01-26T19:22:45Z
+    ```
+
+=== "CSV"
+
+    ```csv
+    subject,receivedDateTime
+    Lorem ipsum,2023-01-26T19:22:45Z
+    ```
+
+=== "Markdown"
+
+    ```md
+    # outlook message list --folderName "inbox"
+
+    Date: 4/2/2023
+
+    ## AAMkAGUzZWVmZWU4LTM5ZmItNDA4My04OTIzLWY1MGUxNzdiYTQ0MQBGAAAAAABn1FpEFqPeR7YAnkzP_VgXBwAhebtol4HnTZCmNsr9Gnh6AAAAAAEMAAAhebtol4HnTZCmNsr9Gnh6AAPfHbtVAAA=
+
+    Property | Value
+    ---------|-------
+    id | AAMkAGUzZWVmZWU4LTM5ZmItNDA4My04OTIzLWY1MGUxNzdiYTQ0MQBGAAAAAABn1FpEFqPeR7YAnkzP_VgXBwAhebtol4HnTZCmNsr9Gnh6AAAAAAEMAAAhebtol4HnTZCmNsr9Gnh6AAPfHbtVAAA=
+    createdDateTime | 2023-01-26T19:22:44Z
+    lastModifiedDateTime | 2023-01-26T19:22:46Z
+    changeKey | CQAAABYAAAAhebtol4HnTZCmNsr9Gnh6AAPk7Plc
+    categories | []
+    receivedDateTime | 2023-01-26T19:22:45Z
+    sentDateTime | 2023-01-26T19:22:42Z
+    hasAttachments | true
+    internetMessageId | <HE1P190MB032953D4D9C86FCEF5FFA8C4CECF9@HE1P190MB0329.EURP190.PROD.OUTLOOK.COM>
+    subject | Lorem ipsum
+    bodyPreview | Lorem ipsum dolor sit amet, consectetur adipiscing elit. Duis vel diam gravida, auctor mauris nec, posuere tellus. Vivamus placerat, nunc ac cursus feugiat, arcu tellus mattis nisl, id cursus nisl lectus eu lacus. Praesent malesuada ut orci vitae viverra.
+    importance | normal
+    parentFolderId | AAMkAGUzZWVmZWU4LTM5ZmItNDA4My04OTIzLWY1MGUxNzdiYTQ0MQAuAAAAAABn1FpEFqPeR7YAnkzP\_VgXAQAhebtol4HnTZCmNsr9Gnh6AAAAAAEMAAA=
+    conversationId | AAQkAGUzZWVmZWU4LTM5ZmItNDA4My04OTIzLWY1MGUxNzdiYTQ0MQAQAJfvGq77YHxJvRN73\_QiuVw=
+    conversationIndex | AQHZMbuNl+8arvtgfEm9E3vf5CK5XA==
+    isDeliveryReceiptRequested | false
+    isReadReceiptRequested | false
+    isRead | true
+    isDraft | false
+    webLink | https://outlook.office365.com/owa/?ItemID=AAMkAGUzZWVmZWU4LTM5ZmItNDA4My04OTIzLWY1MGUxNzdiYTQ0MQBGAAAAAABn1FpEFqPeR7YAnkzP%2BVgXBwAhebtol4HnTZCmNsr9Gnh6AAAAAAEMAAAhebtol4HnTZCmNsr9Gnh6AAPfHbtVAAA%3D&exvsurl=1&viewmodel=ReadMessageItem
+    inferenceClassification | focused
+    body | {"contentType":"html","content":"<html><head>\r\n<meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\"><style type=\"text/css\" style=\"display:none\">\r\n<!--\r\np\r\n\t{margin-top:0;\r\n\tmargin-bottom:0}\r\n-->\r\n</style></head><body dir=\"ltr\"><div class=\"elementToProof ContentPasted0\" style=\"font-family:Calibri,Arial,Helvetica,sans-serif; font-size:12pt; color:rgb(0,0,0); background-color:rgb(255,255,255)\">Lorem ipsum dolor sit amet, consectetur adipiscing elit. Duis vel diam gravida, auctor mauris nec, posuere tellus. Vivamus placerat, nunc ac cursus feugiat, arcu tellus mattis nisl, id cursus nisl lectus eu lacus. Praesent malesuada ut orci vitae viverra. Suspendisse cursus turpis vel urna volutpat congue. Etiam auctor nec nulla sed suscipit. Vestibulum rhoncus quis mi ac faucibus. Curabitur eget eleifend felis. Vestibulum ut dolor non elit molestie ornare. <br></div></body></html>"}
+    sender | {"emailAddress":{"name":"John Doe","address":"john.doe@contoso.com"}}
+    from | {"emailAddress":{"name":"John Doe","address":"john.doe@contoso.com"}}
+    toRecipients | [{"emailAddress":{"name":"Megan Bowen","address":"megan.bowen@contoso.com"}}]
+    ccRecipients | []
+    bccRecipients | []
+    replyTo | []
+    flag | {"flagStatus":"notFlagged"}
+    ```
+
 ## More information
 
 - Well-known folder names: [https://docs.microsoft.com/en-us/graph/api/resources/mailfolder?view=graph-rest-1.0](https://docs.microsoft.com/en-us/graph/api/resources/mailfolder?view=graph-rest-1.0)

package/docs/docs/cmd/outlook/message/message-move.md

@@ -48,6 +48,10 @@ name
 m365 outlook message move --id AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYmY4OABGAAAAAAAiQ8W967B7TKBjgx9rVEURBwAiIsqMbYjsT5e-T7KzowPTAAAAAAEMAAAiIsqMbYjsT5e-T7KzowPTAALdyzhHAAA= --sourceFolderName inbox --targetFolderName archive
 ```
 
+## Response
+
+The command won't return a response on success.
+
 ## More information
 
 - Well-known folder names: [https://docs.microsoft.com/en-us/graph/api/resources/mailfolder?view=graph-rest-1.0](https://docs.microsoft.com/en-us/graph/api/resources/mailfolder?view=graph-rest-1.0)

package/docs/docs/cmd/outlook/report/report-mailactivitycounts.md

@@ -37,3 +37,43 @@ Gets the trends of email activity (like how many were sent, read, and received)
 ```sh
 m365 outlook report mailactivitycounts --period D7 --output json > "mailactivitycounts.json"
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "Report Refresh Date": "2023-01-24",
+        "Send": "",
+        "Receive": "2",
+        "Read": "",
+        "Meeting Created": "0",
+        "Meeting Interacted": "",
+        "Report Date": "2023-01-18",
+        "Report Period": "7"
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```txt
+    Report Refresh Date,Send,Receive,Read,Meeting Created,Meeting Interacted,Report Date,Report Period
+    2023-01-24,,2,,0,,2023-01-18,7
+    ```
+
+=== "CSV"
+
+    ```csv
+    Report Refresh Date,Send,Receive,Read,Meeting Created,Meeting Interacted,Report Date,Report Period
+    2023-01-24,,2,,0,,2023-01-18,7
+    ```
+
+=== "Markdown"
+
+    ```md
+    Report Refresh Date,Send,Receive,Read,Meeting Created,Meeting Interacted,Report Date,Report Period
+    2023-01-24,,2,,0,,2023-01-18,7
+    ```

package/docs/docs/cmd/outlook/report/report-mailactivityusercounts.md

@@ -37,3 +37,43 @@ Gets the trends on the number of unique users who are performing email activitie
 ```sh
 m365 outlook report mailactivityusercounts --period D7 --output json > "mailactivityusercounts.json"
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "Report Refresh Date": "2023-01-24",
+        "Send": "",
+        "Receive": "2",
+        "Read": "",
+        "Meeting Created": "0",
+        "Meeting Interacted": "",
+        "Report Date": "2023-01-18",
+        "Report Period": "7"
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```txt
+    Report Refresh Date,Send,Receive,Read,Meeting Created,Meeting Interacted,Report Date,Report Period
+    2023-01-24,,2,,0,,2023-01-18,7
+    ```
+
+=== "CSV"
+
+    ```csv
+    Report Refresh Date,Send,Receive,Read,Meeting Created,Meeting Interacted,Report Date,Report Period
+    2023-01-24,,2,,0,,2023-01-18,7
+    ```
+
+=== "Markdown"
+
+    ```md
+    Report Refresh Date,Send,Receive,Read,Meeting Created,Meeting Interacted,Report Date,Report Period
+    2023-01-24,,2,,0,,2023-01-18,7
+    ```