@pnp/cli-microsoft365 7.0.0-beta.f2e9fd9 → 7.1.0-beta.129c6c7

package/docs/docs/cmd/planner/plan/plan-remove.mdx

@@ -25,7 +25,7 @@ m365 planner plan remove [options]
 `--ownerGroupName [ownerGroupName]`
 : Name of the Group that owns the plan. Specify either `ownerGroupId` or `ownerGroupName` when using `title`.
 
-`--confirm`
+`-f, --force`
 : Don't prompt for confirmation.
 ```
 
@@ -52,7 +52,7 @@ m365 planner plan remove --title "My Plan" --ownerGroupId 00000000-0000-0000-000
 Removes the Microsoft Planner plan with title _My Plan_ in group with name _My Planner Group_ without confirmation prompt
 
 ```sh
-m365 planner plan remove --title "My Plan" --ownerGroupName "My Planner Group" --confirm
+m365 planner plan remove --title "My Plan" --ownerGroupName "My Planner Group" --force
 ```
 
 ## Response

package/docs/docs/cmd/planner/plan/plan-set.mdx

@@ -59,19 +59,19 @@ When using `rosterId`, the command is based on an API that is currently in previ
 
 ## Examples
 
-Updates a Microsoft Planner plan title to New Title
+Updates a Microsoft Planner plan title.
 
 ```sh
 m365 planner plan set --id 'gndWOTSK60GfPQfiDDj43JgACDCb' --newTitle 'New Title'
 ```
 
-Share a Microsoft Planner plan owned by the group, with the users
+Share a Microsoft Planner plan owned by the group, with the users.
 
 ```sh
 m365 planner plan set --title 'Plan Title' --ownerGroupName 'My Group' --shareWithUserNames 'user1@contoso.com,user2@contoso.com'
 ```
 
-Updates a Microsoft Planner plan category labels
+Updates a Microsoft Planner plan category labels.
 
 ```sh
 m365 planner plan set --id 'gndWOTSK60GfPQfiDDj43JgACDCb' --category21 'ToDo' --category25 'Urgent'
@@ -142,8 +142,6 @@ m365 planner plan set --id 'gndWOTSK60GfPQfiDDj43JgACDCb' --category21 'ToDo' --
   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"}
   ```
 
   </TabItem>
@@ -245,10 +243,6 @@ When we make use of the option `shareWithUserIds` or `shareWithUserNames` the re
   owner | ebf3b108-5234-4e22-b93d-656d7dae5874
   title | My Planner Plan
   id | xqQg5FS2LkCp935s-FIFm2QAFkHM
-  createdBy | {"user":{"displayName":null,"id":"dd8b99a7-77c6-4238-a609-396d27844921"},"application":{"displayName":null,"id":"31359c7f-bd7e-475c-86db-fdb8c937548e"}}
-  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}
   ```
 
   </TabItem>

package/docs/docs/cmd/planner/roster/roster-member-add.mdx

@@ -37,13 +37,13 @@ This command is based on an API that is currently in preview and is subject to c
 
 ## Examples
 
-Adds a specific user by user name as member of the Planner Roster
+Adds a specific user by user name as member of the Planner Roster.
 
 ```sh
 m365 planner roster member add --rosterId tYqYlNd6eECmsNhN_fcq85cAGAnd --userName john.doe@contoso.com
 ```
 
-Adds a specific user by ID as member of the Planner Roster
+Adds a specific user by ID as member of the Planner Roster.
 
 ```sh
 m365 planner roster member add --rosterId tYqYlNd6eECmsNhN_fcq85cAGAnd --userId d049a857-f1c3-4fb3-a629-d8cfb3bd7275
@@ -96,9 +96,7 @@ m365 planner roster member add --rosterId tYqYlNd6eECmsNhN_fcq85cAGAnd --userId
   id | b3a1be03-54a5-43d2-b4fb-6562fe9bec0b
   userId | 2056d2f6-3257-4253-8cfc-b73393e414e5
   tenantId | 5b7b813c-2339-48cd-8c51-bd4fcb269420
-  roles | []
   ```
 
   </TabItem>
 </Tabs>
