@pnp/cli-microsoft365 5.9.0 → 6.0.0-beta.063a75a

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

@@ -10,7 +10,7 @@ m365 flow list [options]
 
 ## Options
 
-`-e, --environment <environment>`
+`-e, --environmentName <environmentName>`
 : The name of the environment for which to retrieve available flows
 
 `--asAdmin`
@@ -32,11 +32,118 @@ By default, the `flow list` command returns only your flows. To list all flows,
 List all your flows in the given environment
 
 ```sh
-m365 flow list --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5
+m365 flow list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5
 ```
 
 List all flows in the given environment
 
 ```sh
-m365 flow list --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --asAdmin
+m365 flow list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --asAdmin
 ```
+
+## Response
+
+### Standard response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "name": "00afcb83-df7b-4fe0-ab9c-1542a1dc66a9",
+        "id": "/providers/Microsoft.ProcessSimple/environments/Default-00000000-0000-0000-0000-000000000000/flows/00afcb83-df7b-4fe0-ab9c-1542a1dc66a9",
+        "type": "Microsoft.ProcessSimple/environments/flows",
+        "properties": {
+          "apiId": "/providers/Microsoft.PowerApps/apis/shared_logicflows",
+          "displayName": "Contoso Invoicing Flow",
+          "userType": "Owner",
+          "state": "Started",
+          "connectionReferences": {
+            "shared_contoso-20invoicing-5fdd00e4805bfffb8f-5fbaee43593a7efda0": {
+              "connectionName": "bd877f62e4224011aa936d706fc68902",
+              "source": "Invoker",
+              "id": "/providers/Microsoft.PowerApps/apis/shared_contoso-20invoicing-5fdd00e4805bfffb8f-5fbaee43593a7efda0",
+              "displayName": "Contoso Invoicing",
+              "iconUri": "https://az787822.vo.msecnd.net/defaulticons/api-dedicated.png",
+              "brandColor": "#007ee5",
+              "tier": "NotSpecified"
+            },
+            "shared_flowpush": {
+              "connectionName": "shared-flowpush-d2c01136-3f7d-4449-b4f1-cb2d03a35ba8",
+              "source": "Invoker",
+              "id": "/providers/Microsoft.PowerApps/apis/shared_flowpush",
+              "displayName": "Notifications",
+              "iconUri": "https://connectoricons-prod.azureedge.net/releases/v1.0.1599/1.0.1599.3017/flowpush/icon.png",
+              "brandColor": "#FF3B30",
+              "tier": "Standard"
+            }
+          },
+          "createdTime": "2022-06-11T10:34:03.7241198Z",
+          "lastModifiedTime": "2022-06-11T10:35:54.1920032Z",
+          "environment": {
+            "name": "Default-00000000-0000-0000-0000-000000000000",
+            "type": "Microsoft.ProcessSimple/environments",
+            "id": "/providers/Microsoft.ProcessSimple/environments/Default-00000000-0000-0000-0000-000000000000"
+          },
+          "definitionSummary": {
+            "triggers": [
+              {
+                "type": "Request",
+                "kind": "Button",
+                "metadata": {
+                  "operationMetadataId": "0cc0490e-e1b6-4a19-b313-f54862d64f02"
+                }
+              }
+            ],
+            "actions": [
+              {
+                "type": "OpenApiConnection",
+                "swaggerOperationId": "ListInvoices",
+                "metadata": {
+                  "operationMetadataId": "d76a7b54-48bb-49a0-86b8-dd3d21b3d5ce"
+                }
+              },
+              {
+                "type": "Table",
+                "metadata": {
+                  "operationMetadataId": "1164ebc4-b501-46bc-bc88-cc99660f92c3"
+                }
+              },
+              {
+                "type": "OpenApiConnection",
+                "swaggerOperationId": "SendEmailNotification",
+                "metadata": {
+                  "operationMetadataId": "9febe29f-2e36-4765-81ab-83645d28332d"
+                }
+              }
+            ]
+          },
+          "creator": {
+            "tenantId": "00000000-0000-0000-0000-000000000000",
+            "objectId": "00000000-0000-0000-0000-000000000000",
+            "userId": "00000000-0000-0000-0000-000000000000",
+            "userType": "ActiveDirectory"
+          },
+          "provisioningMethod": "FromDefinition",
+          "flowFailureAlertSubscribed": true,
+          "isManaged": false
+        },
+        "displayName": "Contoso Invoicing Flow"
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    name                                  displayName
+    ------------------------------------  -----------------------------------------------
+    00afcb83-df7b-4fe0-ab9c-1542a1dc66a9  Contoso Invoicing Flow
+    ```
+
+=== "CSV"
+
+    ```csv
+    name,displayName
+    00afcb83-df7b-4fe0-ab9c-1542a1dc66a9,Contoso Invoicing Flow
+    ```

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

@@ -13,7 +13,7 @@ m365 flow remove [options]
 `-n, --name <name>`
 : The name of the Power Automate flow to remove
 
-`-e, --environment <environment>`
+`-e, --environmentName <environmentName>`
 : The name of the environment to which the flow belongs
 
 `--asAdmin`
@@ -37,23 +37,27 @@ If the Power Automate flow with the name you specified doesn't exist, you will g
 Removes the specified Power Automate flow owned by the currently signed-in user
 
 ```sh
