Self-help diagnostics for Microsoft Teams administrators
Article
Applies to:
Teams
To keep pace with the growth in usage of Microsoft Teams, Microsoft has developed Teams-specific diagnostics that cover top support issues and configuration tasks for which administrators most commonly request help. These diagnostics can't make changes to your tenant, but they provide insights into the issues that affect them and instructions to fix the issues quickly.
Administrators can run the diagnostics from the Microsoft 365 admin center. For users who don't have administrator permissions, a set of connectivity tests are available in the Microsoft Remote Connectivity Analyzer tool that's used to troubleshoot connectivity issues that affect Teams.
Note
The diagnostics in the admin center aren't available for the GCC High or DoD environments, or for Microsoft 365 operated by 21Vianet.
The Microsoft Remote Connectivity Analyzer tool isn't available for the GCC and GCC High Microsoft 365 Government environments.
Select the Help & Support floating button in the bottom right corner of the screen to open the Help pane.
In the text box, type a brief description of the issue you need help to resolve.
Follow the prompts, and then select Run tests.
After the diagnostic checks finish and the issue is found, you're provided instructions to resolve the issue. If you implement a fix that's based upon the instructions, it's a good practive to rerun the diagnostic to make sure that the issue is completely resolved.
When an IT admin runs customer diagnostics in the Microsoft 365 admin center to resolve issues without logging support requests, Microsoft makes a donation to a global nonprofit organization. For more information, see Diagnostics for Social Good.
Run connectivity tests in the Microsoft Remote Connectivity Analyzer tool
From the list of available tests, select one that applies to your issue.
Provide the required information.
Enter the verification code that's displayed, and then select Verify.
Select the checkbox to accept the terms of agreement, and then select Perform Test.
After the test finishes, the screen will display details about the checks that were performed and whether the test succeeded, failed, or was successful but displayed a few warnings. A link is provided to get details about warnings and failures and how to resolve them.
Scenarios covered by diagnostics and connectivity tests
The following tables list the diagnostics that are currently available in the Microsoft 365 admin center and the connectivity tests that are available in the Microsoft Remote Connectivity Analyzer tool. The diagnostics are organized by category together with links to access the diagnostics and connectivity tests directly, scenario descriptions, and help articles about the scenarios.
Authentication
Description
Diagnostic shortcut
Connectivity test shortcut
Support article
Checks whether a user can sign in to the Teams app.
Determines the ability of Teams to interact with Microsoft Exchange Server. For Exchange Hybrid, run the test two times by using a Microsoft 365 mailbox and an on-premises mailbox. This is useful for IT administrators who want to troubleshoot Teams and Exchange integration.
Demonstrate skills to plan, deploy, configure, and manage Microsoft Teams to focus on efficient and effective collaboration and communication in a Microsoft 365 environment.
Learn about how to set coexistence and upgrade settings for all users in your organization at once, or for a single or set of users in your organization.
Fixes an issue in which you can't switch a tenant to Teams Only mode if the lyncdiscover DNS record doesn't point to Microsoft 365 or isn't present at all.