@pnp/cli-microsoft365 12.0.0-beta.c9bd7f3 → 12.0.0-beta.d654135

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (29) hide show
  1. package/allCommands.json +1 -1
  2. package/allCommandsFull.json +1 -1
  3. package/dist/m365/entra/commands/m365group/m365group-remove.js +2 -8
  4. package/dist/m365/spo/commands/navigation/navigation-node-list.js +6 -4
  5. package/dist/m365/spo/commands/site/site-remove.js +3 -9
  6. package/dist/m365/spo/commands/tenant/tenant-appcatalog-add.js +1 -1
  7. package/dist/m365/spo/commands/web/web-rule-get.js +47 -0
  8. package/dist/m365/spo/commands/web/web-rule-list.js +113 -0
  9. package/dist/m365/spo/commands/web/web-rule-remove.js +54 -0
  10. package/dist/m365/spo/commands.js +3 -0
  11. package/docs/docs/cmd/entra/m365group/m365group-remove.mdx +0 -3
  12. package/docs/docs/cmd/spo/navigation/navigation-node-list.mdx +37 -27
  13. package/docs/docs/cmd/spo/site/site-remove.mdx +0 -3
  14. package/docs/docs/cmd/spo/web/web-rule-get.mdx +108 -0
  15. package/docs/docs/cmd/spo/web/web-rule-list.mdx +189 -0
  16. package/docs/docs/cmd/spo/web/web-rule-remove.mdx +65 -0
  17. package/docs/docs/cmd/tenant/people/people-profilecardproperty-add.mdx +19 -0
  18. package/docs/docs/cmd/tenant/people/people-profilecardproperty-get.mdx +19 -0
  19. package/docs/docs/cmd/tenant/people/people-profilecardproperty-list.mdx +19 -0
  20. package/docs/docs/cmd/tenant/people/people-profilecardproperty-remove.mdx +19 -0
  21. package/docs/docs/cmd/tenant/people/people-profilecardproperty-set.mdx +19 -0
  22. package/docs/docs/cmd/tenant/serviceannouncement/serviceannouncement-health-get.mdx +19 -0
  23. package/docs/docs/cmd/tenant/serviceannouncement/serviceannouncement-health-list.mdx +19 -0
  24. package/docs/docs/cmd/tenant/serviceannouncement/serviceannouncement-healthissue-get.mdx +19 -0
  25. package/docs/docs/cmd/tenant/serviceannouncement/serviceannouncement-healthissue-list.mdx +19 -0
  26. package/docs/docs/cmd/tenant/serviceannouncement/serviceannouncement-message-get.mdx +19 -0
  27. package/docs/docs/cmd/tenant/serviceannouncement/serviceannouncement-message-list.mdx +19 -0
  28. package/npm-shrinkwrap.json +377 -113
  29. package/package.json +4 -4
