npm - @pnp/cli-microsoft365 - Versions diffs - 5.1.0 → 5.2.0-beta.307d8f5 - Mend

@@ -0,0 +1,53 @@
+# teams chat get
+Get a Microsoft Teams chat conversation by id, participants or chat name.
+## Usage
+```sh
+m365 teams chat get [options]
+```
+## Options
+`-i, --id [id]`
+: The ID of the chat conversation. Specify either `id`, `name` or `participants`, but not multiple.
+`-n, --name [name]`
+: The display name of the chat conversation. Specify either `id`, `name` or `participants`, but not multiple.
+`-p, --participants [participants]`
+: A comma-separated list of one or more e-mail addresses. Specify either `id`, `name` or `participants`, but not multiple.
+--8<-- "docs/cmd/_global.md"
+## Remarks
+The output will not include the chat conversation members or messages. It will just retrieve the conversation details.
+When using the `participants` option, the signed-in user will automatically be included as a participant. There's no need to add it to the list manually.
+## Examples
+Get a Microsoft Teams chat conversation by id
+```sh
+m365 teams chat get --id 19:2da4c29f6d7041eca70b638b43d45437@thread.v2
+```
+Get a Microsoft Teams one on one chat conversation, finding it by participant.
+```sh
+m365 teams chat get --participants alexw@contoso.com
+```
+Get a Microsoft Teams group chat conversation, finding it by participants.
+```sh
+m365 teams chat get --participants alexw@contoso.com,meganb@contoso.com
+```
+Get a Microsoft Teams chat conversation, finding it by display name
+```sh
+m365 teams chat get --name "Just a conversation"
+```

@@ -21,4 +21,4 @@ Get guest settings for a Microsoft Teams team
 ```sh
 m365 teams guestsettings list --teamId 2609af39-7775-4f94-a3dc-0dd67657e900
-```
+```

@@ -33,4 +33,4 @@ Disallow guests to delete channels
 ```sh
 m365 teams guestsettings set --teamId '00000000-0000-0000-0000-000000000000' --allowDeleteChannels false
-```
+```

@@ -21,4 +21,4 @@ Get member settings for a Microsoft Teams team
 ```sh
 m365 teams membersettings list --teamId 2609af39-7775-4f94-a3dc-0dd67657e900
-```
+```

@@ -42,4 +42,4 @@ Disallow members to add and remove apps
 ```sh
 m365 teams membersettings set --teamId '00000000-0000-0000-0000-000000000000' --allowAddRemoveApps false
-```
+```

@@ -31,4 +31,4 @@ Retrieve the specified message from a channel of the Microsoft Teams team
 ```sh
 m365 teams message get --teamId 5f5d7b71-1161-44d8-bcc1-3da710eb4171 --channelId 19:88f7e66a8dfe42be92db19505ae912a8@thread.skype --messageId 1540747442203
-```
+```

@@ -31,4 +31,4 @@ Retrieve the replies from a specified message from a channel of the Microsoft Te
 ```sh
 m365 teams message reply list --teamId 5f5d7b71-1161-44d8-bcc1-3da710eb4171 --channelId 19:88f7e66a8dfe42be92db19505ae912a8@thread.skype --messageId 1540747442203
-```
+```

@@ -21,4 +21,4 @@ Get messaging settings for a Microsoft Teams team
 ```sh
 m365 teams messagingsettings list --teamId 2609af39-7775-4f94-a3dc-0dd67657e900
-```
+```

@@ -42,4 +42,4 @@ Disallow users to delete messages in channels
 ```sh
 m365 teams messagingsettings set --teamId '00000000-0000-0000-0000-000000000000' --allowUserDeleteMessages false
-```
+```

@@ -46,4 +46,4 @@ m365 teams report pstncalls --fromDateTime 2020-10-31 --toDateTime 2020-12-31 --
 ## More information
