@pnp/cli-microsoft365 6.0.0-beta.cd80a69 → 6.0.0-beta.d557a48

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

@@ -11,22 +11,22 @@ m365 adaptivecard send [options]
 ## Options
 
 `-u, --url <url>`
-: URL where to send the card to
+: URL where to send the card to.
 
 `-t, --title [title]`
-: Title of the card
+: Title of the card. Specify either `title` or `card` but not both.
 
 `-d, --description [description]`
 : Contents of the card
 
 `-i, --imageUrl [imageUrl]`
-: URL of the image to include on the card
+: URL of the image to include on the card.
 
 `-a, --actionUrl [actionUrl]`
-: URL that users should be sent to after clicking the **View** button on the card
+: URL that users should be sent to after clicking the **View** button on the card.
 
 `--card [card]`
-: Card definition
+: Card definition. Specify either `title` or `card` but not both.
 
 `--cardData [cardData]`
 : Card data. If your card is a card template, using cardData you can apply data to it. If you specify cardData, unknown options will be ignored.
@@ -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
@@ -116,3 +119,7 @@ Send custom card with card data
 ```sh
 m365 adaptivecard send --url https://contoso.webhook.office.com/webhookb2/892e8ed3-997c-4b6e-8f8a-7f32728a8a87@f7322380-f203-42ff-93e8-66e266f6d2e4/IncomingWebhook/fcc6565ec7a944928bd43d6fc193b258/4f0482d4-b147-4f67-8a61-11f0a5019547 --card '{"type":"AdaptiveCard","body":[{"type":"TextBlock","size":"Medium","weight":"Bolder","text":"${title}"},{"type":"TextBlock","text":"${description}","wrap":true},{"type":"FactSet","facts":[{"$data":"${properties}","title":"${key}:","value":"${value}"}]}],"actions":[{"type":"Action.OpenUrl","title":"View","url":"${viewUrl}"}],"$schema":"http://adaptivecards.io/schemas/adaptive-card.json","version":"1.2"}' --cardData '{"title":"Publish Adaptive Card Schema","description":"Now that we have defined the main rules and features of the format, we need to produce a schema and publish it to GitHub. The schema will be the starting point of our reference documentation.","creator":{"name":"Matt Hidinger","profileImage":"https://pbs.twimg.com/profile_images/3647943215/d7f12830b3c17a5a9e4afcc370e3a37e_400x400.jpeg"},"createdUtc":"2017-02-14T06:08:39Z","viewUrl":"https://adaptivecards.io","properties":[{"key":"Board","value":"Adaptive Cards"},{"key":"List","value":"Backlog"},{"key":"Assigned to","value":"Matt Hidinger"},{"key":"Due date","value":"Not set"}]}'
 ```
+
+## Response
+
+If the response is successful, it will return the body of the response.

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

