@pnp/cli-microsoft365 6.0.0-beta.8352f49 → 6.0.0-beta.fe4e66d

package/dist/m365/planner/commands/plan/plan-add.js

@@ -1,11 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-const utils_1 = require("../../../../utils");
 const Auth_1 = require("../../../../Auth");
 const request_1 = require("../../../../request");
+const utils_1 = require("../../../../utils");
 const GraphCommand_1 = require("../../../base/GraphCommand");
 const commands_1 = require("../../commands");
-const aadGroup_1 = require("../../../../utils/aadGroup");
 class PlannerPlanAddCommand extends GraphCommand_1.default {
     get name() {
         return commands_1.default.PLAN_ADD;
@@ -17,6 +16,8 @@ class PlannerPlanAddCommand extends GraphCommand_1.default {
         const telemetryProps = super.getTelemetryProperties(args);
         telemetryProps.ownerGroupId = typeof args.options.ownerGroupId !== 'undefined';
         telemetryProps.ownerGroupName = typeof args.options.ownerGroupName !== 'undefined';
+        telemetryProps.shareWithUserIds = typeof args.options.shareWithUserIds !== 'undefined';
+        telemetryProps.shareWithUserNames = typeof args.options.shareWithUserNames !== 'undefined';
         return telemetryProps;
     }
     defaultProperties() {
@@ -43,16 +44,96 @@ class PlannerPlanAddCommand extends GraphCommand_1.default {
             };
             return request_1.default.post(requestOptions);
         })
+            .then(newPlan => this.updatePlanDetails(args.options, newPlan))
             .then((res) => {
             logger.log(res);
             cb();
         }, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
     }
+    updatePlanDetails(options, newPlan) {
+        const planId = newPlan.id;
+        if (!options.shareWithUserIds && !options.shareWithUserNames) {
+            return Promise.resolve(newPlan);
+        }
+        return Promise
+            .all([this.generateSharedWith(options), this.getPlanDetailsEtag(planId)])
+            .then(resArray => {
+            const sharedWith = resArray[0];
+            const etag = resArray[1];
+            const requestOptionsPlanDetails = {
+                url: `${this.resource}/v1.0/planner/plans/${planId}/details`,
+                headers: {
+                    'accept': 'application/json;odata.metadata=none',
+                    'If-Match': etag,
+                    'Prefer': 'return=representation'
+                },
+                responseType: 'json',
+                data: {
+                    sharedWith: sharedWith
+                }
+            };
+            return request_1.default.patch(requestOptionsPlanDetails);
+        })
+            .then(planDetails => {
+            return Object.assign(Object.assign({}, newPlan), planDetails);
+        });
+    }
+    getPlanDetailsEtag(planId) {
+        const requestOptions = {
+            url: `${this.resource}/v1.0/planner/plans/${planId}/details`,
+            headers: {
+                accept: 'application/json'
+            },
+            responseType: 'json'
+        };
+        return request_1.default
+            .get(requestOptions)
+            .then((response) => response['@odata.etag']);
+    }
+    generateSharedWith(options) {
+        const sharedWith = {};
+        return this
+            .getUserIds(options)
+            .then((userIds) => {
+            userIds.map(x => sharedWith[x] = true);
+            return Promise.resolve(sharedWith);
+        });
+    }
+    getUserIds(options) {
+        if (options.shareWithUserIds) {
+            return Promise.resolve(options.shareWithUserIds.split(','));
+        }
+        // Hitting this section means assignedToUserNames won't be undefined
+        const userNames = options.shareWithUserNames;
+        const userArr = userNames.split(',').map(o => o.trim());
+        const promises = userArr.map(user => {
+            const requestOptions = {
+                url: `${this.resource}/v1.0/users?$filter=userPrincipalName eq '${utils_1.formatting.encodeQueryParameter(user)}'&$select=id,userPrincipalName`,
+                headers: {
+                    'content-type': 'application/json'
+                },
+                responseType: 'json'
+            };
+            return request_1.default.get(requestOptions);
+        });
+        return Promise
+            .all(promises)
+            .then((usersRes) => {
+            const userUpns = usersRes.map(res => { var _a; return (_a = res.value[0]) === null || _a === void 0 ? void 0 : _a.userPrincipalName; });
+            const userIds = usersRes.map(res => { var _a; return (_a = res.value[0]) === null || _a === void 0 ? void 0 : _a.id; });
+            // Find the members where no graph response was found
+            const invalidUsers = userArr.filter(user => !userUpns.some((upn) => (upn === null || upn === void 0 ? void 0 : upn.toLowerCase()) === user.toLowerCase()));
+            if (invalidUsers && invalidUsers.length > 0) {
+                return Promise.reject(`Cannot proceed with planner plan creation. The following users provided are invalid : ${invalidUsers.join(',')}`);
+            }
+            return Promise.resolve(userIds);
+        });
+    }
     getGroupId(args) {
         if (args.options.ownerGroupId) {
             return Promise.resolve(args.options.ownerGroupId);
         }
-        return aadGroup_1.aadGroup
+        return utils_1.aadGroup
             .getGroupByDisplayName(args.options.ownerGroupName)
             .then(group => group.id);
     }
@@ -62,10 +143,16 @@ class PlannerPlanAddCommand extends GraphCommand_1.default {
                 option: '-t, --title <title>'
             },
             {
-                option: "--ownerGroupId [ownerGroupId]"
+                option: '--ownerGroupId [ownerGroupId]'
             },
             {
-                option: "--ownerGroupName [ownerGroupName]"
+                option: '--ownerGroupName [ownerGroupName]'
+            },
+            {
+                option: '--shareWithUserIds [shareWithUserIds]'
+            },
+            {
+                option: '--shareWithUserNames [shareWithUserNames]'
             }
         ];
         const parentOptions = super.options();
