@pnp/cli-microsoft365 6.0.0-beta.8352f49 → 6.0.0-beta.845d3c1

package/docs/docs/cmd/onenote/notebook/notebook-list.md

@@ -0,0 +1,70 @@
+# onenote notebook list
+
+Retrieve a list of notebooks.
+
+## Usage
+
+```sh
+m365 onenote notebook list [options]
+```
+
+## Options
+
+`--userId [userId]`
+: Id of the user. Use either userId or userName, but not both.
+
+`--userName [userName]`
+: Name of the user. Use either userId or userName, but not both.
+
+`--groupId [groupId]`
+: Id of the SharePoint group. Use either groupName or groupId, but not both
+
+`--groupName [groupName]`
+: Name of the SharePoint group. Use either groupName or groupId, but not both.
+
+`-u, --webUrl [webUrl]`
+: URL of the SharePoint site.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+List Microsoft OneNote notebooks for the currently logged in user
+
+```sh
+m365 onenote notebook list
+```
+
+List Microsoft OneNote notebooks in group 233e43d0-dc6a-482e-9b4e-0de7a7bce9b4
+
+```sh
+m365 onenote notebook list --groupId 233e43d0-dc6a-482e-9b4e-0de7a7bce9b4
+```
+
+List Microsoft OneNote notebooks in group My Group
+
+```sh
+m365 onenote notebook list --groupName "MyGroup"
+```
+
+List Microsoft OneNote notebooks for user user1@contoso.onmicrosoft.com
+
+```sh
+m365 onenote notebook list --userName user1@contoso.onmicrosoft.com
+```
+
+List Microsoft OneNote notebooks for user 2609af39-7775-4f94-a3dc-0dd67657e900
+
+```sh
+m365 onenote notebook list --userId 2609af39-7775-4f94-a3dc-0dd67657e900
+```
+
+List Microsoft OneNote notebooks for site https://contoso.sharepoint.com/sites/testsite
+
+```sh
+m365 onenote notebook list --webUrl https://contoso.sharepoint.com/sites/testsite
+```
+
+## More information
+
+- List notebooks (MS Graph docs): [https://docs.microsoft.com/en-us/graph/api/onenote-list-notebooks?view=graph-rest-1.0&tabs=http](https://docs.microsoft.com/en-us/graph/api/onenote-list-notebooks?view=graph-rest-1.0&tabs=http)

package/docs/docs/cmd/outlook/mail/mail-send.md

@@ -1,6 +1,6 @@
-# outlook sendmail
+# outlook mail send
 
-Sends e-mail on behalf of the current user
+Sends an email
 
 ## Usage
 
@@ -8,53 +8,118 @@ Sends e-mail on behalf of the current user
 m365 outlook mail send [options]
 ```
 
-## Alias
-
-```sh
-m365 outlook sendmail [options]
-```
-
 ## Options
 
 `-s, --subject <subject>`
-: E-mail subject
+: Email subject
 
 `-t, --to <to>`
-: Comma-separated list of e-mails to send the message to
+: Comma-separated list of emails to send the message to.
+
+`--cc [cc]`
+: Comma-separated list of CC recipients for the message.
+
+`--bcc [bcc]`
+: Comma-separated list of BCC recipients for the message.
+
+`--sender [sender]`
+: Optional upn or user id to specify what account to send the message from. Also see the remarks section.
+
+`-m, --mailbox [mailbox]`
+: Specify this option to send the email on behalf of another mailbox, for example a shared mailbox, group or distribution list. The sender needs to be a delegate on the specified mailbox. Also see the remarks section.
 
 `--bodyContents <bodyContents>`
-: String containing the body of the e-mail to send
+: String containing the body of the email to send.
 
 `--bodyContentType [bodyContentType]`
-: Type of the body content. Available options: `Text,HTML`. Default `Text`
+: Type of the body content. Available options: `Text,HTML`. Default `Text`.
+
+`--importance [importance]`
+: The importance of the message. Available options: `low`, `normal` or `high`. Default is `normal`.
+
+`--attachment [attachment]`
+: Path to the file that will be added as attachment to the email. This option can be used multiple times to attach multiple attachments.
 
 `--saveToSentItems [saveToSentItems]`
-: Save e-mail in the sent items folder. Default `true`
+: Save email in the sent items folder. Default `true`.
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
+### Attachments
+
+When using the `attachment` option, note that the total size of all attachment files cannot exceed 3 MB.
+
+### If you are connected using app only authentication
+
+- Always specify a user id or upn in the `--sender` option. The email will be sent as if it came from the specified user, and can optionally be saved in the sent folder of that user account.
+- You can optionally also specify the `--mailbox` option to send mail on behalf of a shared mailbox, group or distribution list. The account used in the `--sender` option, needs to have 'Send on behalf of' permissions on the mailbox in question.
+
+!!! important
+    You need `Mail.Send` application permissions on the Microsoft Graph to be able to send mails using an application identity. 
+
+### If you are connected with a regular user account
+
+- Specify the `--mailbox` option if you want to send an email on behalf of another mailbox. This can be a shared mailbox, group or distribution list. It will be visible in the email that the email was sent by you. You need to be assigned `Send on behalf of` permissions on the mailbox in question.  
+- You can specify the `--sender` option if you want to send an email as if you were the other user.
+The sent email can optionally be saved in the sent folder of that user account. You'll need `Read and manage (Full Access)` permissions on the mailbox of the other user. You can combine the `--sender` and `--mailbox` options to let the other user send a mail on behalf of the specified mailbox.
+
+!!! important
+    You need at least `Mail.Send` delegated permissions on the Microsoft Graph to be able to send emails. When specifying another user as sender, you'll need `Mail.Send.Shared` permissions.
+
 ## Examples
 
-Send a text e-mail to the specified e-mail address
+Send a text email to the specified email address
 
 ```sh
 m365 outlook mail send --to chris@contoso.com --subject "DG2000 Data Sheets" --bodyContents "The latest data sheets are in the team site"
 ```
 
-Send an HTML e-mail to the specified e-mail addresses
+Send an HTML email to the specified email addresses
 
 ```sh
 m365 outlook mail send --to "chris@contoso.com,brian@contoso.com" --subject "DG2000 Data Sheets" --bodyContents "The latest data sheets are in the <a href='https://contoso.sharepoint.com/sites/marketing'>team site</a>" --bodyContentType HTML
 ```
 
-Send an HTML e-mail to the specified e-mail address loading e-mail contents from a file on disk
+Send an HTML email to the specified email address loading email contents from a file on disk
 
 ```sh
 m365 outlook mail send --to chris@contoso.com --subject "DG2000 Data Sheets" --bodyContents @email.html --bodyContentType HTML
 ```
 
-Send a text e-mail to the specified e-mail address. Don't store the e-mail in sent items
+Send a text email to the specified email address. Don't store the email in sent items
 
 ```sh
 m365 outlook mail send --to chris@contoso.com --subject "DG2000 Data Sheets" --bodyContents "The latest data sheets are in the team site" --saveToSentItems false
 ```
+
+Send an email on behalf of a shared mailbox using the signed in user
+
+```sh
+m365 outlook mail send --to chris@contoso.com --subject "DG2000 Data Sheets" --bodyContents "The latest data sheets are in the team site" --mailbox sales@contoso.com
+```
+
+Send an email as another user
+
+```sh
+m365 outlook mail send --to chris@contoso.com --subject "DG2000 Data Sheets" --bodyContents "The latest data sheets are in the team site" --sender svc_project@contoso.com
+```
+
+Send an email as another user, on behalf of a shared mailbox
+
+```sh
+m365 outlook mail send --to chris@contoso.com --subject "DG2000 Data Sheets" --bodyContents "The latest data sheets are in the team site" --sender svc_project@contoso.com --mailbox sales@contoso.com
+```
+
+Send an email with cc and bcc recipients marked as important
+
+```sh
+m365 outlook mail send --to chris@contoso.com --cc claire@contoso.com --bcc randy@contoso.com --subject "DG2000 Data Sheets" --bodyContents "The latest data sheets are in the team site" --importance high
+```
+
+Send an email with multiple attachments
+
+```sh
+m365 outlook mail send --to chris@contoso.com --subject "Monthly reports" --bodyContents "Here are the reports of this month." --attachment "C:/Reports/File1.jpg" --attachment "C:/Reports/File2.docx" --attachment "C:/Reports/File3.xlsx"
+```

package/docs/docs/cmd/outlook/message/message-move.md

@@ -10,7 +10,7 @@ m365 outlook message move [options]
 
 ## Options
 
-`--messageId <messageId>`
+`--id <id>`
 : ID of the message to move
 
 `--sourceFolderName [sourceFolderName]`
@@ -32,20 +32,20 @@ m365 outlook message move [options]
 Move the specified message to another folder specified by ID
 
 ```sh
-m365 outlook message move --messageId AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYmY4OABGAAAAAAAiQ8W967B7TKBjgx9rVEURBwAiIsqMbYjsT5e-T7KzowPTAAAAAAEMAAAiIsqMbYjsT5e-T7KzowPTAALdyzhHAAA= --sourceFolderId AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYmY4OAAuAAAAAAAiQ8W967B7TKBjgx9rVEURAQAiIsqMbYjsT5e-T7KzowPTAAAAAAEKAAA= --targetFolderId AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYmY4OAAuAAAAAAAiQ8W967B7TKBjgx9rVEURAQAiIsqMbYjsT5e-T7KzowPTAAAeUO-fAAA=
+m365 outlook message move --id AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYmY4OABGAAAAAAAiQ8W967B7TKBjgx9rVEURBwAiIsqMbYjsT5e-T7KzowPTAAAAAAEMAAAiIsqMbYjsT5e-T7KzowPTAALdyzhHAAA= --sourceFolderId AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYmY4OAAuAAAAAAAiQ8W967B7TKBjgx9rVEURAQAiIsqMbYjsT5e-T7KzowPTAAAAAAEKAAA= --targetFolderId AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYmY4OAAuAAAAAAAiQ8W967B7TKBjgx9rVEURAQAiIsqMbYjsT5e-T7KzowPTAAAeUO-fAAA=
 ```
 
 Move the specified message to another folder specified by name
 
 ```sh
-m365 outlook message move --messageId AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYmY4OABGAAAAAAAiQ8W967B7TKBjgx9rVEURBwAiIsqMbYjsT5e-T7KzowPTAAAAAAEMAAAiIsqMbYjsT5e-T7KzowPTAALdyzhHAAA= --sourceFolderName Inbox --targetFolderName "Project X"
+m365 outlook message move --id AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYmY4OABGAAAAAAAiQ8W967B7TKBjgx9rVEURBwAiIsqMbYjsT5e-T7KzowPTAAAAAAEMAAAiIsqMbYjsT5e-T7KzowPTAALdyzhHAAA= --sourceFolderName Inbox --targetFolderName "Project X"
 ```
 
 Move the specified message to another folder specified by its well-known
 name
 
 ```sh
-m365 outlook message move --messageId AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYmY4OABGAAAAAAAiQ8W967B7TKBjgx9rVEURBwAiIsqMbYjsT5e-T7KzowPTAAAAAAEMAAAiIsqMbYjsT5e-T7KzowPTAALdyzhHAAA= --sourceFolderName inbox --targetFolderName archive
+m365 outlook message move --id AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYmY4OABGAAAAAAAiQ8W967B7TKBjgx9rVEURBwAiIsqMbYjsT5e-T7KzowPTAAAAAAEMAAAiIsqMbYjsT5e-T7KzowPTAALdyzhHAAA= --sourceFolderName inbox --targetFolderName archive
 ```
 
 ## More information

package/docs/docs/cmd/pa/connector/connector-export.md

@@ -16,7 +16,7 @@ m365 flow connector export
 
 ## Options
 
-`-e, --environment <environment>`
+`-e, --environmentName <environmentName>`
 : The name of the environment where the custom connector to export is located
 
 `-c, --connector <connector>`
@@ -39,11 +39,11 @@ If no output folder has been specified, the `pa connector export` command will c
 Export the specified custom connector
 
 ```sh
-m365 pa connector export --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --connector shared_connector-201-5f20a1f2d8d6777a75-5fa602f410652f4dfa
+m365 pa connector export --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --connector shared_connector-201-5f20a1f2d8d6777a75-5fa602f410652f4dfa
 ```
 
 Export the specified custom connector to the specific directory
 
 ```sh
-m365 pa connector export --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --connector shared_connector-201-5f20a1f2d8d6777a75-5fa602f410652f4dfa --outputFolder connector
+m365 pa connector export --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --connector shared_connector-201-5f20a1f2d8d6777a75-5fa602f410652f4dfa --outputFolder connector
 ```

package/docs/docs/cmd/pa/connector/connector-list.md

@@ -16,7 +16,7 @@ m365 flow connector list
 
 ## Options
 
-`-e, --environment <environment>`
+`-e, --environmentName <environmentName>`
 : The name of the environment for which to retrieve custom connectors
 
 --8<-- "docs/cmd/_global.md"
@@ -31,5 +31,5 @@ m365 flow connector list
 List all custom connectors in the given environment
 
 ```sh
-m365 pa connector list --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5
+m365 pa connector list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5
 ```

package/docs/docs/cmd/pa/solution/solution-reference-add.md

@@ -10,7 +10,7 @@ m365 pa solution reference add [options]
 
 ## Options
 
-`-p, --path <path>`
+`-p, --projectPath <projectPath>`
 : The path to the referenced project
 
 --8<-- "docs/cmd/_global.md"
@@ -26,7 +26,7 @@ The CDS solution project and the PowerApps component framework project cannot ha
 Adds a reference inside the CDS Solution project in the current directory to the PowerApps component framework project at `./projects/ExampleProject`
 
 ```sh
-m365 pa solution reference add --path ./projects/ExampleProject
+m365 pa solution reference add --projectPath ./projects/ExampleProject
 ```
 
 ## More information

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

@@ -14,16 +14,16 @@ m365 planner bucket add [options]
 : Name of the bucket to add.
 
 `--planId [planId]`
-: Plan ID to which the bucket belongs. Specify either `planId` or `planName` but not both.
+: ID of the plan to which the bucket belongs. Specify either `planId` or `planTitle` but not both.
 
-`--planName [planName]`
-: Plan Name to which the bucket belongs. Specify either `planId` or `planName` but not both.
+`--planTitle [planTitle]`
+: Title of the plan to which the bucket belongs. Specify either `planId` or `planTitle` but not both.
 
 `--ownerGroupId [ownerGroupId]`
-: ID of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planName`.
+: ID of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planTitle`.
 
 `--ownerGroupName [ownerGroupName]`
-: Name of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planName`.
+: Name of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planTitle`.
 
 `--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/en-us/graph/api/resources/planner-order-hint-format?view=graph-rest-1.0).
