Commands › Microsoft Teams
Set-Team
This cmdlet allows you to update properties of a team, including its displayname, description, and team-specific settings.
Quick start script
# Set-Team — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-MicrosoftTeams -CertificateThumbprint $thumb -ApplicationId $appId -TenantId $tenantId
# 2. Capture the current state first — you cannot roll back what you never recorded
$before = Get-Team
$before | Format-List
# 3. Make the change
Set-Team -GroupId <String>
# 4. Verify and diff
$after = Get-Team
Compare-Object ($before | Out-String) ($after | Out-String)Syntax
Set-Team -GroupId <String> [-DisplayName <String>] [-Description <String>] [-MailNickName <String>]
[-Classification <String>] [-Visibility <String>] [-AllowGiphy <Boolean>] [-GiphyContentRating <String>]
[-AllowStickersAndMemes <Boolean>] [-AllowCustomMemes <Boolean>] [-AllowGuestCreateUpdateChannels <Boolean>]
[-AllowGuestDeleteChannels <Boolean>] [-AllowCreateUpdateChannels <Boolean>] [-AllowDeleteChannels <Boolean>]
[-AllowAddRemoveApps <Boolean>] [-AllowCreateUpdateRemoveTabs <Boolean>]
[-AllowCreateUpdateRemoveConnectors <Boolean>] [-AllowUserEditMessages <Boolean>]
[-AllowUserDeleteMessages <Boolean>] [-AllowOwnerDeleteMessages <Boolean>] [-AllowTeamMentions <Boolean>]
[-AllowChannelMentions <Boolean>] [-ShowInTeamsSearchAndSuggestions <Boolean>] [-AllowCreatePrivateChannels <Boolean>] [<CommonParameters>]Parameters (24)
| Parameter | Type | Required | What it controls |
|---|---|---|---|
| -AllowAddRemoveApps | Boolean | Boolean value that determines whether or not members (not only owners) are allowed to add apps to the team. | |
| -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. | |
| -AllowCreatePrivateChannels | Boolean | Determines whether private channel creation is allowed for the team. | |
| -AllowCreateUpdateChannels | Boolean | Setting that determines whether or not members (and not just owners) are allowed to create channels. | |
| -AllowCreateUpdateRemoveConnectors | Boolean | Setting that determines whether or not members (and not only owners) can manage connectors in the team. | |
| -AllowCreateUpdateRemoveTabs | Boolean | Setting that determines whether or not members (and not only owners) can manage tabs in channels. | |
| -AllowCustomMemes | Boolean | Setting that determines whether or not members can use the custom memes functionality in teams. | |
| -AllowDeleteChannels | Boolean | Setting that determines whether or not members (and not only owners) can delete channels in the team. | |
| -AllowGiphy | Boolean | Setting that determines whether or not giphy can be used in the team. | |
| -AllowGuestCreateUpdateChannels | Boolean | Setting that determines whether or not guests can create channels in the team. | |
| -AllowGuestDeleteChannels | Boolean | Setting that determines whether or not guests can delete in the team. | |
| -AllowOwnerDeleteMessages | Boolean | Setting that determines whether or not owners can delete messages that they or other members of the team have posted. | |
| -AllowStickersAndMemes | Boolean | Setting that determines whether stickers and memes usage is allowed in the team. | |
| -AllowTeamMentions | Boolean | Setting that determines whether the entire team can be @ mentioned (which means that all users will be notified) | |
| -AllowUserDeleteMessages | Boolean | Setting that determines whether or not members can delete messages that they have posted. | |
| -AllowUserEditMessages | Boolean | Setting that determines whether or not users can edit messages that they have posted. | |
| -Classification | String | This parameter is reserved for internal Microsoft use. | |
| -Description | String | Team description. Team Description Characters Limit - 1024. | |
| -DisplayName | String | Team display name. Team Name Characters Limit - 256. | |
| -GiphyContentRating | String | Setting that determines the level of sensitivity of giphy usage that is allowed in the team. Accepted values are "Strict" or "Moderate" | |
| -GroupId | String | yes | GroupId of the team |
| -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... | |
| -ShowInTeamsSearchAndSuggestions | Boolean | The parameter has been deprecated. | |
| -Visibility | String | Team visibility. Valid values are "Private" and "Public" |
Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.