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!

eBook: Top 10 Tips for Delivering a Great Digital Experience for Remote Workers Read the eBook

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

Browsers

2.0.0.0 - 22 Aug 2019 - Added Get Browser Tab Remote Action
Install

Required Modules

Nexthink Act
Nexthink Engage

Platforms

Windows 7
Windows 10
Internet Explorer 11 or Google Chrome 65 onwards

Compatibility

V6.14 and later

Description

Manage Google Chrome and Internet Explorer 11 plugins, retrieve default browser, the number of opened tabs and troubleshoot browsing-related issues. In addition, to be able to clear and set configurations on the previously mentioned browsers.

Versions

  • 2.0.0.0 - 22 Aug 2019 - Added Get Browser Tab Remote Action
  • 1.0.0.0 - Initial release

Clear Chrome settings

Script Description

Clears Chrome files according to the specified parameters. Useful for troubleshooting several browsing-related issues. The script is developed for Windows 10 and 7 and Chrome 65 onwards.

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
Clear Chrome Settings Campaign Id UID of the campaign to notify the user that Chrome must be closed
Browsing History List of visited websites. Set it to "true" for deletion, "false" otherwise
Cache Cached images and sites. Set it to "true" for deletion, "false" otherwise
Cookies Cookies saved on the device by websites. Set it to "true" for deletion, "false" otherwise

Outputs

Label Type Description
Cleaned Settings StringList List of cleaned settings

Further Information

Bookmarks and passwords are not included in the available settings, as they are synchronized when logged-in in Chrome.

Get Chrome Plugins

Script Description

Retrieves the plugins currently configured for Chrome, in alphabetical order, displaying version and status.

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

None.

Outputs

Label Type Description
Chrome Plugins Count Int Number of Chrome plugins available
Chrome Plugins Names StringList Chrome plugins names, followed by version and status

Set Google Chrome Plugins

Script Description

Sets a list of plugins to be installed or banned by editing Google Chrome Policies. Removing previous policies is also possible. The script is designed for Windows 10 and 7, and Google Chrome 65 onwards.

Execution context and suggested scheduling

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

A timeout of 120 seconds is recommended.

Parameters

Label Description
Campaign Id Campaign Id to invoke when Google Chrome is needed to be closed
Banned Plugins Plugin Id, or a comma-separated list of plugin Ids to be banned on the device. Type "" to not change this policy
Mandatory Plugins Plugin Id, or a comma-separated list of plugin Ids to be installed on the device. Type "" to not change this policy
Remove Previous Policies Set if the previous Google Chrome policies have to be removed before applying the new ones stated in the previous parameters. Set it to "true" for deletion, "false" otherwise

Outputs

None.

Further Information

Manages plugins from all user profiles on the device, even if the profile is not the current loaded one. Plugin Id can be found in the Google Chrome Store file information. A normal user cannot disable plugins that have been installed by Google Chrome Policies. When a plugin is banned, the user cannot install it using the Google Chrome Store.

Get Browser Tabs

Script Description

Provides information about the number of opened tabs from a given browser name.

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 prompt the user about the number of tabs opened. Provide an empty GUID to avoid executing this campaign
Browser Name Name of the browser to gather opened tabs. Valid values are: Chrome, Firefox and Internet Explorer
Number Of Tabs Number of tabs to be reached to prompt the user with the campaign. Provide number of tabs lower than 100

Outputs

Label Type Description
Number Of Tabs Int Number of tabs opened in the provided browser

Further Information

The script only retrieves processes with active MainWindowHandle, hence, if the user opens several browser windows, only the last used one is checked.

Test Scenarios

NoBrowserOpened
Test Case When all compatible browsers are closed.
Environment VM Windows 7 x64 (Multi-language) - VM Windows 10 x86/x64 (1803/1809/1903)
Results Success - It finishes with 0 value returned.
BrowsersOpenedWithoutReachingNumberOfTabs
Test Case When Chrome, Firefox or Internet Explorer are opened without reaching the provided number of tabs.
Environment VM Windows 7 x64 (Multi-language) - VM Windows 10 x86/x64 (1803/1809/1903)
Results Success - It returns the proper number of tabs and the campaign is not shown.
BrowsersOpenedReachingNumberOfTabs
Test Case When Chrome, Firefox or Internet Explorer are opened reaching the provided number of tabs.
Environment VM Windows 7 x64 (Multi-language) - VM Windows 10 x86/x64 (1803/1809/1903)
Results Success - It returns the proper number of tabs and the campaign is show to the user to close some of them.
BrowsersOpenedWithSeveralWindows
Test Case Any browser has 2 windows opened, one with 20 tabs the the last used one with 2.
Environment VM Windows 7 x64 (Multi-language) - VM Windows 10 x86/x64 (1803/1809/1903)
Results Success - It returns the number of tabs only for the last used window (2 tabs).

Clear Internet Explorer 11 settings

Script Description

Clears Internet Explorer files according to the specified parameters. Useful for troubleshooting several browsing-related issues. The script is designed for Windows 10 and 7 and Internet Explorer 11.

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
Browsing History List of visited websites. Set it to "true" for deletion, "false" otherwise
Cookies Cookies and files saved on the device by websites. Set it to "true" for deletion, "false" otherwise
Forms Data Saved information typed into forms. Set it to "true" for deletion, "false" otherwise
Passwords Saved passwords. Set it to "true" for deletion, "false" otherwise
Temporary Files Copies of webpages, images and media. Set it to "true" for deletion, "false" otherwise

Outputs

Label Type Description
Cleaned Settings StringList List of cleaned settings

Get Internet Explorer Plugins

Script Description

Retrieves the plugins currently configured for Internet Explorer and displays them in alphabetical order. The script is designed for Windows 10 and 7, and Internet Explorer 11.

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

None.

Outputs

Label Type Description
Internet Explorer Plugins Count Int Number of Internet Explorer plugins available
Internet Explorer Plugins Names StringList Internet Explorer plugins names

Set Internet Explorer Plugins

Script Description

Enables or disables Internet Explorer plugins by editing Group Policies. The script is designed for Windows 10 and 7, and Internet Explorer 11.

Execution context and suggested scheduling

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

A timeout of 120 seconds is recommended.

Parameters

Label Description
Campaign Id Campaign Id to invoke when Internet Explorer is needed to be closed
Plugins Names Plugin name, or a comma-separated list of plugins names
Status Status, or comma-separated list of status, to apply to the plugin. Values expected enabled / disabled

Outputs

Label Type Description
Plugins Status StringList Internet Explorer plugins configured and their status

Further Information

Manages plugins from all user profiles on the device, even if the profile is not the current logged one.

Get Default Browser

Script Description

Retrieves browser name that is configured as default.

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

None.

Outputs

Label Type Description
Default Browser String Name of the default browser. Empty, if no browser associated with HTTP(S) protocol

Further Information

This script has been successfully tested with Chrome, Firefox, Opera, Internet Explorer and Edge.
Any other browser whose installation follows Microsoft standards should be equally recognized.