@pnp/cli-microsoft365 7.0.0-beta.a9cf617 → 7.0.0-beta.af1793c

package/docs/docs/cmd/pa/app/app-permission-list.mdx

@@ -0,0 +1,132 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# pa app permission list
+
+Lists all permissions of a Power Apps app
+
+## Usage
+
+```sh
+m365 pa app permission list [options]
+```
+
+## Options
+
+```md definition-list
+`--appName <appName>`
+: The name (GUID) of the Microsoft Power App.
+
+`--roleName [roleName]`
+: Filter the results to only a given role: `Owner`, `CanEdit`, `CanView`.
+
+`--asAdmin`
+: Run the command as admin for apps you don't own.
+
+`-e, --environmentName [environmentName]`
+: The name of the environment. Required when using `asAdmin`.
+```
+
+<Global />
+
+## Remarks
+
+When you specify a value for `roleName`, consider the following:
+
+- `Owner` shows all the owners of the application.
+- `CanEdit` shows all the co-owners of the application.
+- `CanView` shows all the users with run only permissions.
+
+## Examples
+
+List all permissions for an app you have access to
+
+```sh
+m365 pa app permission list --appName bc9f0a7e-53df-46af-b669-5888bb2f63d0
+```
+
+List all permissions as admin for an app you don't have access to
+
+```sh
+m365 pa app permission list --environmentName "Default-e448e34a-40cc-441a-94c6-ec701a9a9ec2" --appName bc9f0a7e-53df-46af-b669-5888bb2f63d0 --asAdmin
+```
+
+List all co-owners for an app you have access to
+
+```sh
+m365 pa app permission list --appName bc9f0a7e-53df-46af-b669-5888bb2f63d0 --roleName CanEdit
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "name": "fe36f75e-c103-410b-a18a-2bf6df06ac3a",
+      "id": "/providers/Microsoft.PowerApps/apps/37ea6004-f07b-46ca-8ef3-a256b67b4dbb/permissions/fe36f75e-c103-410b-a18a-2bf6df06ac3a",
+      "type": "Microsoft.PowerApps/apps/permissions",
+      "properties": {
+        "roleName": "Owner",
+        "principal": {
+          "id": "fe36f75e-c103-410b-a18a-2bf6df06ac3a",
+          "displayName": "John Doe",
+          "email": "john@contoso.com",
+          "type": "User",
+          "tenantId": "e1dd4023-a656-480a-8a0e-c1b1eec51e1d"
+        },
+        "scope": "/providers/Microsoft.PowerApps/environments/Default-e1dd4023-a656-480a-8a0e-c1b1eec51e1d/apps/37ea6004-f07b-46ca-8ef3-a256b67b4dbb",
+        "notifyShareTargetOption": "NotSpecified",
+        "inviteGuestToTenant": false,
+        "createdOn": "2022-10-25T21:28:14.2122305Z",
+        "createdBy": "f0db9c91-3dae-49c8-98fa-8059b8909d45"
+      },
+      "roleName": "Owner",
+      "principalId": "fe36f75e-c103-410b-a18a-2bf6df06ac3a",
+      "principalType": "User"
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  roleName  principalId                           principalType
+  --------  ------------------------------------  -------------
+  Owner     fe36f75e-c103-410b-a18a-2bf6df06ac3a  User
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  name,id,type,roleName,principalId,principalType
+  fe36f75e-c103-410b-a18a-2bf6df06ac3a,/providers/Microsoft.PowerApps/apps/37ea6004-f07b-46ca-8ef3-a256b67b4dbb/permissions/fe36f75e-c103-410b-a18a-2bf6df06ac3a,Microsoft.PowerApps/apps/permissions,Owner,fe36f75e-c103-410b-a18a-2bf6df06ac3a,User
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # pa app permission list --appName "37ea6004-f07b-46ca-8ef3-a256b67b4dbb"
+
+  Date: 25/06/2023
+
+  ## fe36f75e-c103-410b-a18a-2bf6df06ac3a (/providers/Microsoft.PowerApps/apps/37ea6004-f07b-46ca-8ef3-a256b67b4dbb/permissions/fe36f75e-c103-410b-a18a-2bf6df06ac3a)
+
+  Property | Value
+  ---------|-------
+  name | fe36f75e-c103-410b-a18a-2bf6df06ac3a
+  id | /providers/Microsoft.PowerApps/apps/37ea6004-f07b-46ca-8ef3-a256b67b4dbb/permissions/fe36f75e-c103-410b-a18a-2bf6df06ac3a
+  type | Microsoft.PowerApps/apps/permissions
+  roleName | Owner
+  principalId | fe36f75e-c103-410b-a18a-2bf6df06ac3a
+  principalType | User
+  ```
+
+  </TabItem>
+</Tabs>

