@pnp/cli-microsoft365 11.0.0 → 11.1.0-beta.111c36f

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

package/docs/docs/cmd/spo/site/site-alert-list.mdx

@@ -0,0 +1,187 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# spo site alert list
+
+Lists all SharePoint list alerts
+
+## Usage
+
+```sh
+m365 spo site alert list [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: The URL of the SharePoint site.
+
+`--listId [listId]`
+: The ID of the SharePoint list. Specify either `listId`, `listUrl`, or `listTitle`, but not more than one.
+
+`--listUrl [listUrl]`
+: The URL of the SharePoint list. Specify either `listId`, `listUrl`, or `listTitle`, but not more than one.
+
+`--listTitle [listTitle]`
+: The title of the SharePoint list. Specify either `listId`, `listUrl`, or `listTitle`, but not more than one.
+
+`--userName [userName]`
+: The user name to filter alerts for. Specify either `userName` or `userId`, but not both.
+
+`--userId [userId]`
+: The user ID to filter alerts for. Specify either `userName` or `userId`, but not both.
+```
+
+<Global />
+
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions          |
+  |------------|----------------------|
+  | SharePoint | AllSites.FullControl |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions           |
+  |------------|-----------------------|
+  | SharePoint | Sites.FullControl.All |
+
+  </TabItem>
+</Tabs>
+
+## Examples
+
+List all alerts for a SharePoint site:
+
+```sh
+m365 spo site alert list --webUrl https://contoso.sharepoint.com/sites/Marketing
+```
+
+List alerts for a SharePoint list by listUrl:
+
+```sh
+m365 spo site alert list --webUrl https://contoso.sharepoint.com/sites/Marketing --listUrl /sites/Marketing/lists/Tasks
+```
+
+List alerts for a specific user by userId:
+
+```sh
+m365 spo site alert list --webUrl https://contoso.sharepoint.com/sites/Marketing --userId 7cbb4c8d-8e4d-4d2e-9c6f-3f1d8b2e6a0e
+```
+
+List alerts for a specific list by title and user by username:
+
+```sh
+m365 spo site alert list --webUrl https://contoso.sharepoint.com/sites/Marketing --listTitle "Tasks" --userName jane.doe@contoso.com
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "AlertFrequency": 0,
+      "AlertTemplateName": "SPAlertTemplateType.DocumentLibrary",
+      "AlertType": 1,
+      "AlwaysNotify": false,
+      "DeliveryChannels": 1,
+      "EventType": -1,
+      "Filter": "",
+      "ID": "c52b4bf0-add0-4323-b670-f765bb46337b",
+      "Properties": [
+        {
+          "Key": "dispformurl",
+          "Value": "Shared Documents/Forms/DispForm.aspx",
+          "ValueType": "Edm.String"
+        }
+      ],
+      "Status": 0,
+      "Title": "Documents: ProjectPlan.docx",
+      "UserId": 9,
+      "Item": {
+        "Id": 37326,
+        "FileRef": "/sites/marketing/Shared Documents/ProjectPlan.docx",
+        "GUID": "ef5cc60b-71c0-4357-a291-14274234efde"
+      },
+      "List": {
+        "Id": "6b4f195c-02da-47f4-8237-065b96258cf3",
+        "Title": "Documents",
+        "RootFolder": {
+          "ServerRelativeUrl": "/sites/marketing/Shared Documents"
+        }
+      },
+      "User": {
+        "Id": 9,
+        "IsHiddenInUI": false,
+        "LoginName": "i:0#.f|membership|jane.doe@contoso.onmicrosoft.com",
+        "Title": "Jane Doe",
+        "PrincipalType": 1,
+        "Email": "jane.doe@contoso.onmicrosoft.com",
+        "Expiration": "",
+        "IsEmailAuthenticationGuestUser": false,
+        "IsShareByEmailGuestUser": false,
+        "IsSiteAdmin": false,
+        "UserId": {
+          "NameId": "10037ffeaed549a5",
+          "NameIdIssuer": "urn:federation:microsoftonline"
+        },
+        "UserPrincipalName": "jane.doe@contoso.onmicrosoft.com"
+      }
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```txt
+  ID                                    Title                        UserPrincipalName
+  ------------------------------------  ---------------------------  --------------------
+  fa5115ee-0c72-4d17-9fda-ee2451ba1c6d  Documents: ProjectPlan.docx  jane.doe@contoso.com
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  AlertFrequency,AlertTemplateName,AlertType,AlwaysNotify,DeliveryChannels,EventType,Filter,ID,Status,Title,UserId,UserPrincipalName
+  0,SPAlertTemplateType.DocumentLibrary,1,0,1,-1,,fa5115ee-0c72-4d17-9fda-ee2451ba1c6d,0,Documents: ProjectPlan.docx,6,jane.doe@contoso.com
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # spo site alert list --webUrl "https://contoso.sharepoint.com/sites/marketing" --listUrl "/sites/marketing/Shared Documents"
+
+  Date: 10/6/2025
+
+  ## Documents: ProjectPlan.docx (c52b4bf0-add0-4323-b670-f765bb46337b)
+
+  Property | Value
+  ---------|-------
+  AlertFrequency | 0
+  AlertTemplateName | SPAlertTemplateType.DocumentLibrary
+  AlertType | 1
+  AlwaysNotify | false
+  DeliveryChannels | 1
+  EventType | -1
+  Filter |
+  ID | c52b4bf0-add0-4323-b670-f765bb46337b
+  Status | 0
+  Title | Documents: ProjectPlan.docx
+  UserId | 9
+  UserPrincipalName | jane.doe@contoso.com
+  ```
+
+  </TabItem>
+</Tabs>

package/docs/docs/cmd/spo/site/site-alert-remove.mdx

@@ -0,0 +1,65 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# spo site alert remove
+
+Removes an alert from a SharePoint list
+
+## Usage
+
+```sh
+m365 spo site alert remove [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: The URL of the SharePoint site.
+
+`--id <id>`
+: The ID of the alert.
+
+`-f, --force`
+: Don't prompt for confirmation.
+```
+
+<Global />
+
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions          |
+  |------------|----------------------|
+  | SharePoint | AllSites.FullControl |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions           |
+  |------------|-----------------------|
+  | SharePoint | Sites.FullControl.All |
+
+  </TabItem>
+</Tabs>
+
+## Examples
+
+Remove an alert by ID
+
+```sh
+m365 spo site alert remove --webUrl https://contoso.sharepoint.com/sites/Marketing --id 7cbb4c8d-8e4d-4d2e-9c6f-3f1d8b2e6a0e
+```
+
+Remove another alert without confirmation
+
+```sh
+m365 spo site alert remove --webUrl https://contoso.sharepoint.com/sites/Marketing --id 2b6f1c8a-3e6a-4c7e-b8c0-7bf4c8e6d7f1 --force
+```
+
+## Response
+
+The command won't return a response on success.

package/eslint-rules/lib/rules/correct-command-class-name.js

@@ -42,7 +42,7 @@ function capitalizeWord(word, capitalized) {
   return word.substr(0, 1).toUpperCase() + word.substr(1).toLowerCase();
 }
 
-function breakWords(longWord, dictionary) { 
+function breakWords(longWord, dictionary) {
   const words = [];
   for (let i = 0; i < dictionary.length; i++) {
     if (longWord.indexOf(dictionary[i]) === 0) {
@@ -72,7 +72,23 @@ module.exports = {
     fixable: 'code',
     messages: {
       invalidName: "'{{ actualClassName }}' is not a valid command class name. Expected '{{ expectedClassName }}'"
-    }
+    },
+    schema: [
+      {
+        type: 'array',
+        items: { type: 'string' },
+        uniqueItems: true,
+        title: 'dictionary',
+        description: 'List of known word parts used to break long command names into words.'
+      },
+      {
+        type: 'array',
+        items: { type: 'string' },
+        uniqueItems: true,
+        title: 'capitalized',
+        description: 'List of known word parts that should be capitalized.'
+      }
+    ]
   },
   create: context => {
     return {