@pnp/cli-microsoft365 5.9.0-beta.fd6d022 → 6.0.0-beta.01ba480

package/docs/docs/cmd/aad/o365group/o365group-recyclebinitem-list.md

@@ -10,11 +10,11 @@ m365 aad o365group recyclebinitem list [options]
 
 ## Options
 
-`-d, --displayName [displayName]`
-: Lists groups with displayName starting with the specified value
+`-d, --groupDisplayName [groupDisplayName]`
+: Lists groups with DisplayName starting with the specified value
 
-`-m, --mailNickname [mailNickname]`
-: Lists groups with mailNickname starting with the specified value
+`-m, --groupMailNickname [groupMailNickname]`
+: Lists groups with MailNickname starting with the specified value
 
 --8<-- "docs/cmd/_global.md"
 
@@ -29,17 +29,17 @@ m365 aad o365group recyclebinitem list
 List deleted Microsoft 365 Groups with display name starting with _Project_
 
 ```sh
-m365 aad o365group recyclebinitem list --displayName Project
+m365 aad o365group recyclebinitem list --groupDisplayName Project
 ```
 
 List deleted Microsoft 365 Groups mail nick name starting with _team_
 
 ```sh
-m365 aad o365group recyclebinitem list --mailNickname team
+m365 aad o365group recyclebinitem list --groupMailNickname team
 ```
 
 List deleted Microsoft 365 Groups mail nick name starting with _team_ and with display name starting with _Project_
 
 ```sh
-m365 aad o365group recyclebinitem list --mailNickname team --displayName Project
+m365 aad o365group recyclebinitem list --groupMailNickname team --groupDisplayName Project
 ```

package/docs/docs/cmd/aad/o365group/o365group-recyclebinitem-restore.md

@@ -8,12 +8,6 @@ Restores a deleted Microsoft 365 Group
 m365 aad o365group recyclebinitem restore [options]
 ```
 
-## Alias
-
-```sh
-m365 aad o365group restore [options]
-```
-
 ## Options
 
 `-i, --id [id]`

package/docs/docs/cmd/aad/o365group/o365group-teamify.md

@@ -10,11 +10,11 @@ m365 aad o365group teamify [options]
 
 ## Options
 
-`-i, --groupId [groupId]`
-: The ID of the Microsoft 365 Group to connect to Microsoft Teams. Specify either groupId or mailNickname but not both
+`-i, --id [id]`
+: The ID of the Microsoft 365 Group to connect to Microsoft Teams. Specify either id or mailNickname but not both
 
 `--mailNickname [mailNickname]`
-: The mail alias of the Microsoft 365 Group to connect to Microsoft Teams. Specify either groupId or mailNickname but not both
+: The mail alias of the Microsoft 365 Group to connect to Microsoft Teams. Specify either id or mailNickname but not both
 
 --8<-- "docs/cmd/_global.md"
 
@@ -23,7 +23,7 @@ m365 aad o365group teamify [options]
 Creates a new Microsoft Teams team under existing Microsoft 365 group with id _e3f60f99-0bad-481f-9e9f-ff0f572fbd03_
 
 ```sh
-m365 aad o365group teamify --groupId e3f60f99-0bad-481f-9e9f-ff0f572fbd03
+m365 aad o365group teamify --id e3f60f99-0bad-481f-9e9f-ff0f572fbd03
 ```
 
 Creates a new Microsoft Teams team under existing Microsoft 365 group with mailNickname _GroupName_

package/docs/docs/cmd/aad/policy/policy-list.md

@@ -10,7 +10,7 @@ m365 aad policy list [options]
 
 ## Options
 
-`-p, --policyType [policyType]`
+`-t, --type [type]`
 : The type of policies to return. Allowed values `activityBasedTimeout`,`authorization`,`claimsMapping`,`homeRealmDiscovery`,`identitySecurityDefaultsEnforcement`,`tokenIssuance`,`tokenLifetime`. If omitted, all policies are returned
 
 --8<-- "docs/cmd/_global.md"
@@ -26,7 +26,7 @@ m365 aad policy list
 Returns claim-mapping policies from Azure AD
 
 ```sh
