@pnp/cli-microsoft365 6.3.0-beta.fee5cdb → 6.4.0-beta.006c079

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

@@ -11,7 +11,7 @@ m365 teams team list [options]
 ## Options
 
 `-j, --joined`
-: Show only joined teams
+: Show only joined teams.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -21,13 +21,13 @@ You can only see the details or archived status of the Microsoft Teams you are a
 
 ## Examples
 
-List all Microsoft Teams in the tenant
+List all Microsoft Teams in the tenant.
 
 ```sh
 m365 teams team list
 ```
 
-List all Microsoft Teams in the tenant you are a member of
+List all Microsoft Teams in the tenant you are a member of.
 
 ```sh
 m365 teams team list --joined
@@ -62,3 +62,34 @@ m365 teams team list --joined
     id,displayName,isArchived,description
     5dc7ba76-b9aa-4fdd-9e91-9fe7d0e8dca3,Architecture,,Architecture Discussion
     ```
+
+=== "Markdown"
+
+    ```md
+    # teams team list --joined "true"
+
+    Date: 1/3/2023
+
+    ## Architecture (5dc7ba76-b9aa-4fdd-9e91-9fe7d0e8dca3)
+
+    Property | Value
+    ---------|-------
+    id | 5dc7ba76-b9aa-4fdd-9e91-9fe7d0e8dca3
+    createdDateTime | null
+    displayName | Architecture
+    description | Architecture Discussion
+    internalId | null
+    classification | null
+    specialization | null
+    visibility | null
+    webUrl | null
+    isArchived | false
+    tenantId | 92e59666-257b-49c3-b1fa-1bae8107f6ba
+    isMembershipLimitedToOwners | null
+    memberSettings | null
+    guestSettings | null
+    messagingSettings | null
+    funSettings | null
+    discoverySettings | null
+    summary | null
+    ```

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

@@ -29,19 +29,19 @@ If the command finds multiple Microsoft Teams teams with the specified name, it
 
 ## Examples
 
-Removes the specified Microsoft Teams team with id _00000000-0000-0000-0000-000000000000_
+Removes the specified Microsoft Teams team by id.
 
 ```sh
 m365 teams team remove --id 00000000-0000-0000-0000-000000000000
 ```
 
-Removes the specified Microsoft Teams team with name _Team Name_
+Removes the specified Microsoft Teams team by name.
 
 ```sh
 m365 teams team remove --name "Team Name"
 ```
 
-Removes the specified team without confirmation
+Removes the specified team without confirmation.
 
 ```sh
 m365 teams team remove --id 00000000-0000-0000-0000-000000000000 --confirm

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

@@ -11,34 +11,34 @@ m365 teams team set [options]
 ## Options
 
 `-i, --id [id]`
-: The ID of the Microsoft Teams team for which to update settings
+: The ID of the Microsoft Teams team for which to update settings.
 
 `-n, --name [name]`
-: The display name for the Microsoft Teams team for which to update settings
+: The display name for the Microsoft Teams team for which to update settings.
 
 `--description [description]`
-: The description for the Microsoft Teams team
+: The description for the Microsoft Teams team.
 
 `--mailNickName [mailNickName]`
-: The mail alias for the Microsoft Teams team
+: The mail alias for the Microsoft Teams team.
 
 `--classification [classification]`
-: The classification for the Microsoft Teams team
+: The classification for the Microsoft Teams team.
 
 `--visibility [visibility]`
-: The visibility of the Microsoft Teams team. Valid values `Private,Public`
+: The visibility of the Microsoft Teams team. Valid values `Private`, `Public`.
 
 --8<-- "docs/cmd/_global.md"
 
 ## Examples
 
-Set Microsoft Teams team visibility as Private
+Set Microsoft Teams team visibility.
 
 ```sh
 m365 teams team set --id "00000000-0000-0000-0000-000000000000" --visibility Private
 ```
 
-Set Microsoft Teams team classification as MBI
+Set Microsoft Teams team classification.
 
 ```sh
 m365 teams team set --id "00000000-0000-0000-0000-000000000000" --classification MBI

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

@@ -28,17 +28,18 @@ This command restores users' ability to send messages and edit the team, abiding
 
 ## Examples
 
-Restore an archived Microsoft Teams team with id _6f6fd3f7-9ba5-4488-bbe6-a789004d0d55_
+Restore an archived Microsoft Teams team by id.
 
 ```sh
 m365 teams team unarchive --id 6f6fd3f7-9ba5-4488-bbe6-a789004d0d55
 ```
 
-Restore an archived Microsoft Teams team with name _Team Name_
+Restore an archived Microsoft Teams team by name.
 
 ```sh
 m365 teams team unarchive --name "Team Name"
 ```
+
 ## Response
 
 The command won't return a response on success.

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