@@ -38,8 +38,8 @@ Adds a Microsoft Planner bucket with the name _My Planner Bucket_ for plan with
 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 name _My Planner Plan_ owned by group _My Planner Group_
+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_
 
 ```sh
-m365 planner bucket add --name "My Planner Bucket" --planName "My Planner Plan" --ownerGroupName "My Planner Group"
+m365 planner bucket add --name "My Planner Bucket" --planTitle "My Planner Plan" --ownerGroupName "My Planner Group"
 ```

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

@@ -17,16 +17,16 @@ m365 planner bucket get [options]
 : Name of the bucket to retrieve details. Specify either `id` or `name` but not both. 
 
 `--planId [planId]`
-: Plan ID to which the bucket belongs. Specify either `planId` or `planName` when using `name`.
+: ID of the plan to which the bucket belongs. Specify either `planId` or `planTitle` when using `name`.
 
-`--planName [planName]`
-: Plan Name to which the bucket belongs. Specify either `planId` or `planName` when using `name`.
+`--planTitle [planTitle]`
+: Title of the plan to which the bucket belongs. Specify either `planId` or `planTitle` when using `name`.
 
 `--ownerGroupId [ownerGroupId]`
-: ID of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planName`.
+: ID of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planTitle`.
 
 `--ownerGroupName [ownerGroupName]`