-m365 aad policy list --policyType "claimsMapping"
+m365 aad policy list --type "claimsMapping"
 ```
 
 ## More information

package/docs/docs/cmd/aad/sp/sp-get.md

@@ -13,17 +13,17 @@ m365 aad sp get [options]
 `-i, --appId [appId]`
 : ID of the application for which the service principal should be retrieved
 
-`-n, --displayName [displayName]`
+`-n, --appDisplayName [appDisplayName]`
 : Display name of the application for which the service principal should be retrieved
 
-`--objectId [objectId]`
+`--appObjectId [appObjectId]`
 : ObjectId of the application for which the service principal should be retrieved
 
 --8<-- "docs/cmd/_global.md"
 
 ## Remarks
 
-Specify either the `appId`, `objectId` or `displayName`. If you specify more than one option value, the command will fail with an error.
+Specify either the `appId`, `appObjectId` or `appDisplayName`. If you specify more than one option value, the command will fail with an error.
 
 ## Examples
 
@@ -36,13 +36,13 @@ m365 aad sp get --appId b2307a39-e878-458b-bc90-03bc578531d6
 Return details about the _Microsoft Graph_ service principal.
 
 ```sh
-m365 aad sp get --displayName "Microsoft Graph"
+m365 aad sp get --appDisplayName "Microsoft Graph"
 ```
 
 Return details about the service principal with ObjectId _b2307a39-e878-458b-bc90-03bc578531dd_.
 
 ```sh
