Hello everyone, this is the first of many articles I hope to post about managing Microsoft 365 using PowerShell. In this first article, I want to show you how to perform basic administration tasks in Microsoft Teams using PowerShell.
Important:
- You must use your Teams administrator account to perform these steps.
PowerShell Workaround
First, you need to make sure the MicrosoftTeams module is installed on your computer and then imported into your Powershell session. To do that, you should use the following commands.
1 2 3 4 | Install-Module -Name MicrosoftTeams Import-Module -Name MicrosoftTeams |
Once you have imported the module, you are ready to start.
Connect to Microsoft Teams
The easiest way to get started is to log in interactively at the command line.
1 2 3 | Connect-MicrosoftTeams |
Creates a new Team
The New-Team cmdlet creates a new team to use in Microsoft Teams and will provide a unified O365 group to support the team.
1 2 3 4 5 | New-Team -DisplayName "My Demo Team" ` -Description "Internal Collaboration place for the Demo Team" ` -Visibility Private |
You can create teams as public, private, or org-wide. For public teams, Anyone using Teams in your organization can join. For private teams, team owners manage team membership. And for an org-wide team, all members of your organization are automatically added.
Get existing Teams
To retrieve all teams in the organization, you should use the Get-Team cmdlet. You can use the following parameters to retrieve teams with particular properties.
1 2 3 4 5 6 7 8 | Get-Team -GroupId <String> ` -User <String> ` -Archived <Boolean> ` -Visibility <String> ` -DisplayName <String> ` -MailNickName <String> |
Update Team properties
If you want to update the properties of a team, you should use the Set-Team cmdlet with the following syntax.
1 2 3 4 5 6 7 8 9 10 11 12 | $team = Get-Team -DisplayName "My Demo Team" Set-Team -GroupId $team.GroupId` -AllowChannelMentions $false ` -AllowCreateUpdateChannels $false ` -AllowUserDeleteMessages $false ` -AllowUserEditMessages $false ` -AllowAddRemoveApps $false ` -AllowGiphy $false ` -AllowStickersAndMemes $false |
Create a new channel for a Team
Once the Team is deployed, you can create a channel for that team; To do this, you should use the New-TeamChannel cmdlet with the following syntax.
1 2 3 4 5 | New-TeamChannel -DisplayName "MyChannel” ` -GroupId $team.GroupId ` -MembershipType Private |
Update Team channel settings
If you want to update the properties of a channel, you should use the Set-TeamChannel cmdlet with the following syntax.
1 2 3 4 5 6 | Set-TeamChannel -GroupId $team.GroupId ` -CurrentDisplayName "MyChannel" ` -NewDisplayName "MyNewChannel" ` -Description "Use this channel to share project material." |
To obtain the information about a team channel, you should use the Get-TeamChannel cmdlet.
1 2 3 4 | Get-TeamChannel -GroupId $team.GroupId |
Delete a Team channel
Deleting a channel in teams using PowerShell should be done using the Remove-TeamChannel cmdlet with the following syntax.
1 2 3 | Remove-TeamChannel -GroupId $team.GroupId -DisplayName "MyNewChannel” |
Get the members of a Team
You can use the Get-TeamUser cmdlet to get the list of team members. Using the -role parameter, you can filter the owners\members of the team.
1 2 3 4 | Get-TeamUser -GroupId $team.GroupId -Role Owner Get-TeamUser -GroupId $team.GroupId -Role Member |
Add members to the Team
You can add members or owners to the team using the Add-TeamUser cmdlet with the following syntax.
1 2 3 4 5 6 7 8 | Add-TeamUser -GroupId $team.GroupId ` -User User01@jorgebernhardt.com Add-TeamUser -GroupId $team.GroupId ` -User Owner01@jorgebernhardt.com ` -Role Owner |
Remove members from a Team
If you’re a team owner, you can remove someone from your team. To do this, you should use the Remove-TeamUser cmdlet with the following syntax.
1 2 3 4 | Remove-TeamUser -GroupId $team.GroupId ` -User User01@jorgebernhardt.com |
Deletes a Team from Microsoft Team
Finally, if you want to remove the team, you should use the cmdlet with the following syntax.
1 2 3 | Remove-Team -GroupId $team.GroupId |
Thanks for reading my post. I hope you find it helpful.
If you want to learn more about the Microsoft Teams PowerShell module, check out this link.
