@pnp/cli-microsoft365 4.3.0-beta.bec032d → 4.3.0-beta.fa07425
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.
- package/.devcontainer/devcontainer.json +9 -1
- package/dist/Utils.js +3 -0
- package/dist/m365/aad/commands/o365group/{Group.js → GroupExtended.js} +1 -1
- package/dist/m365/aad/commands/o365group/o365group-user-set.js +3 -3
- package/dist/m365/aad/commands/user/user-get.js +33 -6
- package/dist/m365/planner/commands/task/task-add.js +288 -0
- package/dist/m365/planner/commands.js +1 -0
- package/dist/m365/spo/commands/site/site-ensure.js +1 -1
- package/dist/m365/teams/commands/message/message-get.js +1 -1
- package/docs/docs/cmd/aad/user/user-get.md +13 -4
- package/docs/docs/cmd/planner/task/task-add.md +78 -0
- package/docs/docs/cmd/teams/message/message-get.md +0 -3
- package/package.json +2 -1
- package/dist/m365/aad/commands/o365group/GroupUser.js +0 -3
|
@@ -2,7 +2,15 @@
|
|
|
2
2
|
"name": "CLI for Microsoft 365",
|
|
3
3
|
"dockerFile": "Dockerfile",
|
|
4
4
|
"settings": {
|
|
5
|
-
"terminal.integrated.
|
|
5
|
+
"terminal.integrated.profiles.linux": {
|
|
6
|
+
"zsh": {
|
|
7
|
+
"path": "/bin/zsh",
|
|
8
|
+
"args": [
|
|
9
|
+
"-l"
|
|
10
|
+
]
|
|
11
|
+
}
|
|
12
|
+
},
|
|
13
|
+
"terminal.integrated.defaultProfile.linux": "zsh"
|
|
6
14
|
},
|
|
7
15
|
"postCreateCommand": "npm i && npm run clean && npm run build && npm link",
|
|
8
16
|
"extensions": [
|
package/dist/Utils.js
CHANGED
|
@@ -40,6 +40,9 @@ class Utils {
|
|
|
40
40
|
}
|
|
41
41
|
});
|
|
42
42
|
}
|
|
43
|
+
static isValidGuidArray(guids) {
|
|
44
|
+
return guids.every(guid => this.isValidGuid(guid));
|
|
45
|
+
}
|
|
43
46
|
static isValidGuid(guid) {
|
|
44
47
|
const guidRegEx = new RegExp(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i);
|
|
45
48
|
return guidRegEx.test(guid);
|
|
@@ -37,14 +37,14 @@ class AadO365GroupUserSetCommand extends GraphItemsListCommand_1.GraphItemsListC
|
|
|
37
37
|
logger.logToStderr(this.items);
|
|
38
38
|
logger.logToStderr('');
|
|
39
39
|
}
|
|
40
|
-
if (this.items.filter(i =>
|
|
40
|
+
if (this.items.filter(i => args.options.userName.toUpperCase() === i.userPrincipalName.toUpperCase()).length <= 0) {
|
|
41
41
|
const userNotInGroup = (typeof args.options.groupId !== 'undefined') ?
|
|
42
42
|
'The specified user does not belong to the given Microsoft 365 Group. Please use the \'o365group user add\' command to add new users.' :
|
|
43
43
|
'The specified user does not belong to the given Microsoft Teams team. Please use the \'graph teams user add\' command to add new users.';
|
|
44
44
|
throw new Error(userNotInGroup);
|
|
45
45
|
}
|
|
46
46
|
if (args.options.role === "Owner") {
|
|
47
|
-
const foundMember = this.items.find(e =>
|
|
47
|
+
const foundMember = this.items.find(e => args.options.userName.toUpperCase() === e.userPrincipalName.toUpperCase() && e.userType === 'Member');
|
|
48
48
|
if (foundMember !== undefined) {
|
|
49
49
|
const endpoint = `${this.resource}/v1.0/groups/${groupId}/owners/$ref`;
|
|
50
50
|
const requestOptions = {
|
|
@@ -65,7 +65,7 @@ class AadO365GroupUserSetCommand extends GraphItemsListCommand_1.GraphItemsListC
|
|
|
65
65
|
}
|
|
66
66
|
}
|
|
67
67
|
else {
|
|
68
|
-
const foundOwner = this.items.find(e =>
|
|
68
|
+
const foundOwner = this.items.find(e => args.options.userName.toUpperCase() === e.userPrincipalName.toUpperCase() && e.userType === 'Owner');
|
|
69
69
|
if (foundOwner !== undefined) {
|
|
70
70
|
const endpoint = `${this.resource}/v1.0/groups/${groupId}/owners/${foundOwner.id}/$ref`;
|
|
71
71
|
const requestOptions = {
|
|
@@ -20,10 +20,20 @@ class AadUserGetCommand extends GraphCommand_1.default {
|
|
|
20
20
|
}
|
|
21
21
|
commandAction(logger, args, cb) {
|
|
22
22
|
const properties = args.options.properties ?
|
|
23
|
-
|
|
23
|
+
`&$select=${args.options.properties.split(',').map(p => encodeURIComponent(p.trim())).join(',')}` :
|
|
24
24
|
'';
|
|
25
|
+
let requestUrl = `${this.resource}/v1.0/users`;
|
|
26
|
+
if (args.options.id) {
|
|
27
|
+
requestUrl += `?$filter=id eq '${encodeURIComponent(args.options.id)}'${properties}`;
|
|
28
|
+
}
|
|
29
|
+
else if (args.options.userName) {
|
|
30
|
+
requestUrl += `?$filter=userPrincipalName eq '${encodeURIComponent(args.options.userName)}'${properties}`;
|
|
31
|
+
}
|
|
32
|
+
else if (args.options.email) {
|
|
33
|
+
requestUrl += `?$filter=mail eq '${encodeURIComponent(args.options.email)}'${properties}`;
|
|
34
|
+
}
|
|
25
35
|
const requestOptions = {
|
|
26
|
-
url:
|
|
36
|
+
url: requestUrl,
|
|
27
37
|
headers: {
|
|
28
38
|
accept: 'application/json;odata.metadata=none'
|
|
29
39
|
},
|
|
@@ -31,6 +41,18 @@ class AadUserGetCommand extends GraphCommand_1.default {
|
|
|
31
41
|
};
|
|
32
42
|
request_1.default
|
|
33
43
|
.get(requestOptions)
|
|
44
|
+
.then((res) => {
|
|
45
|
+
if (res.value.length === 1) {
|
|
46
|
+
return Promise.resolve(res.value[0]);
|
|
47
|
+
}
|
|
48
|
+
const identifier = args.options.id ? `id ${args.options.id}`
|
|
49
|
+
: args.options.userName ? `user name ${args.options.userName}`
|
|
50
|
+
: `email ${args.options.email}`;
|
|
51
|
+
if (res.value.length === 0) {
|
|
52
|
+
return Promise.reject(`The specified user with ${identifier} does not exist`);
|
|
53
|
+
}
|
|
54
|
+
return Promise.reject(`Multiple users with ${identifier} found. Please disambiguate (user names): ${res.value.map(a => a.userPrincipalName).join(', ')} or (ids): ${res.value.map(a => a.id).join(', ')}`);
|
|
55
|
+
})
|
|
34
56
|
.then((res) => {
|
|
35
57
|
logger.log(res);
|
|
36
58
|
cb();
|
|
@@ -44,6 +66,9 @@ class AadUserGetCommand extends GraphCommand_1.default {
|
|
|
44
66
|
{
|
|
45
67
|
option: '-n, --userName [userName]'
|
|
46
68
|
},
|
|
69
|
+
{
|
|
70
|
+
option: '--email [email]'
|
|
71
|
+
},
|
|
47
72
|
{
|
|
48
73
|
option: '-p, --properties [properties]'
|
|
49
74
|
}
|
|
@@ -52,11 +77,13 @@ class AadUserGetCommand extends GraphCommand_1.default {
|
|
|
52
77
|
return options.concat(parentOptions);
|
|
53
78
|
}
|
|
54
79
|
validate(args) {
|
|
55
|
-
if (!args.options.id && !args.options.userName) {
|
|
56
|
-
return 'Specify
|
|
80
|
+
if (!args.options.id && !args.options.userName && !args.options.email) {
|
|
81
|
+
return 'Specify id, userName or email, one is required';
|
|
57
82
|
}
|
|
58
|
-
if (args.options.id && args.options.
|
|
59
|
-
|
|
83
|
+
if ((args.options.id && args.options.email) ||
|
|
84
|
+
(args.options.id && args.options.userName) ||
|
|
85
|
+
(args.options.userName && args.options.email)) {
|
|
86
|
+
return 'Use either id, userName or email, but not all';
|
|
60
87
|
}
|
|
61
88
|
if (args.options.id &&
|
|
62
89
|
!Utils_1.default.isValidGuid(args.options.id)) {
|
|
@@ -0,0 +1,288 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
const request_1 = require("../../../../request");
|
|
4
|
+
const Utils_1 = require("../../../../Utils");
|
|
5
|
+
const GraphCommand_1 = require("../../../base/GraphCommand");
|
|
6
|
+
const commands_1 = require("../../commands");
|
|
7
|
+
class PlannerTaskAddCommand extends GraphCommand_1.default {
|
|
8
|
+
get name() {
|
|
9
|
+
return commands_1.default.TASK_ADD;
|
|
10
|
+
}
|
|
11
|
+
get description() {
|
|
12
|
+
return 'Adds a new Microsoft Planner Task';
|
|
13
|
+
}
|
|
14
|
+
getTelemetryProperties(args) {
|
|
15
|
+
const telemetryProps = super.getTelemetryProperties(args);
|
|
16
|
+
telemetryProps.planId = typeof args.options.planId !== 'undefined';
|
|
17
|
+
telemetryProps.planName = typeof args.options.planName !== 'undefined';
|
|
18
|
+
telemetryProps.ownerGroupId = typeof args.options.ownerGroupId !== 'undefined';
|
|
19
|
+
telemetryProps.ownerGroupName = typeof args.options.ownerGroupName !== 'undefined';
|
|
20
|
+
telemetryProps.bucketId = typeof args.options.bucketId !== 'undefined';
|
|
21
|
+
telemetryProps.bucketName = typeof args.options.bucketName !== 'undefined';
|
|
22
|
+
telemetryProps.startDateTime = typeof args.options.startDateTime !== 'undefined';
|
|
23
|
+
telemetryProps.dueDateTime = typeof args.options.dueDateTime !== 'undefined';
|
|
24
|
+
telemetryProps.percentComplete = typeof args.options.percentComplete !== 'undefined';
|
|
25
|
+
telemetryProps.assignedToUserIds = typeof args.options.assignedToUserIds !== 'undefined';
|
|
26
|
+
telemetryProps.assignedToUserNames = typeof args.options.assignedToUserNames !== 'undefined';
|
|
27
|
+
telemetryProps.description = typeof args.options.description !== 'undefined';
|
|
28
|
+
telemetryProps.orderHint = typeof args.options.orderHint !== 'undefined';
|
|
29
|
+
return telemetryProps;
|
|
30
|
+
}
|
|
31
|
+
commandAction(logger, args, cb) {
|
|
32
|
+
this
|
|
33
|
+
.getPlanId(args)
|
|
34
|
+
.then(planId => {
|
|
35
|
+
this.planId = planId;
|
|
36
|
+
return this.getBucketId(args, planId);
|
|
37
|
+
})
|
|
38
|
+
.then(bucketId => {
|
|
39
|
+
this.bucketId = bucketId;
|
|
40
|
+
return this.generateUserAssignments(args);
|
|
41
|
+
})
|
|
42
|
+
.then(assignments => {
|
|
43
|
+
const requestOptions = {
|
|
44
|
+
url: `${this.resource}/v1.0/planner/tasks`,
|
|
45
|
+
headers: {
|
|
46
|
+
'accept': 'application/json;odata.metadata=none'
|
|
47
|
+
},
|
|
48
|
+
responseType: 'json',
|
|
49
|
+
data: {
|
|
50
|
+
planId: this.planId,
|
|
51
|
+
bucketId: this.bucketId,
|
|
52
|
+
title: args.options.title,
|
|
53
|
+
startDateTime: args.options.startDateTime,
|
|
54
|
+
dueDateTime: args.options.dueDateTime,
|
|
55
|
+
percentComplete: args.options.percentComplete,
|
|
56
|
+
assignments: assignments,
|
|
57
|
+
orderHint: args.options.orderHint
|
|
58
|
+
}
|
|
59
|
+
};
|
|
60
|
+
return request_1.default.post(requestOptions);
|
|
61
|
+
})
|
|
62
|
+
.then(newTask => this.updateTaskDetails(args.options, newTask))
|
|
63
|
+
.then((res) => {
|
|
64
|
+
logger.log(res);
|
|
65
|
+
cb();
|
|
66
|
+
}, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
|
|
67
|
+
}
|
|
68
|
+
getTaskDetailsEtag(taskId) {
|
|
69
|
+
const requestOptions = {
|
|
70
|
+
url: `${this.resource}/v1.0/planner/tasks/${encodeURIComponent(taskId)}/details`,
|
|
71
|
+
headers: {
|
|
72
|
+
accept: 'application/json'
|
|
73
|
+
},
|
|
74
|
+
responseType: 'json'
|
|
75
|
+
};
|
|
76
|
+
return request_1.default
|
|
77
|
+
.get(requestOptions)
|
|
78
|
+
.then((response) => {
|
|
79
|
+
const etag = response ? response['@odata.etag'] : undefined;
|
|
80
|
+
if (!etag) {
|
|
81
|
+
return Promise.reject(`Error fetching task details`);
|
|
82
|
+
}
|
|
83
|
+
return Promise.resolve(etag);
|
|
84
|
+
});
|
|
85
|
+
}
|
|
86
|
+
updateTaskDetails(options, newTask) {
|
|
87
|
+
const taskId = newTask.id;
|
|
88
|
+
if (!options.description) {
|
|
89
|
+
return Promise.resolve(newTask);
|
|
90
|
+
}
|
|
91
|
+
return this
|
|
92
|
+
.getTaskDetailsEtag(taskId)
|
|
93
|
+
.then(etag => {
|
|
94
|
+
const requestOptionsTaskDetails = {
|
|
95
|
+
url: `${this.resource}/v1.0/planner/tasks/${taskId}/details`,
|
|
96
|
+
headers: {
|
|
97
|
+
'accept': 'application/json;odata.metadata=none',
|
|
98
|
+
'If-Match': etag,
|
|
99
|
+
'Prefer': 'return=representation'
|
|
100
|
+
},
|
|
101
|
+
responseType: 'json',
|
|
102
|
+
data: {
|
|
103
|
+
description: options.description
|
|
104
|
+
}
|
|
105
|
+
};
|
|
106
|
+
return request_1.default.patch(requestOptionsTaskDetails);
|
|
107
|
+
})
|
|
108
|
+
.then(taskDetails => {
|
|
109
|
+
return Object.assign(Object.assign({}, newTask), taskDetails);
|
|
110
|
+
});
|
|
111
|
+
}
|
|
112
|
+
generateUserAssignments(args) {
|
|
113
|
+
const assignments = {};
|
|
114
|
+
if (!args.options.assignedToUserIds && !args.options.assignedToUserNames) {
|
|
115
|
+
return Promise.resolve(assignments);
|
|
116
|
+
}
|
|
117
|
+
return this
|
|
118
|
+
.getUserIds(args.options)
|
|
119
|
+
.then((userIds) => {
|
|
120
|
+
userIds.map(x => assignments[x] = {
|
|
121
|
+
'@odata.type': '#microsoft.graph.plannerAssignment',
|
|
122
|
+
orderHint: ' !'
|
|
123
|
+
});
|
|
124
|
+
return Promise.resolve(assignments);
|
|
125
|
+
});
|
|
126
|
+
}
|
|
127
|
+
getBucketId(args, planId) {
|
|
128
|
+
if (args.options.bucketId) {
|
|
129
|
+
return Promise.resolve(args.options.bucketId);
|
|
130
|
+
}
|
|
131
|
+
const requestOptions = {
|
|
132
|
+
url: `${this.resource}/v1.0/planner/plans/${planId}/buckets`,
|
|
133
|
+
headers: {
|
|
134
|
+
accept: 'application/json;odata.metadata=none'
|
|
135
|
+
},
|
|
136
|
+
responseType: 'json'
|
|
137
|
+
};
|
|
138
|
+
return request_1.default
|
|
139
|
+
.get(requestOptions)
|
|
140
|
+
.then((response) => {
|
|
141
|
+
const bucket = response.value.find(val => val.name === args.options.bucketName);
|
|
142
|
+
if (!bucket) {
|
|
143
|
+
return Promise.reject(`The specified bucket does not exist`);
|
|
144
|
+
}
|
|
145
|
+
return Promise.resolve(bucket.id);
|
|
146
|
+
});
|
|
147
|
+
}
|
|
148
|
+
getPlanId(args) {
|
|
149
|
+
if (args.options.planId) {
|
|
150
|
+
return Promise.resolve(args.options.planId);
|
|
151
|
+
}
|
|
152
|
+
return this
|
|
153
|
+
.getGroupId(args)
|
|
154
|
+
.then((groupId) => {
|
|
155
|
+
const requestOptions = {
|
|
156
|
+
url: `${this.resource}/v1.0/planner/plans?$filter=(owner eq '${groupId}')`,
|
|
157
|
+
headers: {
|
|
158
|
+
accept: 'application/json;odata.metadata=none'
|
|
159
|
+
},
|
|
160
|
+
responseType: 'json'
|
|
161
|
+
};
|
|
162
|
+
return request_1.default.get(requestOptions);
|
|
163
|
+
}).then((response) => {
|
|
164
|
+
const plan = response.value.find(val => val.title === args.options.planName);
|
|
165
|
+
if (!plan) {
|
|
166
|
+
return Promise.reject(`The specified plan does not exist`);
|
|
167
|
+
}
|
|
168
|
+
return Promise.resolve(plan.id);
|
|
169
|
+
});
|
|
170
|
+
}
|
|
171
|
+
getGroupId(args) {
|
|
172
|
+
if (args.options.ownerGroupId) {
|
|
173
|
+
return Promise.resolve(args.options.ownerGroupId);
|
|
174
|
+
}
|
|
175
|
+
const requestOptions = {
|
|
176
|
+
url: `${this.resource}/v1.0/groups?$filter=displayName eq '${encodeURIComponent(args.options.ownerGroupName)}'`,
|
|
177
|
+
headers: {
|
|
178
|
+
accept: 'application/json;odata.metadata=none'
|
|
179
|
+
},
|
|
180
|
+
responseType: 'json'
|
|
181
|
+
};
|
|
182
|
+
return request_1.default
|
|
183
|
+
.get(requestOptions)
|
|
184
|
+
.then(response => {
|
|
185
|
+
const group = response.value[0];
|
|
186
|
+
if (!group) {
|
|
187
|
+
return Promise.reject(`The specified owner group does not exist`);
|
|
188
|
+
}
|
|
189
|
+
return Promise.resolve(group.id);
|
|
190
|
+
});
|
|
191
|
+
}
|
|
192
|
+
getUserIds(options) {
|
|
193
|
+
if (options.assignedToUserIds) {
|
|
194
|
+
return Promise.resolve(options.assignedToUserIds.split(','));
|
|
195
|
+
}
|
|
196
|
+
// Hitting this section means assignedToUserNames won't be undefined
|
|
197
|
+
const userNames = options.assignedToUserNames;
|
|
198
|
+
const userArr = userNames.split(',').map(o => o.trim());
|
|
199
|
+
let userIds = [];
|
|
200
|
+
const promises = userArr.map(user => {
|
|
201
|
+
const requestOptions = {
|
|
202
|
+
url: `${this.resource}/v1.0/users?$filter=userPrincipalName eq '${Utils_1.default.encodeQueryParameter(user)}'&$select=id,userPrincipalName`,
|
|
203
|
+
headers: {
|
|
204
|
+
'content-type': 'application/json'
|
|
205
|
+
},
|
|
206
|
+
responseType: 'json'
|
|
207
|
+
};
|
|
208
|
+
return request_1.default.get(requestOptions);
|
|
209
|
+
});
|
|
210
|
+
return Promise
|
|
211
|
+
.all(promises)
|
|
212
|
+
.then((usersRes) => {
|
|
213
|
+
let userUpns = [];
|
|
214
|
+
userUpns = usersRes.map(res => { var _a; return (_a = res.value[0]) === null || _a === void 0 ? void 0 : _a.userPrincipalName; });
|
|
215
|
+
userIds = usersRes.map(res => { var _a; return (_a = res.value[0]) === null || _a === void 0 ? void 0 : _a.id; });
|
|
216
|
+
// Find the members where no graph response was found
|
|
217
|
+
const invalidUsers = userArr.filter(user => !userUpns.some((upn) => (upn === null || upn === void 0 ? void 0 : upn.toLowerCase()) === user.toLowerCase()));
|
|
218
|
+
if (invalidUsers && invalidUsers.length > 0) {
|
|
219
|
+
return Promise.reject(`Cannot proceed with planner task creation. The following users provided are invalid : ${invalidUsers.join(',')}`);
|
|
220
|
+
}
|
|
221
|
+
return Promise.resolve(userIds);
|
|
222
|
+
});
|
|
223
|
+
}
|
|
224
|
+
options() {
|
|
225
|
+
const options = [
|
|
226
|
+
{ option: '-t, --title <title>' },
|
|
227
|
+
{ option: '--planId [planId]' },
|
|
228
|
+
{ option: '--planName [planName]' },
|
|
229
|
+
{ option: '--ownerGroupId [ownerGroupId]' },
|
|
230
|
+
{ option: '--ownerGroupName [ownerGroupName]' },
|
|
231
|
+
{ option: '--bucketId [bucketId]' },
|
|
232
|
+
{ option: '--bucketName [bucketName]' },
|
|
233
|
+
{ option: '--startDateTime [startDateTime]' },
|
|
234
|
+
{ option: '--dueDateTime [dueDateTime]' },
|
|
235
|
+
{ option: '--percentComplete [percentComplete]' },
|
|
236
|
+
{ option: '--assignedToUserIds [assignedToUserIds]' },
|
|
237
|
+
{ option: '--assignedToUserNames [assignedToUserNames]' },
|
|
238
|
+
{ option: '--description [description]' },
|
|
239
|
+
{ option: '--orderHint [orderHint]' }
|
|
240
|
+
];
|
|
241
|
+
const parentOptions = super.options();
|
|
242
|
+
return options.concat(parentOptions);
|
|
243
|
+
}
|
|
244
|
+
validate(args) {
|
|
245
|
+
if (!args.options.planId && !args.options.planName) {
|
|
246
|
+
return 'Specify either planId or planName';
|
|
247
|
+
}
|
|
248
|
+
if (args.options.planId && args.options.planName) {
|
|
249
|
+
return 'Specify either planId or planName but not both';
|
|
250
|
+
}
|
|
251
|
+
if (args.options.planName && !args.options.ownerGroupId && !args.options.ownerGroupName) {
|
|
252
|
+
return 'Specify either ownerGroupId or ownerGroupName when using planName';
|
|
253
|
+
}
|
|
254
|
+
if (args.options.planName && args.options.ownerGroupId && args.options.ownerGroupName) {
|
|
255
|
+
return 'Specify either ownerGroupId or ownerGroupName when using planName but not both';
|
|
256
|
+
}
|
|
257
|
+
if (args.options.ownerGroupId && !Utils_1.default.isValidGuid(args.options.ownerGroupId)) {
|
|
258
|
+
return `${args.options.ownerGroupId} is not a valid GUID`;
|
|
259
|
+
}
|
|
260
|
+
if (!args.options.bucketId && !args.options.bucketName) {
|
|
261
|
+
return 'Specify either bucketId or bucketName';
|
|
262
|
+
}
|
|
263
|
+
if (args.options.bucketId && args.options.bucketName) {
|
|
264
|
+
return 'Specify either bucketId or bucketName but not both';
|
|
265
|
+
}
|
|
266
|
+
if (args.options.startDateTime && !Utils_1.default.isValidISODateTime(args.options.startDateTime)) {
|
|
267
|
+
return 'The startDateTime is not a valid ISO date string';
|
|
268
|
+
}
|
|
269
|
+
if (args.options.dueDateTime && !Utils_1.default.isValidISODateTime(args.options.dueDateTime)) {
|
|
270
|
+
return 'The dueDateTime is not a valid ISO date string';
|
|
271
|
+
}
|
|
272
|
+
if (args.options.percentComplete && isNaN(args.options.percentComplete)) {
|
|
273
|
+
return `percentComplete is not a number`;
|
|
274
|
+
}
|
|
275
|
+
if (args.options.percentComplete && (args.options.percentComplete < 0 || args.options.percentComplete > 100)) {
|
|
276
|
+
return `percentComplete should be between 0 and 100 `;
|
|
277
|
+
}
|
|
278
|
+
if (args.options.assignedToUserIds && !Utils_1.default.isValidGuidArray(args.options.assignedToUserIds.split(','))) {
|
|
279
|
+
return 'assignedToUserIds contains invalid GUID';
|
|
280
|
+
}
|
|
281
|
+
if (args.options.assignedToUserIds && args.options.assignedToUserNames) {
|
|
282
|
+
return 'Specify either assignedToUserIds or assignedToUserNames but not both';
|
|
283
|
+
}
|
|
284
|
+
return true;
|
|
285
|
+
}
|
|
286
|
+
}
|
|
287
|
+
module.exports = new PlannerTaskAddCommand();
|
|
288
|
+
//# sourceMappingURL=task-add.js.map
|
|
@@ -59,7 +59,7 @@ class SpoSiteEnsureCommand extends SpoCommand_1.default {
|
|
|
59
59
|
if (this.debug) {
|
|
60
60
|
logger.logToStderr(err.stderr);
|
|
61
61
|
}
|
|
62
|
-
if (err.error.message !== '
|
|
62
|
+
if (err.error.message !== '404 FILE NOT FOUND') {
|
|
63
63
|
return Promise.reject(err);
|
|
64
64
|
}
|
|
65
65
|
if (this.verbose) {
|
|
@@ -13,7 +13,7 @@ class TeamsMessageGetCommand extends GraphCommand_1.default {
|
|
|
13
13
|
}
|
|
14
14
|
commandAction(logger, args, cb) {
|
|
15
15
|
const requestOptions = {
|
|
16
|
-
url: `${this.resource}/
|
|
16
|
+
url: `${this.resource}/v1.0/teams/${args.options.teamId}/channels/${args.options.channelId}/messages/${args.options.messageId}`,
|
|
17
17
|
headers: {
|
|
18
18
|
accept: 'application/json;odata.metadata=none'
|
|
19
19
|
},
|
|
@@ -11,10 +11,13 @@ m365 aad user get [options]
|
|
|
11
11
|
## Options
|
|
12
12
|
|
|
13
13
|
`-i, --id [id]`
|
|
14
|
-
: The ID of the user to retrieve information for.
|
|
14
|
+
: The ID of the user to retrieve information for. Use either `id`, `userName` or `email`, but not all.
|
|
15
15
|
|
|
16
16
|
`-n, --userName [userName]`
|
|
17
|
-
: The name of the user to retrieve information for.
|
|
17
|
+
: The name of the user to retrieve information for. Use either `id`, `userName` or `email`, but not all.
|
|
18
|
+
|
|
19
|
+
`--email [email]`
|
|
20
|
+
: The email of the user to retrieve information for. Use either `id`, `userName` or `email`, but not all.
|
|
18
21
|
|
|
19
22
|
`-p, --properties [properties]`
|
|
20
23
|
: Comma-separated list of properties to retrieve
|
|
@@ -23,9 +26,9 @@ m365 aad user get [options]
|
|
|
23
26
|
|
|
24
27
|
## Remarks
|
|
25
28
|
|
|
26
|
-
You can retrieve information about a user, either by specifying that user's id
|
|
29
|
+
You can retrieve information about a user, either by specifying that user's id, user name (`userPrincipalName`), or email (`mail`), but not all.
|
|
27
30
|
|
|
28
|
-
If the user with the specified id
|
|
31
|
+
If the user with the specified id, user name, or email doesn't exist, you will get a `Resource 'xyz' does not exist or one of its queried reference-property objects are not present.` error.
|
|
29
32
|
|
|
30
33
|
## Examples
|
|
31
34
|
|
|
@@ -41,6 +44,12 @@ Get information about the user with user name _AarifS@contoso.onmicrosoft.com_
|
|
|
41
44
|
m365 aad user get --userName AarifS@contoso.onmicrosoft.com
|
|
42
45
|
```
|
|
43
46
|
|
|
47
|
+
Get information about the user with email _AarifS@contoso.onmicrosoft.com_
|
|
48
|
+
|
|
49
|
+
```sh
|
|
50
|
+
m365 aad user get --email AarifS@contoso.onmicrosoft.com
|
|
51
|
+
```
|
|
52
|
+
|
|
44
53
|
For the user with id _1caf7dcd-7e83-4c3a-94f7-932a1299c844_ retrieve the user name, e-mail address and full name
|
|
45
54
|
|
|
46
55
|
```sh
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
# planner task add
|
|
2
|
+
|
|
3
|
+
Adds a new Microsoft Planner task
|
|
4
|
+
|
|
5
|
+
## Usage
|
|
6
|
+
|
|
7
|
+
```sh
|
|
8
|
+
m365 planner task add [options]
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
## Options
|
|
12
|
+
|
|
13
|
+
`-t, --title <title>`
|
|
14
|
+
: Title of the task to add.
|
|
15
|
+
|
|
16
|
+
`--planId [planId]`
|
|
17
|
+
: Plan ID to which the task belongs. Specify either `planId` or `planName` but not both.
|
|
18
|
+
|
|
19
|
+
`--planName [planName]`
|
|
20
|
+
: Plan Name to which the task belongs. Specify either `planId` or `planName` but not both.
|
|
21
|
+
|
|
22
|
+
`--ownerGroupId [ownerGroupId]`
|
|
23
|
+
: ID of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planName`.
|
|
24
|
+
|
|
25
|
+
`--ownerGroupName [ownerGroupName]`
|
|
26
|
+
: Name of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planName`.
|
|
27
|
+
|
|
28
|
+
`--bucketId [bucketId]`
|
|
29
|
+
: Bucket ID to which the task belongs. The bucket needs to exist in the selected plan. Specify either `bucketId` or `bucketName` but not both.
|
|
30
|
+
|
|
31
|
+
`--bucketName [bucketName]`
|
|
32
|
+
: Bucket Name to which the task belongs. The bucket needs to exist in the selected plan. Specify either `bucketId` or `bucketName` but not both.
|
|
33
|
+
|
|
34
|
+
`--startDateTime [startDateTime]`
|
|
35
|
+
: The date and time when the task started. This should be defined as a valid ISO 8601 string. `2021-12-16T18:28:48.6964197Z`
|
|
36
|
+
|
|
37
|
+
`--dueDateTime [dueDateTime]`
|
|
38
|
+
: The date and time when the task is due. This should be defined as a valid ISO 8601 string. `2021-12-16T18:28:48.6964197Z`
|
|
39
|
+
|
|
40
|
+
`--percentComplete [percentComplete]`
|
|
41
|
+
: Percentage of task completion. Number between 0 and 100.
|
|
42
|
+
- When set to 0, the task is considered _Not started_.
|
|
43
|
+
- When set between 1 and 99, the task is considered _In progress_.
|
|
44
|
+
- When set to 100, the task is considered _Completed_.
|
|
45
|
+
|
|
46
|
+
`--assignedToUserIds [assignedToUserIds]`
|
|
47
|
+
: The comma-separated IDs of the assignees the task is assigned to. Specify either `assignedToUserIds` or `assignedToUserNames` but not both.
|
|
48
|
+
|
|
49
|
+
`--assignedToUserNames [assignedToUserNames]`
|
|
50
|
+
: The comma-separated UPNs of the assignees the task is assigned to. Specify either `assignedToUserIds` or `assignedToUserNames` but not both.
|
|
51
|
+
|
|
52
|
+
`--description [description]`
|
|
53
|
+
: Description of the task
|
|
54
|
+
|
|
55
|
+
`--orderHint [orderHint]`
|
|
56
|
+
: 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).
|
|
57
|
+
|
|
58
|
+
--8<-- "docs/cmd/_global.md"
|
|
59
|
+
|
|
60
|
+
## Examples
|
|
61
|
+
|
|
62
|
+
Adds a Microsoft Planner task with the name _My Planner Task_ for plan with the ID _8QZEH7b3wkSbGQobscsM5gADCBa_ and for the bucket with the ID _IK8tuFTwQEa5vTonM7ZMRZgAKdna_
|
|
63
|
+
|
|
64
|
+
```sh
|
|
65
|
+
m365 planner task add --title "My Planner Task" --planId "8QZEH7b3wkSbGQobscsM5gADCBa" --bucketId "IK8tuFTwQEa5vTonM7ZMRZgAKdna"
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
Adds a Completed Microsoft Planner task with the name _My Planner Task_ for plan with the name _My Planner Plan_ owned by group _My Planner Group_ and for the bucket with the ID _IK8tuFTwQEa5vTonM7ZMRZgAKdna_
|
|
69
|
+
|
|
70
|
+
```sh
|
|
71
|
+
m365 planner task add --title "My Planner task" --planName "My Planner Plan" --ownerGroupName "My Planner Group" --bucketId "IK8tuFTwQEa5vTonM7ZMRZgAKdna" --percentComplete 100
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
Adds a Microsoft Planner task with the name _My Planner Task_ for plan with the ID _8QZEH7b3wkbGQobscsM5gADCBa_ and for the bucket with the ID _IK8tuFTwQEa5vTonM7ZMRZgAKdna_. The new task will be assigned to the users _Allan.Carroll@contoso.com_ and _Ida.Stevens@contoso.com_ and receive a due date for _2021-12-16_
|
|
75
|
+
|
|
76
|
+
```sh
|
|
77
|
+
m365 planner task add --title "My Planner Task" --planId "8QZEH7b3wkSbGQobscsM5gADCBa" --bucketId "IK8tuFTwQEa5vTonM7ZMRZgAKdna" --assignedToUserNames "Allan.Carroll@contoso.com,Ida.Stevens@contoso.com" --dueDateTime "2021-12-16"
|
|
78
|
+
```
|
|
@@ -23,9 +23,6 @@ m365 teams message get [options]
|
|
|
23
23
|
|
|
24
24
|
## Remarks
|
|
25
25
|
|
|
26
|
-
!!! attention
|
|
27
|
-
This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
|
|
28
|
-
|
|
29
26
|
You can only retrieve a message from a Microsoft Teams team if you are a member of that team.
|
|
30
27
|
|
|
31
28
|
## Examples
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@pnp/cli-microsoft365",
|
|
3
|
-
"version": "4.3.0-beta.
|
|
3
|
+
"version": "4.3.0-beta.fa07425",
|
|
4
4
|
"description": "Manage Microsoft 365 and SharePoint Framework projects on any platform",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"main": "./dist/index.js",
|
|
@@ -164,6 +164,7 @@
|
|
|
164
164
|
"van Iersel, Cas <cvaniersel@portiva.nl>",
|
|
165
165
|
"van Rousselt, Rick <rick.vanrousselt@outlook.com>",
|
|
166
166
|
"Velliah, Joseph <joseph@sprider.org>",
|
|
167
|
+
"Waegebaert, Jasey <jaseyw@gmigroup.be>",
|
|
167
168
|
"Wilen, Wictor <wictor@wictorwilen.se>",
|
|
168
169
|
"Williams, Rabia <rabiawilliams@gmail.com>",
|
|
169
170
|
"Wojcik, Adam <adam.wojcik.it@gmail.com>"
|