@@ -11,10 +11,10 @@ m365 teams user app add [options]
 ## Options
 
 `--id <id>`
-: The ID of the app to install
+: The ID of the app to install.
 
 `--userId <userId>`
-: The ID of the user to install the app for
+: The ID of the user to install the app for.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -24,7 +24,7 @@ The `id` has to be the ID of the app from the Microsoft Teams App Catalog. Do no
 
 ## Examples
 
-Install an app from the catalog for the specified user
+Install an app from the catalog for the specified user.
 
 ```sh
 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-list.md

@@ -20,13 +20,13 @@ m365 teams user app list [options]
 
 ## Examples
 
-List the apps installed in the personal scope of the specified user using its ID
+List the apps installed in the personal scope of the specified user using its ID.
 
 ```sh
 m365 teams user app list --userId 4440558e-8c73-4597-abc7-3644a64c4bce
 ```
 
-List the apps installed in the personal scope of the specified user using its UPN
+List the apps installed in the personal scope of the specified user using its UPN.
 
 ```sh
 m365 teams user app list --userName admin@contoso.com
@@ -77,3 +77,19 @@ m365 teams user app list --userName admin@contoso.com
     NzhjY2Y1MzAtYmJmMC00N2U0LWFhZTYtZGE1ZjhjNmZiMTQyIyMxNGQ2OTYyZC02ZWViLTRmNDgtODg5MC1kZTU1NDU0YmIxMzY=,14d6962d-6eeb-4f48-8890-de55454bb136,Activity,1.0
     ```
 
+=== "Markdown"
+
+    ```md
+    # teams user app list --userName "admin@contoso.com"
+
+    Date: 1/3/2023
+
+    ## Activity (NzhjY2Y1MzAtYmJmMC00N2U0LWFhZTYtZGE1ZjhjNmZiMTQyIyMxNGQ2OTYyZC02ZWViLTRmNDgtODg5MC1kZTU1NDU0YmIxMzY=)
+
+    Property | Value
+    ---------|-------
+    id | NzhjY2Y1MzAtYmJmMC00N2U0LWFhZTYtZGE1ZjhjNmZiMTQyIyMxNGQ2OTYyZC02ZWViLTRmNDgtODg5MC1kZTU1NDU0YmIxMzY=
+    appId | 14d6962d-6eeb-4f48-8890-de55454bb136
+    displayName | Activity
+    version | 1.0
+    ```

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

@@ -11,13 +11,13 @@ m365 teams user app remove [options]
 ## Options
 
 `--id <id>`
-: The unique id of the app instance installed for the user
+: The unique id of the app instance installed for the user.
 
 `--userId <userId>`
-: The ID of the user to uninstall the app for
+: The ID of the user to uninstall the app for.
 
 `--confirm`
-: Confirm removal of app for user
+: Confirm removal of app for user.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -28,7 +28,7 @@ Do not use the ID from the manifest of the zip app package or the id from the Mi
 
 ## Examples
 
-Uninstall an app for the specified user
+Uninstall an app for the specified user.
 
 ```sh
 m365 teams user app remove --id YzUyN2E0NzAtYTg4Mi00ODFjLTk4MWMtZWU2ZWZhYmE4NWM3IyM0ZDFlYTA0Ny1mMTk2LTQ1MGQtYjJlOS0wZDI4NTViYTA1YTY= --userId 2609af39-7775-4f94-a3dc-0dd67657e900

package/docs/docs/cmd/teams/user/user-list.md

@@ -11,22 +11,22 @@ m365 teams user list [options]
 ## Options
 
 `-i, --teamId <teamId>`
-: The ID of the Microsoft Teams team for which to list users
+: The ID of the Microsoft Teams team for which to list users.
 
 `-r, --role [role]`
-: Filter the results to only users with the given role: `Owner,Member,Guest`
+: Filter the results to only users with the given role: `Owner`, `Member`, `Guest`.
 
 --8<-- "docs/cmd/_global.md"
 
 ## Examples
 
-List all users and their role in the specified Microsoft teams team
+List all users and their role in the specified Microsoft teams team.
 
 ```sh
 m365 teams user list --teamId '00000000-0000-0000-0000-000000000000'
 ```
 
-List all owners and their role in the specified Microsoft teams team
+List all owners and their role in the specified Microsoft teams team.
 
 ```sh
 m365 teams user list --teamId '00000000-0000-0000-0000-000000000000' --role Owner
@@ -62,3 +62,20 @@ m365 teams user list --teamId '00000000-0000-0000-0000-000000000000' --role Owne
     id,displayName,userPrincipalName,userType
     78ccf530-bbf0-47e4-aae6-da5f8c6fb142,John Doe,john@contoso.onmicrosoft.com,Owner
     ```
