You are using an ad blocker that is interfering with our web typography and internal javascript. Please whitelist our domain to live in a more beautiful world. No ads here, just really great software!

Application Experience Live Webinar: SaaS applications – visibility, employee experience and business impact Book Your Seat

cookie alert

We use cookies to offer you a better browsing experience, analyze site traffic, personalize content, and serve targeted advertisements. If you continue to use this site, you consent to our use of cookies.

Nexthink Library

MS Teams: Management

Latest Version: 1.1.0.0
Install
Configuration

Required Products

Nexthink Act
Nexthink Engage

Platforms

Windows 7
Windows 10

Compatibility

V6.14 and later

Description

Set of Microsoft Teams related Remote Actions to examine errors, warnings, performance and troubleshoot issues.

Versions

  • 1.1.0.0 - 14 Apr 2021 - Updated "Reinstall Microsoft Teams" Remote Action description
  • 1.0.1.1 - 11 Jan 2021 - Modified campaign message in "Clear Microsoft Teams Cache" Remote Action
  • 1.0.1.0 - 20 Oct 2020 - Fixed "Clear Microsoft Teams Cache" Remote Action documentation
  • 1.0.0.0 - 19 Oct 2020 - Initial release

Clear Microsoft Teams Cache

Script Description

Closes Microsoft Teams if it is open and deletes the cache files.

Execution context and suggested scheduling

Run the script as 'interactive user'. The script should be executed manually.

A timeout of 120 seconds is recommended.

Parameters

Label Description
Campaign Id UID of the campaign to notify user that Microsoft Teams must be closed for the cache cleaning. Provide an empty value to avoid executing this campaign
Operation Completed Campaign Id UID of the campaign to notify the user about the finish of the Microsoft Teams cache cleaning. Provide an empty value to avoid executing this campaign

Outputs

None.

Further Information

The Remote Action deletes files recursively from these folders:
- All content from %APPDATA%\\Microsoft\\Teams\\Application Cache\\Cache.
- All content from %APPDATA%\\Microsoft\\Teams\\blob_storage.
- All content from %APPDATA%\\Microsoft\\Teams\\Cache.
- All content from %APPDATA%\\Microsoft\\Teams\\databases.
- All content from %APPDATA%\\Microsoft\\Teams\\GPUcache.
- All content from %APPDATA%\\Microsoft\\Teams\\Local Storage.
- All content from %APPDATA%\\Microsoft\\Teams\\tmp.
- .db and .ldb files from %APPDATA%\\Microsoft\\Teams\\IndexedDB.

Test Scenarios

NoLocationIsPresent
Test Case Microsoft Teams locations are not present on the device
Environment VM Windows 7 x64 (Multi-language) - VM Windows 10 x86/x64 (Multi-language) (1803/1809/1903)
Results Failure - Message about no location has been found
UserRejectedToCloseTeams
Test Case User answered "Close later" in the campaign
Environment VM Windows 7 x64 (Multi-language) - VM Windows 10 x86/x64 (Multi-language) (1803/1809/1903)
Results Failure - Is was impossible to close Microsoft Teams so the cleaning cannot be performed
CleaningPerformedWhenUsingCampaigns
Test Case Teams is opened and the user answered "Close now" in the campaign
Environment VM Windows 7 x64 (Multi-language) - VM Windows 10 x86/x64 (Multi-language) (1803/1809/1903)
Results Success - Teams is closed automatically and the cache is cleaned
CleaningPerformedWhenTeamsOpenedAndNoCampaigns
Test Case Teams is opened and no campaigns are configured
Environment VM Windows 7 x64 (Multi-language) - VM Windows 10 x86/x64 (Multi-language) (1803/1809/1903)
Results Success - Teams is closed automatically wihtout any notice and the cache is cleaned. No campaign is shown

Get Teams Info

Script Description

Shows the login errors of the last 24h, the deployment ring, network errors and calls made using Teams.

Execution context and suggested scheduling

Run the script as 'interactive user'. The script should be executed every 1 day.

A timeout of 120 seconds is recommended.

Parameters

None.

Outputs

Label Type Description
Authentication Errors Bool Checks if a authentication error has ocurred in the last 24h
Deployment Ring String Name of the deployment ring the Microsoft Teams user is part of
Network Access Denied Bool Checks if a network access error has ocurred in the last 24h
Calls Int Total number of calls initiated in the last 24h

Test Scenarios

