@pnp/cli-microsoft365 7.0.0-beta.00a5490 → 7.0.0-beta.14c7857

package/docs/docs/cmd/graph/subscription/subscription-add.mdx

@@ -16,19 +16,19 @@ m365 graph subscription add [options]
 
 ```md definition-list
 `-r, --resource <resource>`
-: The resource that will be monitored for changes
+: The resource that will be monitored for changes.
 
-`-c, --changeType <changeType>`
-: The type of change in the subscribed resource that will raise a notification. The supported values are: `created`, `updated`, `deleted`. Multiple values can be combined using a comma-separated list
+`-c, --changeTypes <changeTypes>`
+: The type of change in the subscribed resource that will raise a notification. The supported values are: `created`, `updated`, `deleted`. Multiple values can be combined using a comma-separated list.
 
 `-u, --notificationUrl <notificationUrl>`
-: The URL of the endpoint that will receive the notifications. This URL must use the HTTPS protocol
+: The URL of the endpoint that will receive the notifications. This URL must use the HTTPS protocol.
 
 `-e, --expirationDateTime [expirationDateTime]`
-: The date and time when the webhook subscription expires. The time is in UTC, and can be an amount of time from subscription creation that varies for the resource subscribed to. If not specified, the maximum allowed expiration for the specified resource will be used
+: The date and time when the webhook subscription expires. The time is in UTC, and can be an amount of time from subscription creation that varies for the resource subscribed to. If not specified, the maximum allowed expiration for the specified resource will be used.
 
 `-s, --clientState [clientState]`
-: The value of the clientState property sent by the service in each notification. The maximum length is 128 characters
+: The value of the clientState property sent by the service in each notification. The maximum length is 128 characters.
 ```
 
 <Global />
@@ -52,19 +52,19 @@ To subscribe to change notifications of Outlook contacts, events, or messages in
 Create a subscription
 
 ```sh
-m365 graph subscription add --resource "me/mailFolders('Inbox')/messages" --changeType "updated" --notificationUrl "https://webhook.azurewebsites.net/api/send/myNotifyClient" --expirationDateTime "2016-11-20T18:23:45.935Z" --clientState "secretClientState"
+m365 graph subscription add --resource "me/mailFolders('Inbox')/messages" --changeTypes "updated" --notificationUrl "https://webhook.azurewebsites.net/api/send/myNotifyClient" --expirationDateTime "2016-11-20T18:23:45.935Z" --clientState "secretClientState"
 ```
 
 Create a subscription on multiple change types
 
 ```sh
-m365 graph subscription add --resource groups --changeType updated,deleted --notificationUrl "https://webhook.azurewebsites.net/api/send/myNotifyClient" --expirationDateTime "2016-11-20T18:23:45.935Z" --clientState "secretClientState"
+m365 graph subscription add --resource groups --changeTypes "updated,deleted" --notificationUrl "https://webhook.azurewebsites.net/api/send/myNotifyClient" --expirationDateTime "2016-11-20T18:23:45.935Z" --clientState "secretClientState"
 ```
 
 Create a subscription using the maximum allowed expiration for Group resources
 
 ```sh
-m365 graph subscription add --resource groups --changeType "updated" --notificationUrl "https://webhook.azurewebsites.net/api/send/myNotifyClient"
+m365 graph subscription add --resource groups --changeTypes "updated" --notificationUrl "https://webhook.azurewebsites.net/api/send/myNotifyClient"
 ```
 
 ## Response
@@ -125,7 +125,7 @@ m365 graph subscription add --resource groups --changeType "updated" --notificat
   <TabItem value="Markdown">
 
   ```md
-  # graph subscription add --resource "groups" --changeType "updated" --notificationUrl "https://webhook.azurewebsites.net/api/changeNotificationHook" --expirationDateTime "2023-05-23T18:23:45.935Z" --clientState "some secret value"
+  # graph subscription add --resource "groups" --changeTypes "updated" --notificationUrl "https://webhook.azurewebsites.net/api/changeNotificationHook" --expirationDateTime "2023-05-23T18:23:45.935Z" --clientState "some secret value"
 
   Date: 2023-05-22
 

package/docs/docs/cmd/login.mdx

@@ -157,6 +157,12 @@ Log in to Microsoft 365 using your own Azure AD application that's restricted on
 m365 login --appId 31359c7f-bd7e-475c-86db-fdb8c937548c --tenant 31359c7f-bd7e-475c-86db-fdb8c937548a
 ```
 
