New Teams client preinstallation script

Microsoft has a preinstallation check script designed to identify why devices can't be updated to the new Teams client. The script also suggests solutions to any problems it finds. Admins can save time moving to new Teams by running the script in these two use cases:

• Before you install new Teams for the first time.
• After the new Teams client installation fails on some devices.

Admins, by running this script, can proactively identify and resolve issues, making it easier to install the new Teams client across their organization.

Note

If you want to get a preinstall check status across all devices, run this script using device management software like Intune. If you want to have the preinstall script check the status for a single device, you can run it directly on the device.

Using the script

You can run the script locally on a device, in Intune, or using some other device management software.

We have sample instructions to run the script in Intune at this location: Sample instructions

After running the script:

• If run locally, the failures and suggested resolutions display in the command line for administrators to see. Administrators can fix the issues and run the new Teams client installation again.
• If the script is run in Intune or other device management software:
  • Administrators can see issues and suggested resolutions for each device.
  • Administrators can download these results as a CSV file.
  • Administrators can filter the CSV file for each error to identify all devices requiring a specific fix.
  • Administrators can fix one error at a time across all machines and rerun the new Teams installation.

A video demonstration of the script being run is located here.