package/docs/docs/cmd/pa/app/app-permission-remove.mdx

@@ -0,0 +1,74 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# pa app permission remove
+
+Removes permissions to a Power Apps app
+
+## Usage
+
+```sh
+m365 pa app permission remove [options]
+```
+
+## Options
+
+```md definition-list
+`--appName <appName>`
+: The name (GUID) of the Microsoft Power App.
+
+`--userId [userId]`
+: The Azure AD ID of the user. Specify either `userId`, `userName`, `groupId`, `groupName`, or `tenant`.
+
+`--userName [userName]`
+: The user principal name of the user. Specify either `userId`, `userName`, `groupId`, `groupName`, or `tenant`.
+
+`--groupId [groupId]`
+: The Azure AD ID of the group. Specify either `userId`, `userName`, `groupId`, `groupName`, or `tenant`.
+
+`--groupName [groupName]`
+: The name of the Azure AD group. Specify either `userId`, `userName`, `groupId`, `groupName`, or `tenant`.
+
+`--tenant`
+: When specifying this, tenant permissions (everyone in the tenant) will be removed. Specify either `userId`, `userName`, `groupId`, `groupName`, or `tenant`.
+
+`--asAdmin`
+: Run the command as admin for apps you don't own.
+
+`-e, --environmentName [environmentName]`
+: The name of the environment. Specify only a value when running the command as admin.
+
+`-f, --force`
+: Don't prompt for confirmation.
+```
+
+<Global />
+
+## Examples
+
+Remove permissions of a specific user for a specific app
+
+```sh
+m365 pa app permission remove --appName bc9f0a7e-53df-46af-b669-5888bb2f63d0 --userName john.doe@contoso.com 
+```
+
+Remove permissions of a specific security group for a specific app
+
+```sh
+m365 pa app permission remove --appName bc9f0a7e-53df-46af-b669-5888bb2f63d0 --groupName Developers
+```
+
+Removes permissions as administrator for an app which you do not own
+
+```sh
+m365 pa app permission remove --environment Default-e535e809-c6a1-47b5-8951-d0898a64bf8a --appName bc9f0a7e-53df-46af-b669-5888bb2f63d0 --userId 42a28ec6-972f-4fdd-b483-50ee4b237f91 --asAdmin
+```
+
+Unshare a Power Apps app with the entire tenant
+
+```sh
+m365 pa app permission remove --appName bc9f0a7e-53df-46af-b669-5888bb2f63d0 --tenant
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/pa/app/app-remove.mdx

@@ -16,7 +16,7 @@ m365 pa app remove [options]
 `-n, --name <name>`
 : The name of the Power App to remove
 
-`--confirm`
+`-f, --force`
 : Don't prompt for confirmation
 ```
 
@@ -41,7 +41,7 @@ m365 pa app remove --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d
 Removes the specified Power App without confirmation
 
 ```sh
-m365 pa app remove --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --confirm
+m365 pa app remove --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --force
 ```
 
 ## Response

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

@@ -19,10 +19,13 @@ m365 planner bucket add [options]
 : Name of the bucket to add.
 
 `--planId [planId]`
