Skip to content

Commit 50e8ed4

Browse files
committed
updated docs to include appliedcategories
1 parent 8f0f322 commit 50e8ed4

File tree

2 files changed

+24
-2
lines changed

2 files changed

+24
-2
lines changed

documentation/Add-PnPPlannerTask.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -146,7 +146,7 @@ Accept wildcard characters: False
146146
```
147147
148148
### -AppliedCategories
149-
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}
149+
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}. Notice that omitting a category from the data you send in will -not- reset that category. E.g. if you want to remove a category/label from a task you will have to explicitly set it to $false.
150150
151151
```yaml
152152
Type: AppliedCategories

documentation/Set-PnPPlannerTask.md

Lines changed: 23 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ Updates an existing task.
2121

2222
```powershell
2323
Set-PnPPlannerTask -TaskId <String> [-Title <String>] [-Bucket <PlannerBucketPipeBind>]
24-
[-PercentComplete <Int32>] [-DueDateTime <DateTime>] [-StartDateTime <DateTime>]
24+
[-PercentComplete <Int32>] [-DueDateTime <DateTime>] [-StartDateTime <DateTime>] [-AppliedCategories <AppliedCategories>]
2525
[-AssignedTo <String[]] [-Priority <Int32>] [-Description <String>] [-Connection <PnPConnection>]
2626
2727
```
@@ -52,6 +52,13 @@ Set-PnPPlannerTask -TaskId RSNNbc4HM0e7jt-btAKtTZYAFAf0 -AssignedTo "user@contos
5252

5353
This updates the task with the specified id and replaces the assigned users with the ones specified.
5454

55+
### EXAMPLE 4
56+
```powershell
57+
Set-PnPPlannerTask -TaskId RSNNbc4HM0e7jt-btAKtTZYAFAf0 -AppliedCategories ${"Category1"=$true,"Category5"=$false}
58+
```
59+
60+
This updates the task and sets the first label to true and unsets the 5th label on the task.
61+
5562
## PARAMETERS
5663

5764
### -AssignedTo
@@ -209,6 +216,21 @@ Accept pipeline input: False
209216
Accept wildcard characters: False
210217
```
211218
219+
### -AppliedCategories
220+
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, Set-PnPPlannerTask -PlanId <yourid> -AppliedCategories $task.AppliedCategory) or you can define it as a new object: @{"Category1"=$true,"Category5"=$true}. Notice that omitting a category from the data you send in will -not- reset that category. E.g. if you want to remove a category/label from a task you will have to explicitly set it to $false.
221+
222+
```yaml
223+
Type: AppliedCategories
224+
Parameter Sets: (All)
225+
Aliases: ß
226+
227+
Required: False
228+
Position: Named
229+
Default value: None
230+
Accept pipeline input: False
231+
Accept wildcard characters: False
232+
```
233+
212234
## RELATED LINKS
213235
214236
[Microsoft 365 Patterns and Practices](https://aka.ms/m365pnp)

0 commit comments

Comments
 (0)