@pnp/cli-microsoft365 10.0.0-beta.04ac437 → 10.0.0-beta.58f28f9

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 (49) hide show
  1. package/allCommands.json +1 -1
  2. package/allCommandsFull.json +1 -1
  3. package/dist/Auth.js +3 -3
  4. package/dist/AuthServer.js +7 -7
  5. package/dist/api.js +1 -1
  6. package/dist/config.js +1 -0
  7. package/dist/m365/cli/commands/cli-doctor.js +2 -2
  8. package/dist/m365/cli/commands.js +1 -2
  9. package/dist/m365/entra/commands/m365group/m365group-set.js +24 -16
  10. package/dist/m365/entra/commands/m365group/m365group-user-add.js +5 -12
  11. package/dist/m365/entra/commands/oauth2grant/oauth2grant-list.js +3 -12
  12. package/dist/m365/external/commands/item/item-add.js +2 -5
  13. package/dist/m365/flow/commands/environment/environment-list.js +1 -1
  14. package/dist/m365/pa/commands/app/app-list.js +1 -6
  15. package/dist/m365/pa/commands/connector/connector-list.js +1 -6
  16. package/dist/m365/pa/commands/environment/environment-list.js +1 -1
  17. package/dist/m365/pp/commands/environment/environment-list.js +1 -1
  18. package/dist/m365/spo/commands/app/app-instance-list.js +3 -18
  19. package/dist/m365/spo/commands/app/app-list.js +1 -8
  20. package/dist/m365/spo/commands/feature/feature-list.js +1 -8
  21. package/dist/m365/spo/commands/list/list-webhook-list.js +1 -6
  22. package/dist/m365/spo/commands/listitem/listitem-attachment-list.js +1 -8
  23. package/dist/m365/spo/commands/page/page-list.js +1 -1
  24. package/dist/m365/spo/commands/page/page-template-list.js +1 -3
  25. package/dist/m365/spo/commands/site/site-admin-list.js +8 -9
  26. package/dist/m365/spo/commands/site/site-admin-remove.js +5 -4
  27. package/dist/m365/spo/commands/sitescript/sitescript-list.js +1 -3
  28. package/dist/m365/spo/commands/{site/site-rename.js → tenant/tenant-site-rename.js} +29 -32
  29. package/dist/m365/spo/commands/theme/theme-list.js +1 -1
  30. package/dist/m365/spo/commands/web/web-clientsidewebpart-list.js +1 -6
  31. package/dist/m365/spo/commands.js +1 -1
  32. package/dist/m365/teams/commands/tab/tab-list.js +5 -3
  33. package/dist/m365/viva/commands/engage/Community.js +2 -0
  34. package/dist/m365/viva/commands/engage/engage-community-list.js +28 -0
  35. package/dist/m365/viva/commands.js +1 -0
  36. package/dist/request.js +46 -61
  37. package/dist/utils/spo.js +5 -7
  38. package/dist/utils/timersUtil.js +12 -0
  39. package/docs/docs/cmd/cli/cli-doctor.mdx +24 -23
  40. package/docs/docs/cmd/entra/m365group/m365group-set.mdx +9 -6
  41. package/docs/docs/cmd/entra/m365group/m365group-user-add.mdx +0 -3
  42. package/docs/docs/cmd/external/item/item-add.mdx +3 -3
  43. package/docs/docs/cmd/spo/site/site-admin-list.mdx +64 -12
  44. package/docs/docs/cmd/spo/{site/site-rename.mdx → tenant/tenant-site-rename.mdx} +7 -7
  45. package/docs/docs/cmd/teams/tab/tab-list.mdx +1 -2
  46. package/docs/docs/cmd/viva/engage/engage-community-list.mdx +81 -0
  47. package/package.json +1 -1
  48. package/dist/m365/cli/commands/cli-reconsent.js +0 -29
  49. package/docs/docs/cmd/cli/cli-reconsent.mdx +0 -62
@@ -28,12 +28,10 @@ m365 spo site admin list [options]
28
28
 
29
29
  :::info
30
30
 
31
- To use this command with the `--asAdmin` mode, you must have permission to access the tenant admin site.
31
+ To use this command with the `--asAdmin` mode, you must be at least SharePoint administrator.
32
32
 
33
33
  Without this parameter, you must have site collection admin permissions for the requested site.
34
34
 
35
- In `--asAdmin` mode, the Id, PrincipalType, and PrincipalTypeString properties are not exported.
36
-
37
35
  :::
38
36
 
39
37
  ## Examples
@@ -52,6 +50,8 @@ m365 spo site admin list --siteUrl https://contoso.sharepoint.com --asAdmin
52
50
 
53
51
  ## Response
54
52
 
53
+ ### Standard response
54
+
55
55
  <Tabs>
56
56
  <TabItem value="JSON">
