@pnp/cli-microsoft365 6.0.0-beta.09b5216 → 6.0.0-beta.0e3b373

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

@@ -25,8 +25,8 @@ m365 aad o365group add [options]
 `--members [members]`
 : Comma-separated list of Microsoft 365 Group members
 
-`--isPrivate [isPrivate]`
-: Set to `true` if the Microsoft 365 Group should be private and to `false` if it should be public (default)
+`--isPrivate`
+: Specify, if the Microsoft 365 Group should be private. If not specified, will create a public group (default)
 
 `--allowMembersToPost [allowMembersToPost]`
 : Set if only group members should be able to post conversations to the group
@@ -61,7 +61,7 @@ m365 aad o365group add --displayName Finance --description "This is the Contoso
 Create a private Microsoft 365 Group
 
 ```sh
-m365 aad o365group add --displayName Finance --description "This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more." --mailNickname finance --isPrivate true
+m365 aad o365group add --displayName Finance --description "This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more." --mailNickname finance --isPrivate
 ```
 
 Create a public Microsoft 365 Group and set specified users as its owners

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

@@ -1,4 +1,4 @@
-# aad o365group restore
+# aad o365group recyclebinitem restore
 
 Restores a deleted Microsoft 365 Group
 
@@ -8,23 +8,35 @@ Restores a deleted Microsoft 365 Group
 m365 aad o365group recyclebinitem restore [options]
 ```
 
-## Alias
+## Options
 
-```sh
-m365 aad o365group restore [options]
-```
+`-i, --id [id]`
+: The ID of the Microsoft 365 Group to restore. Specify either `id`, `displayName` or `mailNickname` but not multiple.
 
-## Options
+`-d, --displayName [displayName]`
+: Display name for the Microsoft 365 Group to restore. Specify either `id`, `displayName` or `mailNickname` but not multiple.
 
-`-i, --id <id>`
-: The ID of the Microsoft 365 Group to restore
+`-m, --mailNickname [mailNickname]`
+: Name of the group e-mail (part before the @). Specify either `id`, `displayName` or `mailNickname` but not multiple.
 
 --8<-- "docs/cmd/_global.md"
 
 ## Examples
 
-Restores the Microsoft 365 Group with id _28beab62-7540-4db1-a23f-29a6018a3848_
+Restores the Microsoft 365 Group with specific ID
 
 ```sh
 m365 aad o365group recyclebinitem restore --id 28beab62-7540-4db1-a23f-29a6018a3848
 ```
+
+Restores the Microsoft 365 Group with specific name
+
+```sh
+m365 aad o365group recyclebinitem restore --displayName "My Group"
+```
+
+Restores the Microsoft 365 Group with specific mail nickname
+
+```sh
+m365 aad o365group recyclebinitem restore --mailNickname "Mygroup"
+```

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-get.md

@@ -56,6 +56,18 @@ For the user with id _1caf7dcd-7e83-4c3a-94f7-932a1299c844_ retrieve the user na
 m365 aad user get --id 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --properties "userPrincipalName,mail,displayName"
 ```
 
+Get information about the currently logged user using the Id token
+
+```sh
+m365 aad user get --id "@meId"
+```
+
+Get information about the currently logged in user using the UserName token
+
+```sh
+m365 aad user get --userName "@meUserName"
+```
+
 ## More information
 
 - Microsoft Graph User properties: [https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties](https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties)

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!" --inviteRedirectUrl https://contoso.sharepoint.com --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/aad/user/user-signin-list.md

@@ -78,4 +78,4 @@ Get all user's sign-ins filter by given user's Id and application identifier in
 
 ```sh
 m365 aad user signin list --userId '11111111-1111-1111-1111-111111111111' --appId '00000000-0000-0000-0000-000000000000'
-```
+```

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
@@ -117,22 +120,6 @@ Send custom card with card data
 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"}]}'
 ```
 
-## Examples for PowerShell
-
-Send custom card with all known options merged
-
-```powershell
-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\":\"${actionUrl}\"}],\"$schema\":\"http://adaptivecards.io/schemas/adaptive-card.json\",\"version\":\"1.2\"}" --title "CLI for Microsoft 365 v3.4" --description "New release of CLI for Microsoft 365" --imageUrl "https://contoso.com/image.gif" --actionUrl "https://aka.ms/cli-m365"
-```
-
-Send custom card with unknown option merged
-
-```powershell
-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}\"}],\"$schema\":\"http://adaptivecards.io/schemas/adaptive-card.json\",\"version\":\"1.2\"}" --Title "CLI for Microsoft 365 v3.4"
-```
+## Response
 
-Send custom card with card data
-
-```powershell
-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\"}]}"
-```
+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

@@ -1,4 +1,4 @@
-# aad app open
+# app open
 
 Returns deep link of the current AD app to open the Azure portal on the Azure AD app registration management page.
 
@@ -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
+    ```