New-TeamChannel

Module:

MicrosoftTeamsPowerShell

Add a new channel to a team.

Syntax

New-TeamChannel
   -GroupId <String>
   -DisplayName <String>
   [-Description <String>]
   [-MembershipType <String>]
   [-Owner <String>]
   [<CommonParameters>]

Description

Add a new channel to a team.

Examples

Example 1

New-TeamChannel -GroupId 126b90a5-e65a-4fef-98e3-d9b49f4acf12 -DisplayName "Architecture"

Create a standard channel with display name as "Architecture"

Example 2

New-TeamChannel -GroupId 126b90a5-e65a-4fef-98e3-d9b49f4acf12 -DisplayName "Engineering" -MembershipType Private

Create a private channel with display name as "Engineering"

Parameters

-Description

Channel description. Channel description can be up to 1024 characters.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DisplayName

Channel display name. Names must be 50 characters or less, and can't contain the characters # % & * { } / \ : < > ? + | ' "

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-GroupId

GroupId of the team

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-MembershipType

Channel membership type, Standard, Shared, or Private.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Owner

UPN of owner that can be specified while creating a private channel.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

Inputs

GroupId, DisplayName, Description, MembershipType, Owner

Outputs

Id