@pnp/cli-microsoft365 6.8.0 → 6.9.0-beta.148279d

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

@@ -0,0 +1,132 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# adaptivecard send
+
+Sends adaptive card to the specified URL
+
+## Usage
+
+```sh
+m365 adaptivecard send [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --url <url>`
+: URL where to send the card to.
+
+`-t, --title [title]`
+: 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.
+
+`-a, --actionUrl [actionUrl]`
+: URL that users should be sent to after clicking the **View** button on the card.
+
+`--card [card]`
+: 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.
+```
+
+<Global />
+
+## Remarks
+
+Using this command you can send either a predefined or a custom adaptive card to the specified URL. To send a predefined adaptive card, specify one or more options: `title`, `description`, `imageUrl`, `actionUrl`. To specify a custom card, specify the card's JSON contents using the `card` option.
+
+When sending both predefined and custom cards, you can specify arbitrary options. With predefined cards, these options will be listed in a FactSet. With custom card, you control how the data will be presented on the card.
+
+The predefined card is automatically adjusted based on which options have been specified (`title`, `description`, `imageUrl`, `actionUrl`). If you don't specify a particular option, that portion of the card will not be included in the sent card.
+
+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.
+
+:::caution 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.mdx#escaping-double-quotes-in-powershell) apply due to an issue. Remember that you can also use [file tokens](./../../user-guide/using-cli.mdx#passing-complex-content-into-cli-options) instead.
+
+:::
+
+## Examples
+
+Send a predefined adaptive card with just title.
+
+```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 --title "CLI for Microsoft 365 v3.4"
+```
+
+Send a predefined adaptive card with just description.
+
+```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 --description "New release of CLI for Microsoft 365"
+```
+
+Send card with title and description.
+
+```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 --title "CLI for Microsoft 365 v3.4" --description "New release of CLI for Microsoft 365"
+```
+
+Send card with title, description, and image.
+
+```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 --title "CLI for Microsoft 365 v3.4" --description "New release of CLI for Microsoft 365" --imageUrl "https://contoso.com/image.gif"
+```
+
+Send card with title, description, and action.
+
+```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 --title "CLI for Microsoft 365 v3.4" --description "New release of CLI for Microsoft 365" --actionUrl "https://aka.ms/cli-m365"
+```
+
+Send card with title, description, image, and action.
+
+```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 --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 card with title, description, action, and unknown options.
+
+```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 --title "CLI for Microsoft 365 v3.4" --description "New release of CLI for Microsoft 365" --actionUrl "https://aka.ms/cli-m365" --Version "v3.4.0" --ReleaseNotes "https://pnp.github.io/cli-microsoft365/about/release-notes/#v340"
+```
+
+Send custom card without any 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":"CLI for Microsoft 365 v3.4"},{"type":"TextBlock","text":"New release of CLI for Microsoft 365","wrap":true}],"actions":[{"type":"Action.OpenUrl","title":"View","url":"https://aka.ms/cli-m365"}],"$schema":"http://adaptivecards.io/schemas/adaptive-card.json","version":"1.2"}'
+```
+
+Send custom card with just title merged.
+
+```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}"}],"$schema":"http://adaptivecards.io/schemas/adaptive-card.json","version":"1.2"}' --title "CLI for Microsoft 365 v3.4"
+```
+
+Send custom card with all known options merged.
+
+```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":"${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.
+
+```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}"}],"$schema":"http://adaptivecards.io/schemas/adaptive-card.json","version":"1.2"}' --Title "CLI for Microsoft 365 v3.4"
+```
+
+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.mdx

@@ -0,0 +1,225 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# app get
+
+Retrieves information about the current Azure AD app
+
+## Usage
+
+```sh
+m365 app get [options]
+```
+
+## Options
+
+```md definition-list
+`--appId [appId]`
+: Client ID of the Azure AD app registered in the .m365rc.json file to retrieve information for.
+```
+
+<Global />
+
+## Remarks
+
+Use this command to quickly look up information for the Azure AD application registration registered in the .m365rc.json file in your current project (folder).
+
+If you have multiple apps registered in your .m365rc.json file, you can specify the app for which you'd like to retrieve permissions using the `--appId` option. If you don't specify the app using the `--appId` option, you'll be prompted to select one of the applications from your .m365rc.json file.
+
+## Examples
+
+Retrieve information about your current Azure AD app.
+
+```sh
+m365 app get
+```
+
+Retrieve information about the Azure AD app with client ID specified in the _.m365rc.json_ file.
+
+```sh
+m365 app get --appId e23d235c-fcdf-45d1-ac5f-24ab2ee0695d
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="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": "contoso.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": []
+    }
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="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           : contoso.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":[]}
+  ```
+
+  </TabItem>
+  <TabItem value="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,,,[],,,,contoso.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"":[]}"
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # app get --appId "02f9ff8c-b79e-4552-bdda-4facd74d6df1"
+
+  Date: 5/29/2023
+
+  ## My AAD app (b3241f2a-6551-43d4-a72f-0d02ccfeb77f)
+
+  Property | Value
+  ---------|-------
+  id | b3241f2a-6551-43d4-a72f-0d02ccfeb77f
+  appId | 02f9ff8c-b79e-4552-bdda-4facd74d6df1
+  createdDateTime | 2022-10-28T21:20:57Z
+  displayName | My AAD app
+  publisherDomain | contoso.onmicrosoft.com
+  signInAudience | AzureADMyOrg
+  ```
+
+  </TabItem>
+</Tabs>
+

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

@@ -0,0 +1,85 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# app open
+
+Returns deep link of the current AD app to open the Azure portal on the Azure AD app registration management page.
+
+## Usage
+
+```sh
+m365 app open [options]
+```
+
+## Options
+
+```md definition-list
+`--appId [appId]`
+: Optional Application (client) ID of the Azure AD application registration to open. Uses the app from the `.m365rc.json` file corresponding to the `appId`. If multiple apps are available, this will evade the prompt to choose an app. If the `appId` is not available in the list of apps, an error is thrown.
+
+`--preview`
+: Use to open the url of the Azure AD preview portal.
+```
+
+<Global />
+
+## Remarks
+
+If config setting `autoOpenLinksInBrowser` is configured to true, the command will automatically open the link to the Azure Portal in the browser.
+
+Gets the app from the `.m365rc.json` file in the current directory. If the `--appId` option is not used and multiple apps are available, it will prompt the user to choose one.
+
+## Examples
+
+Prints the URL to the Azure AD application registration management page on the Azure Portal. 
+
+```sh
+m365 app open
+```
+
+Prints the url of the Azure AD application registration management page on the preview Azure Portal.
+
+```sh
+m365 app open --preview
+```
+
+Prints the URL to the Azure AD application registration management page on the Azure Portal, evading a possible choice prompt in the case of multiple saved apps in the `.m365rc.json` file. 
+
+```sh
+m365 app open --appId d75be2e1-0204-4f95-857d-51a37cf40be8 
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="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/"
+  ```
+
+  </TabItem>
+  <TabItem value="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/
+  ```
+
+  </TabItem>
+  <TabItem value="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/
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  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/
+  ```
+
+  </TabItem>
+</Tabs>
+

package/docs/docs/cmd/app/permission/permission-add.mdx

@@ -0,0 +1,57 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# app permission add
+
+Adds the specified application and/or delegated permissions to the current AAD app API permissions
+
+## Usage
+
+```sh
+m365 app permission add [options]
+```
+
+## Options
+
+```md definition-list
+`--appId [appId]`
+: Client ID of the Azure AD app registered in the .m365rc.json file to retrieve API permissions for.
+
+`--applicationPermission [applicationPermission]`
+: Space-separated list of application permissions to add.
+
+`--delegatedPermission [delegatedPermission]`
+: Space-separated list of delegated permissions to add.
+
+`--grantAdminConsent`
+: If specified, admin consent to the newly added permissions will be granted.
+```
+
+<Global />
+
+## Remarks
+
+If you have multiple apps registered in your .m365rc.json file, you can specify the app for which you'd like to retrieve permissions using the `--appId` option. If you don't specify the app using the `--appId` option, you'll be prompted to select one of the applications from your .m365rc.json file.
+
+## Examples
+
+Adds the specified application permissions to the default app registered in the _.m365rc.json_ file while granting admin consent.
+
+```sh
+m365 app permission add --applicationPermission 'https://graph.microsoft.com/User.ReadWrite.All https://graph.microsoft.com/User.Read.All' --grantAdminConsent
+```
+
+Adds the specified delegated permissions to the default app registered in the _.m365rc.json_ file without granting admin consent.
+
+```sh
+m365 app permission add --delegatedPermission 'https://graph.microsoft.com/offline_access'
+```
+
+Adds the specified application and delegated permissions to a specific app registered in the _.m365rc.json_ file while granting admin consent.
+
+```sh
+m365 app permission add --appId '1663767b-4172-4519-bfd1-28e6ff19055b' --applicationPermission 'https://graph.microsoft.com/User.ReadWrite.All https://graph.microsoft.com/User.Read.All' --delegatedPermission 'https://graph.microsoft.com/offline_access' --grantAdminConsent
+```
+
+## Response
+
+The command won't return a response on success.

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

@@ -0,0 +1,93 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# app permission list
+
+Lists API permissions for the current AAD app
+
+## Usage
+
+```sh
+m365 app permission list [options]
+```
+
+## Options
+
+```md definition-list
+`--appId [appId]`
+: Client ID of the Azure AD app registered in the .m365rc.json file to retrieve API permissions for.
+```
+
+<Global />
+
+## Remarks
+
+Use this command to quickly look up API permissions for the Azure AD application registration registered in the _.m365rc.json_ file in your current project (folder).
+
+If you have multiple apps registered in your .m365rc.json file, you can specify the app for which you'd like to retrieve permissions using the `--appId` option. If you don't specify the app using the `--appId` option, you'll be prompted to select one of the applications from your _.m365rc.json_ file.
+
+## Examples
+
+Retrieve API permissions for your current Azure AD app.
+
+```sh
+m365 app permission list
+```
+
+Retrieve API permissions for the Azure AD app with the client ID specified in the _.m365rc.json_ file.
+
+```sh
+m365 app permission list --appId e23d235c-fcdf-45d1-ac5f-24ab2ee0695d
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "resource": "Microsoft Teams - Teams And Channels Service",
+      "permission": "channels.readwrite",
+      "type": "Application"
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  resource                                      permission          type
+  --------------------------------------------  ------------------  -----------
+  Microsoft Teams - Teams And Channels Service  channels.readwrite  Application
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  resource,permission,type
+  Microsoft Teams - Teams And Channels Service,channels.readwrite,Application
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # app permission list
+
+  Date: 5/29/2023
+
+  Property | Value
+  ---------|-------
+  resource | Microsoft Teams - Teams And Channels Service
+  permission | channels.readwrite
+  type | Application
+  ```
+
+  </TabItem>
+</Tabs>
+