@@ -0,0 +1,189 @@
1
+ import Global from '../../_global.mdx';
2
+ import Tabs from '@theme/Tabs';
3
+ import TabItem from '@theme/TabItem';
4
+
5
+ # spo web rule list
6
+
7
+ Lists all SharePoint list alerts
8
+
9
+ ## Usage
10
+
11
+ ```sh
12
+ m365 spo web rule list [options]
13
+ ```
14
+
15
+ ## Options
16
+
17
+ ```md definition-list
18
+ `-u, --webUrl <webUrl>`
19
+ : The URL of the SharePoint site.
20
+
21
+ `--listId [listId]`
22
+ : The ID of the SharePoint list. Specify either `listId`, `listUrl`, or `listTitle`, but not more than one.
23
+
24
+ `--listUrl [listUrl]`
25
+ : The URL of the SharePoint list. Specify either `listId`, `listUrl`, or `listTitle`, but not more than one.
26
+
27
+ `--listTitle [listTitle]`
28
+ : The title of the SharePoint list. Specify either `listId`, `listUrl`, or `listTitle`, but not more than one.
29
+
30
+ `--userName [userName]`
31
+ : The user name to filter alerts for. Specify either `userName` or `userId`, but not both.
32
+
33
+ `--userId [userId]`
34
+ : The user ID to filter alerts for. Specify either `userName` or `userId`, but not both.
35
+ ```
36
+
37
+ <Global />
38
+
39
+ ## Permissions
40
+
41
+ <Tabs>
42
+ <TabItem value="Delegated">
43
+
44
+ | Resource | Permissions |
45
+ |-----------------|----------------------|
46
+ | SharePoint | AllSites.FullControl |
47
+ | Microsoft Graph | User.ReadBasic.All |
48
+
49
+ </TabItem>
50
+ <TabItem value="Application">
51
+
52
+ | Resource | Permissions |
53
+ |-----------------|-----------------------|
54
+ | SharePoint | Sites.FullControl.All |
55
+ | Microsoft Graph | User.ReadBasic.All |
56
+
57
+ </TabItem>
58
+ </Tabs>
59
+
60
+ ## Examples
61
+
62
+ List all alerts for a SharePoint site:
63
+
64
+ ```sh
65
+ m365 spo web rule list --webUrl https://contoso.sharepoint.com/sites/Marketing
66
+ ```
67
+
68
+ List alerts for a SharePoint list by listUrl:
69
+
70
+ ```sh
71
+ m365 spo web rule list --webUrl https://contoso.sharepoint.com/sites/Marketing --listUrl /sites/Marketing/lists/Tasks
72
+ ```
73
+
74
+ List alerts for a specific user by userId:
75
+
76
+ ```sh
77
+ m365 spo web rule list --webUrl https://contoso.sharepoint.com/sites/Marketing --userId 7cbb4c8d-8e4d-4d2e-9c6f-3f1d8b2e6a0e
78
+ ```
79
+
80
+ List alerts for a specific list by title and user by username:
81
+
82
+ ```sh
83
+ m365 spo web rule list --webUrl https://contoso.sharepoint.com/sites/Marketing --listTitle "Tasks" --userName jane.doe@contoso.com
84
+ ```
85
+
86
+ ## Response
87
+
88
+ <Tabs>
89
+ <TabItem value="JSON">
90
+
91
+ ```json
92
+ [
93
+ {
94
+ "AlertFrequency": 0,
95
+ "AlertTemplateName": "SPAlertTemplateType.DocumentLibrary",
96
+ "AlertType": 1,
97
+ "AlwaysNotify": false,
98
+ "DeliveryChannels": 1,
99
+ "EventType": -1,
100
+ "Filter": "",
101
+ "ID": "c52b4bf0-add0-4323-b670-f765bb46337b",
102
+ "Properties": [
103
+ {
104
+ "Key": "dispformurl",
105
+ "Value": "Shared Documents/Forms/DispForm.aspx",
106
+ "ValueType": "Edm.String"
107
+ }
108
+ ],
109
+ "Status": 0,
110
+ "Title": "Documents: ProjectPlan.docx",
111
+ "UserId": 9,
112
+ "Item": {
113
+ "Id": 37326,
114
+ "FileRef": "/sites/marketing/Shared Documents/ProjectPlan.docx",
115
+ "GUID": "ef5cc60b-71c0-4357-a291-14274234efde"
116
+ },
117
+ "List": {
118
+ "Id": "6b4f195c-02da-47f4-8237-065b96258cf3",
119
+ "Title": "Documents",
120
+ "RootFolder": {
121
+ "ServerRelativeUrl": "/sites/marketing/Shared Documents"
122
+ }
123
+ },
124
+ "User": {
125
+ "Id": 9,
126
+ "IsHiddenInUI": false,
127
+ "LoginName": "i:0#.f|membership|jane.doe@contoso.onmicrosoft.com",
128
+ "Title": "Jane Doe",
129
+ "PrincipalType": 1,
130
+ "Email": "jane.doe@contoso.onmicrosoft.com",
131
+ "Expiration": "",
132
+ "IsEmailAuthenticationGuestUser": false,
133
+ "IsShareByEmailGuestUser": false,
134
+ "IsSiteAdmin": false,
135
+ "UserId": {
136
+ "NameId": "10037ffeaed549a5",
137
+ "NameIdIssuer": "urn:federation:microsoftonline"
138
+ },
139
+ "UserPrincipalName": "jane.doe@contoso.onmicrosoft.com"
140
+ }
141
+ }
142
+ ]
143
+ ```
144
+
145
+ </TabItem>
146
+ <TabItem value="Text">
147
+
148
+ ```txt
149
+ ID Title UserPrincipalName
150
+ ------------------------------------ --------------------------- --------------------
151
+ fa5115ee-0c72-4d17-9fda-ee2451ba1c6d Documents: ProjectPlan.docx jane.doe@contoso.com
152
+ ```
153
+
154
+ </TabItem>
155
+ <TabItem value="CSV">
156
+
157
+ ```csv
158
+ AlertFrequency,AlertTemplateName,AlertType,AlwaysNotify,DeliveryChannels,EventType,Filter,ID,Status,Title,UserId,UserPrincipalName
159
+ 0,SPAlertTemplateType.DocumentLibrary,1,0,1,-1,,fa5115ee-0c72-4d17-9fda-ee2451ba1c6d,0,Documents: ProjectPlan.docx,6,jane.doe@contoso.com
160
+ ```
161
+
162
+ </TabItem>
163
+ <TabItem value="Markdown">
164
+
165
+ ```md
166
+ # spo web rule list --webUrl "https://contoso.sharepoint.com/sites/marketing" --listUrl "/sites/marketing/Shared Documents"
167
+
168
+ Date: 10/6/2025
169
+
170
+ ## Documents: ProjectPlan.docx (c52b4bf0-add0-4323-b670-f765bb46337b)
171
+
172
+ Property | Value
173
+ ---------|-------
174
+ AlertFrequency | 0
175
+ AlertTemplateName | SPAlertTemplateType.DocumentLibrary
176
+ AlertType | 1
177
+ AlwaysNotify | false
178
+ DeliveryChannels | 1
179
+ EventType | -1
180
+ Filter |
181
+ ID | c52b4bf0-add0-4323-b670-f765bb46337b
182
+ Status | 0
183
+ Title | Documents: ProjectPlan.docx
184
+ UserId | 9
185
+ UserPrincipalName | jane.doe@contoso.com
186
+ ```
187
+
188
+ </TabItem>
189
+ </Tabs>
@@ -0,0 +1,65 @@
1
+ import Global from '../../_global.mdx';
2
+ import Tabs from '@theme/Tabs';
3
+ import TabItem from '@theme/TabItem';
4
+
5
+ # spo web rule remove
6
+
7
+ Removes an alert from a SharePoint list
8
+
9
+ ## Usage
10
+
11
+ ```sh
12
+ m365 spo web rule remove [options]
13
+ ```
14
+
15
+ ## Options
16
+
17
+ ```md definition-list
18
+ `-u, --webUrl <webUrl>`
19
+ : The URL of the SharePoint site.
20
+
21
+ `--id <id>`
22
+ : The ID of the alert.
23
+
24
+ `-f, --force`
25
+ : Don't prompt for confirmation.
26
+ ```
27
+
28
+ <Global />
29
+
30
+ ## Permissions
31
+
32
+ <Tabs>
33
+ <TabItem value="Delegated">
34
+
35
+ | Resource | Permissions |
36
+ |------------|----------------------|
37
+ | SharePoint | AllSites.FullControl |
38
+
39
+ </TabItem>
40
+ <TabItem value="Application">
41
+
42
+ | Resource | Permissions |
43
+ |------------|-----------------------|
44
+ | SharePoint | Sites.FullControl.All |
45
+
46
+ </TabItem>
47
+ </Tabs>
48
+
49
+ ## Examples
50
+
51
+ Remove an alert by ID
52
+
53
+ ```sh
54
+ m365 spo web rule remove --webUrl https://contoso.sharepoint.com/sites/Marketing --id 7cbb4c8d-8e4d-4d2e-9c6f-3f1d8b2e6a0e
55
+ ```
56
+
57
+ Remove another alert without confirmation
58
+
59
+ ```sh
60
+ m365 spo web rule remove --webUrl https://contoso.sharepoint.com/sites/Marketing --id 2b6f1c8a-3e6a-4c7e-b8c0-7bf4c8e6d7f1 --force
61
+ ```
62
+
63
+ ## Response
64
+
65
+ The command won't return a response on success.
@@ -44,6 +44,25 @@ When adding an attribute to a profile card, it takes up to 24 hours for the addi
44
44
 