-: Name of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planName`.
+: Name of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planTitle`.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -47,11 +47,11 @@ m365 planner bucket get --name "Planner Bucket A" --planId "xqQg5FS2LkCp935s-FIF
 Gets the Microsoft Planner bucket in the Plan _My Plan_ owned by group _My Group_
 
 ```sh
-m365 planner bucket get --name "Planner Bucket A" --planName "My Plan" --ownerGroupName "My Group"
+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
 
 ```sh
-m365 planner bucket get --name "Planner Bucket A" --planName "My Plan" --ownerGroupId "ee0f40fc-b2f7-45c7-b62d-11b90dd2ea8e"
-```
+m365 planner bucket get --name "Planner Bucket A" --planTitle "My Plan" --ownerGroupId "ee0f40fc-b2f7-45c7-b62d-11b90dd2ea8e"
+```

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

@@ -11,16 +11,16 @@ m365 planner bucket list [options]
 ## Options
 
 `--planId [planId]`
-: ID of the plan to list the buckets of. Specify either `planId` or `planName` but not both.
+: ID of the plan to list the buckets of. Specify either `planId` or `planTitle` but not both.
 
-`--planName [planName]`
-: Name of the plan to list the buckets of. Specify either `planId` or `planName` but not both.
+`--planTitle [planTitle]`
+: Title of the plan to list the buckets of. Specify either `planId` or `planTitle` but not both.
 
 `--ownerGroupId [ownerGroupId]`
