npm - @pnp/cli-microsoft365 - Versions diffs - 7.0.0-beta.31d0077 → 7.0.0-beta.602a03f - Mend

@pnp/cli-microsoft365 7.0.0-beta.31d0077 → 7.0.0-beta.602a03f

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (528) hide show

package/docs/docs/cmd/flow/run/run-resubmit.mdx CHANGED Viewed

@@ -16,13 +16,13 @@ m365 flow run resubmit [options]
 `-n, --name <name>`
 : The name of the run to resubmit
-`-f, --flowName <flowName>`
+`--flowName <flowName>`
 : The name of the flow to resubmit the run for
 `-e, --environmentName <environmentName>`
 : The name of the environment where the Flow is located
-`--confirm`
+`-f, --force`
 : Don't prompt for confirmation
 ```
@@ -53,7 +53,7 @@ m365 flow run resubmit --environmentName Default-d87a7535-dd31-4437-bfe1-95340ac
 Resubmits a specific flow run for the specified Microsoft Flow without prompting for confirmation
 ```sh
-m365 flow run resubmit --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a --name 08586653536760200319026785874CU62 --confirm
+m365 flow run resubmit --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a --name 08586653536760200319026785874CU62 --force
 ```
 ## Response

package/docs/docs/cmd/graph/schemaextension/schemaextension-remove.mdx CHANGED Viewed

@@ -16,7 +16,7 @@ m365 graph schemaextension remove [options]
 `-i, --id <id>`
 : The unique identifier for the schema extension definition
-`--confirm`
+`-f, --force`
 : Don't prompt for confirming removing the specified schema extension
 ```
@@ -38,7 +38,7 @@ m365 graph schemaextension remove --id domain_myExtension
 Removes specified Microsoft Graph schema extension with ID domain_myExtension without prompt for confirmation
 ```sh
-m365 graph schemaextension remove --id domain_myExtension --confirm
+m365 graph schemaextension remove --id domain_myExtension --force
 ```
 ## Response

package/docs/docs/cmd/onedrive/report/report-activityfilecounts.mdx CHANGED Viewed

@@ -18,7 +18,7 @@ m365 onedrive report activityfilecounts [options]
 `-p, --period <period>`
 : The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`.
-`-f, --outputFile [outputFile]`
+`--outputFile [outputFile]`
 : Path to the file where the report should be stored in
 ```

package/docs/docs/cmd/onedrive/report/report-activityusercounts.mdx CHANGED Viewed

@@ -18,7 +18,7 @@ m365 onedrive report activityusercounts [options]
 `-p, --period <period>`
 : The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`.
-`-f, --outputFile [outputFile]`
+`--outputFile [outputFile]`
 : Path to the file where the report should be stored in
 ```

package/docs/docs/cmd/onedrive/report/report-activityuserdetail.mdx CHANGED Viewed

@@ -21,7 +21,7 @@ m365 onedrive report activityuserdetail [options]
 `-d, --date [date]`
 : The date for which you would like to view the users who performed any activity. Supported date format is YYYY-MM-DD. Specify the date or period, but not both`
-`-f, --outputFile [outputFile]`
+`--outputFile [outputFile]`
 : Path to the file where the report should be stored in
 ```

package/docs/docs/cmd/onedrive/report/report-usageaccountcounts.mdx CHANGED Viewed

@@ -18,7 +18,7 @@ m365 onedrive report usageaccountcounts [options]
 `-p, --period <period>`
 : The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`.
-`-f, --outputFile [outputFile]`
+`--outputFile [outputFile]`
 : Path to the file where the report should be stored in
 ```

package/docs/docs/cmd/onedrive/report/report-usageaccountdetail.mdx CHANGED Viewed

@@ -21,7 +21,7 @@ m365 onedrive report usageaccountdetail [options]
 `-d, --date [date]`
 : The date for which you would like to view the users who performed any activity. Supported date format is YYYY-MM-DD. Specify the date or period, but not both`
-`-f, --outputFile [outputFile]`
+`--outputFile [outputFile]`
 : Path to the file where the report should be stored in
 ```

package/docs/docs/cmd/onedrive/report/report-usagefilecounts.mdx CHANGED Viewed

@@ -18,7 +18,7 @@ m365 onedrive report usagefilecounts [options]
 `-p, --period <period>`
 : The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`.
-`-f, --outputFile [outputFile]`
+`--outputFile [outputFile]`
 : Path to the file where the report should be stored in
 ```

package/docs/docs/cmd/onedrive/report/report-usagestorage.mdx CHANGED Viewed

@@ -18,7 +18,7 @@ m365 onedrive report usagestorage [options]
 `-p, --period <period>`
 : The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`.
-`-f, --outputFile [outputFile]`
+`--outputFile [outputFile]`
 : Path to the file where the report should be stored in
 ```

package/docs/docs/cmd/outlook/report/report-mailactivitycounts.mdx CHANGED Viewed

@@ -18,7 +18,7 @@ m365 outlook report mailactivitycounts [options]
 `-p, --period <period>`
 : The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`.
-`-f, --outputFile [outputFile]`
+`--outputFile [outputFile]`
 : Path to the file where the report should be stored in
 ```

package/docs/docs/cmd/outlook/report/report-mailactivityusercounts.mdx CHANGED Viewed

