< Back
New-Team
Post
NAME New-Team
SYNOPSIS
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/powers ... xchange-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.
SYNTAX
New-Team [-MailNickName <String>] [-Classification <String>] [-Description <String>] -DisplayName <String>
[-Template <String>] [-Owner <String>] [-AllowAddRemoveApps <Boolean>] [-AllowChannelMentions <Boolean>]
[-AllowCreateUpdateChannels <Boolean>] [-AllowCreateUpdateRemoveConnectors <Boolean>]
[-AllowCreateUpdateRemoveTabs <Boolean>] [-AllowCustomMemes <Boolean>] [-AllowDeleteChannels <Boolean>]
[-AllowGiphy <Boolean>] [-AllowGuestCreateUpdateChannels <Boolean>] [-AllowGuestDeleteChannels <Boolean>]
[-AllowOwnerDeleteMessages <Boolean>] [-AllowStickersAndMemes <Boolean>] [-AllowTeamMentions <Boolean>]
[-AllowUserDeleteMessages <Boolean>] [-AllowUserEditMessages <Boolean>] [-GiphyContentRating <String>]
[-Visibility <String>] [-ShowInTeamsSearchAndSuggestions <Boolean>] [<CommonParameters>]
New-Team [-Owner <String>] [-AllowAddRemoveApps <Boolean>] [-AllowChannelMentions <Boolean>]
[-AllowCreateUpdateChannels <Boolean>] [-AllowCreateUpdateRemoveConnectors <Boolean>]
[-AllowCreateUpdateRemoveTabs <Boolean>] [-AllowCustomMemes <Boolean>] [-AllowDeleteChannels <Boolean>]
[-AllowGiphy <Boolean>] [-AllowGuestCreateUpdateChannels <Boolean>] [-AllowGuestDeleteChannels <Boolean>]
[-AllowOwnerDeleteMessages <Boolean>] [-AllowStickersAndMemes <Boolean>] [-AllowTeamMentions <Boolean>]
[-AllowUserDeleteMessages <Boolean>] [-AllowUserEditMessages <Boolean>] [-GiphyContentRating <String>] -GroupId
<String> [-ShowInTeamsSearchAndSuggestions <Boolean>] [<CommonParameters>]
DESCRIPTION
Creates a new team with user specified settings, and returns a Group object with a GroupID property. Note that
Templates are not yet supported in our 1.0 PowerShell release.
PARAMETERS
-MailNickName <String>
The MailNickName 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
MailNickName parameter has to be unique across your tenant.
For more details about the naming conventions see here: New-UnifiedGroup, Parameter: -Alias (https://docs.micro
soft.com/en-us/powershell/module/exchange/users-and-groups/new-unifiedgroup?view=exchange-ps#optional-parameter
s).
Required? false
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-Classification <String>
This parameter is reserved for internal Microsoft use.
Required? false
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-Description <String>
Team description. Team Description Characters Limit - 1024.
Required? false
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-DisplayName <String>
Team display name. Team Name Characters Limit - 256.
Required? true
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-Template <String>
Note: this parameter is not supported in our 1.0 PowerShell release, only in Preview.
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"
Required? false
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-Owner <String>
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.
Required? false
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-AllowAddRemoveApps <Boolean>
Boolean value that determines whether or not members (not only owners) are allowed to add apps to the team.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-AllowChannelMentions <Boolean>
Boolean value that determines whether or not channels in the team can be @ mentioned so that all users who
follow the channel are notified.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-AllowCreateUpdateChannels <Boolean>
Setting that determines whether or not members (and not just owners) are allowed to create channels.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-AllowCreateUpdateRemoveConnectors <Boolean>
Setting that determines whether or not members (and not only owners) can manage connectors in the team.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-AllowCreateUpdateRemoveTabs <Boolean>
Setting that determines whether or not members (and not only owners) can manage tabs in channels.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-AllowCustomMemes <Boolean>
Setting that determines whether or not members can use the custom memes functionality in teams.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-AllowDeleteChannels <Boolean>
Setting that determines whether or not members (and not only owners) can delete channels in the team.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-AllowGiphy <Boolean>
Setting that determines whether or not giphy can be used in the team.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-AllowGuestCreateUpdateChannels <Boolean>
Setting that determines whether or not guests can create channels in the team.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-AllowGuestDeleteChannels <Boolean>
Setting that determines whether or not guests can delete in the team.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-AllowOwnerDeleteMessages <Boolean>
Setting that determines whether or not owners can delete messages that they or other members of the team have
posted.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-AllowStickersAndMemes <Boolean>
Setting that determines whether stickers and memes usage is allowed in the team.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-AllowTeamMentions <Boolean>
Setting that determines whether the entire team can be @ mentioned (which means that all users will be
notified)
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-AllowUserDeleteMessages <Boolean>
Setting that determines whether or not members can delete messages that they have posted.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-AllowUserEditMessages <Boolean>
Setting that determines whether or not users can edit messages that they have posted.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-GiphyContentRating <String>
Setting that determines the level of sensitivity of giphy usage that is allowed in the team. Accepted values
are "Strict" or "Moderate"
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-GroupId <String>
Specify a GroupId to convert to a Team. If specified, you cannot provide the other values that are already
specified by the existing group, namely: Visibility, Alias, Description, or DisplayName.
Required? true
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-Visibility <String>
Set to Public to allow all users in your organization to join the group by default. Set to Private to require
that an owner approve the join request.
Required? false
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-ShowInTeamsSearchAndSuggestions <Boolean>
Setting that determines whether or not private teams should be searchable from Teams clients for users who do
not belong to that team. Set to $false to make those teams not discoverable from Teams clients.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
GroupId
NOTES
-------------------------- Example 1 --------------------------
New-Team -DisplayName "Tech Reads"
-------------------------- Example 2 --------------------------
New-Team -DisplayName "Tech Reads" -Description "Team to post technical articles and blogs" -Visibility Public
-------------------------- Example 3 --------------------------
Connect-MicrosoftTeams -AccountId myaccount@example.com
$group = New-Team -MailNickname "TestTeam" -displayname "Test Teams" -Visibility "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"
RELATED LINKS
Remove-Team
Get-Team
Set-Team
SYNOPSIS
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/powers ... xchange-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.
SYNTAX
New-Team [-MailNickName <String>] [-Classification <String>] [-Description <String>] -DisplayName <String>
[-Template <String>] [-Owner <String>] [-AllowAddRemoveApps <Boolean>] [-AllowChannelMentions <Boolean>]
[-AllowCreateUpdateChannels <Boolean>] [-AllowCreateUpdateRemoveConnectors <Boolean>]
[-AllowCreateUpdateRemoveTabs <Boolean>] [-AllowCustomMemes <Boolean>] [-AllowDeleteChannels <Boolean>]
[-AllowGiphy <Boolean>] [-AllowGuestCreateUpdateChannels <Boolean>] [-AllowGuestDeleteChannels <Boolean>]
[-AllowOwnerDeleteMessages <Boolean>] [-AllowStickersAndMemes <Boolean>] [-AllowTeamMentions <Boolean>]
[-AllowUserDeleteMessages <Boolean>] [-AllowUserEditMessages <Boolean>] [-GiphyContentRating <String>]
[-Visibility <String>] [-ShowInTeamsSearchAndSuggestions <Boolean>] [<CommonParameters>]
New-Team [-Owner <String>] [-AllowAddRemoveApps <Boolean>] [-AllowChannelMentions <Boolean>]
[-AllowCreateUpdateChannels <Boolean>] [-AllowCreateUpdateRemoveConnectors <Boolean>]
[-AllowCreateUpdateRemoveTabs <Boolean>] [-AllowCustomMemes <Boolean>] [-AllowDeleteChannels <Boolean>]
[-AllowGiphy <Boolean>] [-AllowGuestCreateUpdateChannels <Boolean>] [-AllowGuestDeleteChannels <Boolean>]
[-AllowOwnerDeleteMessages <Boolean>] [-AllowStickersAndMemes <Boolean>] [-AllowTeamMentions <Boolean>]
[-AllowUserDeleteMessages <Boolean>] [-AllowUserEditMessages <Boolean>] [-GiphyContentRating <String>] -GroupId
<String> [-ShowInTeamsSearchAndSuggestions <Boolean>] [<CommonParameters>]
DESCRIPTION
Creates a new team with user specified settings, and returns a Group object with a GroupID property. Note that
Templates are not yet supported in our 1.0 PowerShell release.
PARAMETERS
-MailNickName <String>
The MailNickName 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
MailNickName parameter has to be unique across your tenant.
For more details about the naming conventions see here: New-UnifiedGroup, Parameter: -Alias (https://docs.micro
soft.com/en-us/powershell/module/exchange/users-and-groups/new-unifiedgroup?view=exchange-ps#optional-parameter
s).
Required? false
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-Classification <String>
This parameter is reserved for internal Microsoft use.
Required? false
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-Description <String>
Team description. Team Description Characters Limit - 1024.
Required? false
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-DisplayName <String>
Team display name. Team Name Characters Limit - 256.
Required? true
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-Template <String>
Note: this parameter is not supported in our 1.0 PowerShell release, only in Preview.
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"
Required? false
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-Owner <String>
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.
Required? false
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-AllowAddRemoveApps <Boolean>
Boolean value that determines whether or not members (not only owners) are allowed to add apps to the team.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-AllowChannelMentions <Boolean>
Boolean value that determines whether or not channels in the team can be @ mentioned so that all users who
follow the channel are notified.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-AllowCreateUpdateChannels <Boolean>
Setting that determines whether or not members (and not just owners) are allowed to create channels.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-AllowCreateUpdateRemoveConnectors <Boolean>
Setting that determines whether or not members (and not only owners) can manage connectors in the team.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-AllowCreateUpdateRemoveTabs <Boolean>
Setting that determines whether or not members (and not only owners) can manage tabs in channels.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-AllowCustomMemes <Boolean>
Setting that determines whether or not members can use the custom memes functionality in teams.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-AllowDeleteChannels <Boolean>
Setting that determines whether or not members (and not only owners) can delete channels in the team.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-AllowGiphy <Boolean>
Setting that determines whether or not giphy can be used in the team.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-AllowGuestCreateUpdateChannels <Boolean>
Setting that determines whether or not guests can create channels in the team.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-AllowGuestDeleteChannels <Boolean>
Setting that determines whether or not guests can delete in the team.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-AllowOwnerDeleteMessages <Boolean>
Setting that determines whether or not owners can delete messages that they or other members of the team have
posted.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-AllowStickersAndMemes <Boolean>
Setting that determines whether stickers and memes usage is allowed in the team.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-AllowTeamMentions <Boolean>
Setting that determines whether the entire team can be @ mentioned (which means that all users will be
notified)
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-AllowUserDeleteMessages <Boolean>
Setting that determines whether or not members can delete messages that they have posted.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-AllowUserEditMessages <Boolean>
Setting that determines whether or not users can edit messages that they have posted.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-GiphyContentRating <String>
Setting that determines the level of sensitivity of giphy usage that is allowed in the team. Accepted values
are "Strict" or "Moderate"
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-GroupId <String>
Specify a GroupId to convert to a Team. If specified, you cannot provide the other values that are already
specified by the existing group, namely: Visibility, Alias, Description, or DisplayName.
Required? true
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-Visibility <String>
Set to Public to allow all users in your organization to join the group by default. Set to Private to require
that an owner approve the join request.
Required? false
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-ShowInTeamsSearchAndSuggestions <Boolean>
Setting that determines whether or not private teams should be searchable from Teams clients for users who do
not belong to that team. Set to $false to make those teams not discoverable from Teams clients.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
GroupId
NOTES
-------------------------- Example 1 --------------------------
New-Team -DisplayName "Tech Reads"
-------------------------- Example 2 --------------------------
New-Team -DisplayName "Tech Reads" -Description "Team to post technical articles and blogs" -Visibility Public
-------------------------- Example 3 --------------------------
Connect-MicrosoftTeams -AccountId myaccount@example.com
$group = New-Team -MailNickname "TestTeam" -displayname "Test Teams" -Visibility "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"
RELATED LINKS
Remove-Team
Get-Team
Set-Team