-

package/docs/docs/cmd/planner/roster/roster-member-get.mdx

@@ -37,13 +37,13 @@ This command is based on an API that is currently in preview and is subject to c
 
 ## Examples
 
-Gets a specific user by user name as member of the Planner Roster
+Gets a specific user by user name as member of the Planner Roster.
 
 ```sh
 m365 planner roster member get --rosterId tYqYlNd6eECmsNhN_fcq85cAGAnd --userName john.doe@contoso.com
 ```
 
-Gets a specific user by ID as member of the Planner Roster
+Gets a specific user by ID as member of the Planner Roster.
 
 ```sh
 m365 planner roster member get --rosterId tYqYlNd6eECmsNhN_fcq85cAGAnd --userId d049a857-f1c3-4fb3-a629-d8cfb3bd7275
@@ -96,9 +96,7 @@ m365 planner roster member get --rosterId tYqYlNd6eECmsNhN_fcq85cAGAnd --userId
   id | b3a1be03-54a5-43d2-b4fb-6562fe9bec0b
   userId | 2056d2f6-3257-4253-8cfc-b73393e414e5
   tenantId | 5b7b813c-2339-48cd-8c51-bd4fcb269420
-  roles | []
   ```
 
   </TabItem>
 </Tabs>
-

package/docs/docs/cmd/planner/roster/roster-member-list.mdx

@@ -31,7 +31,7 @@ This command is based on an API that is currently in preview and is subject to c
 
 ## Examples
 
-Lists members of the specified Microsoft Planner Roster
+Lists members of the specified Microsoft Planner Roster.
 
 ```sh
 m365 planner roster member list --rosterId tYqYlNd6eECmsNhN_fcq85cAGAnd
@@ -85,9 +85,7 @@ m365 planner roster member list --rosterId tYqYlNd6eECmsNhN_fcq85cAGAnd
   id | b3a1be03-54a5-43d2-b4fb-6562fe9bec0b
   userId | 2056d2f6-3257-4253-8cfc-b73393e414e5
   tenantId | 5b7b813c-2339-48cd-8c51-bd4fcb269420
-  roles | []
   ```
 
   </TabItem>
 </Tabs>
-

package/docs/docs/cmd/planner/roster/roster-member-remove.mdx

@@ -22,7 +22,7 @@ m365 planner roster member remove [options]
 `--userName [userName]`
 : User's UPN (user principal name, e.g. johndoe@example.com). Specify either `userId` or `userName` but not both.
 
-`--confirm`
+`-f, --force`
 : Don't prompt for confirmation.
 ```
 
@@ -38,7 +38,7 @@ This command is based on an API that is currently in preview and is subject to c
 
 :::caution
 
-The Planner Roster will be deleted when it doesn't have any users remaining in the membership list because the last user removed themselves. Roster, its plan and all contained tasks will be deleted within 30 days of this operation. We will show an extra prompt when this happens. This prompt is also suppressed when specifying `--confirm`.
+The Planner Roster will be deleted when it doesn't have any users remaining in the membership list because the last user removed themselves. Roster, its plan and all contained tasks will be deleted within 30 days of this operation. We will show an extra prompt when this happens. This prompt is also suppressed when specifying `-f, --force`.
 
 :::
 

package/docs/docs/cmd/planner/roster/roster-remove.mdx

@@ -16,7 +16,7 @@ m365 planner roster remove [options]
 `--id <id>`
 : ID of the Planner Roster.
 
-`--confirm`
+`-f, --force`
 : Don't prompt for confirmation.
 ```
 
