Skip to 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 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

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

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

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

# planner task reference add --taskId "OopX1ANphEu7Lm4-0tVtl5cAFRGQ" --url "https://microsoft.com"

Date: 4/2/2023

Property | Value
---------|-------
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"}}}