Skip to main content

planner task list

Lists planner tasks in a bucket, plan, or tasks for the currently logged in user

Usage​

m365 planner task list [options]

Options​

--bucketId [bucketId]

ID of the bucket to list the tasks of. To retrieve tasks from a bucket, specify bucketId or bucketName, but not both.

--bucketName [bucketName]

Name of the bucket to list the tasks of. To retrieve tasks from a bucket, specify bucketId or bucketName, but not both.

--planId [planId]

ID of a plan to list the tasks of. To retrieve all tasks from a plan, specify either planId or planTitle but not both. Use in combination with bucketName to retrieve tasks from a specific bucket.

--planTitle [planTitle]

Title of a plan to list the tasks of. To retrieve all tasks from a plan, specify either planId or planTitle but not both. Always use in combination with either ownerGroupId or ownerGroupName. Use in combination with bucketName to retrieve tasks from a specific bucket.

--ownerGroupId [ownerGroupId]

ID of the group to which the plan belongs. Specify ownerGroupId or ownerGroupName when using planTitle.

--ownerGroupName [ownerGroupName]

Name of the group to which the plan belongs. Specify ownerGroupId or ownerGroupName when using planTitle.

-h, --help [help]

Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are options, examples, remarks, response, full. Default is full.

--query [query]

JMESPath query string. See http://jmespath.org/ for more information and examples.

-o, --output [output]

Output type. json, text, csv, md. Default json.

--verbose

Runs command with verbose logging.

--debug

Runs command with debug logging.

Remarks​

caution

This command uses API that is currently in preview to enrich the results with the priority field. Keep in mind that this preview API is subject to change once the API reached general availability.

Examples​

List tasks for the currently logged in user

m365 planner task list

List the Microsoft Planner tasks in the plan iVPMIgdku0uFlou-KLNg6MkAE1O2

m365 planner task list --planId "iVPMIgdku0uFlou-KLNg6MkAE1O2"`

List the Microsoft Planner tasks in the plan My Plan in group My Group

m365 planner task list --planTitle "My Plan" --ownerGroupName "My Group"

List the Microsoft Planner tasks in the bucket FtzysDykv0-9s9toWiZhdskAD67z

m365 planner task list --bucketId "FtzysDykv0-9s9toWiZhdskAD67z"

List the Microsoft Planner tasks in the bucket My Bucket belonging to plan iVPMIgdku0uFlou-KLNg6MkAE1O2

m365 planner task list --bucketName "My Bucket" --planId "iVPMIgdku0uFlou-KLNg6MkAE1O2"

List the Microsoft Planner tasks in the bucket My Bucket belonging to plan My Plan in group My Group

m365 planner task list --bucketName "My Bucket" --planTitle "My Plan" --ownerGroupName "My Group"

Response​

[
  {
    "planId": "oUHpnKBFekqfGE_PS6GGUZcAFY7b",
    "bucketId": "vncYUXCRBke28qMLB-d4xJcACtNz",
    "title": "Important task",
    "orderHint": "8585269235419217847",
    "assigneePriority": "",
    "percentComplete": 50,
    "startDateTime": "2023-01-20T00:00:00Z",
    "createdDateTime": "2023-01-25T21:49:03.555796Z",
    "dueDateTime": "2023-02-15T00:00:00Z",
    "hasDescription": true,
    "previewType": "automatic",
    "completedDateTime": null,
    "completedBy": null,
    "referenceCount": 0,
    "checklistItemCount": 1,
    "activeChecklistItemCount": 1,
    "conversationThreadId": null,
    "priority": 5,
    "id": "OopX1ANphEu7Lm4-0tVtl5cAFRGQ",
    "createdBy": {
      "user": {
        "displayName": null,
        "id": "b2091e18-7882-4efe-b7d1-90703f5a5c65"
      },
      "application": {
        "displayName": null,
        "id": "31359c7f-bd7e-475c-86db-fdb8c937548e"
      }
    },
    "appliedCategories": {},
    "assignments": {}
  }
]
CTRL + M