Skip to content

teams channel get

Gets information about the specific Microsoft Teams team channel

Usage

m365 teams channel get [options]

Options

--teamId [teamId]
The ID of the team to which the channel belongs to. Specify either teamId or teamName but not both.
--teamName [teamName]
The display name of the team to which the channel belongs to. Specify either teamId or teamName but not both.
-i, --id [id]
The ID of the channel for which to retrieve more information. Specify either id or name but not both.
--name [name]
The display name of the channel for which to retrieve more information. Specify either id or name but not both.
--primary
Gets the default channel, General, of a team. If specified, id or name are not needed.
-h, --help [help]
Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are options, examples, remarks, response, full. Default is full.
--query [query]
JMESPath query string. See http://jmespath.org/ for more information and examples
-o, --output [output]
Output type. json,text,csv,md. Default json
--verbose
Runs command with verbose logging
--debug
Runs command with debug logging

Examples

Get information about Microsoft Teams team channel with id 19:493665404ebd4a18adb8a980a31b4986@thread.skype

m365 teams channel get --teamId 00000000-0000-0000-0000-000000000000 --id '19:493665404ebd4a18adb8a980a31b4986@thread.skype'

Get information about Microsoft Teams team channel with name Channel Name

m365 teams channel get --teamName "Team Name" --name "Channel Name"

Get information about Microsoft Teams team primary channel , i.e. General

m365 teams channel get --teamName "Team Name" --primary

Response

{
  "id": "19:493665404ebd4a18adb8a980a31b4986@thread.tacv2",
  "createdDateTime": "2022-10-26T15:43:31.954Z",
  "displayName": "Channel Name",
  "description": "This team is about Contoso",
  "isFavoriteByDefault": null,
  "email": "TeamName@contoso.onmicrosoft.com",
  "tenantId": "446355e4-e7e3-43d5-82f8-d7ad8272d55b",
  "webUrl": "https://teams.microsoft.com/l/channel/19%3A493665404ebd4a18adb8a980a31b4986%40thread.tacv2/ChannelName?groupId=aee5a2c9-b1df-45ac-9964-c708e760a045&tenantId=446355e4-e7e3-43d5-82f8-d7ad8272d55b&allowXTenantAccess=False",
  "membershipType": "standard"
}

createdDateTime    : 2022-10-26T15:43:31.954Z
description        : This team is about the Contoso
displayName        : Channel Name
email              : TeamName@contoso.onmicrosoft.com
id                 : 19:493665404ebd4a18adb8a980a31b4986@thread.tacv2
isFavoriteByDefault: null
membershipType     : standard
tenantId           : 446355e4-e7e3-43d5-82f8-d7ad8272d55b
webUrl             : https://teams.microsoft.com/l/channel/19%3A493665404ebd4a18adb8a980a31b4986%40thread.tacv2/ChannelName?groupId=aee5a2c9-b1df-45ac-9964-c708e760a045&tenantId=446355e4-e7e3-43d5-82f8-d7ad8272d55b&allowXTenantAccess=False

id,createdDateTime,displayName,description,isFavoriteByDefault,email,tenantId,webUrl,membershipType
19:493665404ebd4a18adb8a980a31b4986@thread.tacv2,2022-10-26T15:43:31.954Z,Channel Name,This team is about Contoso,,TeamName@contoso.onmicrosoft.com,446355e4-e7e3-43d5-82f8-d7ad8272d55b,https://teams.microsoft.com/l/channel/19%3A493665404ebd4a18adb8a980a31b4986%40thread.tacv2/ChannelName?groupId=aee5a2c9-b1df-45ac-9964-c708e760a045&tenantId=446355e4-e7e3-43d5-82f8-d7ad8272d55b&allowXTenantAccess=False,standard