@@ -47,7 +47,7 @@ m365 planner roster remove --id tYqYlNd6eECmsNhN_fcq85cAGAnd
 Removes a Planner Roster without confirmation prompt
 
 ```sh
-m365 planner roster remove --id tYqYlNd6eECmsNhN_fcq85cAGAnd --confirm
+m365 planner roster remove --id tYqYlNd6eECmsNhN_fcq85cAGAnd --force
 ```
 
 ## Response

package/docs/docs/cmd/planner/task/task-add.mdx

@@ -19,10 +19,13 @@ m365 planner task add [options]
 : Title of the task to add.
 
 `--planId [planId]`
-: ID of the plan to which the task belongs. Specify either `planId` or `planTitle` but not both.
+: ID of the plan to which the task belongs. Specify either `planId`, `planTitle`, or `rosterId` but not multiple.
 
 `--planTitle [planTitle]`
-: Title of the plan to which the task belongs. Specify either `planId` or `planTitle` but not both.
+: Title of the plan to which the task belongs. Specify either `planId`, `planTitle`, or `rosterId` but not multiple.
+
+`--rosterId [rosterId]`
+: ID of the Planner Roster. Specify either `planId`, `planTitle`, or `rosterId` but not multiple.
 
 `--ownerGroupId [ownerGroupId]`
 : ID of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planTitle`.
@@ -37,10 +40,10 @@ m365 planner task add [options]
 : Name of the bucket to which the task belongs. The bucket needs to exist in the selected plan. Specify either `bucketId` or `bucketName` but not both.
 
 `--startDateTime [startDateTime]`
-: The date and time when the task started. This should be defined as a valid ISO 8601 string. `2021-12-16T18:28:48.6964197Z`
+: The date and time when the task started. This should be defined as a valid ISO 8601 string. e.g. `2021-12-16T18:28:48.6964197Z`
 
 `--dueDateTime [dueDateTime]`
-: The date and time when the task is due. This should be defined as a valid ISO 8601 string. `2021-12-16T18:28:48.6964197Z`
+: The date and time when the task is due. This should be defined as a valid ISO 8601 string. e.g. `2021-12-16T18:28:48.6964197Z`
 
 `--percentComplete [percentComplete]`
 : Percentage of task completion. Number between 0 and 100.
@@ -61,13 +64,13 @@ m365 planner task add [options]
 : Comma-separated categories that should be added to the task. The possible options are: `category1`, `category2`, `category3`, `category4`, `category5` and/or `category6`. Additional info defined [here](https://docs.microsoft.com/graph/api/resources/plannerappliedcategories?view=graph-rest-1.0).
 
 `--previewType [previewType]`
-: This sets the type of preview that shows up on the task. The possible values are: `automatic`, `noPreview`, `checklist`, `description`, `reference`. When set to automatic the displayed preview is chosen by the app viewing the task. Default `automatic`.
+: This sets the type of preview that shows up on the task. Allowed values: `automatic`, `noPreview`, `checklist`, `description`, `reference`. When set to automatic the displayed preview is chosen by the app viewing the task. Defaults to `automatic`.
 
 `--orderHint [orderHint]`
 : Hint used to order items of this type in a list view. The format is defined as outlined [here](https://docs.microsoft.com/graph/api/resources/planner-order-hint-format?view=graph-rest-1.0).
 
 `--priority [priority]`
-: Priority of the task: Urgent, Important, Medium, Low. Or an integer between 0 and 10 (check remarks section for more info). Default value is Medium.
+: Priority of the task. Allowed values: `Urgent`, `Important`, `Medium`, `Low`. Or an integer between 0 and 10 (check remarks section for more info). Defaults to `Medium`.
 ```
 
 <Global />
