New-MgUserTodoListTask

What is New-MgUserTodoListTask?

New-MgUserTodoListTask is a Microsoft Graph PowerShell cmdlet used to create tasks in a user’s Microsoft To Do task list. It allows administrators and automation scripts to add tasks with properties such as title, due date, and priority directly into a specific To Do list.

Why Use New-MgUserTodoListTask?

This cmdlet is particularly useful for automation scenarios, including:

• Assigning tasks to users during onboarding
• Creating reminders or follow-up tasks programmatically
• Bulk task creation for projects or audits
• Integrating external systems with Microsoft To Do

It removes the need for manual task creation and ensures tasks are created consistently across users.

Prerequisites

Before using this cmdlet, ensure you are connected to Microsoft Graph with the required permissions:

Connect-MgGraph -Scopes "Tasks.ReadWrite"

How to use New-MgUserTodoListTask?

Basic syntax:

New-MgUserTodoListTask -UserId <String> -TodoTaskListId <String> -BodyParameter <PSObject>

You must specify the target user, the To Do task list ID, and provide task details using the -BodyParameter hashtable.

New-MgUserTodoListTask Examples

• Example 1: Create a Single Task

Create a task with specific details such as a title, due date, and priority.

$TaskDetails = @{
    title = "Prepare Quarterly Report"
    dueDateTime = @{ dateTime = "2024-11-15T17:00:00"; timeZone = "UTC" }
    importance = "high"
}
New-MgUserTodoListTask -UserId "john.doe@contoso.com" -TodoTaskListId "A1B2C3D4" -BodyParameter $TaskDetails
                                            

• Example 2: Create Multiple Tasks

Create multiple tasks for a user by iterating through a list of task details.

$Tasks = @(
    @{ title = "Complete Budget Analysis"; dueDateTime = @{ dateTime = "2024-11-18T17:00:00"; timeZone = "UTC" }; importance = "normal" },
    @{ title = "Team Meeting Preparation"; dueDateTime = @{ dateTime = "2024-11-20T10:00:00"; timeZone = "UTC" }; importance = "low" }
)
foreach ($Task in $Tasks) {
    New-MgUserTodoListTask -UserId "john.doe@contoso.com" -TodoTaskListId "A1B2C3D4" -BodyParameter $Task
}
                                            

• Example 3: Bulk Create Tasks via CSV

Use a CSV file to create tasks for multiple users.

$Tasks = Import-Csv "Tasks.csv"
foreach ($Task in $Tasks) {
    $TaskDetails = @{
        title = $Task.Title
        dueDateTime = @{ dateTime = $Task.DueDateTime; timeZone = "UTC" }
        importance = $Task.Importance
    }
    New-MgUserTodoListTask -UserId $Task.UserId -TodoTaskListId $Task.TodoTaskListId -BodyParameter $TaskDetails
}
                                            

Summary

Key Point	Details
Cmdlet Name	New-MgUserTodoListTask
Purpose	Creates tasks in a Microsoft To Do list
Required Scope	Tasks.ReadWrite
Target Resource	User To Do task list
Automation Benefit	Enables bulk and automated task creation
Common Use Case	Task assignment, reminders, project tracking