New-Team

This cmdlet lets you provision a new Team for use in Microsoft Teams and will create an O365 Unified Group to back the team. Groups created through teams cmdlets, APIs, or clients will not show up in Outlook by default. If you want these groups to appear in Outlook clients, you can use the Set-UnifiedGroup (https://docs.microsoft.com/en-us/powershell/module/exchange/users-and-groups/set-unifiedgroup?view=exchange-ps) cmdlet in the Exchange Powershell Module to set the parameter HiddenFromExchangeClients to $false.

Note: The Teams application may need to be open by an Owner for up to two hours before changes are reflected. Note: This cmdlet is currently in Beta and functionality may change.

Syntax

New-Team
   [-Group <String>]
   [-DisplayName <String>]
   [-Description <String>]
   [-Alias <String>]
   [-Owner <String>]
   [-Classification <String>]
   [-AccessType <String>]
   [-AddCreatorAsMember <Boolean>]
   [-Template <String>]
   [<CommonParameters>]

Description

Creates a new team with user specified settings, and returns a Group object with a GroupID property.

Examples

Example 1

New-Team -DisplayName "Tech Reads"

Example 2

New-Team -DisplayName "Tech Reads" -Description "Team to post technical articles and blogs" -AccessType Public

Example 3

Connect-MicrosoftTeams -AccountId myaccount@example.com
$group = New-Team -alias "TestTeam" -displayname "Test Teams" -AccessType "private"
Add-TeamUser -GroupId $group.GroupId -User "fred@example.com"
Add-TeamUser -GroupId $group.GroupId -User "john@example.com"
Add-TeamUser -GroupId $group.GroupId -User "wilma@example.com"
New-TeamChannel -GroupId $group.GroupId -DisplayName "Q4 planning"
New-TeamChannel -GroupId $group.GroupId -DisplayName "Exec status"
New-TeamChannel -GroupId $group.GroupId -DisplayName "Contracts"
Set-TeamFunSettings -GroupId $group.GroupId -AllowCustomMemes true

Optional Parameters

-AccessType

Team visibility. Valid values are "Private" and "Public". Default is "Private". (In Set-Team this parameter is called Visibility.)

Type:String
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-AddCreatorAsMember

This setting has been deprecated as of 0.9.6 release

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Alias

The Alias parameter specifies the alias for the associated Office 365 Group. This value will be used for the mail enabled object and will be used as PrimarySmtpAddress for this Office 365 Group. The value of the Alias parameter has to be unique across your tenant.

For more details about the naming conventions see here: New-UnifiedGroup, Parameter: -Alias.

Type:String
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-Classification

Team classification

Type:String
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-Description

Team description. Team Description Characters Limit - 1024.

Type:String
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-DisplayName

Team display name. Team Name Characters Limit - 256.

Type:String
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-Group

Use this parameter to specify the GroupId of a group you would like to convert to a team. If you are using this parameter, do not specify other parameters.

Type:String
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-Owner

An admin who is allowed to create on behalf of another user should use this flag to specify the desired owner of the group. This user will be added as both a member and an owner of the group. If not specified, the user who creates the team will be added as both a member and an owner.

Type:String
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-Template

If you have an EDU license, you can use this parameter to specify which template you'd like to use for creating your group. Do not use this parameter when converting an existing group.

Valid values are: "EDU_Class" or "EDU_PLC"

Type:String
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False

Outputs

GroupId