@@ -89,38 +92,50 @@ When you specify an integer value for `priority`, consider the following:
 
 When using `description` with a multiple lines value, use the new line character of the shell you are using to indicate line breaks. For PowerShell this is `` `n ``. For Zsh or Bash use `\n` with a `$` in front. E.g. `$"Line 1\nLine 2"`.
 
+:::caution
+
+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.
+
+:::
+
 ## Examples
 
-Adds a Microsoft Planner task with the name _My Planner Task_ for plan with the ID _8QZEH7b3wkSbGQobscsM5gADCBa_ and for the bucket with the ID _IK8tuFTwQEa5vTonM7ZMRZgAKdna_
+Adds a Microsoft Planner task with the name for plan with the specified ID and specified bucket with the ID.
 
 ```sh
 m365 planner task add --title "My Planner Task" --planId "8QZEH7b3wkSbGQobscsM5gADCBa" --bucketId "IK8tuFTwQEa5vTonM7ZMRZgAKdna"
 ```
 
-Adds a Completed Microsoft Planner task with the name _My Planner Task_ for plan with the title _My Planner Plan_ owned by group _My Planner Group_ and for the bucket with the ID _IK8tuFTwQEa5vTonM7ZMRZgAKdna_
+Adds a Completed Microsoft Planner task with the name for plan with the specified title owned by specified group and the specified bucket with the ID.
 
 ```sh
 m365 planner task add --title "My Planner task" --planTitle "My Planner Plan" --ownerGroupName "My Planner Group" --bucketId "IK8tuFTwQEa5vTonM7ZMRZgAKdna" --percentComplete 100
 ```
 
-Adds a Microsoft Planner task with the name _My Planner Task_ for plan with the ID _8QZEH7b3wkbGQobscsM5gADCBa_ and for the bucket with the ID _IK8tuFTwQEa5vTonM7ZMRZgAKdna_. The new task will be assigned to several users and receive a due date for _2021-12-16_
+Adds a Microsoft Planner task with the specified name for the plan with the specified ID and bucket with the ID. The new task will be assigned to the specified users and receive a specified due date.
 
 ```sh
 m365 planner task add --title "My Planner Task" --planId "8QZEH7b3wkSbGQobscsM5gADCBa" --bucketId "IK8tuFTwQEa5vTonM7ZMRZgAKdna" --assignedToUserNames "Allan.Carroll@contoso.com,Ida.Stevens@contoso.com" --dueDateTime "2021-12-16"
 ```
 
-Adds a Microsoft Planner task with the name _My Planner Task_ for plan with the ID _8QZEH7b3wkbGQobscsM5gADCBa_ and for the bucket with the ID _IK8tuFTwQEa5vTonM7ZMRZgAKdna_. The new task will be assigned to several users who will appear first with the asssignee priority _' !'_ 
+Adds a Microsoft Planner task with the specified name for the plan with the specified ID and bucket with the ID. The new task will be assigned to the specified users who will appear first with the asssignee priority _' !'_ 
 
 ```sh
 m365 planner task add --title "My Planner Task" --planId "8QZEH7b3wkSbGQobscsM5gADCBa" --bucketId "IK8tuFTwQEa5vTonM7ZMRZgAKdna" --assignedToUserNames "Allan.Carroll@contoso.com,Ida.Stevens@contoso.com" --asssigneePriority ' !'
 ```
 
-Adds a Microsoft Planner task with the name _My Planner Task_ for plan with the ID _8QZEH7b3wkbGQobscsM5gADCBa_ and for the bucket with the ID _IK8tuFTwQEa5vTonM7ZMRZgAKdna_. The new task will receive the categories _category1,category3_ and get a preview with the type _noPreview_
+Adds a Microsoft Planner task with the specified name for the plan with the specified ID and the bucket with the ID. The new task will receive the specified categories and get a specified preview with the type.
 
 ```sh
 m365 planner task add --title "My Planner Task" --planId "8QZEH7b3wkSbGQobscsM5gADCBa" --bucketId "IK8tuFTwQEa5vTonM7ZMRZgAKdna" --appliedCategories "category1,category3" --previewType "noPreview"
 ```
 
+Adds a Microsoft Planner task with the specified name for the plan with the specified rosterId and bucket with the ID.
+
+```sh
+m365 planner task add --title "My Planner Task" --rosterId "DjL5xiKO10qut8LQgztpKskABWna" --bucketId "IK8tuFTwQEa5vTonM7ZMRZgAKdna"
+```
+
 ## Response
 
 ### Standard response
@@ -232,9 +247,6 @@ m365 planner task add --title "My Planner Task" --planId "8QZEH7b3wkSbGQobscsM5g
   conversationThreadId | null
   priority | 5
   id | D-ys8Ef4kEuwYG4r68Um3pcAAe9M
-  createdBy | {"user":{"displayName":null,"id":"b2091e18-7882-4efe-b7d1-90703f5a5c65"},"application":{"displayName":null,"id":"31359c7f-bd7e-475c-86db-fdb8c937548e"}}
-  appliedCategories | {}
-  assignments | {}
   ```
 
   </TabItem>