@@ -34,3 +34,159 @@ Retrieve information about the Azure AD app with client ID _e23d235c-fcdf-45d1-a
 ```sh
 m365 app get --appId e23d235c-fcdf-45d1-ac5f-24ab2ee0695d
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "id": "b3241f2a-6551-43d4-a72f-0d02ccfeb77f",
+      "deletedDateTime": null,
+      "appId": "02f9ff8c-b79e-4552-bdda-4facd74d6df1",
+      "applicationTemplateId": null,
+      "disabledByMicrosoftStatus": null,
+      "createdDateTime": "2022-10-28T21:20:57Z",
+      "displayName": "My AAD app",
+      "description": null,
+      "groupMembershipClaims": null,
+      "identifierUris": [],
+      "isDeviceOnlyAuthSupported": null,
+      "isFallbackPublicClient": null,
+      "notes": null,
+      "publisherDomain": "8b7jz1.onmicrosoft.com",
+      "serviceManagementReference": null,
+      "signInAudience": "AzureADMyOrg",
+      "tags": [],
+      "tokenEncryptionKeyId": null,
+      "samlMetadataUrl": null,
+      "defaultRedirectUri": null,
+      "certification": null,
+      "optionalClaims": null,
+      "addIns": [],
+      "api": {
+        "acceptMappedClaims": null,
+        "knownClientApplications": [],
+        "requestedAccessTokenVersion": null,
+        "oauth2PermissionScopes": [],
+        "preAuthorizedApplications": []
+      },
+      "appRoles": [
+        {
+          "allowedMemberTypes": [
+            "User"
+          ],
+          "description": "Managers",
+          "displayName": "Managers",
+          "id": "d7c46856-8a66-485a-9047-098eba08b9a3",
+          "isEnabled": true,
+          "origin": "Application",
+          "value": "managers"
+        }
+      ],
+      "info": {
+        "logoUrl": null,
+        "marketingUrl": null,
+        "privacyStatementUrl": null,
+        "supportUrl": null,
+        "termsOfServiceUrl": null
+      },
+      "keyCredentials": [],
+      "parentalControlSettings": {
+        "countriesBlockedForMinors": [],
+        "legalAgeGroupRule": "Allow"
+      },
+      "passwordCredentials": [],
+      "publicClient": {
+        "redirectUris": []
+      },
+      "requiredResourceAccess": [
+        {
+          "resourceAppId": "b55b276d-2b09-4ad2-8de5-f09cf24ffba9",
+          "resourceAccess": [
+            {
+              "id": "162b1576-a2b2-458d-b7b9-04481911b4ef",
+              "type": "Role"
+            }
+          ]
+        },
+        {
+          "resourceAppId": "00000005-0000-0ff1-ce00-000000000000",
+          "resourceAccess": [
+            {
+              "id": "8e5870bb-8808-44dc-8e10-c509ed919ddd",
+              "type": "Scope"
+            },
+            {
+              "id": "5db81a03-0de0-432b-b31e-71d57c8d2e0b",
+              "type": "Scope"
+            }
+          ]
+        }
+      ],
+      "verifiedPublisher": {
+        "displayName": null,
+        "verifiedPublisherId": null,
+        "addedDateTime": null
+      },
+      "web": {
+        "homePageUrl": null,
+        "logoutUrl": null,
+        "redirectUris": [],
+        "implicitGrantSettings": {
+          "enableAccessTokenIssuance": false,
+          "enableIdTokenIssuance": false
+        },
+        "redirectUriSettings": []
+      },
+      "spa": {
+        "redirectUris": []
+      }
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    addIns                    : []
+    api                       : {"acceptMappedClaims":null,"knownClientApplications":[],"requestedAccessTokenVersion":null,"oauth2PermissionScopes":[],"preAuthorizedApplications":[]}
+    appId                     : 02f9ff8c-b79e-4552-bdda-4facd74d6df1
+    appRoles                  : [{"allowedMemberTypes":["User"],"description":"Managers","displayName":"Managers","id":"d7c46856-8a66-485a-9047-098eba08b9a3","isEnabled":true,"origin":"Application","value":"managers"}]
+    applicationTemplateId     : null
+    certification             : null
+    createdDateTime           : 2022-10-28T21:20:57Z
+    defaultRedirectUri        : null
+    deletedDateTime           : null
+    description               : null
+    disabledByMicrosoftStatus : null
+    displayName               : My AAD app
+    groupMembershipClaims     : null
+    id                        : b3241f2a-6551-43d4-a72f-0d02ccfeb77f
+    identifierUris            : []
+    info                      : {"logoUrl":null,"marketingUrl":null,"privacyStatementUrl":null,"supportUrl":null,"termsOfServiceUrl":null}
+    isDeviceOnlyAuthSupported : null
+    isFallbackPublicClient    : null
+    keyCredentials            : []
+    notes                     : null
+    optionalClaims            : null
+    parentalControlSettings   : {"countriesBlockedForMinors":[],"legalAgeGroupRule":"Allow"}
+    passwordCredentials       : []
+    publicClient              : {"redirectUris":[]}
+    publisherDomain           : 8b7jz1.onmicrosoft.com
+    requiredResourceAccess    : [{"resourceAppId":"b55b276d-2b09-4ad2-8de5-f09cf24ffba9","resourceAccess":[{"id":"162b1576-a2b2-458d-b7b9-04481911b4ef","type":"Role"}]},{"resourceAppId":"00000005-0000-0ff1-ce00-000000000000","resourceAccess":[{"id":"8e5870bb-8808-44dc-8e10-c509ed919ddd","type":"Scope"},{"id":"5db81a03-0de0-432b-b31e-71d57c8d2e0b","type":"Scope"}]}]
+    samlMetadataUrl           : null
+    serviceManagementReference: null
+    signInAudience            : AzureADMyOrg
+    spa                       : {"redirectUris":[]}
+    tags                      : []
+    tokenEncryptionKeyId      : null
+    verifiedPublisher         : {"displayName":null,"verifiedPublisherId":null,"addedDateTime":null}
+    web                       : {"homePageUrl":null,"logoutUrl":null,"redirectUris":[],"implicitGrantSettings":{"enableAccessTokenIssuance":false,"enableIdTokenIssuance":false},"redirectUriSettings":[]}
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,deletedDateTime,appId,applicationTemplateId,disabledByMicrosoftStatus,createdDateTime,displayName,description,groupMembershipClaims,identifierUris,isDeviceOnlyAuthSupported,isFallbackPublicClient,notes,publisherDomain,serviceManagementReference,signInAudience,tags,tokenEncryptionKeyId,samlMetadataUrl,defaultRedirectUri,certification,optionalClaims,addIns,api,appRoles,info,keyCredentials,parentalControlSettings,passwordCredentials,publicClient,requiredResourceAccess,verifiedPublisher,web,spa
+    b3241f2a-6551-43d4-a72f-0d02ccfeb77f,,02f9ff8c-b79e-4552-bdda-4facd74d6df1,,,2022-10-28T21:20:57Z,My AAD app,,,[],,,,8b7jz1.onmicrosoft.com,,AzureADMyOrg,[],,,,,,[],"{""acceptMappedClaims"":null,""knownClientApplications"":[],""requestedAccessTokenVersion"":null,""oauth2PermissionScopes"":[],""preAuthorizedApplications"":[]}","[{""allowedMemberTypes"":[""User""],""description"":""Managers"",""displayName"":""Managers"",""id"":""d7c46856-8a66-485a-9047-098eba08b9a3"",""isEnabled"":true,""origin"":""Application"",""value"":""managers""}]","{""logoUrl"":null,""marketingUrl"":null,""privacyStatementUrl"":null,""supportUrl"":null,""termsOfServiceUrl"":null}",[],"{""countriesBlockedForMinors"":[],""legalAgeGroupRule"":""Allow""}",[],"{""redirectUris"":[]}","[{""resourceAppId"":""b55b276d-2b09-4ad2-8de5-f09cf24ffba9"",""resourceAccess"":[{""id"":""162b1576-a2b2-458d-b7b9-04481911b4ef"",""type"":""Role""}]},{""resourceAppId"":""00000005-0000-0ff1-ce00-000000000000"",""resourceAccess"":[{""id"":""8e5870bb-8808-44dc-8e10-c509ed919ddd"",""type"":""Scope""},{""id"":""5db81a03-0de0-432b-b31e-71d57c8d2e0b"",""type"":""Scope""}]}]","{""displayName"":null,""verifiedPublisherId"":null,""addedDateTime"":null}","{""homePageUrl"":null,""logoutUrl"":null,""redirectUris"":[],""implicitGrantSettings"":{""enableAccessTokenIssuance"":false,""enableIdTokenIssuance"":false},""redirectUriSettings"":[]}","{""redirectUris"":[]}"
+    ```

