Table of Contents

Get-PnPTodoTaskChecklistItem

SYNOPSIS

Required Permissions

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

Gets one Todo task checklist item or all checklist items from a Todo task.

SYNTAX

Get-PnPTodoTaskChecklistItem [-List] <String> [-Task] <TodoTaskPipeBind> [[-Identity] <String>] [-User <EntraIDUserPipeBind>]

DESCRIPTION

Use the cmdlet to retrieve checklist items from a Todo task.

EXAMPLES

EXAMPLE 1

Get-PnPTodoTaskChecklistItem -List "AQMkADAwATM0MDAAMS0yMDkyLTllN2QtMDACLTAwCgAuAAAD" -Task "AAMkAGU4MGE1OTRiLTUzMGEtNDRjZi05ZmVm"

This will return all checklist items for the specified Todo task.

EXAMPLE 2

Get-PnPTodoTaskChecklistItem -List "AQMkADAwATM0MDAAMS0yMDkyLTllN2QtMDACLTAwCgAuAAAD" -Task "AAMkAGU4MGE1OTRiLTUzMGEtNDRjZi05ZmVm" -Identity "e8dc83b5-8fc2-4a5c-b5c8-a18b3f60f609"

This will return the specified checklist item for the specified Todo task.

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 checklist item.

Type: String
Parameter Sets: (All)

Required: False
Position: Named
Default value: None
Accept pipeline input: False
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

-Task

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

Type: TodoTaskPipeBind
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 checklist items.

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