How to import ADMX files to Group Policy

Insight powered by AppSense

Download the ADMX ZIP file from https://community.ivanti.com/docs/DOC-46204.

The ZIP file contains:

  • Ivanti_Insight_Including_Custom_Settings.admx
  • Ivanti_Insight_Including_Custom_Settings.adml

The Insight Group Policy ADMX file can be used with both Local and the Domain-based Group Policy. Save the ADMX file and merge the language folder in %systemroot%\PolicyDefinitions to make the policies editable through Administrative Templates in either the Group Policy Object Editor or the Group Policy Management Console.

For further details about editing local and domain-based GPOs with ADMX files, see https://msdn.microsoft.com/en-us/library/bb530196.aspx

When you use the ADMX template to configure settings via a GPO, the registry values are written into the Policies section in HKLM.

Registry settings are evaluated in the following order, with highest priority applied:

  • HKLM Policy (HKLM\Software\Policies\AppSense\Insight)
  • HKLM (HKLM\Software\AppSense\Insight)

Settings

SettingDescription
Ivanti Insight Server FQDN Determines which Ivanti Insight Server the Ivanti Insight Agent uploads data. The name must be the Fully Qualified Domain Name (FQDN) for the target server. For example, NAME.COMPANY.COM. Insight automatically prepends the server with HTTPS:// so the protocol is not required. If a protocol is added, communication with the server will fail. The default port (443) can be overridden by appending the FQDN, for example, NAME.COMPANY.COM:10443.
Ivanti Insight Server API Key Configures the API key that is passed to the server when uploading Ivanti Insight data from the agent. Get the key from the server by navigating to Settings > API Keys in the Insight Web Console.

Custom Settings

SettingDescription
Ivanti Insight Agent Upload Frequency Determines how often Insight Data is sent to the Ivanti Insight Server and how often checks are made for configuration changes to the event collection criteria specified in the Settings > Data Management area of the Ivanti Insight Web Console. If you enable this policy setting, you can select the number of milliseconds that should elapse between subsequent uploads of Ivanti Insight data to the server. If you do not configure this policy setting, Ivanti Insight data is sent to the server once every 2 minutes.
Ivanti Insight Server SSL Certificate Flags Suppress errors with the SSL Certificate for the target Ivanti Insight Server. This is useful for Test Labs where distribution of the SSL certificate is problematic, or for diagnosing issues with the SSL Certificate.

For use in test labs only.

Ivanti Insight Agent Local Mode Enables Local Mode for the Ivanti Insight Agent. If enabled, all Ivanti Insight Agent data collected is written to the Analytics.log file in the %PROGRAMDATA%\AppSense\Insight folder instead of sending it to the Ivanti Insight Server.
Ivanti Insight Agent Logging Enables debug logging for the Ivanti Insight Agent. If enabled, the log file InsightDebug.log is created in the %PROGRAMDATA%\AppSense\Insight folder.
Ivanti Insight Agent Event Log Filter Determines which Ivanti Insight event log events are raised by the Ivanti Insight Agent. Use a comma-separated list of the Events you wish Ivanti Insight to raise in the Event Log. Available Event IDs are:
  • 9800 - Server Connection Status
  • 9801 - Server Connection Failure including HTTP error code
  • 9802 - Events uploaded including the count of uploaded events
Event ID 9800 & 9801 are raised by default prior to configuring this setting. Events are raised with Event Source of IvantiInsight.


The topic was:

Inaccurate

Incomplete

Not what I expected

Other

Each Windows PC contains its own set of administrative templates for group policies. However, they can be better managed in a central location. This is all the more true when ADMX files are added for several applications. Updating templates in the Group Policy Central Store can be tricky, though.

  • Author
  • Recent Posts

How to import ADMX files to Group Policy

Wolfgang Sommergut has over 20 years of experience in IT journalism. He has also worked as a system administrator and as a tech consultant. Today he runs the German publication WindowsPro.de.

How to import ADMX files to Group Policy

Contents

  1. Cumbersome local administration
  2. Setting up a Central Store
  3. Updating templates
  4. Bypass Central Store

If you edit a GPO in the group policy editor, it retrieves the available settings from the ADMX files that ship with Windows under %SystemRoot%\PolicyDefinitions.

Cumbersome local administration ^

If you use several workstations with different versions of Windows to manage group policies, then you will either have different templates everywhere, or you will have to update them to the same version on all PCs.

