Use PowerShell to create a Microsoft Teams Channel

by Carlos Mendible on 14 Nov 2017 » DevOps

For those of you who have been trying to automate anything related to Microsoft Teams, let me tell you that there is a new PowerShell Module in town: Microsoft Teams 0.9.0 which you can install with the following command:

    Install-Module MicrosoftTeams

Now to automate the channel creation In A Team you can simply:

1. Create a file createTeamChannel.ps1 with the following contents:

        [Parameter(Mandatory = $true)][string]$username,
        [Parameter(Mandatory = $true)][securestring]$password,
        [Parameter(Mandatory = $true)][string]$tenantId,
        [Parameter(Mandatory = $true)][string]$teamName,
        [Parameter(Mandatory = $true)][string]$channelName)

    # Create PSCredential
    $credential = New-Object System.Management.Automation.PSCredential($username, $password)

    # Connect to Microsoft Teams
    Connect-MicrosoftTeams -TenantId $tenantId -Credential $credential

    # Get the Team
    $team = Get-Team | Where-Object { $_.DisplayName -eq $teamName}

    if ($team) {
        # Create the new Team Channel
        New-TeamChannel -GroupId $team.GroupId -DisplayName $channelName -Description $channelName
    else {
        throw "Team: $teamName does not exist."

2. Run the following command in PowerShell

    $password = ConvertTo-SecureString "YOUR PASSWORD" -AsPlainText -Force
    .\createTeamChannel.ps1 [email protected] $password $tenantId MonitoringIssues Incident101

Hope it helps!