Install Microsoft Teams PowerShell Module
This article explains how to install the Microsoft Teams PowerShell module using PowerShell Gallery. The Microsoft Teams PowerShell module is supported on all Windows platforms. Mac and Linux are not supported.
Microsoft Teams PowerShell module requires PowerShell 5.1 or higher on all platforms. Install the latest version of PowerShell available for your operating system.
To check your PowerShell version, run the following command from within a PowerShell session:
We recommend that you use the Install-Module cmdlet to install the Microsoft Teams PowerShell module.
If PowerShell Gallery (PSGallery) isn't configured as a trusted repository for PowerShellGet, the first time you use the PSGallery you'll see the following message:
Untrusted repository You are installing the modules from an untrusted repository. If you trust this repository, change its InstallationPolicy value by running the `Set-PSRepository` cmdlet. Are you sure you want to install the modules from 'PSGallery'? [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "N"):
Answer Yes or Yes to All to continue with the installation.
Installing using the PowerShellGallery
Microsoft Teams PowerShell module is currently supported for use with PowerShell 5.1 on Windows. Follow these steps to install the module:
Update to Windows PowerShell 5.1. If you're on Windows 10 version 1607 or higher, you already have PowerShell 5.1 installed.
Install .NET Framework 4.7.2 or later.
Run the following command to install the latest PowerShellGet:
Install-Module -Name PowerShellGet -Force -AllowClobber
Install the Teams PowerShell Module.
Install-Module -Name MicrosoftTeams -Force -AllowClobber
In some environments, it's not possible to connect to the PowerShell Gallery. In those situations, please follow these manual installation steps.
To start working with Microsoft Teams PowerShell module, sign in with your Azure credentials.
Update Teams PowerShell Module
To update any PowerShell module, you should use the same method used to install the module. For example, if you originally used Install-Module, then you should use Update-Module to get the latest version.
If Teams PowerShell has already been imported into your PowerShell session, updating the module will fail. Close PowerShell and re-open a new elevated PowerShell session.
Uninstall Teams PowerShell
To uninstall Microsoft Teams PowerShell, open a new PowerShell command prompt and run the following:
Uninstall-Module MicrosoftTeams # Uninstall all versions of the module Uninstall-Module MicrosoftTeams -Allversions
Now you're ready to manage Microsoft Teams using Microsoft Teams PowerShell. See Managing Teams with Teams PowerShell to get started.
Managing Teams with Teams PowerShell
Teams PowerShell Release Notes
Microsoft Teams cmdlet reference
Submit and view feedback for