@pnp/cli-microsoft365 10.9.0-beta.bc13e90 → 10.10.0-beta.3dc1bcf

package/dist/utils/spo.js

@@ -1403,13 +1403,13 @@ export const spo = {
         await request.post(requestOptions);
     },
     /**
-     * Retrieves the site ID for a given web URL.
+     * Retrieves the site ID for a given web URL by the MS Graph.
      * @param webUrl The web URL for which to retrieve the site ID.
      * @param logger The logger object.
      * @param verbose Set for verbose logging
-     * @returns A promise that resolves to the site ID.
+     * @returns The site ID as a string.
      */
-    async getSiteId(webUrl, logger, verbose) {
+    async getSiteIdByMSGraph(webUrl, logger, verbose) {
         if (verbose && logger) {
             await logger.logToStderr(`Getting site id for URL: ${webUrl}...`);
         }
@@ -1424,6 +1424,90 @@ export const spo = {
         const site = await request.get(requestOptions);
         return site.id;
     },
+    /**
+     * Retrieves the SharePoint Online site ID for the specified web URL by the SharePoint REST API.
+     * @param webUrl The web URL of the SharePoint Online site to retrieve the site ID for.
+     * @param logger The logger object.
+     * @param verbose Set for verbose logging
+     * @returns The site ID as a string.
+     */
+    async getSiteIdBySPApi(webUrl, logger, verbose) {
+        if (verbose && logger) {
+            await logger.logToStderr(`Getting site id for URL: ${webUrl}...`);
+        }
+        const requestOptions = {
+            url: `${webUrl}/_api/site?$select=Id`,
+            headers: {
+                accept: 'application/json;odata=nometadata'
+            },
+            responseType: 'json'
+        };
+        const siteResponse = await request.get(requestOptions);
+        return siteResponse.Id;
+    },
+    /**
+     * Retrieves the id of a SharePoint web for the specified web URL.
+     * @param webUrl The web URL for which to retrieve the web ID.
+     * @param logger The logger object for logging messages.
+     * @param verbose Set to true for verbose logging.
+     * @returns The web ID as a string.
+     */
+    async getWebId(webUrl, logger, verbose) {
+        if (verbose && logger) {
+            await logger.logToStderr(`Getting web id for URL: ${webUrl}...`);
+        }
+        const requestOptions = {
+            url: `${webUrl}/_api/web?$select=Id`,
+            headers: {
+                accept: 'application/json;odata=nometadata'
+            },
+            responseType: 'json'
+        };
+        const webResponse = await request.get(requestOptions);
+        return webResponse.Id;
+    },
+    /**
+     * Retrieves the ID of a SharePoint list by its title or URL.
+     * @param webUrl The base URL of the SharePoint site.
+     * @param listTitle The title of the list (optional).
+     * @param listUrl The server-relative URL of the list (optional).
+     * @param logger The logger object for logging messages (optional).
+     * @param verbose Set to true for verbose logging (optional).
+     * @returns The list ID as a string.
+     */
+    async getListId(webUrl, listTitle, listUrl, logger, verbose) {
+        if (verbose && logger) {
+            await logger.logToStderr(`Retrieving list id...`);
+        }
+        if (!listTitle && !listUrl) {
+            throw new Error('Either listTitle or listUrl must be provided.');
+        }
+        let listId = '';
+        if (listTitle) {
+            const requestOptions = {
+                url: `${webUrl}/_api/web/lists/getByTitle('${formatting.encodeQueryParameter(listTitle)}')?$select=Id`,
+                headers: {
+                    accept: 'application/json;odata=nometadata'
+                },
+                responseType: 'json'
+            };
+            const listResponse = await request.get(requestOptions);
+            listId = listResponse.Id;
+        }
+        else if (listUrl) {
+            const listServerRelativeUrl = urlUtil.getServerRelativePath(webUrl, listUrl);
+            const requestOptions = {
+                url: `${webUrl}/_api/web/GetList('${formatting.encodeQueryParameter(listServerRelativeUrl)}')?$select=Id`,
+                headers: {
+                    accept: 'application/json;odata=nometadata'
+                },
+                responseType: 'json'
+            };
+            const listResponse = await request.get(requestOptions);
+            listId = listResponse.Id;
+        }
+        return listId;
+    },
     /**
      * Retrieves the server-relative URL of a folder.
      * @param webUrl Web URL

package/docs/docs/cmd/_global.mdx

@@ -1,6 +1,6 @@
 ```md definition-list
 `-h, --help [help]`
-: Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are `options`, `examples`, `remarks`, `response`, `full`. Default is `options`.
+: Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are `options`, `examples`, `remarks`, `permissions`, `response`, `full`. Default is `options`.
 
 `--query [query]`
 : JMESPath query string. See [http://jmespath.org/](http://jmespath.org/) for more information and examples.

package/docs/docs/cmd/entra/m365group/m365group-get.mdx

@@ -22,29 +22,32 @@ m365 entra m365group get [options]
 : Display name of the Microsoft 365 Group or Microsoft Teams team to retrieve information for. Specify either `id` or `displayName`, but not both.
 
 `--includeSiteUrl`
-: Set to retrieve the site URL for the group
+: (deprecated. Use option `withSiteUrl` instead) Set to retrieve the site URL for the group.
+
+`--withSiteUrl`
+: Set to retrieve the site URL for the group.
 ```
 
 <Global />
 
 ## Examples
 
-Get information about the Microsoft 365 Group with id _1caf7dcd-7e83-4c3a-94f7-932a1299c844_
+Get information about the Microsoft 365 Group with id _1caf7dcd-7e83-4c3a-94f7-932a1299c844_.
 
 ```sh
 m365 entra m365group get --id 1caf7dcd-7e83-4c3a-94f7-932a1299c844
 ```
 
-Get information about the Microsoft 365 Group with displayName _Finance_
+Get information about the Microsoft 365 Group with displayName _Finance_.
 
 ```sh
 m365 entra m365group get --displayName Finance
 ```
 
-Get information about the Microsoft 365 Group with id _1caf7dcd-7e83-4c3a-94f7-932a1299c844_ and also retrieve the URL of the corresponding SharePoint site
+Get information about the Microsoft 365 Group with id _1caf7dcd-7e83-4c3a-94f7-932a1299c844_ and also retrieve the URL of the corresponding SharePoint site.
 
 ```sh
-m365 entra m365group get --id 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --includeSiteUrl
+m365 entra m365group get --id 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --withSiteUrl
 ```
 
 ## Response

package/docs/docs/cmd/entra/m365group/m365group-list.mdx

@@ -16,54 +16,56 @@ m365 entra m365group list [options]
 
 ```md definition-list
 `-d, --displayName [displayName]`
-: Retrieve only groups with displayName starting with the specified value
+: Retrieve only groups with displayName starting with the specified value.
 
 `-m, --mailNickname [displayName]`
-: Retrieve only groups with mailNickname starting with the specified value
+: Retrieve only groups with mailNickname starting with the specified value.
 
 `--includeSiteUrl`
-: Set to retrieve the site URL for each group
+: (deprecated. Use option `withSiteUrl` instead) Set to retrieve the site URL for each group.
+
+`--withSiteUrl`
+: Set to retrieve the site URL for each group.
 
 `--orphaned`
-: Set to only retrieve groups without owners
+: Set to only retrieve groups without owners.
 ```
 
 <Global />
 
 ## Remarks
 
-Using the `--includeSiteUrl` option, you can retrieve the URL of the site associated with the particular Microsoft 365 Group. If you however retrieve too many groups and will try to get their site URLs, you will most likely get an error as the command will get throttled, issuing too many requests, too frequently. If you get an error, consider narrowing down the result set using the `--displayName` and `--mailNickname` filters.
+Using the `--withSiteUrl` option, you can retrieve the URL of the site associated with the particular Microsoft 365 Group. If you however retrieve too many groups and will try to get their site URLs, you will most likely get an error as the command will get throttled, issuing too many requests, too frequently. If you get an error, consider narrowing down the result set using the `--displayName` and `--mailNickname` filters.
 
 Using the `--orphaned` option, you can retrieve Microsoft 365 Groups without owners.
 
 ## Examples
 
-List all Microsoft 365 Groups in the tenant
+List all Microsoft 365 Groups in the tenant.
 
 ```sh
 m365 entra m365group list
 ```
 
-List Microsoft 365 Groups with display name starting with _Project_
+List Microsoft 365 Groups with display name starting with _Project_.
 
 ```sh
 m365 entra m365group list --displayName Project
 ```
 
-List Microsoft 365 Groups mail nick name starting with _team_
+List Microsoft 365 Groups mail nick name starting with _team_.
 
 ```sh
 m365 entra m365group list --mailNickname team
 ```
 
-List Microsoft 365 Groups with display name starting with _Project_ including
-the URL of the corresponding SharePoint site
+List Microsoft 365 Groups with display name starting with _Project_ including the URL of the corresponding SharePoint site.
 
 ```sh
-m365 entra m365group list --displayName Project --includeSiteUrl
+m365 entra m365group list --displayName Project --withSiteUrl
 ```
 
-List Microsoft 365 Groups without owners
+List Microsoft 365 Groups without owners.
 
 ```sh
 m365 entra m365group list --orphaned

package/docs/docs/cmd/entra/pim/pim-role-assignment-eligibility-list.mdx

@@ -28,6 +28,9 @@ m365 entra pim role assignment eligibility list [options]
 : Display name of the group for which to list eligible roles. Specify either `userId`, `userName`, `groupId` or `groupName`. If not specified, all eligible roles will be listed.
 
 `--includePrincipalDetails`
+: (deprecated. Use option `withPrincipalDetails` instead) An optional flag to include details of the principals that were eligible for a role.
+
+`--withPrincipalDetails`
 : An optional flag to include details of the principals that were eligible for a role.
 ```
 
@@ -50,7 +53,7 @@ m365 entra pim role assignment eligibility list --userId '@meID'
 Get a list of eligible roles for any user with principal details.
 
 ```sh
-m365 entra pim role assignment eligibility list --includePrincipalDetails
+m365 entra pim role assignment eligibility list --withPrincipalDetails
 ```
 
 ## Response
@@ -121,9 +124,9 @@ m365 entra pim role assignment eligibility list --includePrincipalDetails
   </TabItem>
 </Tabs>
 
-### `includePrincipalDetails` response
+### `withPrincipalDetails` response
 
-When we make use of the option `includePrincipalDetails` the response will differ. 
+When we make use of the option `withPrincipalDetails` the response will differ. 
 
 <Tabs>
   <TabItem value="JSON">
@@ -183,7 +186,7 @@ When we make use of the option `includePrincipalDetails` the response will diffe
   <TabItem value="Markdown">
 
   ```md
-  # entra pim role assignment eligibility list --includePrincipalDetails "true"
+  # entra pim role assignment eligibility list --withPrincipalDetails "true"
 
   Date: 4/8/2024
 

package/docs/docs/cmd/entra/pim/pim-role-assignment-list.mdx

@@ -31,7 +31,10 @@ m365 entra pim role assignment list [options]
 : An optional ISO 8601 formatted date filter to search from.
 
 `--includePrincipalDetails`
-: An optional flag to include details of the principals that were assigned a role
+: (deprecated. Use option `withPrincipalDetails` instead) An optional flag to include details of the principals that were assigned a role.
+
+`--withPrincipalDetails`
+: An optional flag to include details of the principals that were assigned a role.
 ```
 
 <Global />
@@ -50,7 +53,7 @@ Get a list of Entra role assignments for the current user.
 m365 entra pim role assignment list --userId '@meID'
 ```
 
-Get a list of Entra role assignments since the first of January 2024
+Get a list of Entra role assignments since the first of January 2024.
 
 ```sh
 m365 entra pim role assignment list --startDateTime 2024-01-01T00:00:00Z
@@ -59,7 +62,7 @@ m365 entra pim role assignment list --startDateTime 2024-01-01T00:00:00Z
 Get a list of Entra role assignments with principal details.
 
 ```sh
-m365 entra pim role assignment list --includePrincipalDetails
+m365 entra pim role assignment list --withPrincipalDetails
 ```
 
 ## Response
@@ -135,9 +138,9 @@ m365 entra pim role assignment list --includePrincipalDetails
   </TabItem>
 </Tabs>
 
-### `includePrincipalDetails` response
+### `withPrincipalDetails` response
 
-When we make use of the option `includePrincipalDetails` the response will differ. 
+When we make use of the option `withPrincipalDetails` the response will differ. 
 
 <Tabs>
   <TabItem value="JSON">
@@ -201,7 +204,7 @@ When we make use of the option `includePrincipalDetails` the response will diffe
   <TabItem value="Markdown">
 
   ```md
-  # entra pim role assignment list --includePrincipalDetails "true"
+  # entra pim role assignment list --withPrincipalDetails "true"
 
   Date: 3/31/2024
 

package/docs/docs/cmd/entra/pim/pim-role-request-list.mdx

@@ -34,6 +34,9 @@ m365 entra pim role request list [options]
 : An optional value to filter the list of requests. Allowed values are: `Canceled`, `Denied`, `Failed`, `Granted`, `PendingAdminDecision`, `PendingApproval`, `PendingProvisioning`, `PendingScheduleCreation`, `Provisioned`, `Revoked`, and `ScheduleCreated`.
 
 `--includePrincipalDetails`
+: (deprecated. Use option `withPrincipalDetails` instead) An optional flag to include details of the principals that were assigned a role.
+
+`--withPrincipalDetails`
 : An optional flag to include details of the principals that were assigned a role.
 ```
 
@@ -62,7 +65,7 @@ m365 entra pim role request list --createdDateTime 2024-01-01T00:00:00Z
 Get a list of PIM requests with principal details.
 
 ```sh
-m365 entra pim role request list --includePrincipalDetails
+m365 entra pim role request list --withPrincipalDetails
 ```
 
 Get a list of PIM requests with pending approvals.
@@ -158,9 +161,9 @@ m365 entra pim role request list --status PendingApproval
   </TabItem>
 </Tabs>
 
-### `includePrincipalDetails` response
+### `withPrincipalDetails` response
 
-When we make use of the option `includePrincipalDetails` the response will differ. 
+When we make use of the option `withPrincipalDetails` the response will differ. 
 
 <Tabs>
   <TabItem value="JSON">
@@ -238,7 +241,7 @@ When we make use of the option `includePrincipalDetails` the response will diffe
   <TabItem value="Markdown">
 
   ```md
-  # entra pim role request list --includePrincipalDetails "true"
+  # entra pim role request list --withPrincipalDetails "true"
 
   Date: 5/30/2024
 

package/docs/docs/cmd/flow/flow-list.mdx

@@ -22,6 +22,9 @@ m365 flow list [options]
 : List a specific type of flows. Valid values: `ownedByMe`, `personal`, `sharedWithMe`, `all`. Defaults to `ownedByMe`. Don't specify this option when using asAdmin.
 
 `--includeSolutions`
+: (deprecated. Use option `withSolutions` instead) Include flows from solutions.
+
+`--withSolutions`
 : Include flows from solutions.
 
 `--asAdmin`
@@ -49,28 +52,28 @@ When you specify a value for `sharingStatus`, consider the following:
 
 ## Examples
 
-List all your flows in the given environment
+List all your flows in the given environment.
 
 ```sh
 m365 flow list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5
 ```
 
-List all flows in the given environment
+List all flows in the given environment.
 
 ```sh
 m365 flow list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --asAdmin
 ```
 
-List all flows that are shared with the current user
+List all flows that are shared with the current user.
 
 ```sh
 m365 flow list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --sharingStatus sharedWithMe
 ```
 
-List all personal flows and include flows from solutions
+List all personal flows and include flows from solutions.
 
 ```sh
-m365 flow list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --sharingStatus personal --includeSolutions
+m365 flow list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --sharingStatus personal --withSolutions
 ```
 
 ## Response

package/docs/docs/cmd/flow/run/run-get.mdx

@@ -22,7 +22,7 @@ m365 flow run get [options]
 : The name of the Power Automate flow for which to retrieve information.
 
 `-e, --environmentName <environmentName>`
-: The name of the environment where the flow is located
+: The name of the environment where the flow is located.
 
 `--includeTriggerInformation`
 : (deprecated. Use option `withTrigger` instead) If specified, include information about the trigger details.

package/docs/docs/cmd/graph/subscription/subscription-add.mdx

@@ -40,13 +40,16 @@ m365 graph subscription add [options]
 : The latest version of TLS that the notification endpoint supports. Allowed values are `v1_0`, `v1_1`, `v1_2`, `v1_3`. Default is `v1_2`.
 
 `--includeResourceData`
+: (deprecated. Use option `withResourceData` instead) When set, the change notifications will include the changed resource data.
+
+`--withResourceData`
 : When set, the change notifications will include the changed resource data.
 
 `--encryptionCertificate [encryptionCertificate]`
-: A base64-encoded representation of a certificate with a public key used to encrypt resource data in change notifications. Required when using `includeResourceData`.
+: A base64-encoded representation of a certificate with a public key used to encrypt resource data in change notifications. Required when using `withResourceData`.
 
 `--encryptionCertificateId [encryptionCertificateId]`
-: A custom app-provided identifier to help identify the certificate needed to decrypt resource data. Required when using `includeResourceData`.
+: A custom app-provided identifier to help identify the certificate needed to decrypt resource data. Required when using `withResourceData`.
 ```
 
 <Global />
@@ -83,7 +86,7 @@ m365 graph subscription add --resource "me/mailFolders('Inbox')/messages" --chan
 Create a subscription on multiple change types and include resource data
 
 ```sh
-m365 graph subscription add --resource "me/messages" --changeTypes "updated,deleted" --includeResourceData --encryptionCertificate 'Q0xJIGZvciBNaWNyb3NvZnQgMzY1' --encryptionCertificateId 'myCert' --notificationUrl "https://webhook.azurewebsites.net/api/send/myNotifyClient" --expirationDateTime "2016-11-20T18:23:45.935Z" --clientState "secretClientState"
+m365 graph subscription add --resource "me/messages" --changeTypes "updated,deleted" --withResourceData --encryptionCertificate 'Q0xJIGZvciBNaWNyb3NvZnQgMzY1' --encryptionCertificateId 'myCert' --notificationUrl "https://webhook.azurewebsites.net/api/send/myNotifyClient" --expirationDateTime "2016-11-20T18:23:45.935Z" --clientState "secretClientState"
 ```
 
 Create a subscription using the maximum allowed expiration for Group resources

package/docs/docs/cmd/planner/bucket/bucket-add.mdx

@@ -47,6 +47,25 @@ When using `rosterId`, the command is based on an API that is currently in previ
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                           |
+  |-----------------|---------------------------------------|
+  | Microsoft Graph | Tasks.ReadWrite, GroupMember.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                               |
+  |-----------------|-------------------------------------------|
+  | Microsoft Graph | Tasks.ReadWrite.All, GroupMember.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Adds a Microsoft Planner bucket for a plan based on its ID with an order hint

package/docs/docs/cmd/planner/bucket/bucket-get.mdx

@@ -47,6 +47,25 @@ When using `rosterId`, the command is based on an API that is currently in previ
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                      |
+  |-----------------|----------------------------------|
+  | Microsoft Graph | Tasks.Read, GroupMember.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                          |
+  |-----------------|--------------------------------------|
+  | Microsoft Graph | Tasks.Read.All, GroupMember.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Gets the specified Microsoft Planner bucket 

package/docs/docs/cmd/planner/bucket/bucket-list.mdx

@@ -41,6 +41,25 @@ When using `rosterId`, the command is based on an API that is currently in previ
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                      |
+  |-----------------|----------------------------------|
+  | Microsoft Graph | Tasks.Read, GroupMember.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                          |
+  |-----------------|--------------------------------------|
+  | Microsoft Graph | Tasks.Read.All, GroupMember.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Lists the Microsoft Planner buckets based on its plan ID

package/docs/docs/cmd/planner/bucket/bucket-remove.mdx

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # planner bucket remove
 
@@ -48,6 +50,25 @@ When using `rosterId`, the command is based on an API that is currently in previ
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                           |
+  |-----------------|---------------------------------------|
+  | Microsoft Graph | Tasks.ReadWrite, GroupMember.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                               |
+  |-----------------|-------------------------------------------|
+  | Microsoft Graph | Tasks.ReadWrite.All, GroupMember.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Removes the Microsoft Planner bucket by ID

package/docs/docs/cmd/planner/bucket/bucket-set.mdx

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # planner bucket set
 
@@ -51,6 +53,25 @@ When using `rosterId`, the command is based on an API that is currently in previ
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                           |
+  |-----------------|---------------------------------------|
+  | Microsoft Graph | Tasks.ReadWrite, GroupMember.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                               |
+  |-----------------|-------------------------------------------|
+  | Microsoft Graph | Tasks.ReadWrite.All, GroupMember.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Updates the Microsoft Planner bucket by its ID

package/docs/docs/cmd/planner/plan/plan-add.mdx

@@ -42,6 +42,25 @@ m365 planner plan add [options]
 
 - Hint: Unlike for groups, a Planner Roster can contain only 1 plan.
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                           |
+  |-----------------|---------------------------------------|
+  | Microsoft Graph | Tasks.ReadWrite, GroupMember.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                               |
+  |-----------------|-------------------------------------------|
+  | Microsoft Graph | Tasks.ReadWrite.All, GroupMember.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Adds a Microsoft Planner plan with a Group by id.

package/docs/docs/cmd/planner/plan/plan-get.mdx

@@ -41,6 +41,25 @@ When using `rosterId`, the command is based on an API that is currently in previ
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                      |
+  |-----------------|----------------------------------|
+  | Microsoft Graph | Tasks.Read, GroupMember.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                          |
+  |-----------------|--------------------------------------|
+  | Microsoft Graph | Tasks.Read.All, GroupMember.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Returns the Microsoft Planner plan by id.

package/docs/docs/cmd/planner/plan/plan-list.mdx

@@ -35,6 +35,25 @@ When using rosterId, the command is based on an API that is currently in preview
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                      |
+  |-----------------|----------------------------------|
+  | Microsoft Graph | Tasks.Read, GroupMember.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                          |
+  |-----------------|--------------------------------------|
+  | Microsoft Graph | Tasks.Read.All, GroupMember.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Returns a list of Microsoft Planner plans for the specified Group by id.