-- List PSTN calls: [https://docs.microsoft.com/en-us/graph/api/callrecords-callrecord-getpstncalls?view=graph-rest-1.0](https://docs.microsoft.com/en-us/graph/api/callrecords-callrecord-getpstncalls?view=graph-rest-1.0)
+- List PSTN calls: [https://docs.microsoft.com/en-us/graph/api/callrecords-callrecord-getpstncalls?view=graph-rest-1.0](https://docs.microsoft.com/en-us/graph/api/callrecords-callrecord-getpstncalls?view=graph-rest-1.0)

@@ -36,4 +36,4 @@ Include all the values from the tab configuration and associated teams app
 ```sh
 m365 teams tab list --teamId 00000000-0000-0000-0000-000000000000 --channelId 19:00000000000000000000000000000000@thread.skype --output json
-```
+```

@@ -36,4 +36,4 @@ Archive the specified Microsoft Teams team and set permissions for team members
 ```sh
 m365 teams team archive --teamId 6f6fd3f7-9ba5-4488-bbe6-a789004d0d55 --shouldSetSpoSiteReadOnlyForMembers
-```
+```

@@ -48,4 +48,4 @@ Creates a clone of a Microsoft Teams team with mandatory and optional parameters
 ```sh
 m365 teams team clone --teamId 15d7a78e-fd77-4599-97a5-dbb6372846c5 --displayName "Library Assist" --partsToClone "apps,tabs,settings,channels,members" --description "Self help community for library" --classification "Library" --visibility "public"
-```
+```

@@ -30,4 +30,4 @@ Get information about Microsoft Teams team with name _Team Name_
 ```sh
 m365 teams team get --name "Team Name"
-```
+```

@@ -31,4 +31,4 @@ List all Microsoft Teams in the tenant you are a member of
 ```sh
 m365 teams team list --joined
-```
+```

@@ -38,4 +38,4 @@ m365 teams team remove --teamId '00000000-0000-0000-0000-000000000000' --confirm
 ## More information
-- directory resource type (deleted items): [https://docs.microsoft.com/en-us/graph/api/resources/directory?view=graph-rest-1.0](https://docs.microsoft.com/en-us/graph/api/resources/directory?view=graph-rest-1.0)
+- directory resource type (deleted items): [https://docs.microsoft.com/en-us/graph/api/resources/directory?view=graph-rest-1.0](https://docs.microsoft.com/en-us/graph/api/resources/directory?view=graph-rest-1.0)

@@ -42,4 +42,4 @@ Set Microsoft Teams team classification as MBI
 ```sh
 m365 teams team set --teamId '00000000-0000-0000-0000-000000000000' --classification MBI
-```
+```

@@ -27,4 +27,4 @@ Restore an archived Microsoft Teams team
 ```sh
 m365 teams team unarchive --teamId 6f6fd3f7-9ba5-4488-bbe6-a789004d0d55
-```
+```

@@ -30,4 +30,4 @@ List tasks from Microsoft To Do tasks list with the id AQMkAGYzNjMxYTU4LTJjZjYtN
 ```sh
 m365 todo task list --listId "AQMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MAAuAAADMN-7V4K8g0q_adetip1DygEAxMBBaLl1lk_dAn8KkjfXKQABF-BAgwAAAA=="
-```
+```

@@ -39,4 +39,4 @@ Update a task with status from _notStarted_ to _inProgress_ in Microsoft To Do t
 ```sh
 m365 todo task set --id "AAMkADU3Y2E0OTMxLTllYTQtNGFlZS1hZGM0LWI1NjZjY2FhM2RhMABGAAAAAADhr7P77n9xS6PdtDemRwpHBwCin1tvQMXzRKN1hQDz2S3VAAAXXsleAACin1tvQMXzRKN1hQDz2S3VAAAXXzr9AAA=" --status "inProgress" --listName "My task list"
-```
+```

@pnp/cli-microsoft365 5.1.0 → 5.2.0-beta.307d8f5