-: ID of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planName`.
+: ID of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planTitle`.
 
 `--ownerGroupName [ownerGroupName]`
-: Name of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planName`.
+: Name of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planTitle`.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -35,5 +35,5 @@ m365 planner bucket list --planId "xqQg5FS2LkCp935s-FIFm2QAFkHM"
 Lists the Microsoft Planner buckets in the Plan _My Plan_ owned by group _My Group_
 
 ```sh
-m365 planner bucket list --planName "My Plan" --ownerGroupName "My Group"
+m365 planner bucket list --planTitle "My Plan" --ownerGroupName "My Group"
 ```

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

@@ -17,16 +17,16 @@ 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 `planName` when using `name`.
+: ID of the plan to which the bucket to remove belongs. Specify either `planId` or `planTitle` when using `name`.
 
-`--planName [planName]`
-: Name of the plan to which the bucket to remove belongs. Specify either `planId` or `planName` when using `name`.
+`--planTitle [planTitle]`
+: Title of the plan to which the bucket to remove belongs. Specify either `planId` or `planTitle` when using `name`.
 
 `--ownerGroupId [ownerGroupId]`
-: ID of the group to which the plan belongs. Specify either `ownerGroupId` or `ownerGroupName` when using `planName`.
+: ID of the group to which the plan belongs. Specify either `ownerGroupId` or `ownerGroupName` when using `planTitle`.
 
 `--ownerGroupName [ownerGroupName]`
