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

package/docs/docs/cmd/teams/team/team-unarchive.md

@@ -10,8 +10,11 @@ m365 teams team unarchive [options]
 
 ## Options
 
-`-i, --teamId <teamId>`
-: The ID of the Microsoft Teams team to restore
+`-i, --id [id]`
+: The ID of the Microsoft Teams team to restore. Specify either id or name but not both
+
+`-n, --name [name]`
+: The display name of the Microsoft Teams team to restore. Specify either id or name but not both
 
 --8<-- "docs/cmd/_global.md"
 
@@ -19,12 +22,20 @@ m365 teams team unarchive [options]
 
 This command supports admin permissions. Global admins and Microsoft Teams service admins can restore teams that they are not a member of.
 
+If the command finds multiple Microsoft Teams teams with the specified name, it will prompt you to disambiguate which team it should use, listing the discovered team IDs.
+
 This command restores users' ability to send messages and edit the team, abiding by tenant and team settings.
 
 ## Examples
 
-Restore an archived Microsoft Teams team
+Restore an archived Microsoft Teams team with id _6f6fd3f7-9ba5-4488-bbe6-a789004d0d55_
+
+```sh
+m365 teams team unarchive --id 6f6fd3f7-9ba5-4488-bbe6-a789004d0d55
+```
+
+Restore an archived Microsoft Teams team with name _Team Name_
 
 ```sh
-m365 teams team unarchive --teamId 6f6fd3f7-9ba5-4488-bbe6-a789004d0d55
+m365 teams team unarchive --name "Team Name"
 ```

package/docs/docs/cmd/teams/user/user-app-add.md

@@ -10,7 +10,7 @@ m365 teams user app add [options]
 
 ## Options
 
-`--appId <appId>`
+`--id <id>`
 : The ID of the app to install
 
 `--userId <userId>`
@@ -20,12 +20,12 @@ m365 teams user app add [options]
 
 ## Remarks
 
-The `appId` has to be the ID of the app from the Microsoft Teams App Catalog. Do not use the ID from the manifest of the zip app package. Use the [teams app list](../app/app-list.md) command to get this ID.
+The `id` has to be the ID of the app from the Microsoft Teams App Catalog. Do not use the ID from the manifest of the zip app package. Use the [teams app list](../app/app-list.md) command to get this ID.
 
 ## Examples
 
 Install an app from the catalog for the specified user
 
 ```sh
-m365 teams user app add --appId 4440558e-8c73-4597-abc7-3644a64c4bce --userId 2609af39-7775-4f94-a3dc-0dd67657e900
+m365 teams user app add --id 4440558e-8c73-4597-abc7-3644a64c4bce --userId 2609af39-7775-4f94-a3dc-0dd67657e900
 ```

package/docs/docs/cmd/teams/user/user-app-remove.md

@@ -10,7 +10,7 @@ m365 teams user app remove [options]
 
 ## Options
 
-`--appId <appId>`
+`--id <id>`
 : The unique id of the app instance installed for the user
 
 `--userId <userId>`
@@ -23,7 +23,7 @@ m365 teams user app remove [options]
 
 ## Remarks
 
-The `appId` has to be the id of the app instance installed for the user.
+The `id` has to be the id of the app instance installed for the user.
 Do not use the ID from the manifest of the zip app package or the id from the Microsoft Teams App Catalog.
 
 ## Examples
@@ -31,5 +31,5 @@ Do not use the ID from the manifest of the zip app package or the id from the Mi
 Uninstall an app for the specified user
 
 ```sh
-m365 teams user app remove --appId YzUyN2E0NzAtYTg4Mi00ODFjLTk4MWMtZWU2ZWZhYmE4NWM3IyM0ZDFlYTA0Ny1mMTk2LTQ1MGQtYjJlOS0wZDI4NTViYTA1YTY= --userId 2609af39-7775-4f94-a3dc-0dd67657e900
+m365 teams user app remove --id YzUyN2E0NzAtYTg4Mi00ODFjLTk4MWMtZWU2ZWZhYmE4NWM3IyM0ZDFlYTA0Ny1mMTk2LTQ1MGQtYjJlOS0wZDI4NTViYTA1YTY= --userId 2609af39-7775-4f94-a3dc-0dd67657e900
 ```

