Skip to main 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 options.

--query [query]

JMESPath query string. See http://jmespath.org/ for more information and examples.

-o, --output [output]

Output type. json, text, csv, md, none. 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"
}
CTRL + M