New-MSTTeam

Teams: Creates a new Team with O365 Unified Group

Script

#Requires -Version 5.1

[CmdletBinding()]
Param(
    [Parameter(Mandatory = $true)]
    [ValidateLength(5, 256)]
    [string]$DisplayName,
    [ValidateLength(0, 1024)]
    [string]$Description,
    [ValidateSet('Public', 'Private')]
    [string]$Visibility,
    [string]$MailNickName,
    [bool]$AllowAddRemoveApps,
    [bool]$AllowChannelMentions,
    [bool]$AllowCreateUpdateChannels,
    [bool]$AllowCreateUpdateRemoveConnectors,
    [bool]$AllowCreateUpdateRemoveTabs,
    [bool]$AllowCustomMemes,
    [bool]$AllowDeleteChannels,
    [bool]$AllowGuestCreateUpdateChannels,
    [bool]$AllowGiphy,
    [bool]$AllowGuestDeleteChannels,
    [bool]$AllowOwnerDeleteMessages,
    [bool]$AllowStickersAndMemes,
    [bool]$AllowTeamMentions,
    [bool]$AllowUserDeleteMessages,
    [bool]$AllowUserEditMessages,
    [bool]$ShowInTeamsSearchAndSuggestions,
    [ValidateSet('Strict', 'Moderate')]
    [string]$GiphyContentRating,
    [string]$Owner,
    [string[]]$Users,
    [string]$Channels,
    [switch]$RetainCreatedGroup
)

Process {
    try {
        [string[]]$Properties = @('DisplayName', 'GroupId')
        [hashtable]$cmdArgs = @{'ErrorAction' = 'Stop'; 'DisplayName' = $DisplayName}

        if (-not [System.String]::IsNullOrWhiteSpace($Description)) {
            $cmdArgs.Add('Description', $Description)
            $Properties += 'Description'
        }
        if (-not [System.String]::IsNullOrWhiteSpace($MailNickName)) {
            $cmdArgs.Add('MailNickName', $MailNickName)
            $Properties += 'MailNickName'
        }
        if (-not [System.String]::IsNullOrWhiteSpace($Visibility)) {
            $cmdArgs.Add('Visibility', $Visibility)
            $Properties += 'Visibility'
        }
        if (-not [System.String]::IsNullOrWhiteSpace($GiphyContentRating)) {
            $cmdArgs.Add('GiphyContentRating', $GiphyContentRating)
            $Properties += 'GiphyContentRating'
        }
        if (-not [System.String]::IsNullOrWhiteSpace($Owner)) {
            $cmdArgs.Add('Owner', $Owner)
            $Properties += 'Owner'
        }

        $boolParams = @('AllowAddRemoveApps', 'AllowChannelMentions', 'AllowCreateUpdateChannels', 'AllowCreateUpdateRemoveConnectors', 'AllowCreateUpdateRemoveTabs', 'AllowCustomMemes', 'AllowDeleteChannels', 'AllowGuestCreateUpdateChannels', 'AllowGiphy', 'AllowGuestDeleteChannels', 'AllowOwnerDeleteMessages', 'AllowStickersAndMemes', 'AllowTeamMentions', 'AllowUserDeleteMessages', 'AllowUserEditMessages', 'ShowInTeamsSearchAndSuggestions')
        foreach ($paramName in $boolParams) {
            if ($PSBoundParameters.ContainsKey($paramName)) {
                $cmdArgs.Add($paramName, (Get-Variable -Name $paramName -ValueOnly))
            }
        }

        $cmdArgs.Add('RetainCreatedGroup', $RetainCreatedGroup)
        $team = New-Team @cmdArgs | Select-Object $Properties

        $result = @()
        $result += $team

        if (($null -ne $Users) -and ($Users.Length -gt 0)) {
            foreach ($usr in $Users) {
                try {
                    $null = Add-TeamUser -User $usr -GroupId $team.GroupId -Role Member -ErrorAction Stop
                    $result += "User $($usr) added to team $($team.DisplayName)"
                }
                catch {
                    $result += "Error adding user $($usr) to team $($team.DisplayName)"
                }
            }
        }

        if (($null -ne $Channels) -and ($Channels.Length -gt 0)) {
            foreach ($cnl in $Channels.Split(',')) {
                try {
                    $null = New-TeamChannel -GroupId $team.GroupId -DisplayName $cnl.Trim() -ErrorAction Stop
                    $result += "Channel $($cnl.Trim()) added to team $($team.DisplayName)"
                }
                catch {
                    $result += "Error adding channel $($cnl.Trim()) to team $($team.DisplayName)"
                }
            }
        }

        foreach ($item in $result) {
            if ($item -is [PSCustomObject]) {
                $item | Add-Member -NotePropertyName Timestamp -NotePropertyValue (Get-Date -Format 'yyyy-MM-dd HH:mm:ss') -PassThru -Force
            }
            else {
                [PSCustomObject]@{
                    Timestamp = Get-Date -Format 'yyyy-MM-dd HH:mm:ss'
                    Result    = $item
                }
            }
        }
    }
    catch { throw }
}

Customize

DisplayName string

Team display name

Description string

Team description

Visibility string

Set to Public or Private

MailNickName string

Alias for the associated Office 365 Group, must be unique across the tenant

AllowAddRemoveApps bool

Members can add apps to the team

AllowChannelMentions bool

Channels can be @ mentioned

AllowCreateUpdateChannels bool

Members can create channels

AllowCreateUpdateRemoveConnectors bool

Members can manage connectors

AllowCreateUpdateRemoveTabs bool

Members can manage tabs in channels

AllowCustomMemes bool

Members can use custom memes

AllowDeleteChannels bool

Members can delete channels

AllowGuestCreateUpdateChannels bool

Guests can create channels

AllowGiphy bool

Giphy can be used in the team

AllowGuestDeleteChannels bool

Guests can delete channels

AllowOwnerDeleteMessages bool

Owners can delete any messages

AllowStickersAndMemes bool

Stickers and memes usage is allowed

AllowTeamMentions bool

The entire team can be @ mentioned

AllowUserDeleteMessages bool

Members can delete their own messages

AllowUserEditMessages bool

Users can edit their messages

ShowInTeamsSearchAndSuggestions bool

Private teams are searchable from Teams clients

GiphyContentRating string

Sensitivity level of giphy usage

Owner string

Desired owner of the group

Users string

One or more User UPNs to add as members

Channels string

One or more channel display names, comma separated

RetainCreatedGroup switch

Off

Retain the group if team creation fails