+
+=== "Markdown"
+
+    ```md
+    # teams user list --teamId "00000000-0000-0000-0000-000000000000"
+
+    Date: 1/3/2023
+
+    ## John Doe (78ccf530-bbf0-47e4-aae6-da5f8c6fb142)
+
+    Property | Value
+    ---------|-------
+    id | 78ccf530-bbf0-47e4-aae6-da5f8c6fb142
+    displayName | John Doe
+    userPrincipalName | john@contoso.onmicrosoft.com
+    userType | Owner
+    ```

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

@@ -34,8 +34,24 @@ m365 todo task add [options]
 `--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.
 
+`--categories [categories]`
+: Comma-separated list of categories associated with the task.
+
+`--completedDateTime [completedDateTime]`
+: The date and time when the task was finished. This should be defined as a valid ISO 8601 string. `2021-12-16T18:28:48.6964197Z`. This option can only be used when the `status` is set to `completed`.
+
+`--startDateTime [startDateTime]`
+: The date and time when the task is scheduled to start. This should be defined as a valid ISO 8601 string. `2021-12-16T18:28:48.6964197Z`
+
+`--status [status]`
+: Indicates the state or progress of the task. The possible values are: `notStarted`, `inProgress`, `completed`, `waitingOnOthers`, `deferred`.
+
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
+When you specify the values for `categories`, each category can correspond to the displayName property of an [outlookCategory](https://learn.microsoft.com/graph/api/resources/outlookcategory?view=graph-rest-1.0). It is permissible to use distinct names.
+
 ## Examples
 
 Add a task to Microsoft To Do tasks list with with a specific name
@@ -62,9 +78,13 @@ Create a new task with a specific due date
 m365 todo task add --title "New task" --listId "AQMkADlhMTRkOGEzLWQ1M2QtNGVkNS04NjdmLWU0NzJhMjZmZWNmMwAuAAADKvwNgAMNPE_zFNRJXVrU1wEAhHKQZHItDEOVCn8U3xuA2AABmQeVPwAAAA==" --dueDateTime 2023-01-01
 ```
 
-## Response
+Create a new task with categories, a completedDateTime, a startDateTime and a status
 
-### Standard response
+```sh
+m365 todo task add --title "New task" --listName "My task list" --categories "Red category,Important" --completedDateTime 2023-12-01 --startDateTime 2023-12-01 --status "notStarted"
+```
+
+## Response
 
 === "JSON"
 
@@ -117,3 +137,28 @@ m365 todo task add --title "New task" --listId "AQMkADlhMTRkOGEzLWQ1M2QtNGVkNS04
     importance,isReminderOn,status,title,createdDateTime,lastModifiedDateTime,hasAttachments,categories,id,body,dueDateTime,reminderDateTime
     high,1,notStarted,New task,2022-10-29T10:54:06.3672421Z,2022-10-29T10:54:06.5078837Z,,[],AAMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MABGAAAAAAAw3-tXgryDSr5p162KnUPKBwDEwEFouXWWT50CfwqSN9cpAAEX8ECDAADEwEFouXWWT50CfwqSN9cpAAEX8GuPAAA=,"{""content"":""I should not forget this"",""contentType"":""text""}","{""dateTime"":""2023-01-01T00:00:00.0000000"",""timeZone"":""UTC""}","{""dateTime"":""2023-01-01T12:00:00.0000000"",""timeZone"":""UTC""}"
     ```
+
+=== "Markdown"
+
+    ```md
+    # todo task add --title "New task" --listName "My task list" --status "notStarted"
+
+    Date: 4/3/2023
+
+    ## New task (AAMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MABGAAAAAAAw3-tXgryDSr5p162KnUPKBwDEwEFouXWWT50CfwqSN9cpAAEX8ECDAADEwEFouXWWT50CfwqSN9cpAAEX8GuPAAA=)
+
+    Property | Value
+    ---------|-------
+    importance | high
+    isReminderOn | true
+    status | notStarted
+    title | New task
+    createdDateTime | 2022-10-29T10:54:06.3672421Z
+    lastModifiedDateTime | 2022-10-29T10:54:06.5078837Z
+    hasAttachments | false
+    categories | []
+    id | AAMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MABGAAAAAAAw3-tXgryDSr5p162KnUPKBwDEwEFouXWWT50CfwqSN9cpAAEX8ECDAADEwEFouXWWT50CfwqSN9cpAAEX8GuPAAA=
+    body | {"content": "I should not forget this","contentType": "text"}
+    dueDateTime | {"dateTime": "2023-01-01T00:00:00.0000000","timeZone": "UTC"}
+    reminderDateTime |  {"dateTime": "2023-01-01T12:00:00.0000000","timeZone": "UTC"}
+    ```