@@ -81,6 +168,12 @@ class PlannerPlanAddCommand extends GraphCommand_1.default {
         if (args.options.ownerGroupId && !utils_1.validation.isValidGuid(args.options.ownerGroupId)) {
             return `${args.options.ownerGroupId} is not a valid GUID`;
         }
+        if (args.options.shareWithUserIds && args.options.shareWithUserNames) {
+            return 'Specify either shareWithUserIds or shareWithUserNames but not both';
+        }
+        if (args.options.shareWithUserIds && !utils_1.validation.isValidGuidArray(args.options.shareWithUserIds.split(','))) {
+            return 'shareWithUserIds contains invalid GUID';
+        }
         return true;
     }
 }

package/dist/m365/planner/commands/plan/plan-get.js

@@ -54,7 +54,7 @@ class PlannerPlanGetCommand extends GraphCommand_1.default {
         else {
             this
                 .getGroupId(args)
-                .then(groupId => planner_1.planner.getPlanByName(args.options.title, groupId))
+                .then(groupId => planner_1.planner.getPlanByTitle(args.options.title, groupId))
                 .then(plan => this.getPlanDetails(plan))
                 .then((res) => {
                 if (res) {

package/dist/m365/planner/commands/plan/plan-remove.js

@@ -82,7 +82,7 @@ class PlannerPlanRemoveCommand extends GraphCommand_1.default {
                 return planner_1.planner.getPlanById(id, 'minimal');
             }
             const groupId = yield this.getGroupId(args);
-            return yield planner_1.planner.getPlanByName(title, groupId);
+            return yield planner_1.planner.getPlanByTitle(title, groupId);
         });
     }
     getGroupId(args) {

package/dist/m365/planner/commands/task/task-add.js

@@ -24,6 +24,7 @@ class PlannerTaskAddCommand extends GraphCommand_1.default {
         const telemetryProps = super.getTelemetryProperties(args);
         telemetryProps.planId = typeof args.options.planId !== 'undefined';
         telemetryProps.planName = typeof args.options.planName !== 'undefined';
+        telemetryProps.planTitle = typeof args.options.planTitle !== 'undefined';
         telemetryProps.ownerGroupId = typeof args.options.ownerGroupId !== 'undefined';
         telemetryProps.ownerGroupName = typeof args.options.ownerGroupName !== 'undefined';
         telemetryProps.bucketId = typeof args.options.bucketId !== 'undefined';
@@ -42,6 +43,10 @@ class PlannerTaskAddCommand extends GraphCommand_1.default {
         return telemetryProps;
     }
     commandAction(logger, args, cb) {
+        if (args.options.planName) {
+            args.options.planTitle = args.options.planName;
+            this.warn(logger, `Option 'planName' is deprecated. Please use 'planTitle' instead`);
+        }
         if (utils_1.accessToken.isAppOnlyAccessToken(Auth_1.default.service.accessTokens[this.resource].accessToken)) {
             this.handleError('This command does not support application permissions.', logger, cb);
             return;
@@ -96,13 +101,7 @@ class PlannerTaskAddCommand extends GraphCommand_1.default {
         };
         return request_1.default
             .get(requestOptions)
-            .then((response) => {
-            const etag = response ? response['@odata.etag'] : undefined;
-            if (!etag) {
-                return Promise.reject(`Error fetching task details`);
-            }
-            return Promise.resolve(etag);
-        });
+            .then((response) => response['@odata.etag']);
     }
     generateAppliedCategories(options) {
         if (!options.appliedCategories) {
@@ -181,7 +180,7 @@ class PlannerTaskAddCommand extends GraphCommand_1.default {
         }
         return this
             .getGroupId(args)
-            .then((groupId) => planner_1.planner.getPlanByName(args.options.planName, groupId))
+            .then((groupId) => planner_1.planner.getPlanByTitle(args.options.planTitle, groupId))
             .then(plan => plan.id);
     }
     getGroupId(args) {
@@ -229,6 +228,7 @@ class PlannerTaskAddCommand extends GraphCommand_1.default {
             { option: '-t, --title <title>' },
             { option: '--planId [planId]' },
             { option: '--planName [planName]' },
+            { option: '--planTitle [planTitle]' },
             { option: '--ownerGroupId [ownerGroupId]' },
             { option: '--ownerGroupName [ownerGroupName]' },
             { option: '--bucketId [bucketId]' },
@@ -255,17 +255,17 @@ class PlannerTaskAddCommand extends GraphCommand_1.default {
         return options.concat(parentOptions);
     }
     validate(args) {
-        if (!args.options.planId && !args.options.planName) {
-            return 'Specify either planId or planName';
+        if (!args.options.planId && !args.options.planName && !args.options.planTitle) {
+            return 'Specify either planId or planTitle';
         }
-        if (args.options.planId && args.options.planName) {
-            return 'Specify either planId or planName but not both';
+        if (args.options.planId && (args.options.planName || args.options.planTitle)) {
+            return 'Specify either planId or planTitle but not both';
         }
-        if (args.options.planName && !args.options.ownerGroupId && !args.options.ownerGroupName) {
-            return 'Specify either ownerGroupId or ownerGroupName when using planName';
+        if ((args.options.planName || args.options.planTitle) && !args.options.ownerGroupId && !args.options.ownerGroupName) {
+            return 'Specify either ownerGroupId or ownerGroupName when using planTitle';
         }
-        if (args.options.planName && args.options.ownerGroupId && args.options.ownerGroupName) {
-            return 'Specify either ownerGroupId or ownerGroupName when using planName but not both';
+        if ((args.options.planName || args.options.planTitle) && args.options.ownerGroupId && args.options.ownerGroupName) {
+            return 'Specify either ownerGroupId or ownerGroupName when using planTitle but not both';
         }
         if (args.options.ownerGroupId && !utils_1.validation.isValidGuid(args.options.ownerGroupId)) {
             return `${args.options.ownerGroupId} is not a valid GUID`;

package/dist/m365/planner/commands/task/task-get.js

@@ -31,6 +31,10 @@ class PlannerTaskGetCommand extends GraphCommand_1.default {
     }
     commandAction(logger, args, cb) {
         this.showDeprecationWarning(logger, commands_1.default.TASK_DETAILS_GET, commands_1.default.TASK_GET);
+        if (args.options.planName) {
+            args.options.planTitle = args.options.planName;
+            this.warn(logger, `Option 'planName' is deprecated. Please use 'planTitle' instead`);
+        }
         if (utils_1.accessToken.isAppOnlyAccessToken(Auth_1.default.service.accessTokens[this.resource].accessToken)) {
             this.handleError('This command does not support application permissions.', logger, cb);
             return;
@@ -135,7 +139,7 @@ class PlannerTaskGetCommand extends GraphCommand_1.default {
         }
         return this
             .getGroupId(options)
-            .then(groupId => planner_1.planner.getPlanByName(options.planName, groupId))
+            .then(groupId => planner_1.planner.getPlanByTitle(options.planTitle, groupId))
             .then(plan => plan.id);
     }
     getGroupId(options) {
@@ -160,6 +164,7 @@ class PlannerTaskGetCommand extends GraphCommand_1.default {
             { option: '--bucketName [bucketName]' },
             { option: '--planId [planId]' },
             { option: '--planName [planName]' },
+            { option: '--planTitle [planTitle]' },
             { option: '--ownerGroupId [ownerGroupId]' },
             { option: '--ownerGroupName [ownerGroupName]' }
         ];
@@ -173,17 +178,17 @@ class PlannerTaskGetCommand extends GraphCommand_1.default {
         if (args.options.title && args.options.bucketId && args.options.bucketName) {
             return 'Specify either bucketId or bucketName when using title but not both';
         }
-        if (args.options.bucketName && !args.options.planId && !args.options.planName) {
-            return 'Specify either planId or planName when using bucketName';
+        if (args.options.bucketName && !args.options.planId && !args.options.planName && !args.options.planTitle) {
+            return 'Specify either planId or planTitle when using bucketName';
         }
-        if (args.options.bucketName && args.options.planId && args.options.planName) {
-            return 'Specify either planId or planName when using bucketName but not both';
+        if (args.options.bucketName && args.options.planId && (args.options.planName || args.options.planTitle)) {
+            return 'Specify either planId or planTitle when using bucketName but not both';
         }
-        if (args.options.planName && !args.options.ownerGroupId && !args.options.ownerGroupName) {
-            return 'Specify either ownerGroupId or ownerGroupName when using planName';
+        if ((args.options.planName || args.options.planTitle) && !args.options.ownerGroupId && !args.options.ownerGroupName) {
+            return 'Specify either ownerGroupId or ownerGroupName when using planTitle';
         }
-        if (args.options.planName && args.options.ownerGroupId && args.options.ownerGroupName) {
-            return 'Specify either ownerGroupId or ownerGroupName when using planName but not both';
+        if ((args.options.planName || args.options.planTitle) && args.options.ownerGroupId && args.options.ownerGroupName) {
+            return 'Specify either ownerGroupId or ownerGroupName when using planTitle but not both';
         }
         if (args.options.ownerGroupId && !utils_1.validation.isValidGuid(args.options.ownerGroupId)) {
             return `${args.options.ownerGroupId} is not a valid GUID`;

package/dist/m365/planner/commands/task/task-list.js

@@ -20,6 +20,7 @@ class PlannerTaskListCommand extends GraphCommand_1.default {
         telemetryProps.bucketName = typeof args.options.bucketName !== 'undefined';
         telemetryProps.planId = typeof args.options.planId !== 'undefined';
         telemetryProps.planName = typeof args.options.planName !== 'undefined';
+        telemetryProps.planTitle = typeof args.options.planTitle !== 'undefined';
         telemetryProps.ownerGroupId = typeof args.options.ownerGroupId !== 'undefined';
         telemetryProps.ownerGroupName = typeof args.options.ownerGroupName !== 'undefined';
         return telemetryProps;
@@ -28,13 +29,17 @@ class PlannerTaskListCommand extends GraphCommand_1.default {
         return ['id', 'title', 'startDateTime', 'dueDateTime', 'completedDateTime'];
     }
     commandAction(logger, args, cb) {
+        if (args.options.planName) {
+            args.options.planTitle = args.options.planName;
+            this.warn(logger, `Option 'planName' is deprecated. Please use 'planTitle' instead`);
+        }
         if (utils_1.accessToken.isAppOnlyAccessToken(Auth_1.default.service.accessTokens[this.resource].accessToken)) {
             this.handleError('This command does not support application permissions.', logger, cb);
             return;
         }
         const bucketName = args.options.bucketName;
         let bucketId = args.options.bucketId;
-        const planName = args.options.planName;
+        const planTitle = args.options.planTitle;
         let planId = args.options.planId;
         let taskItems = [];
         if (bucketId || bucketName) {
@@ -53,7 +58,7 @@ class PlannerTaskListCommand extends GraphCommand_1.default {
                 cb();
             }, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
         }
-        else if (planId || planName) {
+        else if (planId || planTitle) {
             this
                 .getPlanId(args)
                 .then((retrievedPlanId) => {
@@ -112,7 +117,7 @@ class PlannerTaskListCommand extends GraphCommand_1.default {
         }
         return this
             .getGroupId(args)
-            .then((groupId) => planner_1.planner.getPlanByName(args.options.planName, groupId))
+            .then((groupId) => planner_1.planner.getPlanByTitle(args.options.planTitle, groupId))
             .then(plan => plan.id);
     }
     getGroupId(args) {
@@ -148,6 +153,9 @@ class PlannerTaskListCommand extends GraphCommand_1.default {
             {
                 option: '--planName [planName]'
             },
+            {
+                option: '--planTitle [planTitle]'
+            },
             {
                 option: '--ownerGroupId [ownerGroupId]'
             },
@@ -162,17 +170,17 @@ class PlannerTaskListCommand extends GraphCommand_1.default {
         if (args.options.bucketId && args.options.bucketName) {
             return 'To retrieve tasks from a bucket, specify bucketId or bucketName, but not both';
         }
-        if (args.options.bucketName && !args.options.planId && !args.options.planName) {
-            return 'Specify either planId or planName when using bucketName';
+        if (args.options.bucketName && !args.options.planId && !args.options.planName && !args.options.planTitle) {
+            return 'Specify either planId or planTitle when using bucketName';
         }
-        if (args.options.planId && args.options.planName) {
-            return 'Specify either planId or planName but not both';
+        if (args.options.planId && (args.options.planName || args.options.planTitle)) {
+            return 'Specify either planId or planTitle but not both';
         }
-        if (args.options.planName && !args.options.ownerGroupId && !args.options.ownerGroupName) {
-            return 'Specify either ownerGroupId or ownerGroupName when using planName';
+        if ((args.options.planName || args.options.planTitle) && !args.options.ownerGroupId && !args.options.ownerGroupName) {
+            return 'Specify either ownerGroupId or ownerGroupName when using planTitle';
         }
-        if (args.options.planName && args.options.ownerGroupId && args.options.ownerGroupName) {
-            return 'Specify either ownerGroupId or ownerGroupName when using planName but not both';
+        if ((args.options.planName || args.options.planTitle) && args.options.ownerGroupId && args.options.ownerGroupName) {
+            return 'Specify either ownerGroupId or ownerGroupName when using planTitle but not both';
         }
         if (args.options.ownerGroupId && !utils_1.validation.isValidGuid(args.options.ownerGroupId)) {
             return `${args.options.ownerGroupId} is not a valid GUID`;

package/dist/m365/planner/commands/task/task-reference-add.js

@@ -46,13 +46,7 @@ class PlannerTaskReferenceAddCommand extends GraphCommand_1.default {
         };
         return request_1.default
             .get(requestOptions)
-            .then((response) => {
-            const etag = response ? response['@odata.etag'] : undefined;
-            if (!etag) {
-                return Promise.reject(`Error fetching task details`);
-            }
-            return Promise.resolve(etag);
-        });
+            .then((response) => response['@odata.etag']);
     }
     options() {
         const options = [

package/dist/m365/planner/commands/task/task-reference-remove.js

@@ -74,21 +74,18 @@ class PlannerTaskReferenceRemoveCommand extends GraphCommand_1.default {
         let url = options.url;
         return request_1.default
             .get(requestOptions)
-            .then((response) => {
-            const etag = response ? response['@odata.etag'] : undefined;
-            if (!etag) {
-                return Promise.reject(`Error fetching task details`);
-            }
+            .then((taskDetails) => {
             if (options.alias) {
-                const alias = options.alias;
                 const urls = [];
-                Object.entries(response.references).forEach((ref) => {
-                    var _a;
-                    if (((_a = ref[1].alias) === null || _a === void 0 ? void 0 : _a.toLocaleLowerCase()) === alias.toLocaleLowerCase()) {
-                        urls.push(decodeURIComponent(ref[0]));
-                    }
-                });
-                if (!urls.length) {
+                if (taskDetails.references) {
+                    Object.entries(taskDetails.references).forEach((ref) => {
+                        var _a;
+                        if (((_a = ref[1].alias) === null || _a === void 0 ? void 0 : _a.toLocaleLowerCase()) === options.alias.toLocaleLowerCase()) {
+                            urls.push(decodeURIComponent(ref[0]));
+                        }
+                    });
+                }
+                if (urls.length === 0) {
                     return Promise.reject(`The specified reference with alias ${options.alias} does not exist`);
                 }
                 if (urls.length > 1) {
@@ -96,7 +93,7 @@ class PlannerTaskReferenceRemoveCommand extends GraphCommand_1.default {
                 }
                 url = urls[0];
             }
-            return Promise.resolve({ etag, url });
+            return Promise.resolve({ etag: taskDetails['@odata.etag'], url });
         });
     }
     options() {

package/dist/m365/planner/commands/task/task-remove.js

@@ -114,7 +114,7 @@ class PlannerTaskRemoveCommand extends GraphCommand_1.default {
         }
         return this
             .getGroupId(options)
-            .then(groupId => planner_1.planner.getPlanByName(planTitle, groupId))
+            .then(groupId => planner_1.planner.getPlanByTitle(planTitle, groupId))
             .then(plan => plan.id);
     }
     getGroupId(options) {
@@ -122,24 +122,9 @@ class PlannerTaskRemoveCommand extends GraphCommand_1.default {
         if (ownerGroupId) {
             return Promise.resolve(ownerGroupId);
         }
-        const requestOptions = {
-            url: `${this.resource}/v1.0/groups?$filter=displayName eq '${encodeURIComponent(ownerGroupName)}'`,
-            headers: {
-                accept: 'application/json;odata.metadata=none'
-            },
-            responseType: 'json'
-        };
-        return request_1.default
-            .get(requestOptions)
-            .then(response => {
-            if (response.value.length === 0) {
-                return Promise.reject(`The specified owner group ${ownerGroupName} does not exist`);
-            }
-            if (response.value.length > 1) {
-                return Promise.reject(`Multiple owner groups with name ${ownerGroupName} found: ${response.value.map(x => x.id)}`);
-            }
-            return Promise.resolve(response.value[0].id);
-        });
+        return utils_1.aadGroup
+            .getGroupByDisplayName(ownerGroupName)
+            .then(group => group.id);
     }
     options() {
         const options = [

package/dist/m365/planner/commands/task/task-set.js

@@ -24,6 +24,7 @@ class PlannerTaskSetCommand extends GraphCommand_1.default {
         telemetryProps.title = typeof args.options.title !== 'undefined';
         telemetryProps.planId = typeof args.options.planId !== 'undefined';
         telemetryProps.planName = typeof args.options.planName !== 'undefined';
+        telemetryProps.planTitle = typeof args.options.planTitle !== 'undefined';
         telemetryProps.ownerGroupId = typeof args.options.ownerGroupId !== 'undefined';
         telemetryProps.ownerGroupName = typeof args.options.ownerGroupName !== 'undefined';
         telemetryProps.bucketId = typeof args.options.bucketId !== 'undefined';
@@ -41,6 +42,10 @@ class PlannerTaskSetCommand extends GraphCommand_1.default {
         return telemetryProps;
     }
     commandAction(logger, args, cb) {
+        if (args.options.planName) {
+            args.options.planTitle = args.options.planName;
+            this.warn(logger, `Option 'planName' is deprecated. Please use 'planTitle' instead`);
+        }
         if (utils_1.accessToken.isAppOnlyAccessToken(Auth_1.default.service.accessTokens[this.resource].accessToken)) {
             this.handleError('This command does not support application permissions.', logger, cb);
             return;
@@ -112,13 +117,7 @@ class PlannerTaskSetCommand extends GraphCommand_1.default {
         };
         return request_1.default
             .get(requestOptions)
-            .then((response) => {
-            const etag = response ? response['@odata.etag'] : undefined;
-            if (!etag) {
-                return Promise.reject(`Error fetching task details`);
-            }
-            return Promise.resolve(etag);
-        });
+            .then((response) => response['@odata.etag']);
     }
     getTaskEtag(taskId) {
         const requestOptions = {
@@ -130,13 +129,7 @@ class PlannerTaskSetCommand extends GraphCommand_1.default {
         };
         return request_1.default
             .get(requestOptions)
-            .then((response) => {
-            const etag = response ? response['@odata.etag'] : undefined;
-            if (!etag) {
-                return Promise.reject(`Error fetching task`);
-            }
-            return Promise.resolve(etag);
-        });
+            .then((response) => response['@odata.etag']);
     }
     generateAppliedCategories(options) {
         if (!options.appliedCategories) {
@@ -226,7 +219,7 @@ class PlannerTaskSetCommand extends GraphCommand_1.default {
         }
         return this
             .getGroupId(options)
-            .then((groupId) => planner_1.planner.getPlanByName(options.planName, groupId))
+            .then((groupId) => planner_1.planner.getPlanByTitle(options.planTitle, groupId))
             .then(plan => plan.id);
     }
     getGroupId(options) {
@@ -277,6 +270,7 @@ class PlannerTaskSetCommand extends GraphCommand_1.default {
             { option: '-t, --title [title]' },
             { option: '--planId [planId]' },
             { option: '--planName [planName]' },
+            { option: '--planTitle [planTitle]' },
             { option: '--ownerGroupId [ownerGroupId]' },
             { option: '--ownerGroupName [ownerGroupName]' },
             { option: '--bucketId [bucketId]' },
@@ -299,17 +293,17 @@ class PlannerTaskSetCommand extends GraphCommand_1.default {
         if (args.options.bucketId && args.options.bucketName) {
             return 'Specify either bucketId or bucketName but not both';
         }
-        if (args.options.bucketName && !args.options.planId && !args.options.planName) {
-            return 'Specify either planId or planName when using bucketName';
+        if (args.options.bucketName && !args.options.planId && !args.options.planName && !args.options.planTitle) {
+            return 'Specify either planId or planTitle when using bucketName';
         }
-        if (args.options.bucketName && args.options.planId && args.options.planName) {
-            return 'Specify either planId or planName when using bucketName but not both';
+        if (args.options.bucketName && args.options.planId && (args.options.planName || args.options.planTitle)) {
+            return 'Specify either planId or planTitle when using bucketName but not both';
         }
-        if (args.options.planName && !args.options.ownerGroupId && !args.options.ownerGroupName) {
-            return 'Specify either ownerGroupId or ownerGroupName when using planName';
+        if ((args.options.planName || args.options.planTitle) && !args.options.ownerGroupId && !args.options.ownerGroupName) {
+            return 'Specify either ownerGroupId or ownerGroupName when using planTitle';
         }
-        if (args.options.planName && args.options.ownerGroupId && args.options.ownerGroupName) {
-            return 'Specify either ownerGroupId or ownerGroupName when using planName but not both';
+        if ((args.options.planName || args.options.planTitle) && args.options.ownerGroupId && args.options.ownerGroupName) {
+            return 'Specify either ownerGroupId or ownerGroupName when using planTitle but not both';
         }
         if (args.options.ownerGroupId && !utils_1.validation.isValidGuid(args.options.ownerGroupId)) {
             return `${args.options.ownerGroupId} is not a valid GUID`;

package/dist/m365/search/commands/externalconnection/externalconnection-get.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const request_1 = require("../../../../request");
+const GraphCommand_1 = require("../../../base/GraphCommand");
+const commands_1 = require("../../commands");
+class SearchExternalConnectionGetCommand extends GraphCommand_1.default {
+    get name() {
+        return commands_1.default.EXTERNALCONNECTION_GET;
+    }
+    get description() {
+        return 'Get a specific external connection for use in Microsoft Search';
+    }
+    getTelemetryProperties(args) {
+        const telemetryProps = super.getTelemetryProperties(args);
+        telemetryProps.id = typeof args.options.id !== 'undefined';
+        telemetryProps.name = typeof args.options.name !== 'undefined';
+        return telemetryProps;
+    }
+    commandAction(logger, args, cb) {
+        let url = `${this.resource}/v1.0/external/connections`;
+        if (args.options.id) {
+            url += `/${encodeURIComponent(args.options.id)}`;
+        }
+        else {
+            url += `?$filter=name eq '${encodeURIComponent(args.options.name)}'`;
+        }
+        const requestOptions = {
+            url: url,
+            headers: {
+                accept: 'application/json;odata.metadata=none'
+            },
+            responseType: 'json'
+        };
+        request_1.default
+            .get(requestOptions)
+            .then((res) => {
+            if (args.options.name) {
+                if (res.value.length === 0) {
+                    return Promise.reject(`External connection with name '${args.options.name}' not found`);
+                }
+                res = res.value[0];
+            }
+            return Promise.resolve(res);
+        })
+            .then(res => {
+            logger.log(res);
+            cb();
+        }, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
+    }
+    optionSets() {
+        return [
+            ['id', 'name']
+        ];
+    }
+    options() {
+        const options = [
+            {
+                option: '-i, --id [id]'
+            },
+            {
+                option: '-n, --name [name]'
+            }
+        ];
+        const parentOptions = super.options();
+        return options.concat(parentOptions);
+    }
+}
+module.exports = new SearchExternalConnectionGetCommand();
+//# sourceMappingURL=externalconnection-get.js.map

package/dist/m365/search/commands.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const prefix = 'search';
 exports.default = {
     EXTERNALCONNECTION_ADD: `${prefix} externalconnection add`,
+    EXTERNALCONNECTION_GET: `${prefix} externalconnection get`,
     EXTERNALCONNECTION_LIST: `${prefix} externalconnection list`
 };
 //# sourceMappingURL=commands.js.map