Skip to main content

planner plan get

Retrieve information about the specified plan

Usage​

m365 planner plan get [options]

Options​

-i, --id [id]

ID of the plan. Specify either id, title or rosterId but not multiple.

-t, --title [title]

Title of the plan. Specify either id, title or rosterId but not multiple.

--rosterId [rosterId]

ID of the Planner Roster. Specify either id, title or rosterId but not multiple.

--ownerGroupId [ownerGroupId]

ID of the Group that owns the plan. Specify either ownerGroupId or ownerGroupName when using title but not both.

--ownerGroupName [ownerGroupName]

Name of the Group that owns the plan. Specify either ownerGroupId or ownerGroupName when using title but not both.

-h, --help [help]

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

--query [query]

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

-o, --output [output]

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

--verbose

Runs command with verbose logging.

--debug

Runs command with debug logging.

Remarks​

warning

When using rosterId, the command is based on an API that is currently in preview and is subject to change once the API reached general availability.

Permissions​

ResourcePermissions
Microsoft GraphTasks.Read, GroupMember.Read.All

Examples​

Returns the Microsoft Planner plan by id.

m365 planner plan get --id "gndWOTSK60GfPQfiDDj43JgACDCb"

Returns the Microsoft Planner plan by title and owner group id.

m365 planner plan get --title "MyPlan" --ownerGroupId "233e43d0-dc6a-482e-9b4e-0de7a7bce9b4"

Returns the Microsoft Planner plan by title and owner group name.

m365 planner plan get --title "MyPlan" --ownerGroupName "My Planner Group"

Returns the Microsoft Planner plan by roster id.

m365 planner plan get --rosterId "FeMZFDoK8k2oWmuGE-XFHZcAEwtn"

Response​

{
  "createdDateTime": "2015-03-30T18:36:49.2407981Z",
  "owner": "ebf3b108-5234-4e22-b93d-656d7dae5874",
  "title": "My Planner Plan",
  "id": "xqQg5FS2LkCp935s-FIFm2QAFkHM",
  "createdBy": {
    "user": {
      "displayName": null,
      "id": "95e27074-6c4a-447a-aa24-9d718a0b86fa"
    },
    "application": {
      "displayName": null,
      "id": "ebf3b108-5234-4e22-b93d-656d7dae5874"
    }
  },
  "container": {
    "containerId": "ebf3b108-5234-4e22-b93d-656d7dae5874",
    "type": "group",
    "url": "https://graph.microsoft.com/v1.0/groups/ebf3b108-5234-4e22-b93d-656d7dae5874"
  },
  "sharedWith": {
    "ebf3b108-5234-4e22-b93d-656d7dae5874": true,
    "6463a5ce-2119-4198-9f2a-628761df4a62": true
  },
  "categoryDescriptions": {
    "category1": null,
    "category2": null,
    "category3": null,
    "category4": null,
    "category5": null,
    "category6": null,
    "category7": null,
    "category8": null,
    "category9": null,
    "category10": null,
    "category11": null,
    "category12": null,
    "category13": null,
    "category14": null,
    "category15": null,
    "category16": null,
    "category17": null,
    "category18": null,
    "category19": null,
    "category20": null,
    "category21": null,
    "category22": null,
    "category23": null,
    "category24": null,
    "category25": null
  }
}