@pnp/cli-microsoft365 11.1.0-beta.d3fc85d → 11.1.0

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

@@ -39,6 +39,24 @@ m365 entra pim role request list [options]
 
 <Global />
 
+## Permissions
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                                |
+  |-----------------|--------------------------------------------|
+  | Microsoft Graph | RoleAssignmentSchedule.ReadWrite.Directory |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                                |
+  |-----------------|--------------------------------------------|
+  | Microsoft Graph | RoleAssignmentSchedule.ReadWrite.Directory |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get a list of PIM requests for roles.

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

@@ -39,6 +39,24 @@ m365 graph directoryextension add [options]
 
 <Global />
 
+## Permissions
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions               |
+  |-----------------|---------------------------|
+  | Microsoft Graph | Application.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                   |
+  |-----------------|-------------------------------|
+  | Microsoft Graph | Application.ReadWrite.OwnedBy |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Create a new directory extension of string type defined for user resource.

package/docs/docs/cmd/graph/directoryextension/directoryextension-get.mdx

@@ -33,6 +33,24 @@ m365 graph directoryextension get [options]
 
 <Global />
 
+## Permissions
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions          |
+  |-----------------|----------------------|
+  | Microsoft Graph | Application.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions          |
+  |-----------------|----------------------|
+  | Microsoft Graph | Application.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get directory extension by id registered for an application specified by app id.

package/docs/docs/cmd/graph/directoryextension/directoryextension-list.mdx

@@ -37,6 +37,24 @@ Otherwise, it will return directory extensions for a specific application.
 
 https://learn.microsoft.com/en-us/graph/api/application-list-extensionproperty?view=graph-rest-1.0&tabs=http
 
+## Permissions
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions          |
+  |-----------------|----------------------|
+  | Microsoft Graph | Application.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions          |
+  |-----------------|----------------------|
+  | Microsoft Graph | Application.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get all available directory extensions including those registered for multi-tenant apps

package/docs/docs/cmd/graph/directoryextension/directoryextension-remove.mdx

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # graph directoryextension remove
 
@@ -34,6 +36,24 @@ m365 graph directoryextension remove [options]
 
 <Global />
 
+## Permissions
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions               |
+  |-----------------|---------------------------|
+  | Microsoft Graph | Application.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                   |
+  |-----------------|-------------------------------|
+  | Microsoft Graph | Application.ReadWrite.OwnedBy |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Remove a directory extension specified by name from an application specified by app object id and don't prompt for confirmation

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

@@ -55,6 +55,24 @@ When using the `--properties` option it's possible to enter a JSON string. In Po
 
 :::
 
+## Permissions
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions               |
+  |-----------------|---------------------------|
+  | Microsoft Graph | Application.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                                        |
+  |-----------------|----------------------------------------------------|
+  | Microsoft Graph | Application.ReadWrite.All, Directory.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Create a schema extension
@@ -136,4 +154,3 @@ m365 graph schemaextension add --id contoso_MySchemaExtension --description "My
 
   </TabItem>
 </Tabs>
-

package/docs/docs/cmd/graph/schemaextension/schemaextension-get.mdx

@@ -26,6 +26,24 @@ m365 graph schemaextension get [options]
 To get properties of a schema extension definition, you have to pass the ID of the schema
 extension.
 
+## Permissions
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions |
+  |-----------------|-------------|
+  | Microsoft Graph | User.Read   |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions          |
+  |-----------------|----------------------|
+  | Microsoft Graph | Application.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Gets properties of a schema extension definition with ID domain_myExtension
@@ -101,4 +119,3 @@ m365 graph schemaextension get --id domain_myExtension
 
   </TabItem>
 </Tabs>
-

package/docs/docs/cmd/graph/schemaextension/schemaextension-list.mdx

@@ -34,6 +34,24 @@ m365 graph schemaextension list [options]
 
 pageNumber is specified as a 0-based index. A value of 2 returns the third page of items. 
 
