Set-PnPPlannerTask
SYNOPSIS
Required Permissions
- Microsoft Graph API: One of Tasks.ReadWrite, Tasks.ReadWrite.All, Group.ReadWrite.All
Updates an existing task.
SYNTAX
Set-PnPPlannerTask -TaskId <String> [-Title <String>] [-Bucket <PlannerBucketPipeBind>]
[-PercentComplete <Int32>] [-DueDateTime <DateTime>] [-StartDateTime <DateTime>]
[-AssignedTo <String[]] [-Priority <Int32>] [-Description <String>] [-Connection <PnPConnection>]
DESCRIPTION
This cmdlets allows you to update an existing task in a Planner plan.
EXAMPLES
EXAMPLE 1
Set-PnPPlannerTask -TaskId RSNNbc4HM0e7jt-btAKtTZYAFAf0 -Title "New Title" -StartDateTime 2020-10-01
This updates the task with the specified id and sets the title to "New Title" and sets the start date to the first of October 2020.
EXAMPLE 2
Set-PnPPlannerTask -TaskId RSNNbc4HM0e7jt-btAKtTZYAFAf0 -Title "New Title" -Bucket "To do"
This updates the task with the specified id and moves to the bucket "To do".
EXAMPLE 3
Set-PnPPlannerTask -TaskId RSNNbc4HM0e7jt-btAKtTZYAFAf0 -AssignedTo "user@contoso.com","manager@contoso.com"
This updates the task with the specified id and replaces the assigned users with the ones specified.
PARAMETERS
-AssignedTo
Specify the email(s) of the user to assign the task to. Notice that this will replace existing assignments with the ones specified here.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Bucket
Specify the bucket name or ID to move the task to.
Type: PlannerBucketPipeBind
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Connection
Optional connection to be used by the cmdlet. Retrieve the value for this parameter by either specifying -ReturnConnection on Connect-PnPOnline or by executing Get-PnPConnection.
Type: PnPConnection
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Description
Sets the description (notes) of the task.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DueDateTime
Specify the due date.
Type: DateTime
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PercentComplete
Defines the percentage of completeness of the task.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Priority
Sets the priority of the task. Value should be a number between 0 and 10.
- 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
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-StartDateTime
Defines the start date of the task.
Type: DateTime
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-TaskId
The Id of the task to update.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Title
Sets the new title of the task.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False