Skip to content

teams channel member add

Adds a specified member in the specified Microsoft Teams private or shared team channel

Usage

m365 teams channel member add [options]

Options

-i, --teamId [teamId]
The ID of the team where the channel is located. Specify either teamId or teamName, but not both.
--teamName [teamName]
The name of the team where the channel is located. Specify either teamId or teamName, but not both.
-c, --channelId [channelId]
The Id of the Microsoft Teams team channel. Specify either channelId or channelName, but not both.
--channelName [channelName]
The display name of the Microsoft Teams team channel. Specify either channelId or channelName, but not both.
--userId [userId]
The user's ID or principal name. You can also pass a comma separated list of userIds.
--userDisplayName [userDisplayName]
The display name of a user. You can also pass a comma separated list of display names.
--owner
Assign the user the owner role. Defaults to member permissions.
-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. Default json
--verbose
Runs command with verbose logging
--debug
Runs command with debug logging

Remarks

At least one owner must be assigned to a private or shared channel.

You can only add members and owners of a team to a private channel.

Examples

Add members to a channel based on their id or user principal name

m365 teams channel member add --teamId 47d6625d-a540-4b59-a4ab-19b787e40593 --channelId 19:586a8b9e36c4479bbbd378e439a96df2@thread.skype --userId "85a50aa1-e5b8-48ac-b8ce-8e338033c366,john.doe@contoso.com"

Add owners to a channel based on their display names

m365 teams channel member add --teamName "Human Resources" --channelName "Private Channel" --userDisplayName "Anne Matthews,John Doe" --owner

Response

The command won't return a response on success.