57
57
 
@@ -73,13 +73,9 @@ m365 spo site admin list --siteUrl https://contoso.sharepoint.com --asAdmin
73
73
  <TabItem value="Text">
74
74
 
75
75
  ```text
76
- Email : user@contoso.com
77
- Id : 6
78
- LoginName : i:0#.f|membership|user@contoso.com
79
- PrincipalType : 1
80
- PrincipalTypeString : User
81
- Title : User Example
82
- IsPrimaryAdmin : true
76
+ Id LoginName Title PrincipalTypeString
77
+ -- --------------------------------------------------------------------------- ------- -------------------
78
+ 15 c:0o.c|federateddirectoryclaimprovider|d8430798-5a00-00ba-83b0-dd7a032d549a Members SecurityGroup
83
79
  ```
84
80
 
85
81
  </TabItem>
@@ -98,7 +94,7 @@ m365 spo site admin list --siteUrl https://contoso.sharepoint.com --asAdmin
98
94
 
99
95
  Date: 20/03/2024
100
96
 
101
- ## User
97
+ ## User Example
102
98
 
103
99
  Property | Value
104
100
  ---------|-------
@@ -112,4 +108,60 @@ m365 spo site admin list --siteUrl https://contoso.sharepoint.com --asAdmin
112
108
  ```
113
109
 
114
110
  </TabItem>
115
- </Tabs>
111
+ </Tabs>
112
+
113
+ ### `asAdmin` response
114
+
115
+ When we make use of the option `asAdmin` the response will differ.
116
+
117
+ <Tabs>
118
+ <TabItem value="JSON">
119
+
120
+ ```json
121
+ [
122
+ {
123
+ "Email": "user@contoso.com",
124
+ "LoginName": "i:0#.f|membership|user@contoso.com",
125
+ "Title": "User Example",
126
+ "IsPrimaryAdmin": true
127
+ }
128
+ ]
129
+ ```
130
+
131
+ </TabItem>
132
+ <TabItem value="Text">
133
+
134
+ ```text
135
+ LoginName Title
136
+ --------------------------------------------------------------------------- ---------------
137
+ c:0o.c|federateddirectoryclaimprovider|d8430798-5a00-00ba-83b0-dd7a032d549a Members
138
+ ```
139
+
140
+ </TabItem>
141
+ <TabItem value="CSV">
142
+
143
+ ```csv
144
+ Email,LoginName,Title,IsPrimaryAdmin
145
+ user@contoso.com,i:0#.f|membership|user@contoso.com,User Example,1
146
+ ```
147
+
148
+ </TabItem>
149
+ <TabItem value="Markdown">
150
+
151
+ ```md
152
+ # spo site admin list --siteUrl "https://contoso.sharepoint.com/sites/Test" --asAdmin
153
+
154
+ Date: 20/03/2024
155
+
156
+ ## User Example
157
+
158
+ Property | Value
159
+ ---------|-------
160
+ Email | user@contoso.com
161
+ LoginName | i:0#.f\|membership\|user@contoso.com
162
+ Title | User Example
163
+ IsPrimaryAdmin | true
164
+ ```
165
+
166
+ </TabItem>
167
+ </Tabs>
@@ -2,14 +2,14 @@ import Global from '/docs/cmd/_global.mdx';
2
2
  import Tabs from '@theme/Tabs';
3
3
  import TabItem from '@theme/TabItem';
4
4
 
5
- # spo site rename
5
+ # spo tenant site rename
6
6
 
7
7
  Renames the URL and title of a site collection
8
8
 
9
9
  ## Usage
10
10
 
11
11
  ```sh
12
- m365 spo site rename [options]
12
+ m365 spo tenant site rename [options]
13
13
  ```
14
14
 
15
15
  ## Options
@@ -38,7 +38,7 @@ m365 spo site rename [options]
38
38
 
39
39
  ## Remarks
40
40
 
41
- Renaming site collections is by default asynchronous and depending on the current state of Microsoft 365, might take up to few minutes. If you're building a script with steps that require the operation to complete fully, you should use the `--wait` flag. When using this flag, the `spo site rename` command will keep running until it receives confirmation from Microsoft 365 that the site rename operation has completed.
41
+ Renaming site collections is by default asynchronous and depending on the current state of Microsoft 365, might take up to few minutes. If you're building a script with steps that require the operation to complete fully, you should use the `--wait` flag. When using this flag, the `spo tenant site rename` command will keep running until it receives confirmation from Microsoft 365 that the site rename operation has completed.
42
42
 
43
43
  :::info
44
44
 
@@ -51,19 +51,19 @@ To use this command you must have permissions to access the tenant admin site.
51
51
  Starts the rename of the site collection with name "samplesite" to "renamed" without modifying the title
52
52
 
53
53
  ```sh