-: Name of the group to which the plan belongs. Specify either `ownerGroupId` or `ownerGroupName` when using `planName`.
+: Name of the group to which the plan belongs. Specify either `ownerGroupId` or `ownerGroupName` when using `planTitle`.
 
 `--confirm`
 : Don't prompt for confirmation
@@ -56,5 +56,5 @@ m365 planner bucket remove --name "My Bucket" --planId "oUHpnKBFekqfGE_PS6GGUZcA
 Removes the Microsoft Planner bucket with name _My Bucket_ in the Plan _My Plan_ owned by group _My Group_
 
 ```sh
-m365 planner bucket remove --name "My Bucket" --planName "My Plan" --ownerGroupName "My Group"
+m365 planner bucket remove --name "My Bucket" --planTitle "My Plan" --ownerGroupName "My Group"
 ```

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

@@ -17,16 +17,16 @@ 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 `planName` when using `name`.
+: ID of the plan to update the bucket of. Specify either `planId` or `planTitle` when using `name`.
 
-`--planName [planName]`
-: Name of the plan to update the bucket of. Specify either `planId` or `planName` when using `name`. Always use in combination with either `ownerGroupId` or `ownerGroupName`. 
+`--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`. 
 
 `--ownerGroupId [ownerGroupId]`
-: ID of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planName`.
+: ID of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planTitle`.
 
 `--ownerGroupName [ownerGroupName]`
-: Name of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planName`.
+: Name of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planTitle`.
 
 `--newName [newName]`
 : New name of the bucket.
@@ -47,11 +47,11 @@ m365 planner bucket set --id "vncYUXCRBke28qMLB-d4xJcACtNz" --newName "New bucke
 Updates the Microsoft Planner bucket named _My Bucket_ in the Plan _My Plan_ owned by group _My Group_
 
 ```sh
-m365 planner bucket set --name "My Bucket" --planName "My Plan" --ownerGroupName "My Group" --newName "New bucket name"
+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_
 
 ```sh
-m365 planner bucket set --name "My Bucket" --planName "My Plan" --ownerGroupId 00000000-0000-0000-0000-000000000000 --newName "New bucket name"
+m365 planner bucket set --name "My Bucket" --planTitle "My Plan" --ownerGroupId 00000000-0000-0000-0000-000000000000 --newName "New bucket name"
 ```

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

@@ -19,18 +19,34 @@ m365 planner plan add [options]
 `--ownerGroupName [ownerGroupName]`
 : Name of the Group that owns the plan. A valid group must exist before this option can be set. Specify either `ownerGroupId` or `ownerGroupName` but not both.
 
+`--shareWithUserIds [shareWithUserIds]`
+: The comma-separated IDs of the users with whom you want to share the plan. Specify either `shareWithUserIds` or `shareWithUserNames` but not both.
+
+`--shareWithUserNames [shareWithUserNames]`
+: The comma-separated UPNs of the users with whom you want to share the plan. Specify either `shareWithUserIds` or `shareWithUserNames` but not both.
+
 --8<-- "docs/cmd/_global.md"
 
+## 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.
+
 ## Examples
 
 Adds a Microsoft Planner plan with the name _My Planner Plan_ for Group _233e43d0-dc6a-482e-9b4e-0de7a7bce9b4_
 
 ```sh