+Log in to Microsoft 365 using your own Azure AD application and a personal information exchange (.pfx) file
+
+```sh
+m365 login --authType certificate --appId 31359c7f-bd7e-475c-86db-fdb8c937548c --tenant 31359c7f-bd7e-475c-86db-fdb8c937548a --certificateFile /Users/user/dev/localhost.pfx --password 'pass@word1'
+```
+
 Log in to Microsoft 365 using the interactive browser authentication. Uses the identity of the current user.
 
 ```sh

package/docs/docs/cmd/pa/app/app-consent-set.mdx

@@ -13,7 +13,7 @@ m365 pa app consent set [options]
 ## Options
 
 ```md definition-list
-`-e, --environment <environment>`
+`-e, --environmentName <environmentName>`
 : The name of the environment.
 
 `-n, --name <name>`
@@ -37,13 +37,13 @@ This command only works for canvas apps.
 Enables the bypass for the specified canvas app
 
 ```sh
-m365 pa app consent set --environment 4be50206-9576-4237-8b17-38d8aadfaa36 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --bypass true
+m365 pa app consent set --environmentName 4be50206-9576-4237-8b17-38d8aadfaa36 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --bypass true
 ```
 
 Disables the bypass consent for the specified canvas app
 
 ```sh
-m365 pa app consent set --environment 4be50206-9576-4237-8b17-38d8aadfaa36 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --bypass false --force
+m365 pa app consent set --environmentName 4be50206-9576-4237-8b17-38d8aadfaa36 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --bypass false --force
 ```
 
 ## Response

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

@@ -13,13 +13,13 @@ m365 pa app export [options]
 ## Options
 
 ```md definition-list
-`-i, --id <id>`
-: The id of the Power App to export
+`-n, --name <name>`
+: The name (GUID) of the Power Apps app to export
 
-`-e, --environment <environment>`
+`-e, --environmentName <environmentName>`
 : The name of the environment for which to export the app
 
-`-n, --packageDisplayName [packageDisplayName]`
+`--packageDisplayName [packageDisplayName]`
 : The display name to use in the exported package
 
 `-d, --packageDescription [packageDescription]`
@@ -42,13 +42,13 @@ m365 pa app export [options]
 Export the specified Power App as a ZIP file
 
 ```sh
-m365 pa app export --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 3989cb59-ce1a-4a5c-bb78-257c5c39381d 
+m365 pa app export --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --packageDisplayName "PowerApp"
 ```
 
 Export the specified Power App as a ZIP file with the package displayname, package description, the one who created it, the package source environment and the path
 
 ```sh
-m365 pa app export --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 3989cb59-ce1a-4a5c-bb78-257c5c39381d --packageDisplayName "PowerApp" --packageDescription "Power App Description" --packageCreatedBy "John Doe" --packageSourceEnvironment "Contoso" --path "C:/Users/John/Documents"
+m365 pa app export --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --packageDisplayName "PowerApp" --packageDescription "Power App Description" --packageCreatedBy "John Doe" --packageSourceEnvironment "Contoso" --path "C:/Users/John/Documents"
 ```
 
 ## Response

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

@@ -15,7 +15,7 @@ m365 pa app list [options]
 ## Options
 
 ```md definition-list
-`-e, --environment [environment]`
+`-e, --environmentName [environmentName]`
 : The name of the environment for which to retrieve available apps
 
 `--asAdmin`
@@ -47,7 +47,7 @@ m365 pa app list
 List all apps in a given environment
 
 ```sh
-m365 pa app list --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --asAdmin
+m365 pa app list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --asAdmin
 ```
 
 ## Response

