@pnp/cli-microsoft365 5.2.0-beta.dc50ce6 → 5.3.0-beta.99da27d

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 (30) hide show
  1. package/.eslintrc.js +1 -0
  2. package/dist/m365/planner/commands/bucket/bucket-remove.js +214 -0
  3. package/dist/m365/planner/commands/bucket/bucket-set.js +208 -0
  4. package/dist/m365/planner/commands/task/task-get.js +150 -7
  5. package/dist/m365/planner/commands.js +2 -0
  6. package/dist/m365/spfx/commands/project/project-upgrade/{upgrade-1.15.0-beta.1.js → upgrade-1.15.0-beta.6.js} +27 -27
  7. package/dist/m365/spfx/commands/project/project-upgrade.js +1 -1
  8. package/dist/m365/spfx/commands/spfx-doctor.js +1 -105
  9. package/dist/m365/spo/commands/field/field-list.js +84 -0
  10. package/dist/m365/spo/commands/list/list-roleinheritance-break.js +84 -0
  11. package/dist/m365/spo/commands/list/list-roleinheritance-reset.js +76 -0
  12. package/dist/m365/spo/commands.js +3 -0
  13. package/dist/m365/teams/commands/channel/channel-member-remove.js +214 -0
  14. package/dist/m365/teams/commands.js +2 -0
  15. package/dist/m365/tenant/commands/security/security-alerts-list.js +71 -0
  16. package/dist/m365/tenant/commands.js +1 -0
  17. package/docs/docs/cmd/planner/bucket/bucket-remove.md +60 -0
  18. package/docs/docs/cmd/planner/bucket/bucket-set.md +57 -0
  19. package/docs/docs/cmd/planner/task/task-get.md +30 -3
  20. package/docs/docs/cmd/planner/task/task-set.md +2 -2
  21. package/docs/docs/cmd/spfx/project/project-upgrade.md +1 -1
  22. package/docs/docs/cmd/spfx/spfx-doctor.md +1 -1
  23. package/docs/docs/cmd/spo/field/field-list.md +51 -0
  24. package/docs/docs/cmd/spo/list/list-roleinheritance-break.md +55 -0
  25. package/docs/docs/cmd/spo/list/list-roleinheritance-reset.md +36 -0
  26. package/docs/docs/cmd/spo/listitem/listitem-list.md +2 -2
  27. package/docs/docs/cmd/teams/channel/channel-member-remove.md +57 -0
  28. package/docs/docs/cmd/tenant/security/security-alerts-list.md +30 -0
  29. package/npm-shrinkwrap.json +1517 -1284
  30. package/package.json +26 -24