-m365 flow remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d
+m365 flow remove --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d
 ```
 
 Removes the specified Power Automate flow owned by the currently signed-in user without confirmation
 
 ```sh
-m365 flow remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --confirm
+m365 flow remove --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --confirm
 ```
 
 Removes the specified Power Automate flow owned by another user
 
 ```sh
-m365 flow remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --asAdmin
+m365 flow remove --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --asAdmin
 ```
 
 Removes the specified Power Automate flow owned by another user without confirmation
 
 ```sh
-m365 flow remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --asAdmin --confirm
+m365 flow remove --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --asAdmin --confirm
 ```
+
+## Response
+
+The command won't return a response on success.

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

@@ -13,10 +13,10 @@ m365 flow run cancel [options]
 `-n, --name <name>`
 : The name of the run to cancel
 
-`-f, --flow <flow>`
+`-f, --flowName <flowName>`
 : The name of the flow to cancel the run for
 
-`-e, --environment <environment>`
+`-e, --environmentName <environmentName>`
 : The name of the environment where the flow is located
 
 --8<-- "docs/cmd/_global.md"
@@ -37,5 +37,9 @@ If the run with the name you specified doesn't exist, you will get the `The work
 Cancel the given run of the specified flow
 
 ```sh
-m365 flow run cancel --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flow 5923cb07-ce1a-4a5c-ab81-257ce820109a --name 08586653536760200319026785874CU62
+m365 flow run cancel --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a --name 08586653536760200319026785874CU62
 ```
+
+## Response
+
+The command won't return a response on success.

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

@@ -13,10 +13,10 @@ m365 flow run get [options]
 `-n, --name <name>`
 : The name of the run to get information about
 
-`-f, --flow <flow>`
+`-f, --flowName <flowName>`
 : The name of the Power Automate flow for which to retrieve information
 
-`-e, --environment <environment>`
+`-e, --environmentName <environmentName>`
 : The name of the environment where the flow is located
 
 --8<-- "docs/cmd/_global.md"
@@ -37,5 +37,77 @@ If the run with the name you specified doesn't exist, you will get the `The prov
 Get information about the given run of the specified Power Automate flow
 
 ```sh
-m365 flow run get --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flow 5923cb07-ce1a-4a5c-ab81-257ce820109a --name 08586653536760200319026785874CU62
+m365 flow run get --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a --name 08586653536760200319026785874CU62
 ```
+
+
+## Response
+
+### Standard response
+
+=== "JSON"
+
+    ```json
+    {
+      "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",
+      "endTime": "",
+      "status": "Running",
+      "triggerName": "When_a_new_response_is_submitted"
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    endTime    :
+    name       : 08585329112602833828909892130CU17
+    startTime  : 2022-11-17T14:33:45.2763872Z
+    status     : Running
+    triggerName: When_a_new_response_is_submitted
+    ```
+
+=== "CSV"
+
+    ```csv
+    name,startTime,endTime,status,triggerName
+    08585329112602833828909892130CU17,2022-11-17T14:33:45.2763872Z,,Running,When_a_new_response_is_submitted
+    ```
+	

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

@@ -10,10 +10,10 @@ m365 flow run list [options]
 
 ## Options
 
-`-f, --flow <flow>`
+`-f, --flowName <flowName>`
 : The name of the Microsoft Flow to retrieve the runs for
 
