Teams
Microsoft Teams is a collaboration service that combines multiple Microsoft 365 services into a single interface. It's a user-friendly service that users with limited training can manage. As a result, it's a useful tool for workgroups and projects. You can use the Microsoft Teams PowerShell module to perform tasks such as creating teams and managing user permissions.
Microsoft Teams combines many elements of Microsoft 365—such as Microsoft 365 groups, Exchange Online, and SharePoint storage—into a single location for collaboration. You can install the Microsoft Teams module to manage Microsoft Teams by using Windows PowerShell.
You can create and configure Microsoft Teams by using cmdlets with a noun that starts with Team, such as the following cmdlets:
- Get-Team
- Add-TeamUser
- New-TeamsApp
The Microsoft Teams module also includes many functions. These functions have the same verb-noun naming format as other cmdlets, but with a noun that starts with CsTeam. For example, the following cmdlets are included in the Microsoft Teams module:
- Set-CsTeamsMeetingPolicy
- Remove-CsTeamTemplate
- New-CsTeamsEmergencyCallingPolicy
- Get-CsTeamsMessagingPolicy
The functions in the Microsoft Teams module are for configuring of the overall service, but not individual Teams. Also included are commands that you can use to create and configure user policies, and to control and manage communications.
Installation
You can install the Microsoft Teams module from the PowerShell Gallery. To install the Microsoft Teams module, run the following command:
Install-Module -Name MicrosoftTeams
The Microsoft Teams module doesn't update automatically. To update the SharePoint Online Management Shell, run the following command:
Update-Module -Name MicrosoftTeams
You can connect to Microsoft Teams by using the Connect-MicrosoftTeams cmdlet with no additional parameters. When you connect to Microsoft Teams, you're prompted for a username and password to sign in. You might also be prompted for multifactor authentication. Be sure to sign in with a user account that has sufficient privileges to perform the actions you want to complete.
Teams
Microsoft Teams is a collaboration tool. Within a Microsoft Team, you can create multiple channels to organize data and apps. When there are multiple channels, you can restrict access to channels based on the user. You can use the Microsoft Teams PowerShell module to create, configure, and manage teams, user settings, and channels.
Creating teams
To create a new team, you use the New-Team cmdlet as depicted in the following example:
New-Team -DisplayName "Marketing Team"
When you create a new team by using PowerShell, you can't specify a template unless you're an education customer. When you create a team from within the Microsoft Teams client, you can specify a template or copy an existing team. You have the same options when creating a team by using Graph API. To get a list of available templates, use the Get-CsTeamTemplateList cmdlet. You can also create your own templates.
You can convert an existing Microsoft 365 group to a team by using the -GroupId parameter when creating a new team.
If you don't specify an owner when you create a team, then by default you become the owner of the team. If your administrative user doesn't have a Microsoft Teams license, you need to specify an owner with a Microsoft Teams license. Otherwise, the team creation fails.
Configuring teams
When you create a new team, a new Microsoft 365 group is created as part of the team. When you manage an existing team, you need to refer to the Microsoft 365 group ID as the unique identifier for the team. The group ID displays when you create the group. You can also obtain the group ID by using the Get-Team cmdlet.
You can modify team settings by using the Set-Team cmdlet. Some parameters that you can use are listed in the following table.
| Parameter | Description |
|---|---|
| -Description | Provides a description of the team (1,024 characters or less) to make it easier for users to identify the team's purpose. |
| -MailNickName | Specifies the alias for the associated Microsoft 365 group that's used when creating the PrimarySmtpAddress. |
| -Visibility | Determines whether the team is public or private. Public teams are noticeable to everyone in the team gallery, and anyone can join without team owner approval. Whereas private teams can only be joined if the team owner adds someone to them. |
| -AllowAddRemoveApps | Determines whether or not members (and not just owners) are allowed to add apps to the team. |
| -AllowCreateUpdateChannels | Determines whether or not members (and not just owners) are allowed to create channels. |
| -AllowUserEditMessages | Determines whether or not users can edit messages that they've posted. |
You can also use these same parameters when you create the team. The following example depicts how to specify the mail nickname:
Set-Team -GroupId 26be526d-201a-4af6-9918-2fdbf6306916 -MailNickName "MarketingTeam"
Managing team members
After you create a team, you can manage team members by using the Add-TeamUser and Remove-TeamUser cmdlets. You can add users as members or owners. When you use these cmdlets, you need to specify the GroupId associated with the team as in the following example:
Add-TeamUser -GroupId 26be526d-201a-4af6-9918-2fdbf6306916 -User AbbieP@adatum.com -Role Member
Creating and configuring team channels A team can have multiple channels that contain content. The following table depicts some of the cmdlets that you can use to create and manage channels.
| Cmdlet | Description |
|---|---|
| New-TeamChannel | Creates a new channel in a team. |
| Get-TeamChannel | Lists the channels in a set. |
| Set-TeamChannel | Modifies the display name or description for a channel. |
| Add-TeamChannelUser | Adds a user as a member or owner of a channel. |
| Remove-TeamChannelUser | Removes a user from a channel. |