Skip to main content

planner task reference add

Adds a new reference to a Planner task.

Usage​

m365 planner task reference add [options]

Options​

-i, --taskId <taskId>

ID of the task.

-u, --url <url>

URL location of the reference.

--alias [alias]

A name alias to describe the reference.

--type [type]

Used to describe the type of the reference. Types include: PowerPoint, Word, Excel, Other.

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

Examples​

Add a new reference with the url https://www.microsoft.com to a Planner task with the id 2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2

m365 planner task reference add --taskId "2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2" --url "https://www.microsoft.com"

Add a new reference with the url https://www.microsoft.com and with the alias Parker to a Planner task with the id 2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2

m365 planner task reference add --taskId "2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2" --url "https://www.microsoft.com" --alias "Parker"

Add a new reference with the url https://www.microsoft.com and with the type Excel to a Planner task with the id 2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2

m365 planner task reference add --taskId "2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2" --url "https://www.microsoft.com" --type "Excel"

Response​

{
  "https%3A//microsoft%2Ecom": {
    "alias": null,
    "type": null,
    "previewPriority": "8585269190192498871PB",
    "lastModifiedDateTime": "2023-01-25T23:05:26.24332Z",
    "lastModifiedBy": {
      "user": {
        "displayName": null,
        "id": "b2091e18-7882-4efe-b7d1-90703f5a5c65"
      }
    }
  }
}
CTRL + M