-`-e, --environment <environment>`
+`-e, --environmentName <environmentName>`
 : The name of the environment to which the flow belongs
 
 --8<-- "docs/cmd/_global.md"
@@ -32,5 +32,73 @@ If the Microsoft Flow with the name you specified doesn't exist, you will get th
 List runs of the specified Microsoft Flow
 
 ```sh
-m365 flow run list --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flow 5923cb07-ce1a-4a5c-ab81-257ce820109a
+m365 flow run list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a
 ```
+
+## Response
+
+### Standard response
+
+=== "JSON"
+
+    ```json
+    [      
+      {
+        "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"
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    name                               startTime                     status
+    ---------------------------------  ----------------------------  ---------
+    08585329112602833828909892130CU17  2022-11-17T14:33:45.2763872Z  Running
+    ```
+
+=== "CSV"
+
+    ```csv
+    name,startTime,status
+    08585329112602833828909892130CU17,2022-11-17T14:33:45.2763872Z,Running
+    ```

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

@@ -13,10 +13,10 @@ m365 flow run resubmit [options]
 `-n, --name <name>`
 : The name of the run to resubmit
 
-`-f, --flow <flow>`
+`-f, --flowName <flowName>`
 : The name of the flow to resubmit the run for
 
-`-e, --environment <environment>`
+`-e, --environmentName <environmentName>`
 : The name of the environment where the Flow is located
 
 `--confirm`
@@ -40,11 +40,15 @@ If the run with the name you specified doesn't exist, you will get the `The work
 Resubmits a specific flow run for the specified Microsoft Flow
 
 ```sh
-m365 flow run resubmit --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flow 5923cb07-ce1a-4a5c-ab81-257ce820109a --name 08586653536760200319026785874CU62
+m365 flow run resubmit --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a --name 08586653536760200319026785874CU62
 ```
 
 Resubmits a specific flow run for the specified Microsoft Flow without prompting for confirmation
 
 ```sh
-m365 flow run resubmit --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flow 5923cb07-ce1a-4a5c-ab81-257ce820109a --name 08586653536760200319026785874CU62 --confirm
+m365 flow run resubmit --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a --name 08586653536760200319026785874CU62 --confirm
 ```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/graph/schemaextension/schemaextension-add.md

@@ -43,26 +43,19 @@ The schema extension owner is the ID of the Azure AD application that is the own
 
 The target types are the set of Microsoft Graph resource types (that support schema extensions) that this schema extension definition can be applied to. This option is specified as a comma-separated list
 
-When specifying the JSON string of properties on Windows, you have to escape double quotes in a specific way. Considering the following value for the _properties_ option: `{"Foo":"Bar"}`,
-you should specify the value as <code>\`"{""Foo"":""Bar""}"\`</code>.
-In addition, when using PowerShell, you should use the `--%` argument.
+!!! warning "Escaping JSON in PowerShell"
+    When using the `--properties` option it's possible to enter a JSON string. In PowerShell 5 to 7.2 [specific escaping rules](./../../../user-guide/using-cli.md#escaping-double-quotes-in-powershell) apply due to an issue. Remember that you can also use [file tokens](./../../../user-guide/using-cli.md#passing-complex-content-into-cli-options) instead.
 
 ## Examples
 
 Create a schema extension
 
 ```sh
-m365 graph schemaextension add --id MySchemaExtension --description "My Schema Extension" --targetTypes Group --owner 62375ab9-6b52-47ed-826b-58e47e0e304b --properties \`"[{""name"":""myProp1"",""type"":""Integer""},{""name"":""myProp2"",""type"":""String""}]\`
+m365 graph schemaextension add --id MySchemaExtension --description "My Schema Extension" --targetTypes Group --owner 62375ab9-6b52-47ed-826b-58e47e0e304b --properties '[{"name":"myProp1","type":"Integer"},{"name":"myProp2","type":"String"}]'
 ```
 
 Create a schema extension with a verified domain
 
 ```sh
-m365 graph schemaextension add --id contoso_MySchemaExtension --description "My Schema Extension" --targetTypes Group --owner 62375ab9-6b52-47ed-826b-58e47e0e304b --properties \`"[{""name"":""myProp1"",""type"":""Integer""},{""name"":""myProp2"",""type"":""String""}]\`
-```
-
-Create a schema extension in PowerShell
-
-```PowerShell
-graph schemaextension add --id contoso_MySchemaExtension --description "My Schema Extension" --targetTypes Group --owner "62375ab9-6b52-47ed-826b-58e47e0e304b" --properties --% \`"[{""name"":""myProp1"",""type"":""Integer""},{""name"":""myProp2"",""type"":""String""}]\`
+m365 graph schemaextension add --id contoso_MySchemaExtension --description "My Schema Extension" --targetTypes Group --owner 62375ab9-6b52-47ed-826b-58e47e0e304b --properties '[{"name":"myProp1","type":"Integer"},{"name":"myProp2","type":"String"}]'
 ```