package/docs/docs/cmd/pa/app/app-owner-set.mdx

@@ -0,0 +1,60 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# pa app owner set
+
+Sets a new owner for a Power Apps app
+
+## Usage
+
+```sh
+m365 pa app owner set [options]
+```
+
+## Options
+
+```md definition-list
+`-e, --environmentName <environmentName>`
+: The name of the environment.
+
+`--appName <appName>`
+: The name (GUID) of the Microsoft Power App.
+
+`--userId [userId]`
+: The Azure AD ID of the new owner. Specify either `userId` or `userName` but not both.
+
+`--userName [userName]`
+: The user principal name of the new owner. Specify either `userId` or `userName` but not both.
+
+`--roleForOldAppOwner [roleForOldAppOwner]`
+: Grant permissions for the previous owner. Allowed values: `CanView`, `CanEdit`. Don't specify a value to remove the previous owner from the app.
+```
+
+<Global />
+
+## Remarks
+
+:::info
+
+To use this command you must be a Global or Power Platform admin.
+
+:::
+
+## Examples
+
+Set a new owner for a Power Apps app and make the previous owner co-owner
+
+```sh
+m365 pa app owner set --environmentName Default-716eb9fb-bf79-4be9-b0c7-900824fcbe25 --appName 7ab97923-4a4d-4467-b030-12071d2b810b --userId c6ee6ed4-0172-4fdc-87a3-cfd9c324de1d --roleForOldAppOwner CanEdit
+```
+
+Set a new owner for a Power Apps app and remove the previous owner
+
+```sh
+m365 pa app owner set --environmentName Default-716eb9fb-bf79-4be9-b0c7-900824fcbe25 --appName 7ab97923-4a4d-4467-b030-12071d2b810b --userName john.doe@contoso.com
+```
+
+## Response
+
+The command won't return a response on success.

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

@@ -0,0 +1,85 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# pa app permission ensure
+
+Assigns/updates permissions to a Power Apps app
+
+## Usage
+
+```sh
+m365 pa app permission ensure [options]
+```
+
+## Options
+
+```md definition-list
+`--appName <appName>`
+: The name (GUID) of the Microsoft Power App.
+
+`--roleName <roleName>`
+: Permission level given to the app. Valid values: `CanEdit`, `CanView`. Sharing with the entire tenant is only supported with `CanView` role.
+
+`--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`
+: Share the app with the entire tenant. When specifying this, only `CanView` role is supported. Specify either `userId`, `userName`, `groupId`, `groupName`, or `tenant`.
+
+`--sendInvitationMail`
+: When set, an invitation mail will be sent.
+
+`--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.
+```
+
+<Global />
+
+## Remarks
+
+:::note
+
+When specifying a value for `groupId` or `groupName`, note that you can only grant permissions to security groups.
+
+:::
+
+## Examples
+
+Share a Power App app with another user with run-only permissions
+
+```sh
+m365 pa app permission ensure --appName bc9f0a7e-53df-46af-b669-5888bb2f63d0 --userName john.doe@contoso.com --roleName CanView --sendInvitationMail
+```
+
+Add co-owner permissions for a security group to a Power Apps app
+
+```sh
+m365 pa app permission ensure --appName bc9f0a7e-53df-46af-b669-5888bb2f63d0 --groupName Developers --roleName CanEdit
+```
+
+Add permissions as admin to a Power App app that you do not own
+
+```sh
+m365 pa app permission ensure --environment Default-e535e809-c6a1-47b5-8951-d0898a64bf8a --appName bc9f0a7e-53df-46af-b669-5888bb2f63d0 --userId 42a28ec6-972f-4fdd-b483-50ee4b237f91 --roleName CanEdit --asAdmin
+```
+
+Share a Power Apps app with everyone in the tenant
+
+```sh
+m365 pa app permission ensure --appName bc9f0a7e-53df-46af-b669-5888bb2f63d0 --roleName CanView --tenant
+```
+
+## Response
+
+The command won't return a response on success.

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