@pnp/cli-microsoft365 5.4.0-beta.fdd7cb1 → 5.5.0-beta.5a6c547

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

@@ -39,9 +39,6 @@ m365 planner task add [options]
 
 `--percentComplete [percentComplete]`
 : Percentage of task completion. Number between 0 and 100.
-  - When set to 0, the task is considered _Not started_. 
-  - When set between 1 and 99, the task is considered _In progress_.
-  - When set to 100, the task is considered _Completed_.
 
 `--assignedToUserIds [assignedToUserIds]`
 : The comma-separated IDs of the assignees the task is assigned to. Specify either `assignedToUserIds` or `assignedToUserNames` but not both.
@@ -49,14 +46,41 @@ m365 planner task add [options]
 `--assignedToUserNames [assignedToUserNames]`
 : The comma-separated UPNs of the assignees the task is assigned to. Specify either `assignedToUserIds` or `assignedToUserNames` but not both.
 
+`--assigneePriority [assigneePriority]`
+: Hint used to order items of this type in a list view. The format is defined as outlined [here](https://docs.microsoft.com/graph/api/resources/planner-order-hint-format?view=graph-rest-1.0).
+
 `--description [description]`
 : Description of the task
 
+`--appliedCategories [appliedCategories]`
+: Comma-separated categories that should be added to the task. The possible options are: `category1`, `category2`, `category3`, `category4`, `category5` and/or `category6`. Additional info defined [here](https://docs.microsoft.com/graph/api/resources/plannerappliedcategories?view=graph-rest-1.0).
+
+`--previewType [previewType]`
+: This sets the type of preview that shows up on the task. The possible values are: `automatic`, `noPreview`, `checklist`, `description`, `reference`. When set to automatic the displayed preview is chosen by the app viewing the task. Default `automatic`.
+
 `--orderHint [orderHint]`
-: 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).
+: Hint used to order items of this type in a list view. The format is defined as outlined [here](https://docs.microsoft.com/graph/api/resources/planner-order-hint-format?view=graph-rest-1.0).
+
+`--priority [priority]`
+: Priority of the task: Urgent, Important, Medium, Low. Or an integer between 0 and 10 (check remarks section for more info). Default value is Medium.
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
+When you specify the value for `percentComplete`, consider the following:
+
+- when set to 0, the task is considered _Not started_
+- when set between 1 and 99, the task is considered _In progress_
+- when set to 100, the task is considered _Completed_
+
+When you specify an integer value for `priority`, consider the following:
+
+- values 0 and 1 are interpreted as _Urgent_
+- values 2, 3 and 4 are interpreted as _Important_
+- values 5, 6 and 7 are interpreted as _Medium_
+- values 8, 9 and 10 are interpreted as _Low_
+
 ## Examples
 
 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_
@@ -76,3 +100,15 @@ Adds a Microsoft Planner task with the name _My Planner Task_ for plan with the
 ```sh
 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"
 ```
+
+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_ who will appear first with the asssignee priority _' !'_ 
+
+```sh
+m365 planner task add --title "My Planner Task" --planId "8QZEH7b3wkSbGQobscsM5gADCBa" --bucketId "IK8tuFTwQEa5vTonM7ZMRZgAKdna" --assignedToUserNames "Allan.Carroll@contoso.com,Ida.Stevens@contoso.com" --asssigneePriority ' !'
+```
+
+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 receive the categories _category1,category3_ and get a preview with the type _noPreview_
+
+```sh
+m365 planner task add --title "My Planner Task" --planId "8QZEH7b3wkSbGQobscsM5gADCBa" --bucketId "IK8tuFTwQEa5vTonM7ZMRZgAKdna" --appliedCategories "category1,category3" --previewType "noPreview"
+```

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

@@ -0,0 +1,24 @@
+# planner task checklistitem list
+
+Lists the checklist items of a Planner task.
+
+## Usage
+
+```sh
+m365 planner task checklistitem list [options]
+```
+
+## Options
+
+`-i, --taskId <taskId>`
+: ID of the task
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Lists the checklist items of a Planner task.
+
+```sh
+m365 planner task checklistitem list --taskId 'vzCcZoOv-U27PwydxHB8opcADJo-'
+```

package/docs/docs/cmd/planner/task/task-checklistitem-remove.md

@@ -0,0 +1,36 @@
+# planner task checklistitem remove
+
+Removes the checklist item from the Planner task.
+
+## Usage
+
+```sh
+m365 planner task checklistitem remove [options]
+```
+
+## Options
+
+`-i, --id <id>`
+: ID of the checklist item.
+
+`--taskId <taskId>`
+: ID of the task.
+
+`--confirm`
+: Don't prompt for confirmation
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Removes a checklist item with the id _40012_ from the Planner task with the id _2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2_
+
+```sh
+m365 planner task checklistitem remove --id "40012" --taskId "2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2" 
+```
+
+Removes a checklist item with the id _40012_ from the Planner task with the id _2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2_ without prompt
+
+```sh
+m365 planner task checklistitem remove --id "40012" --taskId "2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2" --confirm
+```

package/docs/docs/cmd/planner/task/task-reference-remove.md

@@ -0,0 +1,39 @@
+# planner task reference remove
+
+Removes the reference from the Planner task.
+
+## Usage
+
+```sh
+m365 planner task reference remove [options]
+```
+
+## Options
+
+`-u, --url [url]`
+: URL location of the reference. Specify either `alias` or `url` but not both.
+
+`--alias [alias]`
+: The alias of the reference. Specify either `alias` or `url` but not both.
+
+`-i, --taskId <taskId>`
+: ID of the task.
+
+`--confirm`
+: Don't prompt for confirmation
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Removes a reference with the url _https://www.microsoft.com_ from the Planner task with the id _2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2_
+
+```sh
+m365 planner task reference remove --url "https://www.microsoft.com" --taskId "2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2" 
+```
+
+Removes a reference with the alias _Parker_ from the Planner task with the id _2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2_
+
+```sh
+m365 planner task reference remove --alias "Parker" --taskId "2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2"
+```

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

@@ -61,16 +61,26 @@ m365 planner task set [options]
 `--appliedCategories [appliedCategories]`
 : Comma-separated categories that should be added to the task
 
+`--priority [priority]`
+: Priority of the task: Urgent, Important, Medium, Low. Or an integer between 0 and 10 (check remarks section for more info).
+
 --8<-- "docs/cmd/_global.md"
 
 ## Remarks
 
-When you specify the value for `percentageComplete`, consider the following:
+When you specify the value for `percentComplete`, consider the following:
 
 - when set to 0, the task is considered _Not started_
 - when set between 1 and 99, the task is considered _In progress_
 - when set to 100, the task is considered _Completed_
 
+When you specify an integer value for `priority`, consider the following:
+
+- values 0 and 1 are interpreted as _Urgent_
+- values 2, 3 and 4 are interpreted as _Important_
+- values 5, 6 and 7 are interpreted as _Medium_
+- values 8, 9 and 10 are interpreted as _Low_
+
 You can add up to 6 categories to the task. An example to add _category1_ and _category3_ would be `category1,category3`.
 
 ## Examples

package/docs/docs/cmd/planner/tenant/tenant-settings-set.md

@@ -0,0 +1,56 @@
+# planner tenant settings set
+
+Sets Microsoft Planner configuration of the tenant
+
+## Usage
+
+```sh
+m365 planner tenant settings set [options]
+```
+
+## Options
+
+`--isPlannerAllowed [isPlannerAllowed]`
+: Configure whether Planner should be enabled on the tenant.
+
+`--allowCalendarSharing [allowCalendarSharing]`
+: Configure whether Outlook calendar sync is enabled.
+
+`--allowTenantMoveWithDataLoss [allowTenantMoveWithDataLoss]`
+: Configure whether a tenant move into a new region is authorized.
+
+`--allowTenantMoveWithDataMigration [allowTenantMoveWithDataMigration]`
+: Configure whether a tenant move with data migration is authorized.
+
+`--allowRosterCreation [allowRosterCreation]`
+: Configure whether Planner roster creation is allowed.
+
+`--allowPlannerMobilePushNotifications [allowPlannerMobilePushNotifications]`
+: Configure whether push notifications are enabled in the mobile app.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+!!! important
+    To use this command you must be a global administrator.
+
+## Examples
+
+Disable Microsoft Planner in the tenant
+
+```sh
+m365 planner tenant settings set --isPlannerAllowed false
+```
+
+Disable Outlook calendar sync and mobile push notifications
+
+```sh
+m365 planner tenant settings set --allowCalendarSharing false --allowPlannerMobilePushNotifications false
+```
+
+Enable Microsoft Planner but disallow roster plans to be created
+
+```sh
+m365 planner tenant settings set --isPlannerAllowed true --allowRosterCreation false
+```

package/docs/docs/cmd/spfx/project/project-upgrade.md

@@ -32,7 +32,7 @@ m365 spfx project upgrade [options]
 
 ## Remarks
 
-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-rc.0.
+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.15.0).
 
 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.
 

package/docs/docs/cmd/spo/hubsite/hubsite-list.md

@@ -17,10 +17,7 @@ m365 spo hubsite list [options]
 
 ## Remarks
 
-!!! attention
-    This command is based on a SharePoint API that is currently in preview and is subject to change once the API reached general availability.
-
-When using the text output type (default), the command lists only the values of the `ID`, `SiteUrl` and `Title` properties of the hub site. When setting the output type to JSON, all available properties are included in the command output.
+When using the text or csv output type, the command lists only the values of the `ID`, `SiteUrl` and `Title` properties of the hub site. With the output type as JSON, all available properties are included in the command output.
 
 ## Examples
 

package/docs/docs/cmd/spo/list/list-list.md

@@ -13,6 +13,9 @@ m365 spo list list [options]
 `-u, --webUrl <webUrl>`
 : URL of the site where the lists to retrieve are located
 
+`--executeWithLimitedPermissions`
+: Use this option to execute this command with site member or visitor permissions. Not specifying this option will require site owner (or admin) permissions.
+
 --8<-- "docs/cmd/_global.md"
 
 ## Examples

package/docs/docs/cmd/tenant/serviceannouncement/serviceannouncement-health-get.md

@@ -16,7 +16,7 @@ m365 tenant serviceannouncement health get [options]
 `-i, --issues`
 : Return the collection of issues that happened on the service, with detailed information for each issue. Is only returned in JSON output mode.
 
---8<-- "docs/cmd/\_global.md"
+--8<-- "docs/cmd/_global.md"
 
 ## Examples
 

package/docs/docs/cmd/tenant/serviceannouncement/serviceannouncement-healthissue-list.md

@@ -13,7 +13,7 @@ m365 tenant serviceannouncement healthissue list [options]
 `-s, --service [service]`
 : Retrieve service health issues for the particular service. If not provided, retrieves health issues for all services
 
---8<-- "docs/cmd/\_global.md"
+--8<-- "docs/cmd/_global.md"
 
 ## Examples
 

package/docs/docs/cmd/tenant/serviceannouncement/serviceannouncement-message-list.md

@@ -13,7 +13,7 @@ m365 tenant serviceannouncement message list [options]
 `-s, --service [service]`
 : Retrieve service update messages for the particular service. If not provided, retrieves messages for all services
 
---8<-- "docs/cmd/\_global.md"
+--8<-- "docs/cmd/_global.md"
 
 ## Examples
 

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@pnp/cli-microsoft365",
-  "version": "5.4.0",
+  "version": "5.5.0",
   "lockfileVersion": 2,
   "requires": true,
   "packages": {
     "": {
       "name": "@pnp/cli-microsoft365",
-      "version": "5.4.0",
+      "version": "5.5.0",
       "license": "MIT",
       "dependencies": {
         "@azure/msal-node": "^1.9.1",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnp/cli-microsoft365",
-  "version": "5.4.0-beta.fdd7cb1",
+  "version": "5.5.0-beta.5a6c547",
   "description": "Manage Microsoft 365 and SharePoint Framework projects on any platform",
   "license": "MIT",
   "main": "./dist/api.js",

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

@@ -1,116 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const utils_1 = require("../../../../utils");
-const Auth_1 = require("../../../../Auth");
-const request_1 = require("../../../../request");
-const planner_1 = require("../../../../utils/planner");
-const GraphCommand_1 = require("../../../base/GraphCommand");
-const commands_1 = require("../../commands");
-const aadGroup_1 = require("../../../../utils/aadGroup");
-class PlannerPlanDetailsGetCommand extends GraphCommand_1.default {
-    constructor() {
-        super(...arguments);
-        this.groupId = '';
-    }
-    get name() {
-        return commands_1.default.PLAN_DETAILS_GET;
-    }
-    get description() {
-        return 'Get details of a Microsoft Planner plan';
-    }
-    getTelemetryProperties(args) {
-        const telemetryProps = super.getTelemetryProperties(args);
-        telemetryProps.planId = typeof args.options.planId !== 'undefined';
-        telemetryProps.planTitle = typeof args.options.planTitle !== 'undefined';
-        telemetryProps.ownerGroupId = typeof args.options.ownerGroupId !== 'undefined';
-        telemetryProps.ownerGroupName = typeof args.options.ownerGroupName !== 'undefined';
-        return telemetryProps;
-    }
-    commandAction(logger, args, cb) {
-        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;
-        }
-        this
-            .getGroupId(args)
-            .then((groupId) => {
-            this.groupId = groupId;
-            return this.getPlanId(args);
-        })
-            .then((planId) => {
-            args.options.planId = planId;
-            return this.getPlanDetails(args);
-        })
-            .then((res) => {
-            logger.log(res);
-            cb();
-        }, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
-    }
-    getGroupId(args) {
-        if (args.options.planId) {
-            return Promise.resolve('');
-        }
-        if (args.options.ownerGroupId) {
-            return Promise.resolve(args.options.ownerGroupId);
-        }
-        return aadGroup_1.aadGroup
-            .getGroupByDisplayName(args.options.ownerGroupName)
-            .then(group => group.id);
-    }
-    getPlanId(args) {
-        if (args.options.planId) {
-            return Promise.resolve(args.options.planId);
-        }
-        return planner_1.planner
-            .getPlanByName(args.options.planTitle, this.groupId)
-            .then(plan => plan.id);
-    }
-    getPlanDetails(args) {
-        const requestOptions = {
-            url: `${this.resource}/v1.0/planner/plans/${args.options.planId}/details`,
-            headers: {
-                'accept': 'application/json;odata.metadata=none'
-            },
-            responseType: 'json'
-        };
-        return request_1.default.get(requestOptions);
-    }
-    options() {
-        const options = [
-            {
-                option: '-i, --planId [planId]'
-            },
-            {
-                option: '-t, --planTitle [planTitle]'
-            },
-            {
-                option: '--ownerGroupId [ownerGroupId]'
-            },
-            {
-                option: '--ownerGroupName [ownerGroupName]'
-            }
-        ];
-        const parentOptions = super.options();
-        return options.concat(parentOptions);
-    }
-    validate(args) {
-        if (!args.options.planId && !args.options.planTitle) {
-            return 'Specify either planId or planTitle';
-        }
-        if (args.options.planId && args.options.planTitle) {
-            return 'Specify either planId or planTitle';
-        }
-        if (args.options.planTitle && !args.options.ownerGroupId && !args.options.ownerGroupName) {
-            return 'Specify either ownerGroupId or ownerGroupName';
-        }
-        if (args.options.planTitle && args.options.ownerGroupId && args.options.ownerGroupName) {
-            return 'Specify either ownerGroupId or ownerGroupName but not both';
-        }
-        if (args.options.ownerGroupId && !utils_1.validation.isValidGuid(args.options.ownerGroupId)) {
-            return `${args.options.ownerGroupId} is not a valid GUID`;
-        }
-        return true;
-    }
-}
-module.exports = new PlannerPlanDetailsGetCommand();
-//# sourceMappingURL=plan-details-get.js.map

package/docs/docs/cmd/planner/plan/plan-details-get.md

@@ -1,45 +0,0 @@
-# planner plan details get
-
-Retrieve the planner details about the specified plan.
-
-## Usage
-
-```sh
-m365 planner plan details get [options]
-```
-
-## Options
-
-`-i, --planId [planId]`
-: ID of the plan. Specify either `planId` or `planTitle` but not both.
-
-`-t, --planTitle [planTitle]`
-: Title of the plan. Specify either `planId` or `planTitle` but not both.
-
-`--ownerGroupId [ownerGroupId]`
-: ID of the Group that owns the plan. Specify either `ownerGroupId` or `ownerGroupName` when using `planTitle`.
-
-`--ownerGroupName [ownerGroupName]`
-: Name of the Group that owns the plan. Specify either `ownerGroupId` or `ownerGroupName` when using `planTitle`.
-
---8<-- "docs/cmd/_global.md"
-
-## Examples
-
-Returns the Microsoft Planner plan details with id _gndWOTSK60GfPQfiDDj43JgACDCb_
-
-```sh
-m365 planner plan details get --planId "gndWOTSK60GfPQfiDDj43JgACDCb"
-```
-
-Returns the Microsoft Planner plan details with title _MyPlan_ for Group _233e43d0-dc6a-482e-9b4e-0de7a7bce9b4_
-
-```sh
-m365 planner plan details get --planTitle "MyPlan" --ownerGroupId "233e43d0-dc6a-482e-9b4e-0de7a7bce9b4"
-```
-
-Returns the Microsoft Planner plan details with title _MyPlan_ for Group _My Planner Group_
-
-```sh
-m365 planner plan details get --planTitle "MyPlan" --ownerGroupName "My Planner Group"
-```