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

--userIds [userIds]

The user's ID or principal name. You can also pass a comma-separated list of userIds.

--userDisplayNames [userDisplayNames]

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, permissions, 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.

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 --userIds "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" --userDisplayNames "Anne Matthews,John Doe" --owner

Response​

The command won't return a response on success.