package/docs/docs/cmd/app/app-open.md

@@ -43,3 +43,23 @@ Prints the URL to the Azure AD application registration management page on the A
 ```sh
 m365 app open --appId d75be2e1-0204-4f95-857d-51a37cf40be8 
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    "Use a web browser to open the page https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationMenuBlade/Overview/appId/02f9ff8c-b79e-4552-bdda-4facd74d6df2/isMSAApp/"
+    ```
+
+=== "Text"
+
+    ```text
+    Use a web browser to open the page https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationMenuBlade/Overview/appId/02f9ff8c-b79e-4552-bdda-4facd74d6df2/isMSAApp/
+    ```
+
+=== "CSV"
+
+    ```csv
+    Use a web browser to open the page https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationMenuBlade/Overview/appId/02f9ff8c-b79e-4552-bdda-4facd74d6df2/isMSAApp/
+    ```

package/docs/docs/cmd/app/permission/permission-list.md

@@ -34,3 +34,46 @@ Retrieve API permissions for the Azure AD app with client ID _e23d235c-fcdf-45d1
 ```sh
 m365 app permission list --appId e23d235c-fcdf-45d1-ac5f-24ab2ee0695d
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "resource": "Microsoft Teams - Teams And Channels Service",
+        "permission": "channels.readwrite",
+        "type": "Application"
+      },
+      {
+        "resource": "Yammer",
+        "permission": "access_as_user",
+        "type": "Delegated"
+      },
+      {
+        "resource": "Yammer",
+        "permission": "user_impersonation",
+        "type": "Delegated"
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    resource                                      permission          type
+    --------------------------------------------  ------------------  -----------
+    Microsoft Teams - Teams And Channels Service  channels.readwrite  Application
+    Yammer                                        access_as_user      Delegated
+    Yammer                                        user_impersonation  Delegated
+    ```
+
+=== "CSV"
+
+    ```csv
+    resource,permission,type
+    Microsoft Teams - Teams And Channels Service,channels.readwrite,Application
+    Yammer,access_as_user,Delegated
+    Yammer,user_impersonation,Delegated
+    ```