-m365 aad sp get --objectId b2307a39-e878-458b-bc90-03bc578531dd
+m365 aad sp get --appObjectId b2307a39-e878-458b-bc90-03bc578531dd
 ```
 
 ## More information

package/docs/docs/cmd/aad/user/user-guest-add.md

@@ -0,0 +1,107 @@
+# aad user guest add
+
+Invite an external user to the organization
+
+## Usage
+
+```sh
+m365 aad user guest add [options]
+```
+
+## Options
+
+`--emailAddress <emailAddress>`
+: The email address of the user.
+
+`--displayName [displayName]`
+: The display name of the user.
+
+`--inviteRedirectUrl [inviteRedirectUrl]`
+: The URL the user should be redirected to once the invitation is redeemed. If not specified, default URL https://myapplications.microsoft.com will be set.
+
+`--welcomeMessage [welcomeMessage]`
+: Personal welcome message which will be added to the email along with the default email.
+
+`--ccRecipients [ccRecipients]`
+: Additional recipients the invitation message should be sent to. Currently only 1 additional recipient is supported.
+
+`--messageLanguage [messageLanguage]`
+: The language you want to send the default message in. The language format should be in [ISO 639](https://learn.microsoft.com/en-us/openspecs/office_standards/ms-oi29500/ed06cf15-306c-43be-9053-ca81ca51e656). The default is `en-US`.
+
+`--sendInvitationMessage`
+: Indicates whether an email should be sent to the user.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Invite a user via email and set the display name
+
+```sh
+m365 aad user guest add --emailAddress john.doe@contoso.com --displayName "John Doe" --sendInvitationMessage
+```
+
+Invite a user with a custom email and custom redirect url
+
+```sh
+m365 aad user guest add --emailAddress john.doe@contoso.com --welcomeMessage "Hi John, welcome to the organization!" --sendInvitationMessage
+```
+
+Invite a user and send an invitation mail in Dutch
+
+```sh
+m365 aad user guest add --emailAddress john.doe@contoso.com --messageLanguage nl-BE --sendInvitationMessage
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "id": "35f7f726-c541-4aef-a64e-a7b6868fe47f",
+      "inviteRedeemUrl": "https://login.microsoftonline.com/redeem?rd=https%3a%2f%2finvitations.microsoft.com%2fredeem%2f%3ftenant%3db373bc30-03b3-49bc-be72-9dd3e9027da8%26user%3d35f7f726-c541-4aef-a64e-a7b6868fe47f%26ticket%3dCjO3u3ZpQF2uthfZETfZ8gURzod5egvYI0uhaSN1Loo%25253d%26ver%3d2.0",
+      "invitedUserDisplayName": "John Doe",
+      "invitedUserType": "Guest",
+      "invitedUserEmailAddress": "john.doe@contoso.com",
+      "sendInvitationMessage": true,
+      "resetRedemption": false,
+      "inviteRedirectUrl": "https://myapplications.microsoft.com/",
+      "status": "PendingAcceptance",
+      "invitedUserMessageInfo": {
+        "messageLanguage": "en-US",
+        "customizedMessageBody": "Hi John, welcome to the organization!",
+        "ccRecipients": [
+          {
+            "emailAddress": {
+              "name": null,
+              "address": "maria.jones@contoso.com"
+            }
+          }
+        ]
+      },
+      "invitedUser": {
+        "id": "5257b5b2-4056-4a45-a05e-df5c92d53e6e"
+      }
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    id                     : 35f7f726-c541-4aef-a64e-a7b6868fe47f
+    inviteRedeemUrl        : https://login.microsoftonline.com/redeem?rd=https%3a%2f%2finvitations.microsoft.com%2fredeem%2f%3ftenant%3db373bc30-03b3-49bc-be72-9dd3e9027da8%26user%3d35f7f726-c541-4aef-a64e-a7b6868fe47f%26ticket%3dCjO3u3ZpQF2uthfZETfZ8gURzod5egvYI0uhaSN1Loo%25253d%26ver%3d2.0
+    invitedUserDisplayName : John Doe
+    invitedUserEmailAddress: liwidit556@adroh.com
+    invitedUserType        : Guest
+    resetRedemption        : false
+    sendInvitationMessage  : true
+    status                 : PendingAcceptance
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,inviteRedeemUrl,invitedUserDisplayName,invitedUserEmailAddress,invitedUserType,resetRedemption,sendInvitationMessage,status
+    35f7f726-c541-4aef-a64e-a7b6868fe47f,https://login.microsoftonline.com/redeem?rd=https%3a%2f%2finvitations.microsoft.com%2fredeem%2f%3ftenant%3db373bc30-03b3-49bc-be72-9dd3e9027da8%26user%3d35f7f726-c541-4aef-a64e-a7b6868fe47f%26ticket%3dCjO3u3ZpQF2uthfZETfZ8gURzod5egvYI0uhaSN1Loo%25253d%26ver%3d2.0,John Doe,liwidit556@adroh.com,Guest,,1,PendingAcceptance
+    ```

package/docs/docs/cmd/adaptivecard/adaptivecard-send.md

@@ -43,6 +43,9 @@ The predefined card is automatically adjusted based on which options have been s
 
 If your custom card is a card template (card with placeholders like `${title}`), you can fill it with data either by specifying the complete data object using the `cardData` option, or by passing any number of arbitrary options that will be mapped onto the card. The arbitrary properties should not match any of the global options like `output`, `query`, `debug`, etc. Data options like `title`, `description`, `imageUrl` and `actionUrl` will be mapped onto the card as well.
 
+!!! warning "Escaping JSON in PowerShell"
+    When using the `--card` and `--cardData` options 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
 
 Send a predefined adaptive card with just title

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

@@ -13,7 +13,7 @@ m365 flow disable [options]
 `-n, --name <name>`
 : The name of the Power Automate flow to disable
 
-`-e, --environment <environment>`
+`-e, --environmentName <environmentName>`
 : The name of the environment for which to disable Power Automate flow
 
 `--asAdmin`
@@ -37,11 +37,11 @@ If the Power Automate flow with the name you specified doesn't exist, you will g
 Disables Power Automate flow owned by the currently signed-in user
 
 ```sh
-m365 flow disable --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d
+m365 flow disable --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d
 ```
 
 Disables Power Automate flow owned by another user
 
 ```sh
