Skip to content

teams chat get

Get a Microsoft Teams chat conversation by id, participants or chat name.

Usage

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.
-h, --help
output usage information
--query [query]
JMESPath query string. See http://jmespath.org/ for more information and examples
-o, --output [output]
Output type. json,text,csv. Default json
--verbose
Runs command with verbose logging
--debug
Runs command with debug logging

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

m365 teams chat get --id 19:2da4c29f6d7041eca70b638b43d45437@thread.v2

Get a Microsoft Teams one on one chat conversation, finding it by participant.

m365 teams chat get --participants alexw@contoso.com

Get a Microsoft Teams group chat conversation, finding it by participants.

m365 teams chat get --participants alexw@contoso.com,meganb@contoso.com

Get a Microsoft Teams chat conversation, finding it by display name

m365 teams chat get --name "Just a conversation"