45
45
  :::
46
46
 
47
+ ## Permissions
48
+
49
+ <Tabs>
50
+ <TabItem value="Delegated">
51
+
52
+ | Resource | Permissions |
53
+ |-----------------|------------------------------|
54
+ | Microsoft Graph | PeopleSettings.ReadWrite.All |
55
+
56
+ </TabItem>
57
+ <TabItem value="Application">
58
+
59
+ | Resource | Permissions |
60
+ |-----------------|------------------------------|
61
+ | Microsoft Graph | PeopleSettings.ReadWrite.All |
62
+
63
+ </TabItem>
64
+ </Tabs>
65
+
47
66
  ## Examples
48
67
 
49
68
  Add the UPN as a profile property to the profile cards properties
@@ -29,6 +29,25 @@ To use this command you must be either **Tenant Administrator** or **Global Admi
29
29
 
30
30
  :::
31
31
 
32
+ ## Permissions
33
+
34
+ <Tabs>
35
+ <TabItem value="Delegated">
36
+
37
+ | Resource | Permissions |
38
+ |-----------------|-------------------------|
39
+ | Microsoft Graph | PeopleSettings.Read.All |
40
+
41
+ </TabItem>
42
+ <TabItem value="Application">
43
+
44
+ | Resource | Permissions |
45
+ |-----------------|-------------------------|
46
+ | Microsoft Graph | PeopleSettings.Read.All |
47
+
48
+ </TabItem>
49
+ </Tabs>
50
+
32
51
  ## Examples
