Share via

Bulk deploy the Microsoft Teams client

  • Applies to: Microsoft Teams

Direct or "bulk" deployments are helpful because users don't need to manually download and install the Teams client. Microsoft provides an executable (.exe) file for the Teams client. This executable allows you to deploy the application directly to computers in your organization using your choice of software management tools, such as Intune or Configuration Manager.

The Teams installer installs the Teams MSIX package on a target computer, making sure that Teams can interoperate correctly with Office and other Microsoft software.

Note

New. An offline installer option is now available. Learn more: Download and install Teams using an offline installer

How it works

TeamsBootstrapper is a lightweight online installer with a headless command-line interface. It allows admins to provision (install) the app for all users on a given target computer.

When teamsbootstrapper.exe is run on a computer:

  • The installer downloads the latest Teams MSIX package from Microsoft
  • The installer installs the Teams application for all users on the computer, and any users who may be added afterwards.

Important

Users who installed a different Teams version have their version replaced with the provisioned version.

  • Modifies the registry to allow Teams to work with Office and other computer applications.
  • Displays success or failure message on the command line

Important

You must use the latest version of the bootstrapper.exe. If you downloaded the .exe previously, view Properties > Details > Product version on your version to confirm you have the latest version. You can compare it to the properties on the latest download.

Prerequisites for target computers

For Teams to be successfully installed, computers must meet the minimum requirements listed in Teams client system requirements.

Additional requirements:

Requirement Version/Description
Office Microsoft 365 Apps or Office LTSC 2021 Learn more: Office versions and connectivity to Microsoft 365 services
Settings Turn on the "Show Notification Banners" setting in System > Notifications > Microsoft Teams to receive Teams Notifications.
Webview2 Update to the most current version. Learn more: Enterprise management of WebView2 Runtimes
Delivery optimization (DO) DO powers Teams automatic updates. What is Delivery Optimization?

Recommended settings: Set up Delivery Optimization

Note: Download Mode 100 (Bypass) isn't supported.

Install the Teams application

All steps must be completed to successfully deploy Teams.

Important

You must run the latest version of the bootstrapper.exe to avoid any issues that may be fixed. If you downloaded the file previously, check Properties > Details > Product version to confirm you have the latest version. You can compare it to the latest download.

Option 1A: Download and install Teams for a single computer

To install Teams on a single computer with many users, follow these steps:

  1. Download the .exe installer. If you downloaded this file previously, compare the properties on each file to confirm you have the latest version.

  2. Open the Command Prompt as an Admin.

  3. At the prompt, enter: .\teamsbootstrapper.exe -p

  4. A success or fail status displays. If you receive an error, learn more at Common HRESULT values.

    command line prompt feedback

Option 1B: Download and install Teams using an offline installer

Admins can also use a local teams MSIX to provision Teams. This option minimizes the amount of bandwidth used for the initial installation. The MSIX can exist in a local path or UNC.

  1. Download the .exe installer.. If you downloaded this file previously, compare the properties on each file to confirm you have the latest version.

  2. Download the MSIX:
    - MSIX x86
    - MSIX x64
    - ARM64

  3. Open the Command Prompt as an Admin.

  4. Depending on where your MSIX is located, take the following action:

    For local path, enter: .\teamsbootstrapper.exe -p -o "c:\path\to\teams.msix"

    Example:

    local path location for offline installer

    For UNC, enter: .\teamsbootstrapper.exe -p -o "\unc\path\to\teams.msix"

    Example:

    offline location using unc

Option B: Install Teams across your organization

To deploy this installer to a group of computers, or your entire organization, follow these steps:

  1. Download the .exe installer. If you downloaded this file previously, compare the properties on each file to confirm you have the latest version.
  2. Distribute the installer to your target computers using Intune, Microsoft Endpoint Configuration Manager, Group Policy, or third-party distribution software.
  3. Run the installer on each computer.

Gov cloud deployments for PC and Mac

PC update

If the customer tenant is on the GCCH, DoD, or Gallatin, the customer may need to set the initial cloud endpoint through the following registry key. Setting the endpoint with the registry key restricts teams to connecting to the correct cloud endpoint for pre-sign-in connectivity with Teams, as shown here:

HKEY_CURRENT_USER\SOFTWARE\Policies\Microsoft\Office\16.0\Teams
Value = CloudType
value type = DWORD
  1 = Commercial, 2 = GCC, 3 = GCCH, 4 = DOD, 7 = Gallatin

Mac update

If the customer tenant is on the GCCH, DoD, or Gallatin, the customer may need to set the initial cloud endpoint through the following .plist configuration key. Setting the endpoint with the .plist configuration restricts teams to connecting to the correct cloud endpoint for pre-sign-in connectivity with Teams, as shown here:

Domain: com.microsoft.teams2
Key: CloudType
Data Type: Int
Value: {Enter number associated with the cloud}
  1 = Commercial, 2 = GCC, 3 = GCCH, 4 = DOD, 7 = Gallatin

The .plist configuration can be propagated to managed devices using Intune as described in Add preference file settings to macOS devices in Microsoft Intune.

Remove Teams for all users

For more information, see How to uninstall the Teams client.