package/docs/docs/cmd/tenant/security/security-alerts-list.md

@@ -27,4 +27,4 @@ Get security alerts for a vendor with name _Azure Sentinel_
 
 ```sh
 m365 tenant security alerts list --vendor "Azure Sentinel"
-```
+```

package/docs/docs/cmd/tenant/serviceannouncement/serviceannouncement-health-get.md

@@ -1,4 +1,4 @@
-# tenant service announcement health get
+# tenant serviceannouncement health get
 
 Get the health report of a specified service for a tenant
 

package/docs/docs/cmd/tenant/serviceannouncement/serviceannouncement-health-list.md

@@ -1,4 +1,4 @@
-# tenant service announcement health list
+# tenant serviceannouncement health list
 
 Gets the health report of all subscribed services for a tenant
 

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

@@ -11,26 +11,53 @@ m365 todo task add [options]
 ## Options
 
 `-t, --title <title>`
-: The title of the task
+: The title of the task.
 
 `--listName [listName]`
-: The name of the list in which to create the task. Specify either `listName` or `listId` but not both
+: The name of the list in which to create the task. Specify either `listName` or `listId` but not both.
 
 `--listId [listId]`
-: The id of the list in which to create the task. Specify either `listName` or `listId` but not both
+: The id of the list in which to create the task. Specify either `listName` or `listId` but not both.
+
+`--bodyContent [bodyContent]`
+: The body content of the task. In the UI this is called 'notes'.
+
+`--bodyContentType [bodyContentType]`
+: The type of the body content. Possible values are `text` and `html`. Default is `text`.
+
+`--dueDateTime [dueDateTime]`
+: The date when the task is due. This should be defined as a valid ISO 8601 string in the UTC time zone. Only date value is needed, time value is always ignored.
+
+`--importance [importance]`
+: The importance of the task. Possible values are: `low`, `normal`, `high`. Default is `normal`.
+
+`--reminderDateTime [reminderDateTime]`
+: The date and time for a reminder alert of the task to occur. This should be defined as a valid ISO 8601 string in the UTC time zone.
 
 --8<-- "docs/cmd/_global.md"
 
 ## Examples
 
-Add a task with title _New task_ to Microsoft To Do tasks list with the name _My task list_
+Add a task to Microsoft To Do tasks list with with a specific name
 
 ```sh
 m365 todo task add --title "New task" --listName "My task list"
 ```
 
-Add a task with title _New task_ to Microsoft To Do tasks list with the id `AQMkADlhMTRkOGEzLWQ1M2QtNGVkNS04NjdmLWU0NzJhMjZmZWNmMwAuAAADKvwNgAMNPE_zFNRJXVrU1wEAhHKQZHItDEOVCn8U3xuA2AABmQeVPwAAAA==`
+Add a task to a Microsoft To Do tasks list with a specific id
 
 ```sh
 m365 todo task add --title "New task" --listId "AQMkADlhMTRkOGEzLWQ1M2QtNGVkNS04NjdmLWU0NzJhMjZmZWNmMwAuAAADKvwNgAMNPE_zFNRJXVrU1wEAhHKQZHItDEOVCn8U3xuA2AABmQeVPwAAAA=="
 ```
+
+Create a new task with bodyContent and reminder and flag it as important
+
+```sh
+m365 todo task add --title "New task" --listName "My task list" --bodyContent "I should not forget this" --reminderDateTime 2023-01-01T12:00:00Z --importance high
+```
+
+Create a new task with a specific due date
+
+```sh
+m365 todo task add --title "New task" --listId "AQMkADlhMTRkOGEzLWQ1M2QtNGVkNS04NjdmLWU0NzJhMjZmZWNmMwAuAAADKvwNgAMNPE_zFNRJXVrU1wEAhHKQZHItDEOVCn8U3xuA2AABmQeVPwAAAA==" --dueDateTime 2023-01-01
+```

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

@@ -25,18 +25,45 @@ m365 todo task set [options]
 `--listId [listId]`
 : The id of the task list in which the task exists. Specify either `listName` or `listId`, not both
 
+`--bodyContent [bodyContent]`
+: The body content of the task. In the UI this is called 'notes'.
+
+`--bodyContentType [bodyContentType]`
+: The type of the body content. Possible values are `text` and `html`. Default is `text`.
+
+`--importance [importance]`
+: The importance of the task. Possible values are: `low`, `normal`, `high`.
+
+`--dueDateTime [dueDateTime]`
+: The date and time when the task is due. This should be defined as a valid ISO 8601 string in the UTC time zone. Only date value is needed, time value is always ignored.
+
+`--reminderDateTime [reminderDateTime]`
+: The date and time for a reminder alert of the task to occur. This should be defined as a valid ISO 8601 string in the UTC time zone.
+
 --8<-- "docs/cmd/_global.md"
 
 ## Examples
 
-Update a task with title _New task_ to _Update doco_ in Microsoft To Do tasks list with the name _My task list_
+Update a task with title _New task_ to _Update doco_ in Microsoft To Do tasks list with a specific name
 
 ```sh
 m365 todo task set --id "AAMkADU3Y2E0OTMxLTllYTQtNGFlZS1hZGM0LWI1NjZjY2FhM2RhMABGAAAAAADhr7P77n9xS6PdtDemRwpHBwCin1tvQMXzRKN1hQDz2S3VAAAXXsleAACin1tvQMXzRKN1hQDz2S3VAAAXXzr9AAA=" --title "Update doco" --listName "My task list"
 ```
 
-Update a task with status from _notStarted_ to _inProgress_ in Microsoft To Do tasks list with the name _My task list_
+Update a task with status from _notStarted_ to _inProgress_ in Microsoft To Do tasks list with a specific name
 
 ```sh
 m365 todo task set --id "AAMkADU3Y2E0OTMxLTllYTQtNGFlZS1hZGM0LWI1NjZjY2FhM2RhMABGAAAAAADhr7P77n9xS6PdtDemRwpHBwCin1tvQMXzRKN1hQDz2S3VAAAXXsleAACin1tvQMXzRKN1hQDz2S3VAAAXXzr9AAA=" --status "inProgress" --listName "My task list"
 ```
+
+Update a task with bodyContent and reminder and flag it as important in Microsoft To Do tasks list with a specific name
+
+```sh
+m365 todo task set --id "AAMkADU3Y2E0OTMxLTllYTQtNGFlZS1hZGM0LWI1NjZjY2FhM2RhMABGAAAAAADhr7P77n9xS6PdtDemRwpHBwCin1tvQMXzRKN1hQDz2S3VAAAXXsleAACin1tvQMXzRKN1hQDz2S3VAAAXXzr9AAA=" --listName "My task list" --bodyContent "I should not forget this" --reminderDateTime 2023-01-01T12:00:00Z --importance high
+```
+
+Update a task with due date in Microsoft To Do tasks list with list id
+
+```sh
+m365 todo task set --id "AAMkADU3Y2E0OTMxLTllYTQtNGFlZS1hZGM0LWI1NjZjY2FhM2RhMABGAAAAAADhr7P77n9xS6PdtDemRwpHBwCin1tvQMXzRKN1hQDz2S3VAAAXXsleAACin1tvQMXzRKN1hQDz2S3VAAAXXzr9AAA=" --listId "AQMkADlhMTRkOGEzLWQ1M2QtNGVkNS04NjdmLWU0NzJhMjZmZWNmMwAuAAADKvwNgAMNPE_zFNRJXVrU1wEAhHKQZHItDEOVCn8U3xuA2AABmQeVPwAAAA==" --dueDateTime 2023-01-01
+```

package/docs/docs/cmd/viva/connections/connections-app-create.md

@@ -13,7 +13,7 @@ m365 viva connections app create [options]
 `--portalUrl <portalUrl>`
 : The URL of the site to pin in Microsoft Teams. Must be a Communication site
 
-`--appName <appName>`
+`--name <name>`
 : Name of the app to create, eg. `Contoso`. No longer than 30 characters
 
 `--description <description>`
@@ -63,7 +63,7 @@ After creating the Viva Connections desktop app package, you need to upload it t
 Create a Viva Connections desktop app package
 
 ```sh
