Skip to main content

planner plan add

Adds a new Microsoft Planner plan

Usage​

m365 planner plan add [options]

Options​

-t, --title <title>

Title of the plan to add.

--ownerGroupId [ownerGroupId]

ID of the Group that owns the plan. A valid group must exist before this option can be set. Specify either ownerGroupId, ownerGroupName or rosterId.

--ownerGroupName [ownerGroupName]

Name of the Group that owns the plan. A valid group must exist before this option can be set. Specify either ownerGroupId, ownerGroupName or rosterId.

--rosterId [rosterId]

ID of the Planner Roster. Specify either ownerGroupId, ownerGroupName or rosterId.

--shareWithUserIds [shareWithUserIds]

The comma-separated IDs of the users with whom you want to share the plan. Specify either shareWithUserIds or shareWithUserNames but not both.

--shareWithUserNames [shareWithUserNames]

The comma-separated UPNs of the users with whom you want to share the plan. Specify either shareWithUserIds or shareWithUserNames 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, 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​

  • Related to the options --shareWithUserIds and --shareWithUserNames. If you are leveraging Microsoft 365 groups, use the entra m365group user commands to manage group membership to share the group's plan. You can also add existing members of the group to this collection though it is not required for them to access the plan owned by the group.

  • Hint: Unlike for groups, a Planner Roster can contain only 1 plan.

Examples​

Adds a Microsoft Planner plan with a Group by id.

m365 planner plan add --title 'My Planner Plan' --ownerGroupId '233e43d0-dc6a-482e-9b4e-0de7a7bce9b4'

Adds a Microsoft Planner plan with with a Group by name.

m365 planner plan add --title 'My Planner Plan' --ownerGroupName 'My Planner Group'

Adds a Microsoft Planner plan with a Roster by id.

m365 planner plan add --title 'My Planner Plan' --rosterId '8bc07d47-c06f-41e1-8f00-1c113c8f6067'

Adds a Microsoft Planner plan with with a Group by name and share it with the given users.

m365 planner plan add --title 'My Planner Plan' --ownerGroupName 'My Planner Group' --shareWithUserNames 'Allan.Carroll@contoso.com,Ida.Stevens@contoso.com'

Response​

Standard 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"
  }
}

shareWithUserIds, shareWithUserNames response​

When we make use of the option shareWithUserIds or shareWithUserNames the response will differ.

{
  "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
  }
}
CTRL + M