Top
Mass deployment of the Browser Extension
  • 12 Mar 2024
  • 4 Minutes To Read
  • Dark
    Light
  • PDF

Mass deployment of the Browser Extension

  • Dark
    Light
  • PDF

Article Summary

Whatfix content can be mass deployed on popular browsers like Google Chrome, Internet Explorer, Edge, and Safari. This can be done both on Windows and Mac (for most browsers). Rolling out the extension as part of an IT policy ensures that Whatfix content is available for all users of an organization.

your title goes here

For more information on mass deployment of the Firefox extensions, contact support@whatfix.com.

Prerequisites

Before proceeding with the mass deployment, ensure that you have the following based on installation method:

  • Intune Subscription: Obtain an active Microsoft Intune subscription and administrative access to the Intune portal. For more information, see How to sign up to Microsoft Intune?

    Note

    Admin access is mandatory to add a new script in Intune.

  • You need either one of the following:

    • MSI Package: You must have the MSI file of the Whatfix extension. To get the MSI installer file, see Single Installer for Whatfix Extensions.

    • PowerShell: Ensure that PowerShell is installed on the devices where the deployment will take place. The minimum required version is PowerShell 3.0 or higher.


Whatfix extension can be mass deployed using the following ways:

  • Using Powershell
  • Using MSI
  • Using Intune
Deployment Method Supported Browsers Supported OS
PowerShell Google Chrome, Edge (Chromium) Windows
MSI Package Google Chrome, Internet Explorer, Edge, Safari Windows
Microsoft Intune Google Chrome, Internet Explorer, Edge, Safari Windows, Mac
Using Powershell

The Whatfix extension can be deployed for one or more users on a computer by using a PowerShell script. You can deploy both the Chrome and Edge (Chromium) extensions using this method.

Note

This method is only for Windows users. For mass deployment on macOS, contact support@whatfix.com.

Use the following steps to bulk install Whatfix extension using PowerShell:

  1. On the Whatfix Guidance dashboard, click Settings.
    ia_left_nav_settings

  2. Click Content deployment.
    ia_settings_content%20deployement

  1. Click Details.
    2023-01-10_16-26-07.png

  2. Note down the Extension ID of the Chrome Store or Edge Store and download the corresponding Powershell Script.
    chromescript.png

    Note

    For more information, see Manage Extensions on the Whatfix Dashboard.

  3. Open PowerShell in Administrator mode.
    runasadmin.png

    your title goes here

    In case you do not have PowerShell installed on your computer, see Install PowerShell.

  4. Paste either one of the following commands in PowerShell:

    Note

    You can choose to deploy Whatfix for a particular user in the computer, or for every single user. For example, suppose three users, A, B and C, use a computer in your organization- each with their own login credentials and local app data. The Whatfix extension can be deployed on a machine level (for all the three users), or for any one of them, be it A, B or C.

For Chrome store

* For all users in the machine:
.\Chrome-ExtensionInstall.ps1 -Extension /ExtensionId/ -Hive Machine

* For specific user in the machine:
.\Chrome-ExtensionInstall.ps1 -Extension /ExtensionId/ -Hive User

Note

Replace /ExtensionId/ in the aforementioned commands with the unique Extension ID you noted in Step 4.

For Edge store

* For all users in the machine:
.\EdgeChromium-ChromeStoreExtensionInstall -Extension /ExtensionId/ -Hive 'Machine'

* For specific user in the machine:
.\EdgeChromium-ChromeStoreExtensionInstall -Extension /ExtensionId/ -Hive 'User'

Note

Replace /ExtensionId/ in the aforementioned commands with the unique Extension ID you noted in Step 4.

  1. Press Enter.
your title goes here

When the browser is reopened, the Whatfix extension is installed in the background.

Using MSI

Note
  • The following steps need to be performed from an Admin account.
  • Ensure that you have the MSI installer.

Use the following steps to install the Whatfix Player app on a system level:

  1. In the Windows search bar, type cmd, and then click Run as administrator.
    Snag_1a56db.png

  2. The Command Prompt opens in Admin mode.
    Snag_162947.png

  3. Run the following command to install the Whatfix extension file.

    msiexec.exe /i Whatfix_Extension_Installer_Name.msi ORG="ORG_ID" /q /l*v out.txt
    
    your title goes here

    Replace Whatfix_Extension_Installer_Name with the chosen installer name.

    The following table explains each parameter and whether or not it is required in the code:

    Parameter Description Mandatory
    ORG The ORG is a unique identifier assigned to your organization. To get the value for ORG (i.e., Enterprise ID), contact your Whatfix Representative. Mandatory value
    /l*v These are the installer logs. Optional
    /q This parameter ensures that the installation of the extension is done silently on your desktop. Optional
  4. Press the Enter key.

    Note

    If there is no error message, the installation is successful.

  5. Every time a user signs up or signs into the Windows machine for the first time, the Player app is installed in the localappdata of their respective user profile.

Using Intune

The Whatfix extension can be mass deployed for all the users in your organization by using Microsoft Intune. This can be done both on Windows and Mac (for most browsers). This ensures that the process becomes streamlined and efficient, and does not require you to deploy Whatfix on a machine-to-machine basis.

Mass deployment of the Whatfix extension consists of the following steps:

Steps for Mass Deployment of Intune using MSI or PowerShell

Step 1: Configure Intune Script Deployment Policy

  1. Open the Intune portal and go to the Devices section.
    2023-06-27_15-27-56.png

  2. Under Devices | Overview, search for Scripts and then on the results page, select it.
    2023-06-27_15-28-36.png

  3. Click Add to create a new script policy.
    addcript.jpg

  4. Select the platform to which you wish to deploy the script, either Mac or Windows.
    macwindowschoose.jpg

  5. Provide a Name and Description for the script policy.
    2023-07-03_12-24-26.png

  6. In the Script settings section, upload the MSI file or PowerShell script of the Whatfix extension.
    scriptsettings.jpg

  7. Configure the desired assignment settings for the script policy, such as targeting specific devices, user groups, or all devices in the organization.

  8. Save and assign the script policy.

    Note

    For detailed instructions, see Deploy Powershell using Intune.

Step 2: Validate the Installation

To validate whether mass deployment using Intune is done or not, open any of the users' browsers and check if the Whatfix extension is available.


Was this article helpful?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.