@pnp/cli-microsoft365 5.0.0-beta.d025005 → 5.0.0-beta.d17a15f

package/dist/Command.js

@@ -113,7 +113,7 @@ class Command {
             },
             {
                 option: '-o, --output [output]',
-                autocomplete: ['json', 'text']
+                autocomplete: ['csv', 'json', 'text']
             },
             {
                 option: '--verbose'

package/dist/m365/aad/commands/app/app-delete.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const cli_1 = require("../../../../cli");
+const request_1 = require("../../../../request");
+const Utils_1 = require("../../../../Utils");
+const GraphCommand_1 = require("../../../base/GraphCommand");
+const commands_1 = require("../../commands");
+class AadAppDeleteCommand extends GraphCommand_1.default {
+    get name() {
+        return commands_1.default.APP_DELETE;
+    }
+    get description() {
+        return 'Removes an Azure AD app registration';
+    }
+    getTelemetryProperties(args) {
+        const telemetryProps = super.getTelemetryProperties(args);
+        telemetryProps.appId = typeof args.options.appId !== 'undefined';
+        telemetryProps.objectId = typeof args.options.objectId !== 'undefined';
+        telemetryProps.name = typeof args.options.name !== 'undefined';
+        telemetryProps.confirm = (!(!args.options.confirm)).toString();
+        return telemetryProps;
+    }
+    commandAction(logger, args, cb) {
+        const deleteApp = () => {
+            this
+                .getObjectId(args, logger)
+                .then((objectId) => {
+                if (this.verbose) {
+                    logger.logToStderr(`Deleting Azure AD app ${objectId}...`);
+                }
+                const requestOptions = {
+                    url: `${this.resource}/v1.0/myorganization/applications/${objectId}`,
+                    headers: {
+                        accept: 'application/json;odata.metadata=none'
+                    },
+                    responseType: 'json'
+                };
+                return request_1.default.delete(requestOptions);
+            })
+                .then(_ => cb(), (rawRes) => this.handleRejectedODataJsonPromise(rawRes, logger, cb));
+        };
+        if (args.options.confirm) {
+            deleteApp();
+        }
+        else {
+            cli_1.Cli.prompt({
+                type: 'confirm',
+                name: 'continue',
+                default: false,
+                message: `Are you sure you want to delete the App?`
+            }, (result) => {
+                if (!result.continue) {
+                    cb();
+                }
+                else {
+                    deleteApp();
+                }
+            });
+        }
+    }
+    getObjectId(args, logger) {
+        if (args.options.objectId) {
+            return Promise.resolve(args.options.objectId);
+        }
+        const { appId, name } = args.options;
+        if (this.verbose) {
+            logger.logToStderr(`Retrieving information about Azure AD app ${appId ? appId : name}...`);
+        }
+        const filter = appId ?
+            `appId eq '${encodeURIComponent(appId)}'` :
+            `displayName eq '${encodeURIComponent(name)}'`;
+        const requestOptions = {
+            url: `${this.resource}/v1.0/myorganization/applications?$filter=${filter}&$select=id`,
+            headers: {
+                accept: 'application/json;odata.metadata=none'
+            },
+            responseType: 'json'
+        };
+        return request_1.default
+            .get(requestOptions)
+            .then((res) => {
+            if (res.value.length === 1) {
+                return Promise.resolve(res.value[0].id);
+            }
+            if (res.value.length === 0) {
+                const applicationIdentifier = appId ? `ID ${appId}` : `name ${name}`;
+                return Promise.reject(`No Azure AD application registration with ${applicationIdentifier} found`);
+            }
+            return Promise.reject(`Multiple Azure AD application registration with name ${name} found. Please choose one of the object IDs: ${res.value.map(a => a.id).join(', ')}`);
+        });
+    }
+    options() {
+        const options = [
+            { option: '--appId [appId]' },
+            { option: '--objectId [objectId]' },
+            { option: '--name [name]' },
+            { option: '--confirm' }
+        ];
+        const parentOptions = super.options();
+        return options.concat(parentOptions);
+    }
+    validate(args) {
+        if (!args.options.appId &&
+            !args.options.objectId &&
+            !args.options.name) {
+            return 'Specify either appId, objectId, or name';
+        }
+        if ((args.options.appId && args.options.objectId) ||
+            (args.options.appId && args.options.name) ||
+            (args.options.objectId && args.options.name)) {
+            return 'Specify either appId, objectId, or name';
+        }
+        if (args.options.appId && !Utils_1.default.isValidGuid(args.options.appId)) {
+            return `${args.options.appId} is not a valid GUID`;
+        }
+        if (args.options.objectId && !Utils_1.default.isValidGuid(args.options.objectId)) {
+            return `${args.options.objectId} is not a valid GUID`;
+        }
+        return true;
+    }
+}
+module.exports = new AadAppDeleteCommand();
+//# sourceMappingURL=app-delete.js.map

package/dist/m365/aad/commands/group/group-list.js

@@ -9,12 +9,18 @@ class AadGroupListCommand extends GraphItemsListCommand_1.GraphItemsListCommand
     get description() {
         return 'Lists all groups defined in Azure Active Directory.';
     }
+    getTelemetryProperties(args) {
+        const telemetryProps = super.getTelemetryProperties(args);
+        telemetryProps.deleted = args.options.deleted;
+        return telemetryProps;
+    }
     defaultProperties() {
         return ['id', 'displayName', 'groupType'];
     }
     commandAction(logger, args, cb) {
+        const endpoint = args.options.deleted ? 'directory/deletedItems/microsoft.graph.group' : 'groups';
         this
-            .getAllItems(`${this.resource}/v1.0/groups`, logger, true)
+            .getAllItems(`${this.resource}/v1.0/${endpoint}`, logger, true)
             .then(() => {
             if (args.options.output === 'text') {
                 this.items.forEach((group) => {
@@ -36,6 +42,13 @@ class AadGroupListCommand extends GraphItemsListCommand_1.GraphItemsListCommand
             cb();
         }, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
     }
+    options() {
+        const options = [
+            { option: '-d, --deleted' }
+        ];
+        const parentOptions = super.options();
+        return options.concat(parentOptions);
+    }
 }
 module.exports = new AadGroupListCommand();
 //# sourceMappingURL=group-list.js.map

package/dist/m365/aad/commands.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const prefix = 'aad';
 exports.default = {
     APP_ADD: `${prefix} app add`,
+    APP_DELETE: `${prefix} app delete`,
     APP_GET: `${prefix} app get`,
     APP_SET: `${prefix} app set`,
     APP_ROLE_ADD: `${prefix} app role add`,

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

@@ -12,7 +12,7 @@ class PlannerTaskGetCommand extends GraphCommand_1.default {
     }
     commandAction(logger, args, cb) {
         const requestOptions = {
-            url: `${this.resource}/v1.0/planner/tasks/${encodeURIComponent(args.options.id)}`,
+            url: `${this.resource}/beta/planner/tasks/${encodeURIComponent(args.options.id)}`,
             headers: {
                 accept: 'application/json;odata.metadata=none'
             },

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

@@ -25,25 +25,40 @@ class PlannerTaskListCommand extends GraphItemsListCommand_1.GraphItemsListComma
         return ['id', 'title', 'startDateTime', 'dueDateTime', 'completedDateTime'];
     }
     commandAction(logger, args, cb) {
-        const bucketId = args.options.bucketId;
         const bucketName = args.options.bucketName;
-        const planId = args.options.planId;
+        let bucketId = args.options.bucketId;
         const planName = args.options.planName;
+        let planId = args.options.planId;
+        let taskItems = [];
         if (bucketId || bucketName) {
             this
                 .getBucketId(args)
-                .then((bucketId) => this.getAllItems(`${this.resource}/v1.0/planner/buckets/${bucketId}/tasks`, logger, true))
+                .then((retrievedBucketId) => {
+                bucketId = retrievedBucketId;
+                return this.getAllItems(`${this.resource}/v1.0/planner/buckets/${bucketId}/tasks`, logger, true);
+            })
                 .then(() => {
-                logger.log(this.items);
+                taskItems = this.items;
+                return this.getAllItems(`${this.resource}/beta/planner/buckets/${bucketId}/tasks`, logger, true);
+            })
+                .then(() => {
+                logger.log(this.mergeTaskPriority(taskItems, this.items));
                 cb();
             }, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
         }
         else if (planId || planName) {
             this
                 .getPlanId(args)
-                .then((planId) => this.getAllItems(`${this.resource}/v1.0/planner/plans/${planId}/tasks`, logger, true))
+                .then((retrievedPlanId) => {
+                planId = retrievedPlanId;
+                return this.getAllItems(`${this.resource}/v1.0/planner/plans/${planId}/tasks`, logger, true);
+            })
+                .then(() => {
+                taskItems = this.items;
+                return this.getAllItems(`${this.resource}/beta/planner/plans/${planId}/tasks`, logger, true);
+            })
                 .then(() => {
-                logger.log(this.items);
+                logger.log(this.mergeTaskPriority(taskItems, this.items));
                 cb();
             }, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
         }
@@ -51,7 +66,11 @@ class PlannerTaskListCommand extends GraphItemsListCommand_1.GraphItemsListComma
             this
                 .getAllItems(`${this.resource}/v1.0/me/planner/tasks`, logger, true)
                 .then(() => {
-                logger.log(this.items);
+                taskItems = this.items;
+                return this.getAllItems(`${this.resource}/beta/me/planner/tasks`, logger, true);
+            })
+                .then(() => {
+                logger.log(this.mergeTaskPriority(taskItems, this.items));
                 cb();
             }, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
         }
@@ -125,6 +144,17 @@ class PlannerTaskListCommand extends GraphItemsListCommand_1.GraphItemsListComma
             return Promise.resolve(group.id);
         });
     }
+    mergeTaskPriority(taskItems, betaTaskItems) {
+        const findBetaTask = (id) => betaTaskItems.find(task => task.id === id);
+        taskItems.forEach(task => {
+            const betaTaskItem = findBetaTask(task.id);
+            if (betaTaskItem) {
+                const { priority } = betaTaskItem;
+                Object.assign(task, { priority });
+            }
+        });
+        return taskItems;
+    }
     options() {
         const options = [
             {

package/dist/m365/teams/commands/channel/channel-get.js

@@ -21,6 +21,7 @@ class TeamsChannelGetCommand extends GraphCommand_1.default {
         telemetryProps.teamName = typeof args.options.teamName !== 'undefined';
         telemetryProps.channelId = typeof args.options.channelId !== 'undefined';
         telemetryProps.channelName = typeof args.options.channelName !== 'undefined';
+        telemetryProps.primary = (!(!args.options.primary)).toString();
         return telemetryProps;
     }
     getTeamId(args) {
@@ -54,6 +55,9 @@ class TeamsChannelGetCommand extends GraphCommand_1.default {
         if (args.options.channelId) {
             return Promise.resolve(args.options.channelId);
         }
+        if (args.options.primary) {
+            return Promise.resolve('');
+        }
         const channelRequestOptions = {
             url: `${this.resource}/v1.0/teams/${encodeURIComponent(this.teamId)}/channels?$filter=displayName eq '${encodeURIComponent(args.options.channelName)}'`,
             headers: {
@@ -79,15 +83,21 @@ class TeamsChannelGetCommand extends GraphCommand_1.default {
             return this.getChannelId(args);
         })
             .then((channelId) => {
+            let url = '';
+            if (args.options.primary) {
+                url = `${this.resource}/v1.0/teams/${encodeURIComponent(this.teamId)}/primaryChannel`;
+            }
+            else {
+                url = `${this.resource}/v1.0/teams/${encodeURIComponent(this.teamId)}/channels/${encodeURIComponent(channelId)}`;
+            }
             const requestOptions = {
-                url: `${this.resource}/v1.0/teams/${encodeURIComponent(this.teamId)}/channels/${encodeURIComponent(channelId)}`,
+                url: url,
                 headers: {
                     accept: 'application/json;odata.metadata=none'
                 },
                 responseType: 'json'
             };
-            return request_1.default
-                .get(requestOptions);
+            return request_1.default.get(requestOptions);
         })
             .then((res) => {
             logger.log(res);
@@ -107,6 +117,9 @@ class TeamsChannelGetCommand extends GraphCommand_1.default {
             },
             {
                 option: '--channelName [channelName]'
+            },
+            {
+                option: '--primary'
             }
         ];
         const parentOptions = super.options();
@@ -122,11 +135,20 @@ class TeamsChannelGetCommand extends GraphCommand_1.default {
         if (args.options.teamId && !Utils_1.default.isValidGuid(args.options.teamId)) {
             return `${args.options.teamId} is not a valid GUID`;
         }
-        if (args.options.channelId && args.options.channelName) {
-            return 'Specify either channelId or channelName, but not both.';
+        if (args.options.channelId && args.options.channelName && args.options.primary) {
+            return 'Specify channelId, channelName or primary';
+        }
+        if (!args.options.channelId && args.options.channelName && args.options.primary) {
+            return 'Specify channelId, channelName or primary.';
+        }
+        if (args.options.channelId && !args.options.channelName && args.options.primary) {
+            return 'Specify channelId, channelName or primary.';
+        }
+        if (args.options.channelId && args.options.channelName && !args.options.primary) {
+            return 'Specify channelId, channelName or primary.';
         }
-        if (!args.options.channelId && !args.options.channelName) {
-            return 'Specify channelId or channelName, one is required';
+        if (!args.options.channelId && !args.options.channelName && !args.options.primary) {
+            return 'Specify channelId, channelName or primary, one is required';
         }
         if (args.options.channelId && !Utils_1.default.isValidTeamsChannelId(args.options.channelId)) {
             return `${args.options.channelId} is not a valid Teams ChannelId`;

package/docs/docs/cmd/aad/app/app-delete.md

@@ -0,0 +1,51 @@
+# aad app delete
+
+Removes an Azure AD app registration
+
+## Usage
+
+```sh
+m365 aad app delete [options]
+```
+
+## Options
+
+`--appId [appId]`
+: Application (client) ID of the Azure AD application registration to remove. Specify either `appId`, `objectId` or `name`
+
+`--objectId [objectId]`
+: Object ID of the Azure AD application registration to remove. Specify either `appId`, `objectId` or `name`
+
+`--name [name]`
+: Name of the Azure AD application registration to remove. Specify either `appId`, `objectId` or `name`
+
+`--confirm`:
+: Don't prompt for confirmation to delete the app
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+For best performance use the `objectId` option to reference the Azure AD application registration to delete. If you use `appId` or `name`, this command will first need to find the corresponding object ID for that application.
+
+If the command finds multiple Azure AD application registrations with the specified app name, it will prompt you to disambiguate which app it should use, listing the discovered object IDs.
+
+## Examples
+
+Delete the Azure AD application registration by its app (client) ID
+
+```sh
+m365 aad app delete --appId d75be2e1-0204-4f95-857d-51a37cf40be8
+```
+
+Delete the Azure AD application registration by its object ID
+
+```sh
+m365 aad app delete --objectId d75be2e1-0204-4f95-857d-51a37cf40be8
+```
+
+Delete the Azure AD application registration by its name. Will NOT prompt for confirmation before deleting.
+
+```sh
+m365 aad app delete --name "My app" --confirm
+```

package/docs/docs/cmd/aad/group/group-list.md

@@ -10,6 +10,9 @@ m365 aad group list [options]
 
 ## Options
 
+`-d, --deleted`
+: Use to retrieve deleted groups
+
 --8<-- "docs/cmd/_global.md"
 
 ## Examples
@@ -18,4 +21,10 @@ Lists all groups defined in Azure Active Directory.
 
 ```sh
 m365 aad group list
+```
+
+List all recently deleted groups in the tenant
+
+```sh
+m365 aad group list --deleted
 ```

package/docs/docs/cmd/planner/task/task-get.md

@@ -15,6 +15,11 @@ m365 planner task get [options]
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
+!!! attention
+    This command uses an API that is currently in preview to enrich the results with the `priority` field. Keep in mind that this preview API is subject to change once the API reached general availability.
+
 ## Examples
 
 Retrieve the the specified planner task

package/docs/docs/cmd/planner/task/task-list.md

@@ -30,6 +30,11 @@ m365 planner task list [options]
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
+!!! attention
+    This command uses API that is currently in preview to enrich the results with the `priority` field. Keep in mind that this preview API is subject to change once the API reached general availability.
+
 ## Examples
 
 List tasks for the currently logged in user

package/docs/docs/cmd/teams/channel/channel-get.md

@@ -22,6 +22,9 @@ m365 teams channel get [options]
 `--channelName [channelName]`
 : The display name of the channel for which to retrieve more information. Specify either channelId or channelName but not both
 
+`--primary`
+: Gets the default channel, General, of a team. If specified, channelId or channelName are not needed
+
 --8<-- "docs/cmd/_global.md"
 
 ## Examples
@@ -36,4 +39,10 @@ Get information about Microsoft Teams team channel with name _Channel Name_
 
 ```sh
 m365 teams channel get --teamName "Team Name" --channelName "Channel Name"
-```
+```
+
+Get information about Microsoft Teams team primary channel , i.e. General
+
+```sh
+m365 teams channel get --teamName "Team Name" --primary
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnp/cli-microsoft365",
-  "version": "5.0.0-beta.d025005",
+  "version": "5.0.0-beta.d17a15f",
   "description": "Manage Microsoft 365 and SharePoint Framework projects on any platform",
   "license": "MIT",
   "main": "./dist/api.js",
@@ -86,6 +86,7 @@
   "contributors": [
     "Ågren, Simon <simon.agren@sogeti.com>",
     "Albany, Bruce <bruce.albany@gmail.com>",
+    "Auckloo, Reshmee <reshmee011@gmail.com>",
     "Balasubramaniam, Jayakumar <jayakumar@live.in>",
     "Bauer, Stefan <stefan.bauer@n8d.at>",
     "Bernier, Hugo <hugoabernier@live.ca>",