Using Remove-MgUserTodoListTask in Graph PowerShell

The Remove-MgUserTodoListTask cmdlet is used to remove a specific task or multiple tasks from a user's Microsoft To Do list. This cmdlet simplifies task management by enabling administrators to automate task deletions from user accounts. Whether it's deleting a single task, performing a bulk removal, or handling tasks via CSV, this cmdlet provides flexibility and control.

Cmdlet Syntax

Remove-MgUserTodoListTask -UserId <String> -TodoTaskListId <String> -TodoTaskId <String>

• UserId: The ID of the user whose task you want to remove.
• TodoTaskListId: The ID of the To Do task list.
• TodoTaskId: The ID of the task that you wish to remove.

Usage Examples

Example 1: Remove a Single Task from a User’s To Do List

This example removes a single task from a specific task list of a user. The UserId, TodoTaskListId, and TodoTaskId are the required parameters.

Remove-MgUserTodoListTask -UserId "john.doe@contoso.com" -TodoTaskListId "AAMkAGVmMWZmNjczLTFiZGUtNDMzNi05N2RkLTgwZDA1MjlkZDY0ZgBGAAAAAAC" -TodoTaskId "AQMkAGVmMWZmNjczLTFiZGUtNDMzNi05N2RkLTgwZDA1MjlkZDY0ZwAAA="

Example 2: Remove Multiple Tasks in a Single Command

This script loops through an array of task IDs and removes them one by one.

$taskIds = @("AQMkAGVmMWZmNjczLTFiZGUtNDMzNi05N2RkLTgwZDA1MjlkZDY0ZwAAA=", "AQMkAGVmMWZmNjczLTFiZGUtNDMzNi05N2RkLTgwZDA1MjlkZDY0ZwAAB=")
$todoListId = "AAMkAGVmMWZmNjczLTFiZGUtNDMzNi05N2RkLTgwZDA1MjlkZDY0ZgBGAAAAAAC"
$userId = "john.doe@contoso.com"

foreach ($taskId in $taskIds) {
    Remove-MgUserTodoListTask -UserId $userId -TodoTaskListId $todoListId -TodoTaskId $taskId
}

Example 3: Bulk Task Removal via CSV File

This example shows how to remove tasks in bulk using a CSV file. The CSV file should contain a list of task IDs along with the user ID and task list ID.

$csvFile = "C:\TasksToRemove.csv"
$tasks = Import-Csv $csvFile

foreach ($task in $tasks) {
    Remove-MgUserTodoListTask -UserId $task.UserId -TodoTaskListId $task.TodoTaskListId -TodoTaskId $task.TodoTaskId
}

CSV File Structure

    UserId,TodoTaskListId,TodoTaskId
    john.doe@contoso.com,AAMkAGVmMWZmNjczLTFiZGUtNDMzNi05N2RkLTgwZDA1MjlkZDY0ZgBGAAAAAAC,AQMkAGVmMWZmNjczLTFiZGUtNDMzNi05N2RkLTgwZDA1MjlkZDY0ZwAAA=
    jane.doe@contoso.com,AAMkAGVmMWZmNjczLTFiZGUtNDMzNi05N2RkLTgwZDA1MjlkZDY0ZgBGAAAAAAC,AQMkAGVmMWZmNjczLTFiZGUtNDMzNi05N2RkLTgwZDA1MjlkZDY0ZwAAB=

Cmdlet Tips

• Always confirm the task IDs: It's crucial to ensure that you are deleting the correct tasks from the appropriate task lists. Accidentally removing important tasks can cause workflow disruptions.
• User permissions: Ensure that you have the required permissions to remove tasks from user accounts. Lack of sufficient permissions will result in errors.
• Automate with caution: When performing bulk removals, always double-check the CSV file before running the script to avoid accidental deletions.

Possible Errors & Solutions

Error 1: ResourceNotFound

Cause: The TodoTaskId or TodoTaskListId provided does not exist.

Solution: Verify the task and task list IDs using the Get-MgUserTodoListTask and Get-MgUserTodoList cmdlets to ensure they exist.

Error 2: InvalidAuthenticationToken

Cause: The access token used in the request is invalid or expired.

Solution: Refresh the authentication token by re-running the Connect-MgGraph command to acquire a valid token.

Error 3: AccessDenied

Cause: The user running the script does not have sufficient permissions to remove tasks from the specified user’s account.

Solution: Ensure that the user has the appropriate permissions. You may need to adjust the scope of the access token to include Tasks.ReadWrite.

Error 4: InvalidUserId

Cause: The UserId provided is incorrect or does not exist.

Solution: Verify the user’s ID using the Get-MgUser cmdlet and ensure that the ID matches the correct format (UPN or Object ID).

Use Cases

Automated Cleanup of Completed Tasks

In a large organization, users may often forget to remove completed or outdated tasks. IT administrators can use the Remove-MgUserTodoListTask cmdlet to automatically clean up these tasks based on criteria like completion date or project end.

Removing Stale or Irrelevant Tasks

For businesses undergoing restructuring or project reprioritization, some tasks may become irrelevant. Administrators can bulk-remove these tasks from user accounts to streamline workflows and eliminate clutter.

Managing Task Lists for Onboarding or Offboarding

During employee onboarding or offboarding, administrators may need to manage their To Do tasks. Using this cmdlet, admins can remove onboarding tasks for new employees or clean up task lists during offboarding processes.

Conclusion

The Remove-MgUserTodoListTask cmdlet is a powerful tool for managing Microsoft To Do tasks across user accounts. By automating task removal, administrators can streamline task management, prevent clutter, and maintain cleaner task lists. Whether you're removing a single task or performing bulk deletions, this cmdlet offers flexibility and efficiency. Be sure to confirm task details, manage permissions effectively, and carefully review bulk operations to avoid unintentional deletions.