Getting Started With Teams PowerShell

Introduction 

 
In this article, we will see how to install and set up Microsoft Teams PowerShell for Windows.
 
 
Teams PowerShell is a collection of cmdlets designed to interact with Team elements and elements from PowerShell. We can interact with Microsoft Teams objects like – channels, users, etc. via dedicated and simple PowerShell cmdlets. A few use cases where it can be used are,
  • Bulk update of users in Teams
  • Automate creation of Teams and Channels
  • Monitor activities in Teams

System Assumptions

 
This article assumes that the user is using Windows and Windows PowerShell or PowerShell ISE.
 
Version Releases
 
There are two releases of PowerShell modules:
  • General Availability
  • Public Preview
As per Microsoft recommendations, it is advisable to use either of them and not both.
 

Installation

 
Please follow the below steps to install Teams PowerShell
 

Install Windows Powershell ISE

 
Windows 10 and above have PowerShell ISE already installed in them. If it is not present in the system, it can be installed from here. Also, it is necessary to install PowerShell 5.1 or higher.
 

Install NuGet Package Manager

 
Nuget is a package manager that needs to be installed before moving to the next steps. It can be installed via the below code.
 
Install-PackageProvider -Name NuGet -Force
 
 

Install PowerShellGet

 
PowerShellGet is a module installer which is necessary for installing the Teams PowerShell module. It can be installed via the below command.
 
Install-Module -Name PowerShellGet -Force
 
 

Install Teams Powershell

 
Finally, we can install Teams PowerShell via this command below.
 
Install-Module MicrosoftTeams
 
In the first run, users will be warned about installing modules from an untrusted repository (as shown in the screenshot below). Continue with “yes to all” to finish the installation.
 
 
To check if TeamsPowershell in installed in your system, use the below command,
 
Get-Module -ListAvailable -Name MicrosoftTeams
 
 
To update Teams Powershell, please use the below command
 
Update-Module MicrosoftTeams
 
 
 
This concludes the steps for installing Teams PowerShell.
 

Usage and Next Steps

 
Now, we will establish a connection with our Teams (of Azure tenant) and test it out. For connecting to Teams, type the command:
 
Connect-MicrosoftTeams.
 
You will be prompted to enter a username and password.
 
 
Upon successful authentication, the account and tenant details will be displayed on the screen. This indicates that the connection to Microsoft Teams was successful and we can proceed further.
 
 
To get the list of available commands, you can use this cmdlet:
 
Get-Command -Module MicrosoftTeams
 
As of today, there are 24 cmdlets and 6 functions in TeamsPowershell
 
 
To disconnect from the Teams instance, use the command below,
Disconnect-MicrosoftTeams
 
The list of available commands is attached in this article. This article can also be found in my personal blog - CollabLogic. Happy exploring!!
 
References
  • https://docs.microsoft.com/en-us/microsoftteams/teams-powershell-overview
  • https://docs.microsoft.com/en-us/microsoftteams/teams-powershell-install
  • https://docs.microsoft.com/en-us/powershell/scripting/gallery/installing-psget?view=powershell-7
  • https://docs.microsoft.com/en-us/powershell/teams/?view=teams-ps