Added ability to add a label on the planner task

Author: erwinvanhunen

documentation/Add-PnPPlannerTask.md

@@ -22,15 +22,15 @@ Adds a new task to a planner bucket
 ### By Group
 ```powershell
 Add-PnPPlannerTask -Group <PlannerGroupPipeBind> -Plan <PlannerPlanPipeBind> -Bucket <PlannerBucketPipeBind> -Title <String> 
-[-PercentComplete <Int32>] [-DueDateTime <DateTime>] [-StartDateTime <DateTime>]
+[-PercentComplete <Int32>] [-DueDateTime <DateTime>] [-StartDateTime <DateTime>] [-AppliedCategories <AppliedCategories>]
  [-AssignedTo <String[]] [-Priority <Int32>] [-Description <String>] [-OutputTask]
  
 ```
 
 ### By Plan Id
 ```powershell
 Add-PnPPlannerTask -Bucket <PlannerBucketPipeBind> -PlanId <String> -Title <String> 
-[-PercentComplete <Int32>] [-DueDateTime <DateTime>] [-StartDateTime <DateTime>]
+[-PercentComplete <Int32>] [-DueDateTime <DateTime>] [-StartDateTime <DateTime>] [-AppliedCategories <AppliedCategories>]
  [-AssignedTo <String[]] [-Priority <Int32>] [-Description <String>] [-OutputTask]
  
 ```
@@ -42,21 +42,21 @@ This cmdlet adds a new task to Planner bucket
 
 ### Example 1
 ```powershell
-Add-PnPPlannerTask -Group "Marketing" -Plan "Conference Plan" -Bucket "Todos" -Title "Design booth layout"
+Add-PnPPlannerTask -Group "Marketing" -Plan "Conference Plan" -Bucket "Todos" -Title "Design booth layout" -AppliedCategories @{"Category1"=$true,"Category3"=$true}
 ```
 
 This cmdlet adds a new task.
 
 ### Example 2
 ```powershell
-Add-PnPPlannerTask -PlanId "QvfkTd1mc02gwxHjHC_43JYABhAy" -Bucket "Todos" -Title "Design booth layout"
+Add-PnPPlannerTask -PlanId "QvfkTd1mc02gwxHjHC_43JYABhAy" -Bucket "Todos" -Title "Design booth layout" -AppliedCategories @{"Category1"=$true,"Category3"=$true}
 ```
 
 This cmdlet adds a new task.
 
 ### Example 3
 ```powershell
-Add-PnPPlannerTask -Group "Marketing" -Plan "Conference Plan" -Bucket "Todos" -Title "Design booth layout" -AssignedTo "user@contoso.com","manager@contoso.com"
+Add-PnPPlannerTask -Group "Marketing" -Plan "Conference Plan" -Bucket "Todos" -Title "Design booth layout" -AssignedTo "user@contoso.com","manager@contoso.com" -AppliedCategories @{"Category1"=$true,"Category3"=$true}
 ```
 
 This cmdlet adds a new task and assigns to user@contoso.com and manager@contoso.com