-m365 flow disable --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --asAdmin
+m365 flow disable --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --asAdmin
 ```

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

@@ -13,7 +13,7 @@ m365 flow enable [options]
 `-n, --name <name>`
 : The name of the Power Automate flow to enable
 
-`-e, --environment <environment>`
+`-e, --environmentName <environmentName>`
 : The name of the environment for which to enable Power Automate
 
 `--asAdmin`

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

@@ -13,7 +13,7 @@ m365 flow export [options]
 `-i, --id <id>`
 : The id of the Power Automate flow to export
 
-`-e, --environment <environment>`
+`-e, --environmentNameName <environmentName>`
 : The name of the environment for which to export the flow
 
 `-n, --packageDisplayName [packageDisplayName]`
@@ -50,23 +50,23 @@ If the Power Automate flow with the id you specified doesn't exist, you will get
 Export the specified Power Automate flow as a ZIP file
 
 ```sh
-m365 flow export --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 3989cb59-ce1a-4a5c-bb78-257c5c39381d
+m365 flow export --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 3989cb59-ce1a-4a5c-bb78-257c5c39381d
 ```
 
 Export the specified Power Automate flow as a JSON file
 
 ```sh
-m365 flow export --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 3989cb59-ce1a-4a5c-bb78-257c5c39381d --format json
+m365 flow export --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 3989cb59-ce1a-4a5c-bb78-257c5c39381d --format json
 ```
 
 Export the specified Power Automate flow as a ZIP file, specifying a Display Name of 'My flow name' to be embedded into the package
 
 ```sh
-m365 flow export --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 3989cb59-ce1a-4a5c-bb78-257c5c39381d --packageDisplayName 'My flow name'
+m365 flow export --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 3989cb59-ce1a-4a5c-bb78-257c5c39381d --packageDisplayName 'My flow name'
 ```
 
 Export the specified Power Automate flow as a ZIP file with the filename 'MyFlow.zip' saved to the current directory
 
 ```sh
-m365 flow export --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 3989cb59-ce1a-4a5c-bb78-257c5c39381d --path './MyFlow.zip'
+m365 flow export --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 3989cb59-ce1a-4a5c-bb78-257c5c39381d --path './MyFlow.zip'
 ```

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

@@ -13,7 +13,7 @@ m365 flow get [options]
 `-n, --name <name>`
 : The name of the Power Automate flow to get information about
 
-`-e, --environment <environment>`
+`-e, --environmentNameName <environmentName>`
 : The name of the environment for which to retrieve available flows
 
 `--asAdmin`
@@ -37,11 +37,11 @@ If the Power Automate flow with the name you specified doesn't exist, you will g
 Get information about the specified Power Automate flow owned by the currently signed-in user
 
 ```sh
-m365 flow get --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d
+m365 flow get --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d
 ```
 
 Get information about the specified Power Automate flow owned by another user
 
 ```sh
-m365 flow get --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --asAdmin
+m365 flow get --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --asAdmin
 ```

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,11 @@ 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
 ```

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,23 @@ 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
 ```

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,5 @@ 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
 ```

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,5 @@ 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
 ```

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,5 @@ 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
 ```

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,11 @@ 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
 ```

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>`
@@ -43,6 +37,9 @@ m365 outlook sendmail [options]
 `--importance [importance]`
 : 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.
+
 `--saveToSentItems [saveToSentItems]`
 : Save email in the sent items folder. Default `true`.
 
@@ -50,6 +47,10 @@ m365 outlook sendmail [options]
 
 ## Remarks
 
+### Attachments
+
+When using the `attachment` option, note that the total size of all attachment files cannot exceed 3 MB.
+
 ### If you are connected using app only authentication
 
 - Always specify a user id or upn in the `--sender` option. The email will be sent as if it came from the specified user, and can optionally be saved in the sent folder of that user account.
@@ -116,3 +117,9 @@ Send an email with cc and bcc recipients marked as important
 ```sh
 m365 outlook mail send --to chris@contoso.com --cc claire@contoso.com --bcc randy@contoso.com --subject "DG2000 Data Sheets" --bodyContents "The latest data sheets are in the team site" --importance high
 ```
+
+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"
+```

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
+```