@@ -354,14 +366,7 @@ m365 planner task add --title "My Planner Task" --planId "8QZEH7b3wkSbGQobscsM5g
   conversationThreadId | null
   priority | 5
   id | D-ys8Ef4kEuwYG4r68Um3pcAAe9M
-  createdBy | {"user":{"displayName":null,"id":"b2091e18-7882-4efe-b7d1-90703f5a5c65"},"application":{"displayName":null,"id":"31359c7f-bd7e-475c-86db-fdb8c937548e"}}
-  appliedCategories | {}
-  assignments | {}
-  description | Lorem ipsum dolor sit amet, consectetur adipiscing elit.
-  references | {}
-  checklist | {}
   ```
 
   </TabItem>
 </Tabs>
-

package/docs/docs/cmd/planner/task/task-checklistitem-add.mdx

@@ -29,13 +29,13 @@ m365 planner task checklistitem add [options]
 
 ## Examples
 
-Adds an unchecked checklist item with title _My checklist item_ to a Microsoft Planner task with ID _2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2_
+Adds an unchecked checklist item with the specified title to a Microsoft Planner task with the specified ID.
 
 ```sh
 m365 planner task checklistitem add --taskId 2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2 --title "My checklist item"
 ```
 
-Adds a checked checklist item with title _My checklist item_ to a Microsoft Planner task with ID _2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2_
+Adds a checked checklist item with the specified title to a Microsoft Planner task with the specified ID.
 
 ```sh
 m365 planner task checklistitem add --taskId 2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2 --title "My checklist item" --isChecked
@@ -97,9 +97,7 @@ m365 planner task checklistitem add --taskId 2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2 --titl
   title | Communicate with customer
   orderHint | 8585269209601773376
   lastModifiedDateTime | 2023-01-25T22:32:05.3002431Z
-  lastModifiedBy | {"user":{"displayName":null,"id":"b2091e18-7882-4efe-b7d1-90703f5a5c65"}}
   ```
 
   </TabItem>
 </Tabs>
-

package/docs/docs/cmd/planner/task/task-checklistitem-list.mdx

@@ -16,7 +16,7 @@ m365 planner task checklistitem list [options]
 
 ```md definition-list
 `-i, --taskId <taskId>`
-: ID of the task
+: ID of the task.
 ```
 
 <Global />
@@ -85,9 +85,7 @@ m365 planner task checklistitem list --taskId 'vzCcZoOv-U27PwydxHB8opcADJo-'
   title | Communicate with customer
   orderHint | 8585269209601773376
   lastModifiedDateTime | 2023-01-25T22:32:05.3002431Z
-  lastModifiedBy | {"user":{"displayName":null,"id":"b2091e18-7882-4efe-b7d1-90703f5a5c65"}}
   ```
 
   </TabItem>
 </Tabs>
-

package/docs/docs/cmd/planner/task/task-checklistitem-remove.mdx

@@ -19,7 +19,7 @@ m365 planner task checklistitem remove [options]
 `--taskId <taskId>`
 : ID of the task.
 
