New-MSTTeamByGroupId

Teams: Creates a new Team from existing O365 Unified Group

Script

#Requires -Version 5.1

[CmdletBinding()]
Param(
    [Parameter(Mandatory = $true)]
    [string]$GroupId,
    [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
)

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

        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))
            }
        }

        $result = New-Team @cmdArgs | Select-Object $Properties

        if ($null -eq $result) {
            Write-Output "Failed to create team from group"
            return
        }
        $result | Add-Member -NotePropertyName Timestamp -NotePropertyValue (Get-Date -Format 'yyyy-MM-dd HH:mm:ss') -PassThru -Force
    }
    catch { throw }
}

Customize

GroupId string

Specify a GroupId to convert to a Team

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 team