33
52
 
34
53
  Retrieve information about a specific profile card property
@@ -24,6 +24,25 @@ To use this command you must be either **Tenant Administrator** or **Global Admi
24
24
 
25
25
  :::
26
26
 
27
+ ## Permissions
28
+
29
+ <Tabs>
30
+ <TabItem value="Delegated">
31
+
32
+ | Resource | Permissions |
33
+ |-----------------|-------------------------|
34
+ | Microsoft Graph | PeopleSettings.Read.All |
35
+
36
+ </TabItem>
37
+ <TabItem value="Application">
38
+
39
+ | Resource | Permissions |
40
+ |-----------------|-------------------------|
41
+ | Microsoft Graph | PeopleSettings.Read.All |
42
+
43
+ </TabItem>
44
+ </Tabs>
45
+
27
46
  ## Examples
28
47
 
29
48
  Lists all profile card properties
@@ -38,6 +38,25 @@ When removing an attribute from a profile card, it takes up to 24 hours for the
38
38
 
39
39
  :::
40
40
 
41
+ ## Permissions
42
+
43
+ <Tabs>
44
+ <TabItem value="Delegated">
45
+
46
+ | Resource | Permissions |
47
+ |-----------------|------------------------------|
48
+ | Microsoft Graph | PeopleSettings.ReadWrite.All |
49
+
50
+ </TabItem>
51
+ <TabItem value="Application">
52
+
53
+ | Resource | Permissions |
54
+ |-----------------|------------------------------|
55
+ | Microsoft Graph | PeopleSettings.ReadWrite.All |
56
+
57
+ </TabItem>
58
+ </Tabs>
59
+
41
60
  ## Examples
42
61
 
43
62
  Removes the UPN as a profile property from the profile cards
@@ -44,6 +44,25 @@ When updating an attribute to a profile card, it takes up to 24 hours for the ad
44
44
 
45
45
  :::
46
46
 
47
+ ## Permissions
48
+
49
+ <Tabs>
50
+ <TabItem value="Delegated">
51
+
52
+ | Resource | Permissions |
53
+ |-----------------|------------------------------|
54
+ | Microsoft Graph | PeopleSettings.ReadWrite.All |
55
+
56
+ </TabItem>
57
+ <TabItem value="Application">
58
+
59
+ | Resource | Permissions |
60
+ |-----------------|------------------------------|
61
+ | Microsoft Graph | PeopleSettings.ReadWrite.All |
62
+
63
+ </TabItem>
64
+ </Tabs>
65
+
47
66
  ## Examples
48
67
 
49
68
  Updates a custom extension attribute to Cost Center
@@ -24,6 +24,25 @@ m365 tenant serviceannouncement health get [options]
24
24
 
25
25
  <Global />
26
26
 
27
+ ## Permissions
28
+
29
+ <Tabs>
30
+ <TabItem value="Delegated">
31
+
32
+ | Resource | Permissions |
33
+ |-----------------|------------------------|
34
+ | Microsoft Graph | ServiceHealth.Read.All |
35
+
36
+ </TabItem>
37
+ <TabItem value="Application">
38
+
39
+ | Resource | Permissions |
40
+ |-----------------|------------------------|
41
+ | Microsoft Graph | ServiceHealth.Read.All |
42
+
43
+ </TabItem>
44
+ </Tabs>
45
+
27
46
  ## Examples