-`--confirm`
+`-f, --force`
 : Don't prompt for confirmation
 ```
 
@@ -36,7 +36,7 @@ m365 planner task checklistitem remove --id "40012" --taskId "2Vf8JHgsBUiIf-nuvB
 Removes a checklist item with the id _40012_ from the Planner task with the id _2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2_ without prompt
 
 ```sh
-m365 planner task checklistitem remove --id "40012" --taskId "2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2" --confirm
+m365 planner task checklistitem remove --id "40012" --taskId "2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2" --force
 ```
 
 ## Response

package/docs/docs/cmd/planner/task/task-get.mdx

@@ -28,10 +28,13 @@ m365 planner task get [options]
 : Name of the bucket to which the task belongs. Specify `bucketId` or `bucketName` when using `title`.
 
 `--planId [planId]`
-: ID of the plan to which the task belongs. Specify `planId` or `planTitle` when using `bucketName`.
+: ID of the plan to which the task belongs. Specify either `planId`, `planTitle`, or `rosterId` when using `bucketName`.
 
 `--planTitle [planTitle]`
-: Title of the plan to which the task belongs. Specify `planId` or `planTitle` when using `bucketName`.
+: Title of the plan to which the task belongs. Specify either `planId`, `planTitle`, or `rosterId` when using `bucketName`.
+
+`--rosterId [rosterId]`
+: ID of the Planner Roster. Specify either `planId`, `planTitle`, or `rosterId` when using `bucketName`.
 
 `--ownerGroupId [ownerGroupId]`
 : ID of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planTitle`.
@@ -44,18 +47,24 @@ m365 planner task get [options]
 
 ## Examples
 
-Retrieve the specified planner task by id
+Returns the Microsoft Planner task by id.
 
 ```sh
 m365 planner task get --id "vzCcZoOv-U27PwydxHB8opcADJo-"
 ```
 
-Retrieve the specified planner task with the title _My Planner Task_ from the bucket named _My Planner Bucket_. Based on the plan with the title _My Planner Plan_ owned by the group _My Planner Group_.
+Retrieve the Microsoft Planner task by title from the specified bucket. Based on the specified plan with the title owned by the specified group.
 
 ```sh
 m365 planner task get --title "My Planner Task" --bucketName "My Planner Bucket" --planTitle "My Planner Plan" --ownerGroupName "My Planner Group"
 ```
 
+Returns the Microsoft Planner task by rosterId from the specified bucket.
+
+```sh
+m365 planner task get --title "New Task" --bucketName "To do" --rosterId "DjL5xiKO10qut8LQgztpKskABWna"
+```
+
 ## Response
 
 <Tabs>
@@ -183,14 +192,7 @@ m365 planner task get --title "My Planner Task" --bucketName "My Planner Bucket"
   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 | {}
-  description | Lorem ipsum dolor sit amet, consectetur adipiscing elit.
-  references | {}
-  checklist | {"4e3c8841-560c-436e-ba06-cc7731680d59":{"isChecked":false,"title":"Communicate with customer","orderHint":"8585269209601773376","lastModifiedDateTime":"2023-01-25T22:32:05.3002431Z","lastModifiedBy":{"user":{"displayName":null,"id":"b2091e18-7882-4efe-b7d1-90703f5a5c65"}}}}
   ```
 
   </TabItem>
 </Tabs>
-

package/docs/docs/cmd/planner/task/task-list.mdx

@@ -22,10 +22,13 @@ m365 planner task list [options]
 : 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.
+: ID of a plan to list the tasks of. To retrieve all tasks from a plan, Specify either `planId`, `planTitle`, or `rosterId` but not multiple. 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.
+: Title of a plan to list the tasks of. To retrieve all tasks from a plan, Specify either `planId`, `planTitle`, or `rosterId` but not multiple. Always use in combination with either `ownerGroupId` or `ownerGroupName`. Use in combination with `bucketName` to retrieve tasks from a specific bucket.
+
+`--rosterId [rosterId]`
+: ID of the Planner Roster. Specify either `planId`, `planTitle`, or `rosterId` but not multiple.
 
 `--ownerGroupId [ownerGroupId]`
 : ID of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planTitle`.
