New-TeamChannel

Add a new channel to a team.

Syntax

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

Description

Important

Modules in the PS INT gallery for Microsoft Teams run on the /beta version in Microsoft Graph and are subject to change. Int modules can be install from here https://www.poshtestgallery.com/packages/MicrosoftTeams.

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
Accept pipeline input:True (ByPropertyName)
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
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-GroupId

GroupId of the team

Type:String
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-MembershipType (available in private preview)

Channel membership type, Standard or Private.

Type:String
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-Owner (available in private preview)

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

Type:String
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False

Inputs

GroupId, DisplayName, Description, MembershipType, Owner

Outputs

Id