-: ID of the plan to which the bucket belongs. Specify either `planId` or `planTitle` but not both.
+: ID of the plan to which the bucket belongs. Specify either `planId`, `planTitle`, or `rosterId` but not multiple.
 
 `--planTitle [planTitle]`
-: Title of the plan to which the bucket belongs. Specify either `planId` or `planTitle` but not both.
+: Title of the plan to which the bucket 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`.
@@ -36,20 +39,34 @@ m365 planner bucket add [options]
 
 <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
 
-Adds a Microsoft Planner bucket with the name _My Planner Bucket_ for plan with the ID _xqQg5FS2LkCp935s-FIFm2QAFkHM_ with order hint
+Adds a Microsoft Planner bucket for a plan based on its ID with an order hint
 
 ```sh
 m365 planner bucket add --name "My Planner Bucket" --planId "xqQg5FS2LkCp935s-FIFm2QAFkHM" --orderHint " !"
 ```
 
-Adds a Microsoft Planner bucket with the name _My Planner Bucket_ for plan with the title _My Planner Plan_ owned by group _My Planner Group_
+Adds a Microsoft Planner bucket for a plan based on its title and owner group name
 
 ```sh
 m365 planner bucket add --name "My Planner Bucket" --planTitle "My Planner Plan" --ownerGroupName "My Planner Group"
 ```
 
+Adds a Microsoft Planner bucket for a plan based on its Planner Roster ID
+
+```sh
+m365 planner bucket add --name "My Planner Bucket" --rosterId "RuY-PSpdw02drevnYDTCJpgAEfoI"
+```
+
 ## Response
 
 <Tabs>

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

@@ -22,10 +22,13 @@ m365 planner bucket get [options]
 : Name of the bucket to retrieve details. Specify either `id` or `name` but not both. 
 
 `--planId [planId]`
-: ID of the plan to which the bucket belongs. Specify either `planId` or `planTitle` when using `name`.
+: ID of the plan to which the bucket belongs. Specify either `planId`, `planTitle`, or `rosterId` but not multiple when using `name`.
 
 `--planTitle [planTitle]`
-: Title of the plan to which the bucket belongs. Specify either `planId` or `planTitle` when using `name`.
+: Title of the plan to which the bucket belongs. Specify either `planId`, `planTitle`, or `rosterId` but not multiple when using `name`.
+
+`--rosterId [rosterId]`
+: ID of the Planner Roster. Specify either `planId`, `planTitle`, or `rosterId` but not multiple when using `name`.
 
 `--ownerGroupId [ownerGroupId]`
 : ID of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planTitle`.
@@ -36,6 +39,14 @@ m365 planner bucket get [options]
 
 <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
 
 Gets the specified Microsoft Planner bucket 
@@ -44,24 +55,30 @@ Gets the specified Microsoft Planner bucket
 m365 planner bucket get --id "5h1uuYFk4kKQ0hfoTUkRLpgALtYi"
 ```
 
-Gets the Microsoft Planner bucket in the PlanId xqQg5FS2LkCp935s-FIFm2QAFkHM
+Gets the Microsoft Planner bucket based on its plan ID
 
 ```sh
 m365 planner bucket get --name "Planner Bucket A" --planId "xqQg5FS2LkCp935s-FIFm2QAFkHM"
 ```
 
-Gets the Microsoft Planner bucket in the Plan _My Plan_ owned by group _My Group_
+Gets the Microsoft Planner bucket based on its plan title and owner group name
 
 ```sh
 m365 planner bucket get --name "Planner Bucket A" --planTitle "My Plan" --ownerGroupName "My Group"
 ```
 
-Gets the Microsoft Planner bucket in the Plan _My Plan_ owned by groupId ee0f40fc-b2f7-45c7-b62d-11b90dd2ea8e
+Gets the Microsoft Planner bucket based on its plan title and owner group ID
 
 ```sh
 m365 planner bucket get --name "Planner Bucket A" --planTitle "My Plan" --ownerGroupId "ee0f40fc-b2f7-45c7-b62d-11b90dd2ea8e"
 ```
 
+Gets the Microsoft Planner bucket based on its Roster ID
+
+```sh
+m365 planner bucket get --name "Planner Bucket A" --rosterId "RuY-PSpdw02drevnYDTCJpgAEfoI"
+```
+
 ## Response
 
 <Tabs>

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

@@ -16,10 +16,13 @@ m365 planner bucket list [options]
 
 ```md definition-list
 `--planId [planId]`
