@pnp/cli-microsoft365 11.1.0-beta.317d8bb → 11.1.0-beta.53bc672

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/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*.

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

@@ -29,6 +29,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.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                |
+  |-----------------|----------------------------|
+  | Microsoft Graph | RecordsManagement.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get a retention event type by id.

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

@@ -24,6 +24,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.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                |
+  |-----------------|----------------------------|
+  | Microsoft Graph | RecordsManagement.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get a list of retention event types.

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

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # purview retentioneventtype remove
 
@@ -30,9 +32,27 @@ 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
 
-Delete a retention event type by id
+Delete a retention event type by id.
 
 ```sh
 m365 purview retentioneventtype remove --id c37d695e-d581-4ae9-82a0-9364eba4291e

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

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # purview retentioneventtype set
 
@@ -30,9 +32,27 @@ 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
 
-Update the description of a retention event type
+Update the description of a retention event type.
 
 ```sh
 m365 purview retentioneventtype set --id c37d695e-d581-4ae9-82a0-9364eba4291e --description 'some extra information'

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

@@ -59,6 +59,17 @@ 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>
+</Tabs>
+
 ## Examples
 
 Create a retention label that retains documents and deletes them after one year.

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

@@ -29,9 +29,20 @@ 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.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
-Get a retention label
+Get a retention label.
 
 ```sh
 m365 purview retentionlabel get --id c37d695e-d581-4ae9-82a0-9364eba4291e

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

@@ -24,9 +24,20 @@ 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.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
-Get a list of retention labels
+Get a list of retention labels.
 
 ```sh
 m365 purview retentionlabel list

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

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # purview retentionlabel remove
 
@@ -30,9 +32,20 @@ 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>
+</Tabs>
+
 ## Examples
 
-Delete a retention label
+Delete a retention label.
 
 ```sh
 m365 purview retentionlabel remove --id 'e554d69c-0992-4f9b-8a66-fca3c4d9c531'

package/docs/docs/cmd/purview/retentionlabel/retentionlabel-set.mdx

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # purview retentionlabel set
 
@@ -51,6 +53,17 @@ 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>
+</Tabs>
+
 ## Examples
 
 Update a retention label so that it retains documents as records and deletes them after one year.

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

@@ -41,6 +41,24 @@ When operating in app-only mode, you have the option to use either the `userName
 
 :::
 
+## Permissions
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                      |
+  |-----------------|----------------------------------|
+  | Microsoft Graph | InformationProtectionPolicy.Read |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                          |
+  |-----------------|--------------------------------------|
+  | Microsoft Graph | InformationProtectionPolicy.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get a sensitivity label.

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

@@ -38,6 +38,24 @@ When operating in app-only mode, you have the option to use either the `userName
 
 :::
 
+## Permissions
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                      |
+  |-----------------|----------------------------------|
+  | Microsoft Graph | InformationProtectionPolicy.Read |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                          |
+  |-----------------|--------------------------------------|
+  | Microsoft Graph | InformationProtectionPolicy.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get a list of sensitivity labels.

package/docs/docs/cmd/purview/sensitivitylabel/sensitivitylabel-policysettings-list.mdx

@@ -38,6 +38,24 @@ When operating in app-only mode, you have the option to use either the `userName
 
 :::
 
+## Permissions
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                      |
+  |-----------------|----------------------------------|
+  | Microsoft Graph | InformationProtectionPolicy.Read |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                          |
+  |-----------------|--------------------------------------|
+  | Microsoft Graph | InformationProtectionPolicy.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get a list of policy settings for a sensitivity label.

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

@@ -33,6 +33,18 @@ m365 purview threatassessment add [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                    |
+  |-----------------|--------------------------------|
+  | Microsoft Graph | ThreatAssessment.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Remarks
 
 :::info

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

@@ -24,6 +24,25 @@ m365 purview threatassessment get [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                    |
+  |-----------------|--------------------------------|
+  | Microsoft Graph | ThreatAssessment.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                    |
+  |-----------------|--------------------------------|
+  | Microsoft Graph | ThreatAssessment.Read.All      |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get a threat assessment.

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

@@ -21,6 +21,25 @@ m365 purview threatassessment list [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                    |
+  |-----------------|--------------------------------|
+  | Microsoft Graph | ThreatAssessment.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                    |
+  |-----------------|--------------------------------|
+  | Microsoft Graph | ThreatAssessment.Read.All      |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get a list of threat assessments