Join us at Experience '19: The Digital Employee Experience Conference. Learn More

Nexthink Library

Browsers

Allows to manage plugins, clear and set configuration settings, get the default browser in the system as well as the number of tabs opened.

Content

Campaigns - 4

Remote actions - 8

Required Modules

Nexthink Act

Nexthink Engage

Platforms

Windows

Compatibility

V6.14 and later

2.0.0.0 - Added Get Browser Tab Remote Action
1.0.0.0 - Initial release

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.

Clear Chrome settings

1.1.0.0 - Chrome is restarted after clearing settings. Some minor improvements
1.0.0.0 - Initial release

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

2.0.0.0 - Added plugins status and some code improvements
1.0.0.0 - Initial release

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

1.0.0.0 - Initial release

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

1.0.0.0 - Initial release

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

1.0.0.0 - Initial release

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

1.0.1.0 - Additional registry paths are checked
1.0.0.0 - Initial release

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

1.0.0.0 - Initial release

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

1.0.0.0 - Initial release

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.