@pnp/cli-microsoft365 5.4.0 → 5.5.0-beta.10c7ae2

package/dist/utils/validation.js

@@ -6,8 +6,12 @@ exports.validation = {
         return guids.every(guid => this.isValidGuid(guid));
     },
     isValidGuid(guid) {
+        if (!guid) {
+            return false;
+        }
         const guidRegEx = new RegExp(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i);
-        return guidRegEx.test(guid);
+        // verify if the guid is a valid guid. @meid will be replaced in a later stage with the actual user id of the logged in user
+        return guidRegEx.test(guid) || guid.toLocaleLowerCase().trim() === "@meid";
     },
     isValidTeamsChannelId(guid) {
         const guidRegEx = new RegExp(/^19:[0-9a-zA-Z-_]+@thread\.(skype|tacv2)$/i);

package/docs/docs/cmd/aad/user/user-get.md

@@ -56,6 +56,18 @@ For the user with id _1caf7dcd-7e83-4c3a-94f7-932a1299c844_ retrieve the user na
 m365 aad user get --id 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --properties "userPrincipalName,mail,displayName"
 ```
 
+Get information about the currently logged user using the Id token
+
+```sh
+m365 aad user get --id "@meId"
+```
+
+Get information about the currently logged in user using the UserName token
+
+```sh
+m365 aad user get --userName "@meUserName"
+```
+
 ## More information
 
 - Microsoft Graph User properties: [https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties](https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties)

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

@@ -14,16 +14,19 @@ 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.
+
+`--planTitle [planTitle]`
+: Title 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.
+: (deprecated. Use `planTitle` instead) Title of the plan to which the bucket belongs.
 
 `--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 +41,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,19 @@ 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`.
+
+`--planTitle [planTitle]`
+: Title 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`.
+: (deprecated. Use `planTitle` instead) Title of the plan to which the bucket belongs.
 
 `--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 +50,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,19 @@ 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.
+
+`--planTitle [planTitle]`
+: Title 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.
+: (deprecated. Use `planTitle` instead) Title of the plan to which the bucket belongs.
 
 `--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 +38,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,19 @@ 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`.
+
+`--planTitle [planTitle]`
+: Title 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`.
+: (deprecated. Use `planTitle` instead) Title of the plan to which the bucket belongs.
 
 `--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 +59,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,19 @@ 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`.
+
+`--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`. 
 
 `--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`. 
+: (deprecated. Use `planTitle` instead) Title of the plan to which the bucket belongs.
 
 `--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 +50,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-get.md

@@ -8,6 +8,12 @@ Retrieve information about the specified plan
 m365 planner plan get [options]
 ```
 
+## Alias
+
+```sh
+m365 planner plan details get [options]
+```
+
 ## Options
 
 `-i, --id [id]`
@@ -16,11 +22,17 @@ m365 planner plan 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`.
+: ID of the Group that owns the plan. Specify either `ownerGroupId` or `ownerGroupName` when using `title` or the deprecated `planTitle`.
 
 `--ownerGroupName [ownerGroupName]`
-: Name of the Group that owns the plan. Specify either `ownerGroupId` or `ownerGroupName` when using `title`.
+: Name of the Group that owns the plan. Specify either `ownerGroupId` or `ownerGroupName` when using `title` or the deprecated `planTitle`.
 
 --8<-- "docs/cmd/_global.md"
 

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

@@ -0,0 +1,48 @@
+# planner plan remove
+
+Removes the Microsoft Planner plan
+
+## Usage
+
+```sh
+m365 planner plan remove [options]
+```
+
+## Options
+
+`i, --id [id]`
+: ID of the plan to remove. Specify either `id` or `title` but not both.
+
+`-t, --title [title]`
+: Title of the plan to remove. Specify either `id` or `title` but not both.
+
+`--ownerGroupId [ownerGroupId]`
+: ID of the Group that owns the plan. Specify either `ownerGroupId` or `ownerGroupName` when using `title`.
+
+`--ownerGroupName [ownerGroupName]`
+: Name of the Group that owns the plan. Specify either `ownerGroupId` or `ownerGroupName` when using `title`.
+
+`--confirm`
+: Don't prompt for confirmation.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Removes the Microsoft Planner plan by ID
+
+```sh
+m365 planner plan remove --id gndWOTSK60GfPQfiDDj43JgACDCb
+```
+
+Removes the Microsoft Planner plan with title _My Plan_ in group with specific ID
+
+```sh
+m365 planner plan remove --title "My Plan" --ownerGroupId 00000000-0000-0000-0000-000000000000
+```
+
+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
+```

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

@@ -14,22 +14,25 @@ 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.
+
+`--planTitle [planTitle]`
+: Title 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.
+: (deprecated. Use `planTitle` instead) Title of the plan to which the bucket belongs.
 
 `--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 +92,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-get.md

@@ -20,22 +20,25 @@ m365 planner task get [options]
 : (deprecated. Use `id` instead) ID of the task.
 
 `--bucketId [bucketId]`
-: Bucket ID to which the task belongs. Specify `bucketId` or `bucketName` when using `title`.
+: ID of the bucket to which the task belongs. Specify `bucketId` or `bucketName` when using `title`.
 
 `--bucketName [bucketName]`
-: Bucket Name to which the task belongs. Specify `bucketId` or `bucketName` when using `title`.
+: Name of the bucket to which the task belongs. Specify `bucketId` or `bucketName` when using `title`.
 
 `--planId [planId]`
-: Plan ID to which the task belongs. Specify `planId` or `planName` when using `bucketName`.
+: ID of the plan to which the task belongs. Specify `planId` or `planTitle` when using `bucketName`.
+
+`--planTitle [planTitle]`
+: Title of the plan to which the task belongs. Specify `planId` or `planTitle` when using `bucketName`.
 
 `--planName [planName]`
-: Plan Name to which the task belongs. Specify `planId` or `planName` when using `bucketName`.
+: (deprecated. Use `planTitle` instead) Title of the plan to which the bucket belongs.
 
 `--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,8 +50,8 @@ Retrieve the specified planner task by id
 m365 planner task get --id "vzCcZoOv-U27PwydxHB8opcADJo-"
 ```
 
-Retrieve the specified planner task with the title _My Planner Task_ from the bucket named _My Planner Bucket_ based on the plan with the name _My Planner Plan_ owned by the group _My Planner Group_
+Retrieve the specified planner task with the title _My Planner Task_ from the bucket named _My Planner Bucket_. Based on the plan with the title _My Planner Plan_ owned by the group _My Planner Group_.
 
 ```sh
-m365 planner task get --title "My Planner Task" --bucketName "My Planner Bucket" --planName "My Planner Plan" --ownerGroupName "My Planner Group"
+m365 planner task get --title "My Planner Task" --bucketName "My Planner Bucket" --planTitle "My Planner Plan" --ownerGroupName "My Planner Group"
 ```

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

@@ -17,16 +17,19 @@ m365 planner task list [options]
 : Name of the bucket to list the tasks of. To retrieve tasks from a bucket, specify `bucketId` or `bucketName`, but not both.
 
 `--planId [planId]`
-: ID of a plan to list the tasks of. To retrieve all tasks from a plan, specify either `planId` or `planName` but not both. Use in combination with `bucketName` to retrieve tasks from a specific bucket.
+: ID of a plan to list the tasks of. To retrieve all tasks from a plan, specify either `planId` or `planTitle` but not both. Use in combination with `bucketName` to retrieve tasks from a specific bucket.
+
+`--planTitle [planTitle]`
+: Title of a plan to list the tasks of. To retrieve all tasks from a plan, specify either `planId` or `planTitle` but not both. Always use in combination with either `ownerGroupId` or `ownerGroupName`. Use in combination with `bucketName` to retrieve tasks from a specific bucket.
 
 `--planName [planName]`
-: Name of a plan to list the tasks of. To retrieve all tasks from a plan, specify either `planId` or `planName` but not both. Always use in combination with either `ownerGroupId` or `ownerGroupName`. Use in combination with `bucketName` to retrieve tasks from a specific bucket.
+: (deprecated. Use `planTitle` instead) Title of the plan to which the bucket belongs.
 
 `--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"
 
@@ -52,7 +55,7 @@ m365 planner task list --planId "iVPMIgdku0uFlou-KLNg6MkAE1O2"`
 List the Microsoft Planner tasks in the plan _My Plan_ in group _My Group_
 
 ```sh
-m365 planner task list --planName "My Plan" --ownerGroupName "My Group"
+m365 planner task list --planTitle "My Plan" --ownerGroupName "My Group"
 ```
 
 List the Microsoft Planner tasks in the bucket _FtzysDykv0-9s9toWiZhdskAD67z_
@@ -70,5 +73,5 @@ m365 planner task list --bucketName "My Bucket" --planId "iVPMIgdku0uFlou-KLNg6M
 List the Microsoft Planner tasks in the bucket _My Bucket_ belonging to plan _My Plan_ in group _My Group_
 
 ```sh
-m365 planner task list --bucketName "My Bucket" --planName "My Plan" --ownerGroupName "My Group"
+m365 planner task list --bucketName "My Bucket" --planTitle "My Plan" --ownerGroupName "My Group"
 ```

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

@@ -23,16 +23,19 @@ m365 planner task set [options]
 : Name of the bucket to move the task to. The bucket needs to exist in the selected plan. Specify either `bucketId` or `bucketName` when using `title`.
 
 `--planId [planId]`
-: ID of the plan to which the bucket belongs to. Specify either `planId` or `planName` when using `bucketName`.
+: ID of the plan to which the bucket belongs to. Specify either `planId` or `planTitle` when using `bucketName`.
+
+`--planTitle [planTitle]`
+: Title of the plan to which the bucket belongs to. Specify either `planId` or `planTitle` when using `bucketName`.
 
 `--planName [planName]`
-: Name of the plan to which the bucket belongs to. Specify either `planId` or `planName` when using `bucketName`.
+: (deprecated. Use `planTitle` instead) Title of the plan to which the bucket belongs.
 
 `--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`.
 
 `--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`
@@ -91,10 +94,10 @@ Updates a Microsoft Planner task name to _My Planner Task_ for the task with the
 m365 planner task set --id "Z-RLQGfppU6H3663DBzfs5gAMD3o" --title "My Planner Task"
 ```
 
-Moves a Microsoft Planner task with the ID _Z-RLQGfppU6H3663DBzfs5gAMD3o_ to the bucket named _My Planner Bucket_. Based on the plan with the name _My Planner Plan_ owned by the group _My Planner Group_
+Moves a Microsoft Planner task with the ID _Z-RLQGfppU6H3663DBzfs5gAMD3o_ to the bucket named _My Planner Bucket_. Based on the plan with the title _My Planner Plan_ owned by the group _My Planner Group_
 
 ```sh
-m365 planner task set  --id "2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2" --bucketName "My Planner Bucket" --planName "My Planner Plan" --ownerGroupName "My Planner Group"
+m365 planner task set  --id "2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2" --bucketName "My Planner Bucket" --planTitle "My Planner Plan" --ownerGroupName "My Planner Group"
 ```
 
 Marks a Microsoft Planner task with the ID _Z-RLQGfppU6H3663DBzfs5gAMD3o_ as 50% complete and assigned to categories 1 and 3.

package/docs/docs/cmd/planner/tenant/tenant-settings-set.md

@@ -0,0 +1,56 @@
+# planner tenant settings set
+
+Sets Microsoft Planner configuration of the tenant
+
+## Usage
+
+```sh
+m365 planner tenant settings set [options]
+```
+
+## Options
+
+`--isPlannerAllowed [isPlannerAllowed]`
+: Configure whether Planner should be enabled on the tenant.
+
+`--allowCalendarSharing [allowCalendarSharing]`
+: Configure whether Outlook calendar sync is enabled.
+
+`--allowTenantMoveWithDataLoss [allowTenantMoveWithDataLoss]`
+: Configure whether a tenant move into a new region is authorized.
+
+`--allowTenantMoveWithDataMigration [allowTenantMoveWithDataMigration]`
+: Configure whether a tenant move with data migration is authorized.
+
+`--allowRosterCreation [allowRosterCreation]`
+: Configure whether Planner roster creation is allowed.
+
+`--allowPlannerMobilePushNotifications [allowPlannerMobilePushNotifications]`
+: Configure whether push notifications are enabled in the mobile app.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+!!! important
+    To use this command you must be a global administrator.
+
+## Examples
+
+Disable Microsoft Planner in the tenant
+
+```sh
+m365 planner tenant settings set --isPlannerAllowed false
+```
+
+Disable Outlook calendar sync and mobile push notifications
+
+```sh
+m365 planner tenant settings set --allowCalendarSharing false --allowPlannerMobilePushNotifications false
+```
+
+Enable Microsoft Planner but disallow roster plans to be created
+
+```sh
+m365 planner tenant settings set --isPlannerAllowed true --allowRosterCreation false
+```

package/docs/docs/cmd/search/externalconnection/externalconnection-get.md

@@ -0,0 +1,33 @@
+# search externalconnection get
+
+Allow the administrator to get a specific external connection for use in Microsoft Search.
+
+## Usage
+
+```sh
+m365 search externalconnection get [options]
+```
+
+## Options
+
+`-i, --id [id]`
+: ID of the External Connection to get. Specify either `id` or `name`
+
+`-n, --name [name]`
+: Name of the External Connection to get. Specify either `id` or `name`
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Get the External Connection by its id
+
+```sh
+m365 search externalconnection get --id "MyApp"
+```
+
+Get the External Connection by its name
+
+```sh
+m365 search externalconnection get --name "Test"
+```

package/docs/docs/cmd/spo/hubsite/hubsite-get.md

@@ -10,17 +10,16 @@ m365 spo hubsite get [options]
 
 ## Options
 
-`-i, --id <id>`
-: Hub site ID
+`-i, --id [id]`
+: ID of the hubsite. Specify either `id`, `title` or `url` but not multiple.
 
---8<-- "docs/cmd/_global.md"
-
-## Remarks
+`-t, --title [title]`
+: Title of the hubsite. Specify either `id`, `title` or `url` but not multiple.
 
-!!! attention
-    This command is based on a SharePoint API that is currently in preview and is subject to change once the API reached general availability.
+`-u, --url [url]`
+: URL of the hubsite. Specify either `id`, `title` or `url` but not multiple.
 
-If the specified `id` doesn't refer to an existing hub site, you will get a `ResourceNotFoundException` error.
+--8<-- "docs/cmd/_global.md"
 
 ## Examples
 
@@ -30,6 +29,18 @@ Get information about the hub site with ID _2c1ba4c4-cd9b-4417-832f-92a34bc34b2a
 m365 spo hubsite get --id 2c1ba4c4-cd9b-4417-832f-92a34bc34b2a
 ```
 
+Get information about the hub site with Title _My Hub Site_
+
+```sh
+m365 spo hubsite get --title 'My Hub Site'
+```
+
+Get information about the hub site with URL _https://contoso.sharepoint.com/sites/HubSite_
+
+```sh
+m365 spo hubsite get --url 'https://contoso.sharepoint.com/sites/HubSite'
+```
+
 ## More information
 
 - SharePoint hub sites new in Microsoft 365: [https://techcommunity.microsoft.com/t5/SharePoint-Blog/SharePoint-hub-sites-new-in-Office-365/ba-p/109547](https://techcommunity.microsoft.com/t5/SharePoint-Blog/SharePoint-hub-sites-new-in-Office-365/ba-p/109547)

package/docs/docs/cmd/spo/roledefinition/roledefinition-get.md

@@ -0,0 +1,27 @@
+# spo roledefinition get
+
+Gets specified role definition from web by id
+
+## Usage
+
+```sh
+m365 spo roledefinition get [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: URL of the site for which to retrieve the role definition
+
+`-i, --id <id>`
+: The Id of the role definition to retrieve.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Retrieve the role definition for site _https://contoso.sharepoint.com/sites/project-x_ with id _1_
+
+```sh
+m365 spo roledefinition get --webUrl https://contoso.sharepoint.com/sites/project-x --id 1
+```