New-MgTeamChannel

What is New-MgTeamChannel?

New-MgTeamChannel is a Microsoft Graph PowerShell cmdlet used to create new channels within a Microsoft Teams team. Channels allow members to collaborate, share files, and communicate in a focused space, either as standard, private, or shared channels.

Why Use New-MgTeamChannel?

This cmdlet helps administrators and advanced users automate the creation of channels across multiple Teams. Instead of manually creating channels one by one, you can script channel creation at scale, enforce naming conventions, set default favorites, and manage collaboration spaces programmatically.

Prerequisites

Before using this cmdlet, ensure that:

Connect-MgGraph -Scopes "Channel.Create"

You must have the appropriate permissions to create channels in Microsoft Teams.

How to Use New-MgTeamChannel?

The cmdlet requires a TeamId to specify the team where the channel will be created. You can also define the channel’s DisplayName, Description, and MembershipType (standard or private).

New-MgTeamChannel -TeamId <String> [-MembershipType <String>] [-Description <String>] [-DisplayName <String>]

New-MgTeamChannel Examples

• Example 1: Create a Standard Channel

$params = @{
    displayName = "Architecture Discussion"
    description = "This channel is where we debate all future architecture plans"
    membershipType = "standard"
}
New-MgTeamChannel -TeamId $teamId -BodyParameter $params
                                            

Creates a standard channel named Architecture Discussion.

• Example 2: Create a Private Channel

$params = @{
    membershipType = "private"
    displayName = "My First Private Channel"
    description = "This is my first private channel"
}
New-MgTeamChannel -TeamId $teamId -BodyParameter $params
                                            

Creates a private channel for selected members of the team.

• Example 3: Create a Standard Channel and Mark as Favorite

$params = @{
    displayName = "Architecture Discussion"
    description = "This channel is where we debate all future architecture plans"
    membershipType = "standard"
    IsFavoriteByDefault = $true
}
New-MgTeamChannel -TeamId $teamId -BodyParameter $params
                                            

Creates a standard channel and makes it a favorite for members by default.