Skip to main content
This guide covers distributing the Admina browser extension to Windows devices managed by Microsoft Intune. For an overview of the extension, see Distribute the browser extension to detect shadow IT and retrieve service activity. Three distribution methods are available for Windows. Choose the one that fits your environment.

1. Prerequisites

This guide assumes the following are already in place.
  • Target devices are enrolled in Microsoft Intune (visible under Devices in the Intune admin center and syncing normally)
  • Devices are joined to Microsoft Entra ID
  • An Entra ID security group exists for the users you will deploy to
  • The operator holds the Intune Administrator role
Target browsers are Google Chrome and Microsoft Edge. If you deploy to both, configure each separately (the steps are the same).

Values to obtain from the Admina admin console

Before you start, note the following three values from the Admina admin console.

2. Distribution files

Upload .admx and .adml files as matching name pairs. Download the files below and use them when uploading to Intune. Clicking a link below opens the file in the same tab. Use your browser’s back button to return to this page after downloading. To get everything at once, use Download all files as ZIP.
Set-UserEmailEnv.ps1 is saved as UTF-8 with BOM, CRLF line endings. Windows PowerShell (5.1) needs this format to interpret the script’s encoding correctly, so keep this format if you edit the file.

3. How distribution works

Intune has no built-in way to embed the signed-in user’s email address into configuration values automatically. This guide combines two components. ① Configuration template (ADMX) distributes force-install of the extension and related parameters. For UserEmail, it writes a reference to the environment variable %USEREMAIL%, not the actual email address. ② Script (Set-UserEmailEnv.ps1) sets each user’s own email address in the USEREMAIL environment variable at sign-in. When the browser loads configuration, %USEREMAIL% expands to the actual email address. Each user sends the correct value to Admina. Even when multiple users share one device, each user is recorded with their own email address.

4. Configuration steps

Step 1: Import configuration templates

In the Intune admin center, open:
DevicesConfigurationManageTemplatesImport ADMX
Import Chrome and Edge separately in two runs.
  1. First run: upload ExtensionChrome.admx and ExtensionChrome.adml
  2. Second run: upload ExtensionEdge.admx and ExtensionEdge.adml
Both should show State as Available when import succeeds.
Intune Import ADMX screen showing the AdminaEdge ADMX/ADML files uploaded and an Upload Completed message

Step 2: Create a configuration profile

DevicesConfigurationCreateNew Policy
Create a profile screen with Platform set to Windows 10 and later and Profile type set to Templates (Imported Administrative templates)
Select and enter the following. On the Configuration settings page, search for Admina. Two policies appear. Select the browser you want to deploy.
  • [Chrome] Admina Extension を強制インストールし Managed Policy を配布する
  • [Edge] Admina Extension を強制インストールし Managed Policy を配布する
Select Enabled and enter the following values.
Do not replace UserEmail and UserPC with actual values. Enter %USEREMAIL% and %COMPUTERNAME% as literal strings. The browser expands them to per-user values when it loads configuration.
Configuration settings screen with ApiKey, CreatedDate, OrganizationID, UserEmail, and UserPC values entered
Under Assignments, specify the user group to deploy to.
Assign a user group, not a device group. This template applies per user.
Review + create screen showing the final configuration profile settings and assignments
To deploy to both Chrome and Edge, repeat this step to create two profiles.

Step 3: Deploy the email address script

DevicesScripts and remediationsPlatform scriptsAddWindows 10 and later
Set “Run this script using the logged on credentials” to Yes. If left as No, each user’s email address will not be set correctly.
Script settings screen with Set-UserEmailEnv.ps1 settings including Run using logged on credentials entered
Review + create screen showing the final Set-UserEmailEnv.ps1 script settings and assignments

5. Verification

Configuration can take several minutes to apply. After the target user signs in to the device, verify the following.

Check 1: Environment variable

Open a new PowerShell window and run:
If the signed-in user’s email address appears, the check passed.

Check 2: Extension

Open chrome://extensions (or edge://extensions for Edge) and confirm the Admina extension is installed. It shows as “Installed by your organization”.

Check 3: Extension settings page

Open the Admina extension options page. Confirm the Email address field shows the signed-in user’s email and displays Managed. If you encounter issues, see How to check Diag data.

6. FAQ and troubleshooting

Deployment errors during any step

If Step 2 (configuration profile) or Step 3 (script) fails to deploy, check that step’s execution log in the Intune admin center. For the configuration profile, go to DevicesConfiguration → the profile → Device status to see the deployment result (Succeeded, Error, etc.) for each device.
Configuration profile Device status screen showing Succeeded and Error counts and per-device status
For the script, go to DevicesScripts and remediations → the script → Device status / User status to see the execution result.
Set-UserEmailEnv script Device status / User status screen showing execution results
If a device shows Error, select it to see the detailed error code and message.

Settings do not apply right after configuration

Intune configuration has a time lag before it applies. It may also sync on re-sign-in. Wait for a period (one to several hours) on a good network connection, or try signing off and back on.

Extension shows %USEREMAIL%

This happens when data is sent before the environment variable expands. It normally resolves itself once the environment variable expands, so wait a while first. If it still does not resolve, check whether distribution failed using the steps below.

Change configuration values (ApiKey, etc.)

Open the configuration profile from Step 2, update the values, and save. Changes apply to each device at the next sync. Re-uploading files is not required.

Stop distribution

Remove the assignment from the Step 2 configuration profile or delete the profile itself. At the next policy refresh, settings are removed and the browser uninstalls the extension automatically. The USEREMAIL environment variable remains and is not removed. It holds a general user email value, not Admina-specific data. Remove it separately if needed.
Last modified on July 29, 2026