-m365 viva connections app create --portalUrl https://contoso.sharepoint.com --appName Contoso --description "Contoso company app" --longDescription "Stay on top of what's happening at Contoso" --companyName Contoso --companyWebsiteUrl https://contoso.com --coloredIconPath icon-color.png --outlineIconPath icon-outline.png
+m365 viva connections app create --portalUrl https://contoso.sharepoint.com --name Contoso --description "Contoso company app" --longDescription "Stay on top of what's happening at Contoso" --companyName Contoso --companyWebsiteUrl https://contoso.com --coloredIconPath icon-color.png --outlineIconPath icon-outline.png
 ```
 
 ## More information

package/docs/docs/cmd/yammer/group/group-user-add.md

@@ -10,10 +10,10 @@ m365 yammer group user add [options]
 
 ## Options
 
-`--id <id>`
+`--groupId <groupId>`
 : The ID of the group to add the user to
 
-`--userId [userId]`
+`--id [id]`
 : ID of the user to add to the group. If not specified, adds the current user
 
 `--email [email]`
@@ -33,17 +33,17 @@ If the specified user is not a member of the network, the command will return an
 Adds the current user to the group with the ID `5611239081`
 
 ```sh
-m365 yammer group user add --id 5611239081
+m365 yammer group user add --groupId 5611239081
 ```
 
 Adds the user with ID `66622349` to the group with the ID `5611239081`
 
 ```sh