@@ -145,6 +145,21 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -AppliedCategories
+The applied categories represent the labels as shown in the UI of the planner task. Categories are 'hardcoded' as such in Planner, e.g. you can set Category1 to Category25, each having its own color. Labels, if customized in planner will be set accordingly to the ones defined. You can either copy the value from an existing task (e.g. $task = Get-PnPPlannerTask, Add-PnPPlannerTask -PlanId <yourid> -AppliedCategories $task.AppliedCategory) or you can define it as a new object: @{"Category1"=$true,"Category5"=$true}
+
+```yaml
+Type: AppliedCategories
+Parameter Sets: (All)
+Aliases: 
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -AssignedTo
 Specify the email(s) of the user to assign the task to.
 

src/Commands/Model/Planner/PlannerPlanDetails.cs

@@ -0,0 +1,15 @@
+using System;
+using System.Collections.Generic;
+using System.Text.Json.Serialization;
+using PnP.PowerShell.Commands.Model.Graph;
+
+namespace PnP.PowerShell.Commands.Model.Planner
+{
+    public class PlannerPlanDetails
+    {
+        [JsonPropertyName("@odata.etag")]
+        public string ETag { get; set; }
+
+        public Dictionary<string,string> CategoryDescriptions { get; set; }
+    }
+}

src/Commands/Model/Planner/PlannerTask.cs

@@ -49,7 +49,7 @@ public class TaskAssignment
     {
         [JsonPropertyName("@odata.type")]
         public string Type { get; set; } = "#microsoft.graph.plannerAssignment";
-    
+
         public DateTime? AssignedDateTime { get; set; }
         public string OrderHint { get; set; } = " !";
         public IdentitySet AssignedBy { get; set; }
@@ -63,6 +63,25 @@ public class AppliedCategories
         public bool? Category4 { get; set; }
         public bool? Category5 { get; set; }
         public bool? Category6 { get; set; }
+        public bool? Category7 { get; set; }
+        public bool? Category8 { get; set; }
+        public bool? Category9 { get; set; }
+        public bool? Category10 { get; set; }
+        public bool? Category11 { get; set; }
+        public bool? Category12 { get; set; }
+        public bool? Category13 { get; set; }
+        public bool? Category14 { get; set; }
+        public bool? Category15 { get; set; }
+        public bool? Category16 { get; set; }
+        public bool? Category17 { get; set; }
+        public bool? Category18 { get; set; }
+        public bool? Category19 { get; set; }
+        public bool? Category20 { get; set; }
+        public bool? Category21 { get; set; }
+        public bool? Category22 { get; set; }
+        public bool? Category23 { get; set; }
+        public bool? Category24 { get; set; }
+        public bool? Category25 { get; set; }
 
         [JsonExtensionData]
         public IDictionary<string, object> AdditionalData { get; set; }

src/Commands/Planner/AddPlannerTask.cs

@@ -56,6 +56,9 @@ public class AddPlannerTask : PnPGraphCmdlet
         [Parameter(Mandatory = false, ParameterSetName = ParameterAttribute.AllParameterSets)]
         public SwitchParameter OutputTask;
 
+        [Parameter(Mandatory = false, ParameterSetName = ParameterAttribute.AllParameterSets)]
+        public AppliedCategories AppliedCategories;
+
         protected override void ExecuteCmdlet()
         {
             PlannerTask createdTask;
@@ -116,6 +119,11 @@ protected override void ExecuteCmdlet()
                 }
             }
 
+            if(ParameterSpecified(nameof(AppliedCategories)))
+            {
+                newTask.AppliedCategories = AppliedCategories;
+            }
+
             // By Group
             if (ParameterSetName == ParameterName_BYGROUP)
             {

src/Commands/Planner/SetPlannerTask.cs

@@ -44,6 +44,9 @@ public class SetPlannerTask : PnPGraphCmdlet
         [Parameter(Mandatory = false)]
         public string[] AssignedTo;
 
+        [Parameter(Mandatory = false)]
+        public AppliedCategories AppliedCategories;
+
         protected override void ExecuteCmdlet()
         {
             var existingTask = PlannerUtility.GetTask(GraphRequestHelper, TaskId, false, false);
@@ -87,6 +90,11 @@ protected override void ExecuteCmdlet()
                     plannerTask.StartDateTime = StartDateTime.ToUniversalTime();
                 }
 
+                if(ParameterSpecified(nameof(AppliedCategories)))
+                {
+                    plannerTask.AppliedCategories = AppliedCategories;
+                }
+                
                 if (ParameterSpecified(nameof(AssignedTo)))
                 {
                     var errors = new List<Exception>();

src/Commands/Utilities/PlannerUtility.cs

@@ -46,6 +46,13 @@ public static PlannerPlan GetPlan(ApiRequestHelper requestHelper, string planId,
             return plan;
         }
 
+        public static PlannerPlanDetails GetPlanDetails(ApiRequestHelper requestHelper, string planId)
+        {
+            var plan = requestHelper.Get<PlannerPlanDetails>($"v1.0/planner/plans/{planId}/details");
+
+            return plan;
+        }
+
         public static PlannerPlan CreatePlan(ApiRequestHelper requestHelper, string groupId, string title)
         {
             var stringContent = new StringContent(JsonSerializer.Serialize(new { owner = groupId, title = title }));