@@ -18,7 +18,7 @@ m365 outlook report mailactivityusercounts [options]
 `-p, --period <period>`
 : The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`.
-`-f, --outputFile [outputFile]`
+`--outputFile [outputFile]`
 : Path to the file where the report should be stored in
 ```

package/docs/docs/cmd/outlook/report/report-mailactivityuserdetail.mdx CHANGED Viewed

@@ -21,7 +21,7 @@ m365 outlook report mailactivityuserdetail [options]
 `-d, --date [date]`
 : The date for which you would like to view the users who performed any activity. Supported date format is YYYY-MM-DD. Specify the date or period, but not both
-`-f, --outputFile [outputFile]`
+`--outputFile [outputFile]`
 : Path to the file where the report should be stored in
 ```

package/docs/docs/cmd/outlook/report/report-mailappusageappsusercounts.mdx CHANGED Viewed

@@ -18,7 +18,7 @@ m365 outlook report mailappusageappsusercounts [options]
 `-p, --period <period>`
 : The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`.
-`-f, --outputFile [outputFile]`
+`--outputFile [outputFile]`
 : Path to the file where the report should be stored in
 ```

package/docs/docs/cmd/outlook/report/report-mailappusageusercounts.mdx CHANGED Viewed

@@ -18,7 +18,7 @@ m365 outlook report mailappusageusercounts [options]
 `-p, --period <period>`
 : The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`.
-`-f, --outputFile [outputFile]`
+`--outputFile [outputFile]`
 : Path to the file where the report should be stored in
 ```

package/docs/docs/cmd/outlook/report/report-mailappusageuserdetail.mdx CHANGED Viewed

@@ -21,7 +21,7 @@ m365 outlook report mailappusageuserdetail [options]
 `-d, --date [date]`
 : The date for which you would like to view the users who performed any activity. Supported date format is YYYY-MM-DD. Specify the date or period, but not both
-`-f, --outputFile [outputFile]`
+`--outputFile [outputFile]`
 : Path to the file where the report should be stored in
 ```

package/docs/docs/cmd/outlook/report/report-mailappusageversionsusercounts.mdx CHANGED Viewed

@@ -18,7 +18,7 @@ m365 outlook report mailappusageversionsusercounts [options]
 `-p, --period <period>`
 : The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`.
-`-f, --outputFile [outputFile]`
+`--outputFile [outputFile]`
 : Path to the file where the report should be stored in
 ```

package/docs/docs/cmd/outlook/report/report-mailboxusagedetail.mdx CHANGED Viewed

@@ -18,7 +18,7 @@ m365 outlook report mailboxusagedetail [options]
 `-p, --period <period>`
 : The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`.
-`-f, --outputFile [outputFile]`
+`--outputFile [outputFile]`
 : Path to the file where the report should be stored in
 ```

package/docs/docs/cmd/outlook/report/report-mailboxusagemailboxcount.mdx CHANGED Viewed

@@ -18,7 +18,7 @@ m365 outlook report mailboxusagemailboxcount [options]
 `-p, --period <period>`
 : The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`.
-`-f, --outputFile [outputFile]`
+`--outputFile [outputFile]`
 : Path to the file where the report should be stored in
 ```

package/docs/docs/cmd/outlook/report/report-mailboxusagequotastatusmailboxcounts.mdx CHANGED Viewed

@@ -18,7 +18,7 @@ m365 outlook report mailboxusagequotastatusmailboxcounts [options]
 `-p, --period <period>`
 : The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`.
-`-f, --outputFile [outputFile]`
+`--outputFile [outputFile]`
 : Path to the file where the report should be stored in
 ```

package/docs/docs/cmd/outlook/report/report-mailboxusagestorage.mdx CHANGED Viewed

@@ -18,7 +18,7 @@ m365 outlook report mailboxusagestorage [options]
 `-p, --period <period>`
 : The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`.
-`-f, --outputFile [outputFile]`
+`--outputFile [outputFile]`
 : Path to the file where the report should be stored in
 ```

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

@@ -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>`
@@ -22,7 +22,7 @@ m365 pa app consent set [options]
 `-b, --bypass <bypass>`
 : Set to `true` to allow users to bypass the API Consent window. Set to `false` to disable the bypass.
-`--confirm`
+`-f, --force`
 : Don't prompt for confirmation
 ```
@@ -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 --confirm
+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 CHANGED Viewed

@@ -16,7 +16,7 @@ m365 pa app export [options]
 `-i, --id <id>`
 : The id of the Power App to export
-`-e, --environment <environment>`
+`-e, --environmentName <environmentName>`
 : The name of the environment for which to export the app
 `-n, --packageDisplayName [packageDisplayName]`
@@ -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 --id 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 --id 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-get.mdx CHANGED Viewed

@@ -9,7 +9,7 @@ Gets information about the specified Microsoft Power App
 ## Usage
 ```sh
-pa app get [options]
+m365 pa app get [options]
 ```
 ## Options

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

@@ -9,13 +9,13 @@ Lists all Power Apps apps
 ## Usage
 ```sh
-pa app list [options]
+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 ADDED Viewed

@@ -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-list.mdx ADDED Viewed

@@ -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-remove.mdx CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

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