package/docs/docs/cmd/graph/schemaextension/schemaextension-set.md

@@ -35,9 +35,9 @@ m365 graph schemaextension set [options]
 The lifecycle state of the schema extension. The initial state upon creation is `InDevelopment`.
 Possible states transitions are from `InDevelopment` to `Available` and `Available` to `Deprecated`.
 The target types are the set of Microsoft Graph resource types (that support schema extensions) that this schema extension definition can be applied to. This option is specified as a comma-separated list.
-When specifying the JSON string of properties on Windows, you have to escape double quotes in a specific way. Considering the following value for the _properties_ option: `{"Foo":"Bar"}`,
-you should specify the value as <code>\`"{""Foo"":""Bar""}"\`</code>.
-In addition, when using PowerShell, you should use the `--%` argument.
+
+!!! warning "Escaping JSON in PowerShell"
+    When using the `--properties` option it's possible to enter a JSON string. In PowerShell 5 to 7.2 [specific escaping rules](./../../../user-guide/using-cli.md#escaping-double-quotes-in-powershell) apply due to an issue. Remember that you can also use [file tokens](./../../../user-guide/using-cli.md#passing-complex-content-into-cli-options) instead.
 
 ## Examples
 
@@ -50,13 +50,7 @@ m365 graph schemaextension set --id MySchemaExtension --owner 62375ab9-6b52-47ed
 Update the target types and properties of a schema extension
 
 ```sh
-m365 graph schemaextension set --id contoso_MySchemaExtension --owner 62375ab9-6b52-47ed-826b-58e47e0e304b --targetTypes "Group,User" --properties \`"[{""name"":""myProp1"",""type"":""Integer""},{""name"":""myProp2"",""type"":""String""}]\`
-```
-
-Update the properties of a schema extension in PowerShell
-
-```PowerShell
-graph schemaextension set --id contoso_MySchemaExtension --owner 62375ab9-6b52-47ed-826b-58e47e0e304b --properties --% \`"[{""name"":""myProp1"",""type"":""Integer""},{""name"":""myProp2"",""type"":""String""}]\`
+m365 graph schemaextension set --id contoso_MySchemaExtension --owner 62375ab9-6b52-47ed-826b-58e47e0e304b --targetTypes "Group,User" --properties '[{"name":"myProp1","type":"Integer"},{"name":"myProp2","type":"String"}]'
 ```
 
 Change the status of a schema extension to 'Available'

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