+## Permissions
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions |
+  |-----------------|-------------|
+  | Microsoft Graph | User.Read   |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions          |
+  |-----------------|----------------------|
+  | Microsoft Graph | Application.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get a list of schemaExtension objects created in the current tenant, that can be InDevelopment, Available, or Deprecated.
@@ -123,4 +141,4 @@ m365 graph schemaextension list --owner 617720dc-85fc-45d7-a187-cee75eaf239e --p
 
 ## More information
 
-[https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/api/schemaextension_list](https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/api/schemaextension_list)
+[https://learn.microsoft.com/graph/api/schemaextension-list](https://learn.microsoft.com/graph/api/schemaextension-list)

package/docs/docs/cmd/graph/schemaextension/schemaextension-remove.mdx

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # graph schemaextension remove
 
@@ -27,6 +29,24 @@ m365 graph schemaextension remove [options]
 To remove specified schema extension definition, you have to pass the ID of the schema
 extension.
 
+## Permissions
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions               |
+  |-----------------|---------------------------|
+  | Microsoft Graph | Application.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                                        |
+  |-----------------|----------------------------------------------------|
+  | Microsoft Graph | Application.ReadWrite.All, Directory.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Removes specified Microsoft Graph schema extension with ID domain_myExtension. Will prompt for confirmation

package/docs/docs/cmd/graph/schemaextension/schemaextension-set.mdx

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # graph schemaextension set
 
@@ -46,21 +48,39 @@ When using the `--properties` option it's possible to enter a JSON string. In Po
 
 :::
 
+## Permissions
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions               |
+  |-----------------|---------------------------|
+  | Microsoft Graph | Application.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                                        |
+  |-----------------|----------------------------------------------------|
+  | Microsoft Graph | Application.ReadWrite.All, Directory.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
- Update the description of a schema extension
+Update the description of a schema extension.
 
 ```sh
 m365 graph schemaextension set --id MySchemaExtension --owner 62375ab9-6b52-47ed-826b-58e47e0e304b --description "My schema extension" 
 ```
 
-Update the target types and properties of a schema extension
+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"}]'
 ```
 
-Change the status of a schema extension to 'Available'
+Change the status of a schema extension to 'Available'.
 
 ```sh
 m365 graph schemaextension set --id contoso_MySchemaExtension --owner 62375ab9-6b52-47ed-826b-58e47e0e304b --status Available

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

@@ -72,39 +72,57 @@ For these subscribers, not setting this property per the timeline would result i
 
 :::
 
+## Permissions
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                                |
+  |-----------------|--------------------------------------------|
+  | Microsoft Graph | AiEnterpriseInteraction.Read, Calendars.Read, Channel.ReadBasic.All, ChannelMessage.Read.All, ChannelSettings.Read.All, Chat.Read, Chat.ReadBasic, Chat.ReadWrite, ChatMember.Read, ChatMember.ReadWrite, Contacts.Read, Files.Read.All, Group.Read.All, Mail.Read, Mail.ReadBasic, OnlineMeetingRecording.Read.All, OnlineMeetingTranscript.Read.All, Presence.Read.All, Schedule.Read.All, Schedule.ReadWrite.All, SecurityEvents.ReadWrite.All, Sites.Read.All, Tasks.ReadWrite, Team.ReadBasic.All, TeamMember.Read.All, TeamSettings.Read.All, User.Read.All, VirtualEvent.Read |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                                |
+  |-----------------|--------------------------------------------|
+  | Microsoft Graph | AiEnterpriseInteraction.Read.All, AiEnterpriseInteraction.Read.User, Calendars.Read, CallRecords.Read.All, Channel.ReadBasic.All, ChannelMessage.Read.All, ChannelMessage.Read.Group, ChannelMember.Read.All, ChannelSettings.Read.All, Chat.Manage.Chat, Chat.Read.All, Chat.Read.WhereInstalled, Chat.ReadBasic.All, Chat.ReadBasic.WhereInstalled, Chat.ReadWrite.All, Chat.ReadWrite.WhereInstalled, ChatMember.Read.All, ChatMember.Read.Chat, ChatMember.Read.WhereInstalled, ChatMember.ReadWrite.All, ChatMember.ReadWrite.WhereInstalled, ChatSettings.Read.Chat, ChatSettings.ReadWrite.Chat, Contacts.Read, Files.Read.All, Group.Read.All, Mail.Read, OnlineMeetingRecording.Read.All, OnlineMeetingTranscript.Read.All, Presence.Read.All, PrintTaskDefinition.ReadWrite.All, Printer.Read.All, Printer.ReadWrite.All, Schedule.Read.All, Schedule.ReadWrite.All, SecurityEvents.ReadWrite.All, Sites.Read.All, Team.ReadBasic.All, TeamMember.Read.All, TeamSettings.Read.All, User.Read.All, VirtualEvent.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
-Create a subscription
+Create a subscription.
 
 ```sh
 m365 graph subscription add --resource "me/mailFolders('Inbox')/messages" --changeTypes "updated" --notificationUrl "https://webhook.azurewebsites.net/api/send/myNotifyClient" --expirationDateTime "2016-11-20T18:23:45.935Z" --clientState "secretClientState"
 ```
 
-Create a subscription on multiple change types and include resource data
+Create a subscription on multiple change types and include resource data.
 
 ```sh
 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
+Create a subscription using the maximum allowed expiration for Group resources.
 
 ```sh
 m365 graph subscription add --resource groups --changeTypes "updated" --notificationUrl "https://webhook.azurewebsites.net/api/send/myNotifyClient" --lifecycleNotificationUrl "https://webhook.azurewebsites.net/api/send/lifecycleNotifications"
 ```
 
-Create a subscription for Event Hub location if you are using Key Vault
+Create a subscription for Event Hub location if you are using Key Vault.
 
 ```sh
 m365 graph subscription add --resource user --changeTypes "created,updated,deleted" --notificationUrl "EventHub:https://azureKeyVaultName.vault.azure.net/secrets/secretName?tenantId=contoso.com"
 ```
 
-Create a subscription for Event Hub location if you are using role-based access control
+Create a subscription for Event Hub location if you are using role-based access control.
 
 ```sh
 m365 graph subscription add --resource user --changeTypes "created,updated,deleted" --notificationUrl "EventHub:https://eventHubNamespace.servicebus.windows.net/eventhubname/eventHubName?tenantId=contoso.com"
 ```
 
-Create a subscription for Event Grid Partner Topic and use TLS 1.3
+Create a subscription for Event Grid Partner Topic and use TLS 1.3.
 
 ```sh
 m365 graph subscription add --resource user --changeTypes "created,updated,deleted" --latestTLSVersion 'v1_3' --notificationUrl "EventGrid:?azuresubscriptionid=8A8A8A8A-4B4B-4C4C-4D4D-12E12E12E12E&resourcegroup=resourceGroupName&partnertopic=partnerTopicName&location=partnerTopicAzureRegionName"
@@ -190,3 +208,6 @@ m365 graph subscription add --resource user --changeTypes "created,updated,delet
   </TabItem>
 </Tabs>
 
+## More information
+
+[https://learn.microsoft.com/en-us/graph/api/subscription-post-subscriptions](https://learn.microsoft.com/en-us/graph/api/subscription-post-subscriptions)

package/docs/docs/cmd/outlook/mail/mail-send.mdx

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # outlook mail send
 
@@ -49,6 +51,25 @@ m365 outlook mail send [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions |
+  |-----------------|-------------|
+  | Microsoft Graph | Mail.Send   |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions |
+  |-----------------|-------------|
+  | Microsoft Graph | Mail.Send   |
+
+  </TabItem>
+</Tabs>
+
 ## Remarks
 
 ### Attachments

package/docs/docs/cmd/outlook/mailbox/mailbox-settings-get.mdx

@@ -24,6 +24,25 @@ m365 outlook mailbox settings get [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions          |
+  |-----------------|----------------------|
+  | Microsoft Graph | MailboxSettings.Read |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions          |
+  |-----------------|----------------------|
+  | Microsoft Graph | MailboxSettings.Read |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get mailbox settings of the signed-in user
@@ -128,4 +147,4 @@ m365 outlook mailbox settings get --userId 1caf7dcd-7e83-4c3a-94f7-932a1299c844
   ```
 
   </TabItem>
-</Tabs>
+</Tabs>

package/docs/docs/cmd/outlook/mailbox/mailbox-settings-set.mdx

@@ -75,6 +75,25 @@ m365 outlook mailbox settings set [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions               |
+  |-----------------|---------------------------|
+  | Microsoft Graph | MailboxSettings.ReadWrite |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions               |
+  |-----------------|---------------------------|
+  | Microsoft Graph | MailboxSettings.ReadWrite |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Update date, time format and time zone of the signed-in user.
@@ -163,4 +182,4 @@ The command returns the updated properties of the user mailbox settings.
   ```
 
   </TabItem>
-</Tabs>
+</Tabs>

package/docs/docs/cmd/outlook/room/room-list.mdx

@@ -21,6 +21,25 @@ m365 outlook room list [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions    |
+  |-----------------|----------------|
+  | Microsoft Graph | Place.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions    |
+  |-----------------|----------------|
+  | Microsoft Graph | Place.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get all the rooms.

package/docs/docs/cmd/outlook/roomlist/roomlist-list.mdx

@@ -16,6 +16,25 @@ m365 outlook roomlist list [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions    |
+  |-----------------|----------------|
+  | Microsoft Graph | Place.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions    |
+  |-----------------|----------------|
+  | Microsoft Graph | Place.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get all roomlists in your tenant.

package/docs/docs/cmd/purview/retentionevent/retentionevent-add.mdx

@@ -47,6 +47,24 @@ This command is based on an API that is currently in preview and is subject to c
 
 :::
 
+## Permissions
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                     |
+  |-----------------|---------------------------------|
+  | Microsoft Graph | RecordsManagement.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                     |
+  |-----------------|---------------------------------|
+  | Microsoft Graph | RecordsManagement.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Create a retention event to start retention at the end of 2022 for all employee documents that have been labeled and have the Asset ID _EmployeeNr1234_.

package/docs/docs/cmd/purview/retentionevent/retentionevent-get.mdx

@@ -21,6 +21,24 @@ m365 purview retentionevent get [options]
 
 <Global />
 
+## Permissions
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                |
+  |-----------------|----------------------------|
+  | Microsoft Graph | RecordsManagement.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                |
+  |-----------------|----------------------------|
+  | Microsoft Graph | RecordsManagement.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get a retention event by id.

package/docs/docs/cmd/purview/retentionevent/retentionevent-list.mdx

@@ -16,6 +16,24 @@ m365 purview retentionevent list [options]
 
 <Global />
 
+## Permissions
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                |
+  |-----------------|----------------------------|
+  | Microsoft Graph | RecordsManagement.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                |
+  |-----------------|----------------------------|
+  | Microsoft Graph | RecordsManagement.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get a list of retention events.

package/docs/docs/cmd/purview/retentionevent/retentionevent-remove.mdx

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # purview retentionevent remove
 
@@ -22,6 +24,24 @@ m365 purview retentionevent remove [options]
 
 <Global />
 
+## Permissions
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                     |
+  |-----------------|---------------------------------|
+  | Microsoft Graph | RecordsManagement.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                     |
+  |-----------------|---------------------------------|
+  | Microsoft Graph | RecordsManagement.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Delete a retention event by id

package/docs/docs/cmd/purview/retentioneventtype/retentioneventtype-add.mdx

@@ -32,6 +32,24 @@ This command is based on a Microsoft Graph API that is currently in preview and
 
 :::
 
+## Permissions
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                     |
+  |-----------------|---------------------------------|
+  | Microsoft Graph | RecordsManagement.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                     |
+  |-----------------|---------------------------------|
+  | Microsoft Graph | RecordsManagement.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Create a retention event type *Contract Expiry*.