AuthenticationErrorsDuringLastDay
Test Case There was at least one authentication error during the last 24 hours
Environment VM Windows 7 x64 (Multi-language) - VM Windows 10 x86/x64 (Multi-language) (1803/1809/1903)
Results Success - 'AuthenticationErrors' output is "true"
NetworkAccessDeniedLastDay
Test Case There was at least one network access denied error during the last 24 hours
Environment VM Windows 7 x64 (Multi-language) - VM Windows 10 x86/x64 (Multi-language) (1803/1809/1903)
Results Success - 'NetworkAccessDenied' output is "true"
CallsDuringLastDay
Test Case There were calls correctly established during the last 24 hours
Environment VM Windows 7 x64 (Multi-language) - VM Windows 10 x86/x64 (Multi-language) (1803/1809/1903)
Results Success - 'Calls' output displayed the total number of calls done successfully during the last day
DeploymentRingInfoObtained
Test Case The information about the Microsoft Teams product deployment ring is obtained
Environment VM Windows 7 x64 (Multi-language) - VM Windows 10 x86/x64 (Multi-language) (1803/1809/1903)
Results Success - 'DeploymentRing' output displayed the current deployment ring
DeploymentRingInfoNotAvailable
Test Case The information about the Microsoft Teams product deployment ring could not be obtained or was not available
Environment VM Windows 7 x64 (Multi-language) - VM Windows 10 x86/x64 (Multi-language) (1803/1809/1903)
Results Success - 'DeploymentRing' output is empty ("-") since the information was not available, adn a warning is displayed, indicating that the ring information could not be obtained
NothingRelevantDuringLastDay
Test Case Nothing was found during the last 24 hours
Environment VM Windows 7 x64 (Multi-language) - VM Windows 10 x86/x64 (Multi-language) (1803/1809/1903)
Results Success - All the outputs will have default values ("false", "-" or 0)
BigLogFileAnalyzed
Test Case A file with 30.000 lines for the last 24 hours was analyzed
Environment VM Windows 7 x64 (Multi-language) - VM Windows 10 x86/x64 (Multi-language) (1803/1809/1903)
Results Success - The script behaves accordingly, without causing any CPU/Memory peaks nor resource consumption warnings on Finder
MicrosoftTeamsNotInstalled
Test Case The Microsoft Teams product is not installed on target device
Environment VM Windows 7 x64 (Multi-language) - VM Windows 10 x86/x64 (Multi-language) (1803/1809/1903)
Results Failure - Outputs will display default values ("false", "-" or 0) and a warning will be shown, indicating that Microsoft Teams is not installed

Reinstall Microsoft Teams

Script Description

Reinstalls Microsoft Teams to avoid version disparity, broken installed versions or simply because you want the new features offered in new versions.

Warning: This Remote Action simultaneously downloads and installs the latest version of Microsoft Teams on all targeted devices. Please ensure that the available network capacity is appropriate for the number of targeted devices.

Execution context and suggested scheduling

Run the script as 'interactive user'. The script should be executed manually.

A timeout of 900 seconds is recommended.

Parameters

Label Description
Campaign Id UID of the campaign to notify user that Microsoft Teams must be closed for the reinstallation. Provide an empty GUID to avoid executing this campaign
Operation Completed Campaign Id UID of the campaign to notify the user about the finish of the Microsoft Teams reinstallation process. Provide an empty GUID to avoid executing this campaign
Maximum Delay In Seconds Maximum random delay set to avoid overloading the network. Provide number of seconds less than 600

Outputs

None.

Test Scenarios

TeamsIsNotInstalled
Test Case No version of Microsoft Teams is installed.
Environment VM Windows 7 x64 (Multi-language) - VM Windows 10 x86/x64 (Multi-language) (1803/1809/1903)
Results Success - Last version of Teams is installed silently.
TeamsIsInstalledSilently
Test Case Microsoft Teams is installed and not running.
Environment VM Windows 7 x64 (Multi-language) - VM Windows 10 x86/x64 (Multi-language) (1803/1809/1903)
Results Success - Last version of Teams is installed silently.
AllCampaignsAreCalled
Test Case Microsoft Teams is installed and running.
First campaign GUID has the default value.
Second campaign GUID has the default value.
Environment VM Windows 7 x64 (Multi-language) - VM Windows 10 x86/x64 (Multi-language) (1803/1809/1903)
Results Success - Last version of Teams is installed and all campaigns are called correctly.
OnlyFirstCampaignIsCalled
Test Case Microsoft Teams is installed and running.
First campaign GUID has the default value.
Second campaign GUID is empty.
Environment VM Windows 7 x64 (Multi-language) - VM Windows 10 x86/x64 (Multi-language) (1803/1809/1903)
Results Success - Last version of Teams is installed and the first campaign is called correctly.
OnlySecondCampaignIsCalled
Test Case Microsoft Teams is installed and running.
First campaign GUID is empty.
Second campaign GUID has the default value.
Environment VM Windows 7 x64 (Multi-language) - VM Windows 10 x86/x64 (Multi-language) (1803/1809/1903)
Results Success - Last version of Teams is installed and the second campaign is called correctly.

Invoke Network Assessment Tool

Script Description

Using Microsoft Skype for Business Network Assessment Tool connects to nearby Microsoft node to test voice call quality (round trip time, jitter, packet loss rate, packet reorder ratio).Results are calculated based on 90 percentile of values per metric.Tool is applicable for quality test of Microsoft Skype for Business and Microsoft Teams.

Execution context and suggested scheduling

Run the script as 'local system'. The script should be executed manually.

A timeout of 720 seconds is recommended.

Parameters

Label Description
Maximum Delay In Seconds Maximum random delay set to avoid overloading server hosting virtual machines. Provide number of seconds less than 600

Outputs

Label Type Description
RTT Latency Float Round trip time latency between device and Microsoft server node
Jitter Float Average time difference of packet arrival
Packet Loss Rate Ratio Fraction of the total transmitted packets that did not arrive at the receiver
Packet Reorder Ratio Ratio Ratio of the total transmitted packets that did not arrive in correct order at the receiver
Packet Loss Rate Test Passed Bool Microsoft quality test result of packet loss during test call
RTT Latency Test Bool Microsoft quality test result of packet round trip time during test call
Jitter Test Passed Bool Microsoft quality test result of average jitter during test call
Packet Reorder Ratio Test Passed Bool Microsoft quality test result of average jitter during test call

Restrictions

Further Information

Tool can be downloaded from here.

Thank you!