@@ -8,12 +8,6 @@ Sends an email
 m365 outlook mail send [options]
 ```
 
-## Alias
-
-```sh
-m365 outlook sendmail [options]
-```
-
 ## Options
 
 `-s, --subject <subject>`

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

@@ -0,0 +1,48 @@
+# outlook message get
+
+Retrieves specified message
+
+## Usage
+
+```sh
+m365 outlook message get [options]
+```
+
+## Options
+
+`-i, --id <id>`
+: ID of the message
+
+`--userId [userId]`
+: ID of the user from which to retrieve the message. Specify either `userId` or `userPrincipalName`, but not both. This option is required when using application permissions.
+
+`--userPrincipalName [userPrincipalName]`
+: UPN of the user from which to retrieve the message Specify either `userId` or `userPrincipalName`, but not both. This option is required when using application permissions.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Get a specific message using delegated permissions
+
+```sh
+m365 outlook message get --id AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYmY4OABGAAAAAAAiQ8W967B7TKBjgx9rVEURBwAiIsqMbYjsT5e-T7KzowPTAAAAAAEMAAAiIsqMbYjsT5e-T7KzowPTAALvuv07AAA=
+```
+
+Get a specific message using delegated permissions from a shared mailbox
+
+```sh
+m365 outlook message get --id AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYmY4OABGAAAAAAAiQ8W967B7TKBjgx9rVEURBwAiIsqMbYjsT5e-T7KzowPTAAAAAAEMAAAiIsqMbYjsT5e-T7KzowPTAALvuv07AAA= --userPrincipalName sharedmailbox@tenant.com
+```
+
+Get a specific message from a specific user retrieved by user ID using application permissions
+
+```sh
+m365 outlook message get --id AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYmY4OABGAAAAAAAiQ8W967B7TKBjgx9rVEURBwAiIsqMbYjsT5e-T7KzowPTAAAAAAEMAAAiIsqMbYjsT5e-T7KzowPTAALvuv07AAA= --userId 6799fd1a-723b-4eb7-8e52-41ae530274ca
+```
+
+Get a specific message from a specific user retrieved by user principal name using application permissions
+
+```sh
+m365 outlook message get --id AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYmY4OABGAAAAAAAiQ8W967B7TKBjgx9rVEURBwAiIsqMbYjsT5e-T7KzowPTAAAAAAEMAAAiIsqMbYjsT5e-T7KzowPTAALvuv07AAA= --userPrincipalName user@tenant.com
+```

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

@@ -10,7 +10,7 @@ m365 outlook message move [options]
 
 ## Options
 
-`--messageId <messageId>`
+`--id <id>`
 : ID of the message to move
 
 `--sourceFolderName [sourceFolderName]`
@@ -32,20 +32,20 @@ m365 outlook message move [options]
 Move the specified message to another folder specified by ID
 
 ```sh
-m365 outlook message move --messageId AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYmY4OABGAAAAAAAiQ8W967B7TKBjgx9rVEURBwAiIsqMbYjsT5e-T7KzowPTAAAAAAEMAAAiIsqMbYjsT5e-T7KzowPTAALdyzhHAAA= --sourceFolderId AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYmY4OAAuAAAAAAAiQ8W967B7TKBjgx9rVEURAQAiIsqMbYjsT5e-T7KzowPTAAAAAAEKAAA= --targetFolderId AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYmY4OAAuAAAAAAAiQ8W967B7TKBjgx9rVEURAQAiIsqMbYjsT5e-T7KzowPTAAAeUO-fAAA=
+m365 outlook message move --id AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYmY4OABGAAAAAAAiQ8W967B7TKBjgx9rVEURBwAiIsqMbYjsT5e-T7KzowPTAAAAAAEMAAAiIsqMbYjsT5e-T7KzowPTAALdyzhHAAA= --sourceFolderId AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYmY4OAAuAAAAAAAiQ8W967B7TKBjgx9rVEURAQAiIsqMbYjsT5e-T7KzowPTAAAAAAEKAAA= --targetFolderId AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYmY4OAAuAAAAAAAiQ8W967B7TKBjgx9rVEURAQAiIsqMbYjsT5e-T7KzowPTAAAeUO-fAAA=
 ```
 
 Move the specified message to another folder specified by name
 
 ```sh
-m365 outlook message move --messageId AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYmY4OABGAAAAAAAiQ8W967B7TKBjgx9rVEURBwAiIsqMbYjsT5e-T7KzowPTAAAAAAEMAAAiIsqMbYjsT5e-T7KzowPTAALdyzhHAAA= --sourceFolderName Inbox --targetFolderName "Project X"
+m365 outlook message move --id AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYmY4OABGAAAAAAAiQ8W967B7TKBjgx9rVEURBwAiIsqMbYjsT5e-T7KzowPTAAAAAAEMAAAiIsqMbYjsT5e-T7KzowPTAALdyzhHAAA= --sourceFolderName Inbox --targetFolderName "Project X"
 ```
 
 Move the specified message to another folder specified by its well-known
 name
 
 ```sh
-m365 outlook message move --messageId AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYmY4OABGAAAAAAAiQ8W967B7TKBjgx9rVEURBwAiIsqMbYjsT5e-T7KzowPTAAAAAAEMAAAiIsqMbYjsT5e-T7KzowPTAALdyzhHAAA= --sourceFolderName inbox --targetFolderName archive
+m365 outlook message move --id AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYmY4OABGAAAAAAAiQ8W967B7TKBjgx9rVEURBwAiIsqMbYjsT5e-T7KzowPTAAAAAAEMAAAiIsqMbYjsT5e-T7KzowPTAALdyzhHAAA= --sourceFolderName inbox --targetFolderName archive
 ```
 
 ## More information