-: ID of the plan to list the buckets of. Specify either `planId` or `planTitle` but not both.
+: ID of the plan to list the buckets of. Specify either `planId`, `planTitle`, or `rosterId` but not multiple.
 
 `--planTitle [planTitle]`
-: Title of the plan to list the buckets of. Specify either `planId` or `planTitle` but not both.
+: Title of the plan to list the buckets of. 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`.
@@ -30,20 +33,34 @@ m365 planner bucket list [options]
 
 <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
 
-Lists the Microsoft Planner buckets in the Plan _xqQg5FS2LkCp935s-FIFm2QAFkHM_
+Lists the Microsoft Planner buckets based on its plan ID
 
 ```sh
 m365 planner bucket list --planId "xqQg5FS2LkCp935s-FIFm2QAFkHM"
 ```
 
-Lists the Microsoft Planner buckets in the Plan _My Plan_ owned by group _My Group_
+Lists the Microsoft Planner buckets based on its plan title and owner group name
 
 ```sh
 m365 planner bucket list --planTitle "My Plan" --ownerGroupName "My Group"
 ```
 
+Lists the Microsoft Planner buckets based on its Roster ID
+
+```sh
+m365 planner bucket list --planTitle "My Plan" --rosterId "RuY-PSpdw02drevnYDTCJpgAEfoI"
+```
+
 ## Response
 
 <Tabs>

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

@@ -20,10 +20,13 @@ m365 planner bucket remove [options]
 : Name of the bucket to remove. Specify either `id` or `name` but not both.
 
 `--planId [planId]`
-: ID of the plan to which the bucket to remove belongs. Specify either `planId` or `planTitle` when using `name`.
+: ID of the plan to which the bucket to remove belongs. Specify either `planId`, `planTitle`, or `rosterId` but not multiple when using `name`.
 
 `--planTitle [planTitle]`
-: Title of the plan to which the bucket to remove belongs. Specify either `planId` or `planTitle` when using `name`.
+: Title of the plan to which the bucket to remove belongs. Specify either `planId`, `planTitle`, or `rosterId` but not multiple when using `name`.
+
+`--rosterId [rosterId]`
+: ID of the Planner Roster. Specify either `planId`, `planTitle`, or `rosterId` but not multiple when using `name`.
 
 `--ownerGroupId [ownerGroupId]`
 : ID of the group to which the plan belongs. Specify either `ownerGroupId` or `ownerGroupName` when using `planTitle`.
@@ -31,12 +34,20 @@ m365 planner bucket 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 bucket by ID
@@ -48,21 +59,27 @@ m365 planner bucket remove --id "vncYUXCRBke28qMLB-d4xJcACtNz"
 Removes the Microsoft Planner bucket by ID without confirmation
 
 ```sh