28
47
 
29
48
  Get the health report for the service _Exchange Online_
@@ -21,6 +21,25 @@ m365 tenant serviceannouncement health list [options]
21
21
 
22
22
  <Global />
23
23
 
24
+ ## Permissions
25
+
26
+ <Tabs>
27
+ <TabItem value="Delegated">
28
+
29
+ | Resource | Permissions |
30
+ |-----------------|------------------------|
31
+ | Microsoft Graph | ServiceHealth.Read.All |
32
+
33
+ </TabItem>
34
+ <TabItem value="Application">
35
+
36
+ | Resource | Permissions |
37
+ |-----------------|------------------------|
38
+ | Microsoft Graph | ServiceHealth.Read.All |
39
+
40
+ </TabItem>
41
+ </Tabs>
42
+
24
43
  ## Examples
25
44
 
26
45
  Get the health report of all subscribed services for a tenant
@@ -21,6 +21,25 @@ m365 tenant serviceannouncement healthissue get [options]
21
21
 
22
22
  <Global />
23
23
 
24
+ ## Permissions
25
+
26
+ <Tabs>
27
+ <TabItem value="Delegated">
28
+
29
+ | Resource | Permissions |
30
+ |-----------------|------------------------|
31
+ | Microsoft Graph | ServiceHealth.Read.All |
32
+
33
+ </TabItem>
34
+ <TabItem value="Application">
35
+
36
+ | Resource | Permissions |
37
+ |-----------------|------------------------|
38
+ | Microsoft Graph | ServiceHealth.Read.All |
39
+
40
+ </TabItem>
41
+ </Tabs>
42
+
24
43
  ## Examples
25
44
 
26
45
  Gets information about issue with ID _MO226784_
@@ -21,6 +21,25 @@ m365 tenant serviceannouncement healthissue list [options]
21
21
 
22
22
  <Global />
23
23
 
24
+ ## Permissions
25
+
26
+ <Tabs>
27
+ <TabItem value="Delegated">
28
+
29
+ | Resource | Permissions |
30
+ |-----------------|------------------------|
31
+ | Microsoft Graph | ServiceHealth.Read.All |
32
+
33
+ </TabItem>
34
+ <TabItem value="Application">
35
+
36
+ | Resource | Permissions |
37
+ |-----------------|------------------------|
38
+ | Microsoft Graph | ServiceHealth.Read.All |
39
+
40
+ </TabItem>
41
+ </Tabs>
42
+
24
43
  ## Examples
25
44
 
26
45
  Get service health issues of all services in Microsoft 365
@@ -21,6 +21,25 @@ m365 tenant serviceannouncement message get [options]
21
21
 
22
22
  <Global />
23
23
 
24
+ ## Permissions
25
+
26
+ <Tabs>
27
+ <TabItem value="Delegated">
28
+
29
+ | Resource | Permissions |
30
+ |-----------------|-------------------------|
31
+ | Microsoft Graph | ServiceMessage.Read.All |
32
+
33
+ </TabItem>
34
+ <TabItem value="Application">
35
+
36
+ | Resource | Permissions |
37
+ |-----------------|-------------------------|
38
+ | Microsoft Graph | ServiceMessage.Read.All |
39
+
40
+ </TabItem>
41
+ </Tabs>
42
+
24
43
  ## Examples
25
44
 
26
45
  Get service update message with ID MC001337
@@ -21,6 +21,25 @@ m365 tenant serviceannouncement message list [options]
21
21
 
22
22
  <Global />
23
23
 
24
+ ## Permissions
25
+
26
+ <Tabs>
27
+ <TabItem value="Delegated">
28
+
29
+ | Resource | Permissions |
30
+ |-----------------|-------------------------|
31
+ | Microsoft Graph | ServiceMessage.Read.All |
32
+
33
+ </TabItem>
34
+ <TabItem value="Application">
35
+
36
+ | Resource | Permissions |
37
+ |-----------------|-------------------------|
38
+ | Microsoft Graph | ServiceMessage.Read.All |
39
+
40
+ </TabItem>
41
+ </Tabs>
42
+
24
43
  ## Examples
25
44
 
26
45
  Get service update messages of all services in Microsoft 365