package/docs/docs/cmd/booking/business/business-get.md

@@ -31,3 +31,110 @@ Retrieve the specified Microsoft Bookings business with name _business name_.
 ```sh
 m365 booking business get --name 'business name'
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "id": "Accounting@8b7jz1.onmicrosoft.com",
+      "displayName": "Accounting",
+      "businessType": "Financial services",
+      "phone": "",
+      "email": "runningdevadmin@8b7jz1.onmicrosoft.com",
+      "webSiteUrl": "",
+      "defaultCurrencyIso": "USD",
+      "isPublished": true,
+      "publicUrl": "https://outlook.office365.com/owa/calendar/Accounting@8b7jz1.onmicrosoft.com/bookings/",
+      "languageTag": "",
+      "address": {
+        "street": "",
+        "city": "",
+        "state": "",
+        "countryOrRegion": "",
+        "postalCode": ""
+      },
+      "businessHours": [
+        {
+          "day": "monday",
+          "timeSlots": [
+            {
+              "startTime": "08:00:00.0000000",
+              "endTime": "17:00:00.0000000"
+            }
+          ]
+        },
+        {
+          "day": "tuesday",
+          "timeSlots": [
+            {
+              "startTime": "08:00:00.0000000",
+              "endTime": "17:00:00.0000000"
+            }
+          ]
+        },
+        {
+          "day": "wednesday",
+          "timeSlots": [
+            {
+              "startTime": "08:00:00.0000000",
+              "endTime": "17:00:00.0000000"
+            }
+          ]
+        },
+        {
+          "day": "thursday",
+          "timeSlots": [
+            {
+              "startTime": "08:00:00.0000000",
+              "endTime": "17:00:00.0000000"
+            }
+          ]
+        },
+        {
+          "day": "friday",
+          "timeSlots": [
+            {
+              "startTime": "08:00:00.0000000",
+              "endTime": "17:00:00.0000000"
+            }
+          ]
+        },
+        {
+          "day": "saturday",
+          "timeSlots": []
+        },
+        {
+          "day": "sunday",
+          "timeSlots": []
+        }
+      ],
+      "schedulingPolicy": {
+        "timeSlotInterval": "PT30M",
+        "minimumLeadTime": "P1D",
+        "maximumAdvance": "P365D",
+        "sendConfirmationsToOwner": true,
+        "allowStaffSelection": true
+      }
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    businessType      : Financial services
+    defaultCurrencyIso: USD
+    displayName       : Accounting
+    email             : runningdevadmin@8b7jz1.onmicrosoft.com
+    id                : Accounting@8b7jz1.onmicrosoft.com
+    phone             :
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,displayName,businessType,phone,email,defaultCurrencyIso
+    Accounting@8b7jz1.onmicrosoft.com,Accounting,Financial services,,runningdevadmin@8b7jz1.onmicrosoft.com,USD
+
+    ```

package/docs/docs/cmd/booking/business/business-list.md

@@ -19,3 +19,37 @@ Returns a list of all Microsoft Bookings businesses that are created for the ten
 ```sh
 m365 booking business list
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "id": "Accounting@8b7jz1.onmicrosoft.com",
+        "displayName": "Accounting"
+      },
+      {
+        "id": "BestShop@8b7jz1.onmicrosoft.com",
+        "displayName": "Best Shop"
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    id                                 displayName
+    ---------------------------------  -----------
+    Accounting@8b7jz7.onmicrosoft.com  Accounting
+    BestShop@8b7jz7.onmicrosoft.com    Best Shop
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,displayName
+    Accounting@8b7jz7.onmicrosoft.com,Accounting
+    BestShop@8b7jz7.onmicrosoft.com,Best Shop
+    ```

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

@@ -37,6 +37,9 @@ m365 outlook mail send [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`.
 
@@ -44,6 +47,10 @@ m365 outlook mail send [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.
@@ -110,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"
+```