-m365 yammer group user add --id 5611239081 --userId 66622349
+m365 yammer group user add --groupId 5611239081 --id 66622349
 ```
 
 Adds the user with e-mail `suzy@contoso.com` to the group with ID `5611239081`
 
 ```sh
-m365 yammer group user add --id 5611239081 --email suzy@contoso.com
+m365 yammer group user add --groupId 5611239081 --email suzy@contoso.com
 ```

package/docs/docs/cmd/yammer/group/group-user-remove.md

@@ -10,10 +10,10 @@ m365 yammer group user remove [options]
 
 ## Options
 
-`--id <id>`
+`--groupId <groupId>`
 : The ID of the Yammer group
 
-`--userId [userId]`
+`--id [id]`
 : ID of the user to remove from the group. If not specified, removes the current user
 
 `--confirm`
@@ -31,17 +31,17 @@ m365 yammer group user remove [options]
 Remove the current user from the group with the ID `5611239081`
 
 ```sh
-m365 yammer group user remove --id 5611239081
+m365 yammer group user remove --groupId 5611239081
 ```
 
 Remove the user with the ID `66622349` from the group with the ID `5611239081`
 
 ```sh
-m365 yammer group user remove --id 5611239081 --userId 66622349
+m365 yammer group user remove --groupId 5611239081 --id 66622349
 ```
 
 Remove the user with the ID `66622349` from the group with the ID `5611239081` without asking for confirmation
 
 ```sh
-m365 yammer group user remove --id 5611239081 --userId 66622349 --confirm
+m365 yammer group user remove --groupId 5611239081 --id 66622349 --confirm
 ```

package/docs/docs/cmd/yammer/message/message-like-set.md

@@ -10,7 +10,7 @@ m365 yammer message like set [options]
 
 ## Options
 
-`--id <id>`
+`--messageId <messageId>`
 : The id of the Yammer message
 
 `--enable [enable]`
@@ -31,17 +31,17 @@ m365 yammer message like set [options]
 Likes the message with the ID `5611239081`
 
 ```sh
-m365 yammer message like set --id 5611239081
+m365 yammer message like set --messageId 5611239081
 ```
 
 Unlike the message with the ID `5611239081`
 
 ```sh
-m365 yammer message like set --id 5611239081 --enable false
+m365 yammer message like set --messageId 5611239081 --enable false
 ```
 
 Unlike the message with the ID `5611239081` without asking for confirmation
 
 ```sh
-m365 yammer message like set --id 5611239081 --enable false --confirm
+m365 yammer message like set --messageId 5611239081 --enable false --confirm
 ```

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

@@ -10,7 +10,7 @@ m365 yammer user get [options]
 
 ## Options
 
-`-i, --userId [userId]`
+`-i, --id [id]`
 : Retrieve a user by ID
 
 `--email [email]`
@@ -36,7 +36,7 @@ m365 yammer user get
 Returns the user with the ID 1496550697
 
 ```sh
-m365 yammer user get --userId 1496550697
+m365 yammer user get --id 1496550697
 ```
 
 Returns an array of users matching the e-mail john.smith@contoso.com