Table of Contents

Get-PnPTodoTask

SYNOPSIS

Required Permissions

  • Microsoft Graph API : One of Tasks.Read, Tasks.ReadWrite, Tasks.Read.All

Gets one Todo task or all Todo tasks from a Todo list by list Id or display name.

SYNTAX

Get-PnPTodoTask [-List] <TodoTaskPipeBind> [[-Identity] <TodoTaskPipeBind>] [-User <EntraIDUserPipeBind>]

DESCRIPTION

Use the cmdlet to retrieve all Todo tasks from a Todo list or a specific Todo task. The Todo list can be specified by Id or display name.

EXAMPLES

EXAMPLE 1

Get-PnPTodoTask -List "AQMkADAwATM0MDAAMS0yMDkyLTllN2QtMDACLTAwCgAuAAAD"

This will return all tasks from the specified Todo list associated with your logged-in user account.

EXAMPLE 2

Get-PnPTodoTask -List "Travel items"

This will return all tasks from the Todo list with the specified display name associated with your logged-in user account.

EXAMPLE 3

Get-PnPTodoTask -List "AQMkADAwATM0MDAAMS0yMDkyLTllN2QtMDACLTAwCgAuAAAD" -Identity "AAMkAGU4MGE1OTRiLTUzMGEtNDRjZi05ZmVmLWFiMTkyYmQxODRjOQAuAAAAAACQV8RStyZCQJ4ydzjIK5HmAQD2LFcxdwYMRqbupn47nEYYAASUnLfyAAA="

This will return the specified Todo task from the specified Todo list associated with your logged-in user account.

EXAMPLE 4

Get-PnPTodoTask -User john@doe.com -List "AQMkADAwATM0MDAAMS0yMDkyLTllN2QtMDACLTAwCgAuAAAD"

This will return all tasks from the specified Todo list associated with John's account.

EXAMPLE 5

Get-PnPTodoTask -User john@doe.com -List "Travel items"

This will return all tasks from the Todo list with the specified display name associated with John's account.

PARAMETERS

-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)

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Identity

Id of the Todo task or an instance returned by Get-PnPTodoTask.

Type: TodoTaskPipeBind
Parameter Sets: (All)

Required: False
Position: Named
Default value: None
Accept pipeline input: True
Accept wildcard characters: False

-List

Id or display name of the Todo list.

Type: String
Parameter Sets: (All)

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-User

The UPN, Id or instance of an Entra ID user for which you would like to retrieve Todo tasks.

Type: EntraIDUserPipeBind
Parameter Sets: (All)

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

Microsoft 365 Patterns and Practices