In addition, ADMX templates are needed not only for the management of Windows, but also for Office, Microsoft Edge, Chrome, and other third-party applications. These are each subject to their own update cycles and must also be updated regularly on each PC.

Setting up a Central Store ^

To avoid this effort and to achieve the same release status for the templates on all admin PCs, Microsoft allows you to set up a Central Store on a domain controller. You don't have to configure the GPO editor for this repository, as it always searches for the ADMX files automatically in the Central Store first.

This is located under:

\\\SYSVOL\\Policies\PolicyDefinitions\

Hence, for example:

\\4sysops.local\SYSVOL\4sysops.local\Policies\PolicyDefinitions

You have to create the PolicyDefinitions directory first and then copy the ADMX files there.

How to import ADMX files to Group Policy

Path to the Central Store for the administrative templates

In addition, you need to save the language files (*.adml), which contain the localized settings and descriptions, to the respective subdirectories, such as en-US or de-DE. The GPO editor then automatically loads the ADML that matches the admin PC's display language.

A current Windows client can serve as the source for the templates; alternatively, Microsoft provides the ADMX as a separate download. This contains not only all templates, but also the ADML files of all supported languages.

However, it is not advisable to copy language files that are not required into the Central Store because they are then replicated to all domain controllers.

It is absolutely recommended to install the ADML files for en-US, even if only a localized Windows in another language is used. This is because English language files are always used as a fallback if the ADML files for the current display language of Windows are not available.

How to import ADMX files to Group Policy

In this example the Italian GPO editor loads the English templates because the Italian versions do not exist in the store.

Updating templates ^

Since Microsoft releases a new version of the ADMX files with each release of Windows, you have to update the Central Store regularly. However, you cannot simply delete all the templates and import the new ones if you have also placed ADMX files there for other applications. Otherwise, you would have to restore them afterwards.

How to import ADMX files to Group Policy

Templates for different applications in the Central Store

In addition, Microsoft does not always replace all the templates. Sometimes file names are changed, and the Office templates were included with the ADMX download until Windows 10 1903, but they haven't been included since then. The date of the ADMX is no longer a suitable filter for deletion; it is only changed for the modified templates.

One possibility would be to keep all templates that are not intended for Windows in a separate folder. You could then restore them from there after cleaning up the Central Store.

Alternatively, you could unzip the ADMX download, go to the destination directory, and use this PowerShell command to delete all files in the store that also exist in the download:

Get-ChildItem *.admx |
foreach{
Get-ChildItem -Recurse ("\\FQDN\SYSVOL\FQDN\Policies\PolicyDefinitions\" + $_.basename + ".adm?") |
Remove-Item -Verbose
}

How to import ADMX files to Group Policy

Delete files in the Central Store if they are included in the ADMX download

As a precaution, you should first start the del command with the WhatIf switch to see which files are affected. After deleting, you should be able to see with the naked eye whether there are old Windows templates still left in the store.

Bypass Central Store ^

The ADMX update may remove certain settings from the templates. So, you might not be able to edit settings that are used in existing GPOs. In this case, you would want the editor to load the previous templates.

Since several ADMX versions cannot be kept side by side in the Central Store, you may load the local templates of a workstation instead. To force the GPO editor to fetch the settings from the local PC and not from the Central Store, you have to add a registry key named Group Policy under:

HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows

Subscribe to 4sysops newsletter!

There, you create a value of the type REG_DWORD, call it EnableLocalStore-Override, and assign it a value of 1.

How to import ADMX files to Group Policy
How to import ADMX files to Group Policy

How to import ADMX files to Group Policy Server 2012 r2?

ADMX files in Windows Server 2012R2, you must create a Central Store in the SYSVOL folder on a Windows domain controller. The Central Store is a file location that is verified by the Group Policy tools. The Group Policy tools use any . ADMX files that are in the Central Store.

Where are GPO Admx files stored?

Group polices are stored in administrative template files (ADM and ADMX files). By default, the files are stored in the following locations: ADM - C:\WINDOWS\Inf. ADMX - C:\WINDOWS\PolicyDefinitions.

What is Admx and adml file in GPO?

Overview. Administrative Templates files are divided into . admx files and language-specific . adml files for use by Group Policy administrators. The changes that are implemented in these files let administrators configure the same set of policies by using two languages.