-m365 planner plan add --title "My Planner Plan" --ownerGroupId "233e43d0-dc6a-482e-9b4e-0de7a7bce9b4"
+m365 planner plan add --title 'My Planner Plan' --ownerGroupId '233e43d0-dc6a-482e-9b4e-0de7a7bce9b4'
 ```
 
 Adds a Microsoft Planner plan with the name _My Planner Plan_ for Group _My Planner Group_
 
 ```sh
-m365 planner plan add --title "My Planner Plan" --ownerGroupName "My Planner Group"
+m365 planner plan add --title 'My Planner Plan' --ownerGroupName 'My Planner Group'
+```
+
+Adds a Microsoft Planner plan with the name _My Planner Plan_ for Group _My Planner Group_ and share it with the users _Allan.Carroll@contoso.com_ and _Ida.Stevens@contoso.com_
+
+```sh
+m365 planner plan add --title 'My Planner Plan' --ownerGroupName 'My Planner Group' --shareWithUserNames 'Allan.Carroll@contoso.com,Ida.Stevens@contoso.com'
 ```

package/docs/docs/cmd/planner/plan/plan-get.md

@@ -8,12 +8,6 @@ Retrieve information about the specified plan
 m365 planner plan get [options]
 ```
 
-## Alias
-
-```sh
-m365 planner plan details get [options]
-```
-
 ## Options
 
 `-i, --id [id]`
@@ -22,12 +16,6 @@ m365 planner plan details get [options]
 `-t, --title [title]`
 : Title of the plan. Specify either `id` or `title` but not both.
 
-`--planId [planId]`
-: (deprecated. Use `id` instead) ID of the plan. Specify either `planId` or `planTitle` but not both.
-
-`---planTitle [planTitle]`
-: (deprecated. Use `title` instead) Title of the plan. Specify either `planId` or `planTitle` but not both.
-
 `--ownerGroupId [ownerGroupId]`
 : ID of the Group that owns the plan. Specify either `ownerGroupId` or `ownerGroupName` when using `title` or the deprecated `planTitle`.
 

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

@@ -1,4 +1,4 @@
-## planner plan remove
+# planner plan remove
 
 Removes the Microsoft Planner plan
 

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

@@ -14,22 +14,22 @@ m365 planner task add [options]
 : Title of the task to add.
 
 `--planId [planId]`
-: Plan ID to which the task belongs. Specify either `planId` or `planName` but not both.
+: ID of the plan to which the task belongs. Specify either `planId` or `planTitle` but not both.
 
-`--planName [planName]`
-: Plan Name to which the task belongs. Specify either `planId` or `planName` but not both.
+`--planTitle [planTitle]`
+: Title of the plan to which the task belongs. Specify either `planId` or `planTitle` but not both.
 
 `--ownerGroupId [ownerGroupId]`
-: ID of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planName`.
+: ID of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planTitle`.
 
 `--ownerGroupName [ownerGroupName]`
-: Name of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planName`.
+: Name of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planTitle`.
 
 `--bucketId [bucketId]`
-: Bucket ID to which the task belongs. The bucket needs to exist in the selected plan. Specify either `bucketId` or `bucketName` but not both.
+: ID 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.
 
 `--bucketName [bucketName]`
-: Bucket Name to which the task belongs. The bucket needs to exist in the selected plan. Specify either `bucketId` or `bucketName` but not both.
+: 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`
@@ -89,10 +89,10 @@ Adds a Microsoft Planner task with the name _My Planner Task_ for plan with the
 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 name _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 _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_
 
 ```sh
-m365 planner task add --title "My Planner task" --planName "My Planner Plan" --ownerGroupName "My Planner Group" --bucketId "IK8tuFTwQEa5vTonM7ZMRZgAKdna" --percentComplete 100
+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 the users _Allan.Carroll@contoso.com_ and _Ida.Stevens@contoso.com_ and receive a due date for _2021-12-16_

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

@@ -21,4 +21,4 @@ Lists the checklist items of a Planner task.
 
 ```sh
 m365 planner task checklistitem list --taskId 'vzCcZoOv-U27PwydxHB8opcADJo-'
-```
+```