New-MgmtGraphTeam

MgmtGraph: Provisions a new Microsoft Team

Script

#Requires -Version 5.1
#Requires -Modules Microsoft.Graph.Teams

[CmdletBinding()]
Param (
    [Parameter(Mandatory = $true)]
    [string]$DisplayName,

    [Parameter(Mandatory = $true)]
    [string]$TeamOwner,

    [string]$Description,

    [ValidateSet('Public', 'Private')]
    [string]$Visibility = 'Public'
)

Process {
    try {
        $params = @{
            'DisplayName' = $DisplayName
            'Visibility'  = $Visibility
            'Confirm'     = $false
            'ErrorAction' = 'Stop'
            'AdditionalProperties' = @{
                "template@odata.bind" = "https://graph.microsoft.com/v1.0/teamsTemplates('standard')"
            }
            'Members' = @(
                @{
                    "@odata.type" = "#microsoft.graph.aadUserConversationMember"
                    Roles         = @("owner")
                    "User@odata.bind" = "https://graph.microsoft.com/v1.0/users('$($TeamOwner)')"
                }
            )
        }

        if ($Description) { $params.Add('Description', $Description) }

        $team = New-MgTeam @params
        
        $result = [PSCustomObject]@{
            DisplayName = $DisplayName
            Id          = $team.Id
            Visibility  = $Visibility
            Status      = "TeamCreated"
            Timestamp   = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
        }

        Write-Output $result
    }
    catch {
        throw
    }
}

Customize

DisplayName string

Specifies the display name for the new Team.

TeamOwner string

Specifies the UserPrincipalName or ID of the user who will be the initial owner of the Team.

Description string

Optional. Specifies a description for the Team.

Visibility string

Specifies the visibility level of the Team. Valid values: Public, Private.