54
- m365 spo site rename --url http://contoso.sharepoint.com/samplesite --newUrl http://contoso.sharepoint.com/renamed
54
+ m365 spo tenant site rename --url http://contoso.sharepoint.com/samplesite --newUrl http://contoso.sharepoint.com/renamed
55
55
  ```
56
56
 
57
57
  Starts the rename of the site collection with name "samplesite" to "renamed" modifying the title of the site to "New Title"
58
58
 
59
59
  ```sh
60
- m365 spo site rename --url http://contoso.sharepoint.com/samplesite --newUrl http://contoso.sharepoint.com/renamed --newTitle "New Title"
60
+ m365 spo tenant site rename --url http://contoso.sharepoint.com/samplesite --newUrl http://contoso.sharepoint.com/renamed --newTitle "New Title"
61
61
  ```
62
62
 
63
63
  Renames the specified site collection and waits for the operation to complete
64
64
 
65
65
  ```sh
66
- m365 spo site rename --url http://contoso.sharepoint.com/samplesite --newUrl http://contoso.sharepoint.com/renamed --newTitle "New Title" --wait
66
+ m365 spo tenant site rename --url http://contoso.sharepoint.com/samplesite --newUrl http://contoso.sharepoint.com/renamed --newTitle "New Title" --wait
67
67
  ```
68
68
 
69
69
  ## Response
@@ -130,7 +130,7 @@ m365 spo site rename --url http://contoso.sharepoint.com/samplesite --newUrl htt
130
130
  <TabItem value="Markdown">
131
131
 
132
132
  ```md
133
- # spo site rename --url "https://contoso.sharepoint.com/sites/team1" --newUrl "https://contoso.sharepoint.com/sites/team2"
133
+ # spo tenant site rename --url "https://contoso.sharepoint.com/sites/team1" --newUrl "https://contoso.sharepoint.com/sites/team2"
134
134
 
135
135
  Date: 2023-06-21
136
136
 
@@ -67,8 +67,7 @@ m365 teams tab list --teamId 00000000-0000-0000-0000-000000000000 --channelId 19
67
67
  "externalId": null,
68
68
  "displayName": "My Contoso Tab",
69
69
  "distributionMethod": "store"
70
- },
71
- "teamsAppTabId": "1542629c-01b3-4a6d-8f76-1938b779e48d"
70
+ }
72
71
  }
73
72
  ]
