@pnp/cli-microsoft365 6.0.0-beta.b5f756a → 6.0.0-beta.b62b543

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