@@ -0,0 +1,214 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ const cli_1 = require("../../../../cli");
4
+ const request_1 = require("../../../../request");
5
+ const utils_1 = require("../../../../utils");
6
+ const GraphCommand_1 = require("../../../base/GraphCommand");
7
+ const commands_1 = require("../../commands");
8
+ class TeamsChannelMemberRemoveCommand extends GraphCommand_1.default {
9
+ constructor() {
10
+ super(...arguments);
11
+ this.teamId = '';
12
+ this.channelId = '';
13
+ }
14
+ get name() {
15
+ return commands_1.default.CHANNEL_MEMBER_REMOVE;
16
+ }
17
+ get description() {
18
+ return 'Updates the role of the specified member in the specified Microsoft Teams private team channel';
19
+ }
20
+ alias() {
21
+ return [commands_1.default.CONVERSATIONMEMBER_REMOVE];
22
+ }
23
+ optionSets() {
24
+ return [
25
+ ['teamId', 'teamName'],
26
+ ['channelId', 'channelName'],
27
+ ['userId', 'userName', 'id']
28
+ ];
29
+ }
30
+ getTelemetryProperties(args) {
31
+ const telemetryProps = super.getTelemetryProperties(args);
32
+ telemetryProps.teamId = typeof args.options.teamId !== 'undefined';
33
+ telemetryProps.teamName = typeof args.options.teamName !== 'undefined';
34
+ telemetryProps.channelId = typeof args.options.channelId !== 'undefined';
35
+ telemetryProps.channelName = typeof args.options.channelName !== 'undefined';
36
+ telemetryProps.userName = typeof args.options.userName !== 'undefined';
37
+ telemetryProps.userId = typeof args.options.userId !== 'undefined';
38
+ telemetryProps.id = typeof args.options.id !== 'undefined';
39
+ telemetryProps.confirm = (!(!args.options.confirm)).toString();
40
+ return telemetryProps;
41
+ }
42
+ commandAction(logger, args, cb) {
43
+ this.showDeprecationWarning(logger, commands_1.default.CONVERSATIONMEMBER_REMOVE, commands_1.default.CHANNEL_MEMBER_REMOVE);
44
+ const removeMember = () => {
45
+ this
46
+ .removeMemberFromChannel(args)
47
+ .then(cb, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
48
+ };
49
+ if (args.options.confirm) {
50
+ removeMember();
51
+ }
52
+ else {
53
+ const userName = args.options.userName || args.options.userId || args.options.id;
54
+ const teamName = args.options.teamName || args.options.teamId;
55
+ const channelName = args.options.channelName || args.options.channelId;
56
+ cli_1.Cli.prompt({
57
+ type: 'confirm',
58
+ name: 'continue',
59
+ default: false,
60
+ message: `Are you sure you want to remove the member ${userName} from the channel ${channelName} in team ${teamName}?`
61
+ }, (result) => {
62
+ if (!result.continue) {
63
+ cb();
64
+ }
65
+ else {
66
+ removeMember();
67
+ }
68
+ });
69
+ }
70
+ }
71
+ removeMemberFromChannel(args) {
72
+ return this
73
+ .getTeamId(args)
74
+ .then((teamId) => {
75
+ this.teamId = teamId;
76
+ return this.getChannelId(args);
77
+ })
78
+ .then((channelId) => {
79
+ this.channelId = channelId;
80
+ return this.getMemberId(args);
81
+ })
82
+ .then((memberId) => {
83
+ const requestOptions = {
84
+ url: `${this.resource}/v1.0/teams/${this.teamId}/channels/${this.channelId}/members/${memberId}`,
85
+ headers: {
86
+ 'accept': 'application/json;odata.metadata=none'
87
+ },
88
+ responseType: 'json'
89
+ };
90
+ return request_1.default.delete(requestOptions);
91
+ });
92
+ }
93
+ getTeamId(args) {
94
+ if (args.options.teamId) {
95
+ return Promise.resolve(args.options.teamId);
96
+ }
97
+ const requestOptions = {
98
+ url: `${this.resource}/v1.0/groups?$filter=displayName eq '${encodeURIComponent(args.options.teamName)}'`,
99
+ headers: {
100
+ accept: 'application/json;odata.metadata=none'
101
+ },
102
+ responseType: 'json'
103
+ };
104
+ return request_1.default
105
+ .get(requestOptions)
106
+ .then(response => {
107
+ const groupItem = response.value[0];
108
+ if (!groupItem) {
109
+ return Promise.reject(`The specified team does not exist in the Microsoft Teams`);
110
+ }
111
+ if (groupItem.resourceProvisioningOptions.indexOf('Team') === -1) {
112
+ return Promise.reject(`The specified team does not exist in the Microsoft Teams`);
113
+ }
114
+ if (response.value.length > 1) {
115
+ return Promise.reject(`Multiple Microsoft Teams teams with name ${args.options.teamName} found: ${response.value.map(x => x.id)}`);
116
+ }
117
+ return Promise.resolve(groupItem.id);
118
+ });
119
+ }
120
+ getChannelId(args) {
121
+ if (args.options.channelId) {
122
+ return Promise.resolve(args.options.channelId);
123
+ }
124
+ const requestOptions = {
125
+ url: `${this.resource}/v1.0/teams/${encodeURIComponent(this.teamId)}/channels?$filter=displayName eq '${encodeURIComponent(args.options.channelName)}'`,
126
+ headers: {
127
+ accept: 'application/json;odata.metadata=none'
128
+ },
129
+ responseType: 'json'
130
+ };
131
+ return request_1.default
132
+ .get(requestOptions)
133
+ .then(response => {
134
+ const channelItem = response.value[0];
135
+ if (!channelItem) {
136
+ return Promise.reject(`The specified channel does not exist in the Microsoft Teams team`);
137
+ }
138
+ return Promise.resolve(channelItem.id);
139
+ });
140
+ }
141
+ getMemberId(args) {
142
+ if (args.options.id) {
143
+ return Promise.resolve(args.options.id);
144
+ }
145
+ const requestOptions = {
146
+ url: `${this.resource}/v1.0/teams/${this.teamId}/channels/${this.channelId}/members`,
147
+ headers: {
148
+ accept: 'application/json;odata.metadata=none'
149
+ },
150
+ responseType: 'json'
151
+ };
152
+ return request_1.default
153
+ .get(requestOptions)
154
+ .then(response => {
155
+ const conversationMembers = response.value.filter(x => {
156
+ var _a, _b;
157
+ return args.options.userId && ((_a = x.userId) === null || _a === void 0 ? void 0 : _a.toLocaleLowerCase()) === args.options.userId.toLocaleLowerCase() ||
158
+ args.options.userName && ((_b = x.email) === null || _b === void 0 ? void 0 : _b.toLocaleLowerCase()) === args.options.userName.toLocaleLowerCase();
159
+ });
160
+ const conversationMember = conversationMembers[0];
161
+ if (!conversationMember) {
162
+ return Promise.reject(`The specified member does not exist in the Microsoft Teams channel`);
163
+ }
164
+ if (conversationMembers.length > 1) {
165
+ return Promise.reject(`Multiple Microsoft Teams channel members with name ${args.options.userName} found: ${response.value.map(x => x.userId)}`);
166
+ }
167
+ return Promise.resolve(conversationMember.id);
168
+ });
169
+ }
170
+ options() {
171
+ const options = [
172
+ {
173
+ option: '--teamId [teamId]'
174
+ },
175
+ {
176
+ option: '--teamName [teamName]'
177
+ },
178
+ {
179
+ option: '--channelId [channelId]'
180
+ },
181
+ {
182
+ option: '--channelName [channelName]'
183
+ },
184
+ {
185
+ option: '--userName [userName]'
186
+ },
187
+ {
188
+ option: '--userId [userId]'
189
+ },
190
+ {
191
+ option: '--id [id]'
192
+ },
193
+ {
194
+ option: '--confirm'
195
+ }
196
+ ];
197
+ const parentOptions = super.options();
198
+ return options.concat(parentOptions);
199
+ }
200
+ validate(args) {
201
+ if (args.options.teamId && !utils_1.validation.isValidGuid(args.options.teamId)) {
202
+ return `${args.options.teamId} is not a valid GUID`;
203
+ }
204
+ if (args.options.channelId && !utils_1.validation.isValidTeamsChannelId(args.options.channelId)) {
205
+ return `${args.options.channelId} is not a valid Teams Channel ID`;
206
+ }
207
+ if (args.options.userId && !utils_1.validation.isValidGuid(args.options.userId)) {
208
+ return `${args.options.userId} is not a valid GUID`;
209
+ }
210
+ return true;
211
+ }
212
+ }
213
+ module.exports = new TeamsChannelMemberRemoveCommand();
214
+ //# sourceMappingURL=channel-member-remove.js.map
@@ -13,6 +13,7 @@ exports.default = {
13
13
  CHANNEL_LIST: `${prefix} channel list`,
14
14
  CHANNEL_MEMBER_ADD: `${prefix} channel member add`,
15
15
  CHANNEL_MEMBER_LIST: `${prefix} channel member list`,
16
+ CHANNEL_MEMBER_REMOVE: `${prefix} channel member remove`,
16
17
  CHANNEL_MEMBER_SET: `${prefix} channel member set`,
17
18
  CHANNEL_REMOVE: `${prefix} channel remove`,
18
19
  CHANNEL_SET: `${prefix} channel set`,
@@ -23,6 +24,7 @@ exports.default = {
23
24
  CHAT_MESSAGE_SEND: `${prefix} chat message send`,
24
25
  CONVERSATIONMEMBER_ADD: `${prefix} conversationmember add`,
25
26
  CONVERSATIONMEMBER_LIST: `${prefix} conversationmember list`,
27
+ CONVERSATIONMEMBER_REMOVE: `${prefix} conversationmember remove`,
26
28
  FUNSETTINGS_LIST: `${prefix} funsettings list`,
27
29
  FUNSETTINGS_SET: `${prefix} funsettings set`,
28
30
  GUESTSETTINGS_LIST: `${prefix} guestsettings list`,
@@ -0,0 +1,71 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ const GraphCommand_1 = require("../../../base/GraphCommand");
4
+ const request_1 = require("../../../../request");
5
+ const commands_1 = require("../../commands");
6
+ class TenantSecurityAlertsListCommand extends GraphCommand_1.default {
7
+ get name() {
8
+ return commands_1.default.SECURITY_ALERTS_LIST;
9
+ }
10
+ get description() {
11
+ return 'Gets the security alerts for a tenant';
12
+ }
13
+ getTelemetryProperties(args) {
14
+ const telemetryProps = super.getTelemetryProperties(args);
15
+ telemetryProps.vendor = typeof args.options.vendor !== 'undefined';
16
+ return telemetryProps;
17
+ }
18
+ defaultProperties() {
19
+ return ['id', 'title', 'severity'];
20
+ }
21
+ commandAction(logger, args, cb) {
22
+ this
23
+ .listAlert(args.options)
24
+ .then((res) => {
25
+ logger.log(res);
26
+ cb();
27
+ }, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
28
+ }
29
+ listAlert(options) {
30
+ let queryFilter = '';
31
+ if (options.vendor) {
32
+ let vendorName = options.vendor;
33
+ switch (options.vendor.toLowerCase()) {
34
+ case 'azure security center':
35
+ vendorName = 'ASC';
36
+ break;
37
+ case 'microsoft cloud app security':
38
+ vendorName = 'MCAS';
39
+ break;
40
+ case 'azure active directory identity protection':
41
+ vendorName = 'IPC';
42
+ }
43
+ queryFilter = `?$filter=vendorInformation/provider eq '${encodeURIComponent(vendorName)}'`;
44
+ }
45
+ const requestOptions = {
46
+ url: `${this.resource}/v1.0/security/alerts${queryFilter}`,
47
+ headers: {
48
+ accept: 'application/json;odata.metadata=none'
49
+ },
50
+ responseType: 'json'
51
+ };
52
+ return request_1.default
53
+ .get(requestOptions)
54
+ .then(response => {
55
+ const alertList = response.value;
56
+ if (!alertList) {
57
+ return Promise.reject(`Error fetching security alerts`);
58
+ }
59
+ return Promise.resolve(alertList);
60
+ });
61
+ }
62
+ options() {
63
+ const options = [
64
+ { option: '--vendor [vendor]' }
65
+ ];
66
+ const parentOptions = super.options();
67
+ return options.concat(parentOptions);
68
+ }
69
+ }
70
+ module.exports = new TenantSecurityAlertsListCommand();
71
+ //# sourceMappingURL=security-alerts-list.js.map
@@ -9,6 +9,7 @@ exports.default = {
9
9
  REPORT_OFFICE365ACTIVATIONSUSERDETAIL: `${prefix} report office365activationsuserdetail`,
10
10
  REPORT_OFFICE365ACTIVATIONSUSERCOUNTS: `${prefix} report office365activationsusercounts`,
11
11
  REPORT_SERVICESUSERCOUNTS: `${prefix} report servicesusercounts`,
12
+ SECURITY_ALERTS_LIST: `${prefix} security alerts list`,
12
13
  SERVICEANNOUNCEMENT_HEALTHISSUE_GET: `${prefix} serviceannouncement healthissue get`,
13
14
  SERVICEANNOUNCEMENT_HEALTH_GET: `${prefix} serviceannouncement health get`,
14
15
  SERVICEANNOUNCEMENT_HEALTH_LIST: `${prefix} serviceannouncement health list`,
@@ -0,0 +1,60 @@
1
+ # planner bucket remove
2
+
3
+ Removes the Microsoft Planner bucket from a plan
4
+
5
+ ## Usage
6
+
7
+ ```sh
8
+ m365 planner bucket remove [options]
9
+ ```
10
+
11
+ ## Options
12
+
13
+ `--id [id]`
14
+ : ID of the bucket to remove. Specify either `id` or `name` but not both.
15
+
16
+ `--name [name]`
17
+ : Name of the bucket to remove. Specify either `id` or `name` but not both.
18
+
19
+ `--planId [planId]`
20
+ : ID of the plan to which the bucket to remove belongs. Specify either `planId` or `planName` when using `name`.
21
+
22
+ `--planName [planName]`
23
+ : Name of the plan to which the bucket to remove belongs. Specify either `planId` or `planName` when using `name`.
24
+
25
+ `--ownerGroupId [ownerGroupId]`
26
+ : ID of the group to which the plan belongs. Specify either `ownerGroupId` or `ownerGroupName` when using `planName`.
27
+
28
+ `--ownerGroupName [ownerGroupName]`
29
+ : Name of the group to which the plan belongs. Specify either `ownerGroupId` or `ownerGroupName` when using `planName`.
30
+
31
+ `--confirm`
32
+ : Don't prompt for confirmation
33
+
34
+ --8<-- "docs/cmd/_global.md"
35
+
36
+ ## Examples
37
+
38
+ Removes the Microsoft Planner bucket by ID
39
+
40
+ ```sh
41
+ m365 planner bucket remove --id "vncYUXCRBke28qMLB-d4xJcACtNz"
42
+ ```
43
+
44
+ Removes the Microsoft Planner bucket by ID without confirmation
45
+
46
+ ```sh
47
+ m365 planner bucket remove --id "vncYUXCRBke28qMLB-d4xJcACtNz" --confirm
48
+ ```
49
+
50
+ Removes the Microsoft Planner bucket with name _My Bucket_ in the Plan with ID _oUHpnKBFekqfGE_PS6GGUZcAFY7b_
51
+
52
+ ```sh
53
+ m365 planner bucket remove --name "My Bucket" --planId "oUHpnKBFekqfGE_PS6GGUZcAFY7b"
54
+ ```
55
+
56
+ Removes the Microsoft Planner bucket with name _My Bucket_ in the Plan _My Plan_ owned by group _My Group_
57
+
58
+ ```sh
59
+ m365 planner bucket remove --name "My Bucket" --planName "My Plan" --ownerGroupName "My Group"
60
+ ```
@@ -0,0 +1,57 @@
1
+ # planner bucket set
2
+
3
+ Updates a Microsoft Planner bucket
4
+
5
+ ## Usage
6
+
7
+ ```sh
8
+ m365 planner bucket set [options]
9
+ ```
10
+
11
+ ## Options
12
+
13
+ `-i, --id [id]`
14
+ : ID of the bucket. Specify either `id` or `name` but not both.
15
+
16
+ `--name [name]`
17
+ : Name of the bucket. Specify either `id` or `name` but not both.
18
+
19
+ `--planId [planId]`
20
+ : ID of the plan to update the bucket of. Use when referring to bucket using `name`. Specify either `planId` or `planName` but not both.
21
+
22
+ `--planName [planName]`
23
+ : Name of the plan to update the bucket of. Use when referring to bucket using `name`. Specify either `planId` or `planName` but not both.
24
+
25
+ `--ownerGroupId [ownerGroupId]`
26
+ : ID of the group to which the plan belongs. Use when referring to plan using `planName`. Specify `ownerGroupId` or `ownerGroupName`.
27
+
28
+ `--ownerGroupName [ownerGroupName]`
29
+ : Name of the group to which the plan belongs. Use when referring to plan using `planName`. Specify `ownerGroupId` or `ownerGroupName`.
30
+
31
+ `--newName [newName]`
32
+ : New name of the bucket.
33
+
34
+ `--orderHint [orderHint]`
35
+ : Hint used to order items of this type in a list view. The format is defined as outlined [here](https://docs.microsoft.com/en-us/graph/api/resources/planner-order-hint-format?view=graph-rest-1.0).
36
+
37
+ --8<-- "docs/cmd/_global.md"
38
+
39
+ ## Examples
40
+
41
+ Updates the Microsoft Planner bucket with ID _vncYUXCRBke28qMLB-d4xJcACtNz_
42
+
43
+ ```sh
44
+ m365 planner bucket set --id "vncYUXCRBke28qMLB-d4xJcACtNz" --newName "New bucket name"
45
+ ```
46
+
47
+ Updates the Microsoft Planner bucket named _My Bucket_ in the Plan _My Plan_ owned by group _My Group_
48
+
49
+ ```sh
50
+ m365 planner bucket set --name "My Bucket" --planName "My Plan" --ownerGroupName "My Group" --newName "New bucket name"
51
+ ```
52
+
53
+ Updates the Microsoft Planner bucket named _My Bucket_ in the Plan _My Plan_ owned by group with ID _00000000-0000-0000-0000-000000000000_
54
+
55
+ ```sh
56
+ m365 planner bucket set --name "My Bucket" --planName "My Plan" --ownerGroupId 00000000-0000-0000-0000-000000000000 --newName "New bucket name"
57
+ ```
@@ -10,8 +10,29 @@ m365 planner task get [options]
10
10
 
11
11
  ## Options
12
12
 
13
- `-i, --id <id>`
14
- : ID of the task to retrieve details from
13
+ `-i, --id [id]`
14
+ : ID of the task. Specify either `id` or `title` but not both. When you specify the task ID, you no longer need to provide the information for `bucket`, `plan`, and `ownerGroup`.
15
+
16
+ `-t, --title [title]`
17
+ : Title of the task. Specify either `id` or `title` but not both.
18
+
19
+ `--bucketId [bucketId]`
20
+ : Bucket ID to which the task belongs. Specify `bucketId` or `bucketName` when using `title`.
21
+
22
+ `--bucketName [bucketName]`
23
+ : Bucket Name to which the task belongs. Specify `bucketId` or `bucketName` when using `title`.
24
+
25
+ `--planId [planId]`
26
+ : Plan ID to which the task belongs. Specify `planId` or `planName` when using `bucketName`.
27
+
28
+ `--planName [planName]`
29
+ : Plan Name to which the task belongs. Specify `planId` or `planName` when using `bucketName`.
30
+
31
+ `--ownerGroupId [ownerGroupId]`
32
+ : ID of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planName`.
33
+
34
+ `--ownerGroupName [ownerGroupName]`
35
+ : Name of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planName`.
15
36
 
16
37
  --8<-- "docs/cmd/_global.md"
17
38
 
@@ -22,8 +43,14 @@ m365 planner task get [options]
22
43
 
23
44
  ## Examples
24
45
 
25
- Retrieve the the specified planner task
46
+ Retrieve the the specified planner task by id.
26
47
 
27
48
  ```sh
28
49
  m365 planner task get --id 'vzCcZoOv-U27PwydxHB8opcADJo-'
29
50
  ```
51
+
52
+ Retrieve the the specified planner task with the title _My Planner Task_ from the bucket named _My Planner Bucket_. Based on the plan with the name _My Planner Plan_ owned by the group _My Planner Group_.
53
+
54
+ ```sh
55
+ m365 planner task get --title "My Planner Task" --bucketName "My Planner Bucket" --planName "My Planner Plan" --ownerGroupName "My Planner Group"
56
+ ```
@@ -23,10 +23,10 @@ m365 planner task set [options]
23
23
  : Name of the bucket to move the task to. The bucket needs to exist in the selected plan. Specify either `bucketId` or `bucketName` but not both.
24
24
 
25
25
  `--planId [planId]`
26
- : ID of the plan to move the task to. Specify either `planId` or `planName` but not both.
26
+ : ID of the plan to which the bucket belongs to. Specify either `planId` or `planName` when using `bucketName`.
27
27
 
28
28
  `--planName [planName]`
29
- : Name of the plan to move the task to. Specify either `planId` or `planName` but not both.
29
+ : Name of the plan to which the bucket belongs to. Specify either `planId` or `planName` when using `bucketName`.
30
30
 
31
31
  `--ownerGroupId [ownerGroupId]`
32
32
  : ID of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planName`.
@@ -32,7 +32,7 @@ m365 spfx project upgrade [options]
32
32
 
33
33
  ## Remarks
34
34
 
35
- The `spfx project upgrade` command helps you upgrade your SharePoint Framework project to the specified version. If no version is specified, the command will upgrade to the latest version of the SharePoint Framework it supports (v1.14.0). If you specify the `preview` option without a specific version, the command will upgrade your project to the latest preview version v1.15.0-beta.1.
35
+ The `spfx project upgrade` command helps you upgrade your SharePoint Framework project to the specified version. If no version is specified, the command will upgrade to the latest version of the SharePoint Framework it supports (v1.14.0). If you specify the `preview` option without a specific version, the command will upgrade your project to the latest preview version v1.15.0-beta.6.
36
36
 
37
37
  This command doesn't change your project files. Instead, it gives you a report with all steps necessary to upgrade your project to the specified version of the SharePoint Framework. Changing project files is error-prone, especially when it comes to updating your solution's code. This is why at this moment, this command produces a report that you can use yourself to perform the necessary updates and verify that everything is working as expected.
38
38
 
@@ -37,7 +37,7 @@ This commands helps you to verify if your environment meets all prerequisites fo
37
37
 
38
38
  The command starts by detecting the version of SharePoint Framework that you want to use. First, it looks at the current project. If you didn't run the command in the context of a SharePoint Framework project, the command will try to determine the SharePoint Framework version based on the SharePoint Framework Yeoman generator that you have installed either in the current directory or globally.
39
39
 
40
- Based on the determined version of the SharePoint Framework, the command will look at other dependencies such as Node.js, npm, Yeoman, Gulp, React and TypeScript to verify if their meet the requirements of that particular version of the SharePoint Framework.
40
+ Based on the determined version of the SharePoint Framework, the command will look at other dependencies such as Node.js, npm, Yeoman, Gulp and TypeScript to verify if their meet the requirements of that particular version of the SharePoint Framework.
41
41
 
42
42
  If you miss any required tools or use a version that doesn't meet the SharePoint Framework requirements, the command will give you a list of recommendation how to address these issues.
43
43
 
@@ -0,0 +1,51 @@
1
+ # spo field list
2
+
3
+ Retrieves columns for the specified list or site
4
+
5
+ ## Usage
6
+
7
+ ```sh
8
+ m365 spo field list [options]
9
+ ```
10
+
11
+ ## Options
12
+
13
+ `-u, --webUrl <webUrl>`
14
+ : Absolute URL of the site where fields are located
15
+
16
+ `-t, --listTitle [listTitle]`
17
+ : Title of the list where fields are located. Specify `listTitle`, `listId` or `listUrl`
18
+
19
+ `-i --listId [listId]`
20
+ : ID of the list where fields are located. Specify `listTitle`, `listId` or `listUrl`
21
+
22
+ `--listUrl [listUrl]`
23
+ : Server- or web-relative URL of the list where fields are located. Specify `listTitle`, `listId` or `listUrl`
24
+
25
+ --8<-- "docs/cmd/_global.md"
26
+
27
+ ## Examples
28
+
29
+ Retrieves site columns for site _https://contoso.sharepoint.com/sites/contoso-sales_.
30
+
31
+ ```sh
32
+ m365 spo field list --webUrl https://contoso.sharepoint.com/sites/contoso-sales
33
+ ```
34
+
35
+ Retrieves list columns for list _Events_ in site _https://contoso.sharepoint.com/sites/contoso-sales_
36
+
37
+ ```sh
38
+ m365 spo field list --webUrl https://contoso.sharepoint.com/sites/contoso-sales --listTitle Events
39
+ ```
40
+
41
+ Retrieves list columns for list _202b8199-b9de-43fd-9737-7f213f51c991_ in site _https://contoso.sharepoint.com/sites/contoso-sales_
42
+
43
+ ```sh
44
+ m365 spo field list --webUrl https://contoso.sharepoint.com/sites/contoso-sales --listId '202b8199-b9de-43fd-9737-7f213f51c991'
45
+ ```
46
+
47
+ Retrieves list columns for list _/sites/contoso-sales/lists/Events_ in site _https://contoso.sharepoint.com/sites/contoso-sales_
48
+
49
+ ```sh
50
+ m365 spo field list --webUrl https://contoso.sharepoint.com/sites/contoso-sales --listUrl '/sites/contoso-sales/lists/Events'
51
+ ```
@@ -0,0 +1,55 @@
1
+ # spo list roleinheritance break
2
+
3
+ Breaks role inheritance on list or library
4
+
5
+ ## Usage
6
+
7
+ ```sh
8
+ m365 spo list roleinheritance break [options]
9
+ ```
10
+
11
+ ## Options
12
+
13
+ `-u, --webUrl <webUrl>`
14
+ : URL of the site where the list to retrieve is located
15
+
16
+ `-i, --listId [listId]`
17
+ : ID of the list to retrieve information for. Specify either id or title but not both
18
+
19
+ `-t, --listTitle [listTitle]`
20
+ : Title of the list to retrieve information for. Specify either id or title but not both
21
+
22
+ `-c, --clearExistingPermissions`
23
+ : Flag if used clears all roles from the list
24
+
25
+ --8<-- "docs/cmd/_global.md"
26
+
27
+ ## Remarks
28
+
29
+ By default, when breaking permissions inheritance, the list will retain existing permissions. To remove existing permissions, use the `--clearExistingPermissions` option.
30
+
31
+ ## Examples
32
+
33
+ Break inheritance of list _someList_ located in site _https://contoso.sharepoint.com/sites/project-x_
34
+
35
+ ```sh
36
+ m365 spo list roleinheritance break --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList"
37
+ ```
38
+
39
+ Break inheritance of list with ID _202b8199-b9de-43fd-9737-7f213f51c991_ located in site _https://contoso.sharepoint.com/sites/project-x_
40
+
41
+ ```sh
42
+ m365 spo list roleinheritance break --webUrl "https://contoso.sharepoint.com/sites/project-x" --listId "202b8199-b9de-43fd-9737-7f213f51c991"
43
+ ```
44
+
45
+ Break inheritance of list _someList_ located in site _https://contoso.sharepoint.com/sites/project-x_ with clearing permissions
46
+
47
+ ```sh
48
+ m365 spo list roleinheritance break --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --clearExistingPermissions
49
+ ```
50
+
51
+ Break inheritance of list with ID _202b8199-b9de-43fd-9737-7f213f51c991_ located in site _https://contoso.sharepoint.com/sites/project-x_ with clearing permissions
52
+
53
+ ```sh
54
+ m365 spo list roleinheritance break --webUrl "https://contoso.sharepoint.com/sites/project-x" --listId "202b8199-b9de-43fd-9737-7f213f51c991" --clearExistingPermissions
55
+ ```
@@ -0,0 +1,36 @@
1
+ # spo list roleinheritance reset
2
+
3
+ Restores role inheritance on list or library
4
+
5
+ ## Usage
6
+
7
+ ```sh
8
+ m365 spo list roleinheritance reset [options]
9
+ ```
10
+
11
+ ## Options
12
+
13
+ `-u, --webUrl <webUrl>`
14
+ : URL of the site where the list is located
15
+
16
+ `-i, --listId [listId]`
17
+ : ID of the list. Specify either id or title but not both
18
+
19
+ `-t, --listTitle [listTitle]`
20
+ : Title of the list. Specify either id or title but not both
21
+
22
+ --8<-- "docs/cmd/_global.md"
23
+
24
+ ## Examples
25
+
26
+ Restore role inheritance of list with ID _0cd891ef-afce-4e55-b836-fce03286cccf_ located in site _https://contoso.sharepoint.com/sites/project-x_
27
+
28
+ ```sh
29
+ m365 spo list roleinheritance reset --webUrl https://contoso.sharepoint.com/sites/project-x --listId 0cd891ef-afce-4e55-b836-fce03286cccf
30
+ ```
31
+
32
+ Restore role inheritance of list with title _test_ located in site _https://contoso.sharepoint.com/sites/project-x_
33
+
34
+ ```sh
35
+ m365 spo list roleinheritance reset --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle test
36
+ ```
@@ -13,10 +13,10 @@ m365 spo listitem list [options]
13
13
  `-u, --webUrl <webUrl>`
14
14
  : URL of the site from which the item should be retrieved
15
15
 
16
- `-i, --id <id>`
16
+ `-i, --id [id]`
17
17
  : ID of the list to retrieve items from. Specify `id` or `title` but not both
18
18
 
19
- `-t, --title [listTitle]`
19
+ `-t, --title [title]`
20
20
  : Title of the list from which to retrieve the item. Specify `id` or `title` but not both
21
21
 
22
22
  `-q, --camlQuery [camlQuery]`