-m365 planner bucket remove --id "vncYUXCRBke28qMLB-d4xJcACtNz" --confirm
+m365 planner bucket remove --id "vncYUXCRBke28qMLB-d4xJcACtNz" --force
 ```
 
-Removes the Microsoft Planner bucket with name _My Bucket_ in the Plan with ID _oUHpnKBFekqfGE_PS6GGUZcAFY7b_
+Removes the Microsoft Planner bucket by its name based on the plan ID
 
 ```sh
 m365 planner bucket remove --name "My Bucket" --planId "oUHpnKBFekqfGE_PS6GGUZcAFY7b"
 ```
 
-Removes the Microsoft Planner bucket with name _My Bucket_ in the Plan _My Plan_ owned by group _My Group_
+Removes the Microsoft Planner bucket by its name based on the plan title and owner group name
 
 ```sh
 m365 planner bucket remove --name "My Bucket" --planTitle "My Plan" --ownerGroupName "My Group"
 ```
 
+Removes the Microsoft Planner bucket by its name based on the Roster ID
+
+```sh
+m365 planner bucket remove --name "My Bucket" --rosterId "RuY-PSpdw02drevnYDTCJpgAEfoI"
+```
+
 ## Response
 
 The command won't return a response on success.

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

@@ -20,10 +20,13 @@ m365 planner bucket set [options]
 : Name of the bucket. Specify either `id` or `name` but not both.
 
 `--planId [planId]`
-: ID of the plan to update the bucket of. Specify either `planId` or `planTitle` when using `name`.
+: ID of the plan to update the bucket of. Specify either `planId`, `planTitle`, or `rosterId` but not multiple when using `name`.
 
 `--planTitle [planTitle]`
-: Title of the plan to update the bucket of. Specify either `planId` or `planTitle` when using `name`. Always use in combination with either `ownerGroupId` or `ownerGroupName`. 
+: Title of the plan to update the bucket of. Specify either `planId`, `planTitle`, or `rosterId` but not multiple when using `name`. Always use in combination with either `ownerGroupId` or `ownerGroupName`. 
+
+`--rosterId [rosterId]`
+: ID of the Planner Roster. Specify either `planId`, `planTitle`, or `rosterId` but not multiple when using `name`.
 
 `--ownerGroupId [ownerGroupId]`
 : ID of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planTitle`.
@@ -40,26 +43,40 @@ m365 planner bucket set [options]
 
 <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
 
-Updates the Microsoft Planner bucket with ID _vncYUXCRBke28qMLB-d4xJcACtNz_
+Updates the Microsoft Planner bucket by its ID
 
 ```sh
 m365 planner bucket set --id "vncYUXCRBke28qMLB-d4xJcACtNz" --newName "New bucket name"
 ```
 
-Updates the Microsoft Planner bucket named _My Bucket_ in the Plan _My Plan_ owned by group _My Group_
+Updates the Microsoft Planner bucket with a given name based on its plan title and owner group name
 
 ```sh
 m365 planner bucket set --name "My Bucket" --planTitle "My Plan" --ownerGroupName "My Group" --newName "New bucket name"
 ```
 
-Updates the Microsoft Planner bucket named _My Bucket_ in the Plan _My Plan_ owned by group with ID _00000000-0000-0000-0000-000000000000_
+Updates the Microsoft Planner bucket with a given name based on its plan title and owner group ID
 
 ```sh
 m365 planner bucket set --name "My Bucket" --planTitle "My Plan" --ownerGroupId 00000000-0000-0000-0000-000000000000 --newName "New bucket name"
 ```
 
+Updates the Microsoft Planner bucket with a given name based on its Roster ID
+
+```sh
+m365 planner bucket set --name "My Bucket" --rosterId "RuY-PSpdw02drevnYDTCJpgAEfoI" --newName "New bucket name"
+```
+
 ## Response
 
 The command won't return a response on success.

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

@@ -38,7 +38,7 @@ m365 planner plan add [options]
 
 ## Remarks
 
-- Related to the options `--shareWithUserIds` and `--shareWithUserNames`. If you are leveraging Microsoft 365 groups, use the `aad o365group user` commands to manage group membership to share the [group's](https://pnp.github.io/cli-microsoft365/cmd/aad/o365group/o365group-user-add/) 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.
+- Related to the options `--shareWithUserIds` and `--shareWithUserNames`. If you are leveraging Microsoft 365 groups, use the `aad m365group user` commands to manage group membership to share the [group's](https://pnp.github.io/cli-microsoft365/cmd/aad/m365group/m365group-user-add/) 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.
 

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/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`.
@@ -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