@@ -44,44 +47,56 @@ This command uses API that is currently in preview to enrich the results with th
 
 :::
 
+:::caution
+
+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.
+
+:::
+
 ## Examples
 
-List tasks for the currently logged in user
+List tasks for the currently logged in user.
 
 ```sh
 m365 planner task list
 ```
 
-List the Microsoft Planner tasks in the plan _iVPMIgdku0uFlou-KLNg6MkAE1O2_
+List the Microsoft Planner tasks in the plan by id.
 
 ```sh
 m365 planner task list --planId "iVPMIgdku0uFlou-KLNg6MkAE1O2"`
 ```
 
-List the Microsoft Planner tasks in the plan _My Plan_ in group _My Group_
+List the Microsoft Planner tasks in the specified plan by title from the specified group by name.
 
 ```sh
 m365 planner task list --planTitle "My Plan" --ownerGroupName "My Group"
 ```
 
-List the Microsoft Planner tasks in the bucket _FtzysDykv0-9s9toWiZhdskAD67z_
+List the Microsoft Planner tasks in the bucket by id.
 
 ```sh
 m365 planner task list --bucketId "FtzysDykv0-9s9toWiZhdskAD67z"
 ```
 
-List the Microsoft Planner tasks in the bucket _My Bucket_ belonging to plan _iVPMIgdku0uFlou-KLNg6MkAE1O2_
+List the Microsoft Planner tasks in the bucket by name belonging to plan by id.
 
 ```sh
 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_
+List the Microsoft Planner tasks in the bucket by name belonging to plan by title in the specified group.
 
 ```sh
 m365 planner task list --bucketName "My Bucket" --planTitle "My Plan" --ownerGroupName "My Group"
 ```
 
+List the Microsoft Planner tasks by rosterId from the specified bucket.
+
+```sh
+m365 planner task list --bucketName "My Bucket" --rosterId "DjL5xiKO10qut8LQgztpKskABWna"
+```
+
 ## Response
 
 <Tabs>
@@ -173,11 +188,7 @@ m365 planner task list --bucketName "My Bucket" --planTitle "My Plan" --ownerGro
   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 | {}
   ```
 
   </TabItem>
 </Tabs>
-

package/docs/docs/cmd/planner/task/task-reference-add.mdx

@@ -97,9 +97,7 @@ m365 planner task reference add --taskId "2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2" --url "h
 
   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"}}}
   ```
 
   </TabItem>
 </Tabs>
-

package/docs/docs/cmd/planner/task/task-reference-list.mdx

@@ -76,9 +76,7 @@ m365 planner task reference list --taskId uBk5fK_MHkeyuPYlCo4OFpcAM
 
   Property | Value
   ---------|-------
-  https%3A//microsoft%2Ecom | {"alias":null,"type":null,"previewPriority":"8585269191724168649Pp;","lastModifiedDateTime":"2023-01-25T23:02:53.107589Z","lastModifiedBy":{"user":{"displayName":null,"id":"b2091e18-7882-4efe-b7d1-90703f5a5c65"}}}
   ```
 
   </TabItem>
 </Tabs>
-

package/docs/docs/cmd/planner/task/task-reference-remove.mdx

@@ -22,7 +22,7 @@ m365 planner task reference remove [options]
 `-i, --taskId <taskId>`
 : ID of the task.
 
-`--confirm`
+`-f, --force`
 : Don't prompt for confirmation
 ```
 

package/docs/docs/cmd/planner/task/task-remove.mdx