74
73
  ```
@@ -0,0 +1,81 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+ import Tabs from '@theme/Tabs';
3
+ import TabItem from '@theme/TabItem';
4
+
5
+ # viva engage community list
6
+
7
+ Lists all Viva Engage communities
8
+
9
+ ## Usage
10
+
11
+ ```sh
12
+ m365 viva engage community list [options]
13
+ ```
14
+
15
+ ## Options
16
+
17
+ <Global />
18
+
19
+ ## Examples
20
+
21
+ Lists all Viva Engage communities
22
+
23
+ ```sh
24
+ m365 viva engage community list
25
+ ```
26
+
27
+ ## Response
28
+
29
+ <Tabs>
30
+ <TabItem value="JSON">
31
+
32
+ ```json
33
+ [
34
+ {
35
+ "id": "eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiI0NzY5MTM1ODIwOSJ9",
36
+ "displayName": "All Company",
37
+ "description": "This is the default group for everyone in the network",
38
+ "privacy": "public",
39
+ "groupId": "7c99afd7-9f3a-49e2-b105-4ee36314350c"
40
+ }
41
+ ]
42
+ ```
43
+
44
+ </TabItem>
45
+ <TabItem value="Text">
46
+
47
+ ```text
48
+ id displayName privacy
49
+ ------------------------------------------------ ----------- -------
50
+ eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiI0NzY5MTM1ODIwOSJ9 All Company public
51
+ ```
52
+
53
+ </TabItem>
54
+ <TabItem value="CSV">
55
+
56
+ ```csv
57
+ id,displayName,description,privacy,groupId
58
+ eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiI0NzY5MTM1ODIwOSJ9,All Company,This is the default group for everyone in the network,public,7c99afd7-9f3a-49e2-b105-4ee36314350c
59
+ ```
60
+
61
+ </TabItem>
62
+ <TabItem value="Markdown">
63
+
64
+ ```md
65
+ # viva engage community list
66
+
67
+ Date: 8/29/2024
68
+
69
+ ## All Company (eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiI0NzY5MTM1ODIwOSJ9)
70
+
71
+ Property | Value
72
+ ---------|-------
73
+ id | eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiI0NzY5MTM1ODIwOSJ9
74
+ displayName | All Company
75
+ description | This is the default group for everyone in the network
76
+ privacy | public
77
+ groupId | 7c99afd7-9f3a-49e2-b105-4ee36314350c
78
+ ```
79
+
80
+ </TabItem>
81
+ </Tabs>
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@pnp/cli-microsoft365",
3
- "version": "10.0.0-beta.04ac437",
3
+ "version": "10.0.0-beta.58f28f9",
4
4
  "description": "Manage Microsoft 365 and SharePoint Framework projects on any platform",
5
5
  "license": "MIT",
6
6
  "main": "./dist/api.js",
@@ -1,29 +0,0 @@
1
- import { cli } from '../../../cli/cli.js';
2
- import { settingsNames } from '../../../settingsNames.js';
3
- import { browserUtil } from '../../../utils/browserUtil.js';
4
- import AnonymousCommand from '../../base/AnonymousCommand.js';
5
- import commands from '../commands.js';
6
- class CliReconsentCommand extends AnonymousCommand {
7
- get name() {
8
- return commands.RECONSENT;
9
- }
10
- get description() {
11
- return 'Returns URL to open in the browser to re-consent CLI for Microsoft 365 Microsoft Entra permissions';
12
- }
13
- async commandAction(logger) {
14
- const url = `https://login.microsoftonline.com/${cli.getTenant()}/oauth2/authorize?client_id=${cli.getClientId()}&response_type=code&prompt=admin_consent`;
15
- if (cli.getSettingWithDefaultValue(settingsNames.autoOpenLinksInBrowser, false) === false) {
16
- await logger.log(`To re-consent your Microsoft Entra application, navigate in your web browser to ${url}.`);
17
- return;
18
- }
19
- await logger.log(`Opening the following page in your browser: ${url}`);
20
- try {
21
- await browserUtil.open(url);
22
- }
23
- catch (err) {
24
- this.handleRejectedODataJsonPromise(err);
25
- }
26
- }
27
- }
28
- export default new CliReconsentCommand();
29
- //# sourceMappingURL=cli-reconsent.js.map
@@ -1,62 +0,0 @@
1
- import Global from '/docs/cmd/_global.mdx';
2
- import Tabs from '@theme/Tabs';
3
- import TabItem from '@theme/TabItem';
4
-
5
- # cli reconsent
6
-
7
- Returns URL to open in the browser to re-consent CLI for Microsoft 365 Microsoft Entra permissions
8
-
9
- ## Usage
10
-
11
- ```sh
12
- m365 cli reconsent [options]
13
- ```
14
-
15
- ## Options
16
-
17
- <Global />
18
-
19
- ## Examples
20
-
21
- Get the URL to open in the browser to re-consent CLI for Microsoft 365 permissions
22
-
23
- ```sh
24
- m365 cli reconsent
25
- ```
26
-
27
- ## Response
28
-
29
- <Tabs>
30
- <TabItem value="JSON">
31
-
32
- ```json
33
- "To re-consent the PnP Microsoft 365 Management Shell Microsoft Entra application navigate in your web browser to https://login.microsoftonline.com/common/oauth2/authorize?client_id=31359c7f-bd7e-475c-86db-fdb8c937548e&response_type=code&prompt=admin_consent"
34
- ```
35
-
36
- </TabItem>
37
- <TabItem value="Text">
38
-
39
- ```text
40
- To re-consent the PnP Microsoft 365 Management Shell Microsoft Entra application navigate in your web browser to https://login.microsoftonline.com/common/oauth2/authorize?client_id=31359c7f-bd7e-475c-86db-fdb8c937548e&response_type=code&prompt=admin_consent
41
- ```
42
-
43
- </TabItem>
44
- <TabItem value="CSV">
45
-
46
- ```csv
47
- To re-consent the PnP Microsoft 365 Management Shell Microsoft Entra application navigate in your web browser to https://login.microsoftonline.com/common/oauth2/authorize?client_id=31359c7f-bd7e-475c-86db-fdb8c937548e&response_type=code&prompt=admin_consent
48
- ```
49
-
50
- </TabItem>
51
- <TabItem value="Markdown">
52
-
53
- ```md
54
- To re-consent the PnP Microsoft 365 Management Shell Microsoft Entra application navigate in your web browser to https://login.microsoftonline.com/common/oauth2/authorize?client_id=31359c7f-bd7e-475c-86db-fdb8c937548e&response_type=code&prompt=admin_consent
55
- ```
56
-
57
- </TabItem>
58
- </Tabs>
59
-
60
- ## More information
61
-
62
- - Re-consent the PnP Microsoft 365 Management Shell Microsoft Entra application: [https://pnp.github.io/cli-microsoft365/user-guide/connecting-microsoft-365/#re-consent-the-pnp-microsoft-365-management-shell-azure-ad-application](https://pnp.github.io/cli-microsoft365/user-guide/connecting-microsoft-365/#re-consent-the-pnp-microsoft-365-management-shell-azure-ad-application)