@@ -26,10 +26,13 @@ m365 planner task remove [options]
 : Name of the bucket to which the task to remove belongs. Specify either `bucketId` or `bucketName` but not both.
 
 `--planId [planId]`
-: ID of the plan to which the task to remove belongs. Specify either `planId` or `planTitle` when using `title`.
+: ID of the plan to which the task to remove belongs. Specify either `planId`, `planTitle`, or `rosterId` when using `title`.
 
 `--planTitle [planTitle]`
-: Title of the plan to which the task to remove belongs. Specify either `planId` or `planTitle` when using `title`.
+: Title of the plan to which the task to remove belongs. Specify either `planId`, `planTitle`, or `rosterId` when using `title`.
+
+`--rosterId [rosterId]`
+: ID of the Planner Roster. Specify either `planId`, `planTitle`, or `rosterId` when using `title`.
 
 `--ownerGroupId [ownerGroupId]`
 : ID of the group to which the plan belongs. Specify either `ownerGroupId` or `ownerGroupName` when using `planTitle`.
@@ -37,50 +40,64 @@ m365 planner task remove [options]
 `--ownerGroupName [ownerGroupName]`
 : Name of the group to which the plan belongs. Specify either `ownerGroupId` or `ownerGroupName` when using `planTitle`.
 
-`--confirm`
+`-f, --force`
 : Don't prompt for confirmation
 ```
 
 <Global />
 
+## Remarks
+
+:::caution
+
+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.
+
+:::
+
 ## Examples
 
-Removes the Microsoft Planner task by ID
+Removes the Microsoft Planner task by ID.
 
 ```sh
 m365 planner task remove --id "2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2"
 ```
 
-Removes the Microsoft Planner task by ID without confirmation
+Removes the Microsoft Planner task by ID without confirmation.
 
 ```sh
-m365 planner task remove --id "2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2" --confirm
+m365 planner task remove --id "2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2" --force
 ```
 
-Removes the Microsoft Planner task with title _My Task_ in the bucket with ID _vncYUXCRBke28qMLB-d4xJcACtNz_
+Removes the Microsoft Planner task with the specified title in the bucket by ID.
 
 ```sh
 m365 planner task remove --title "My Task" --bucketId "vncYUXCRBke28qMLB-d4xJcACtNz" 
 ```
 
-Removes the Microsoft Planner task with title _My Task_ in the bucket with name _My Bucket_ in the Plan with ID _oUHpnKBFekqfGE_PS6GGUZcAFY7b_
+Removes the Microsoft Planner task with the specified title the bucket by name in the Plan with the specified ID.
 
 ```sh
 m365 planner task remove --title "My Task" --bucketName "My Bucket" --planId "oUHpnKBFekqfGE_PS6GGUZcAFY7b"
 ```
 
-Removes the Microsoft Planner task with title _My Task_ in the bucket with name _My Bucket_ in the Plan _My Plan_ owned by group _My Group_
+Removes the Microsoft Planner task with the specified title in the bucket with name in the Plan owned by group with the specified name.
 
 ```sh
 m365 planner task remove --title "My Task" --bucketName "My Bucket" --planTitle "My Plan" --ownerGroupName "My Group"
 ```
 
-Removes the Microsoft Planner task with title _My Task_ in the bucket with name _My Bucket_ in the Plan _My Plan_ owned by group with ID _00000000-0000-0000-0000-000000000000_
+Removes the Microsoft Planner task with the specified title in the bucket with name in the Plan owned by group with the specified ID.
 
 ```sh
 m365 planner task remove --title "My Task" --bucketName "My Bucket" --planTitle "My Plan" --ownerGroupId "00000000-0000-0000-0000-000000000000"
 ```
 
+Removes the Microsoft Planner task by rosterId from the specified bucket.
+
+```sh
+m365 planner task remove --title "My Task" --bucketName "My Bucket" --rosterId "DjL5xiKO10qut8LQgztpKskABWna"
+```
+
 ## Response
 
 The command won't return a response on success.