ADM/ADMX Conversion Chart

A high-level mapping of ADM syntax to the ADMX equivalents. (A blank entry in the ADM to ADMX conversion chart implies there is no equivalent syntax used in that file.)

ADM to ADMX Conversion Chart

ADM language referenceADMX equivalentComments
.admx .adml
Adm File Language Versions (#If Version) revisionrevisionUnlike ADM files, the ADMX file will have versioning built in and will not be tied to an operating system version.
resources minRequiredRevisionThe resources minRequiredRevision attribute provides the coordination between the .admx and .adml file versions
schemaVersionschemaVersionThe schemaVersion attribute specifies the ADMX schema version assumed when creating the .admx and .adml files. The Windows Vista ADMX files assume a 1.0 schema version number.
comments (;)
  • Annotation
  • <!-- -->
  • Annotation
  • <!-- -->
For ADM files, all text following the ";" is considered a comment. For ADMX files, either the Annotation element or the XML comments will not be processed by GP tools.
Strings reference (!!) stringIn ADM files, precede text with "!!" to reference a string
<Strings> section of the .Adm filestringTable
CLASS classADMX files provide the ability to classify the policy definition as being for user, machine, or both. The "both" classification will allow you to create a single policy definition that applies to the machine and user registry keys.
  • categories
  • category
  • parentCategory
ADM files assume categories are nested within the definitions. ADMX files specifies a parentCategory element for each policy element defined in the .admx file. An individual category is defined within the "categories" element.
Duplicate Category Sections allowed in different ADM files.Duplicate category sections are not allowed in different ADMX files.If one .adm file includes a duplicate "CATEGORY" entry used in a different existing .adm file, the policy settings will merged when the Group Policy object Editor processes the ADM files. ADMX files have unique namespaces. Defining the same "category" element names in two different .admx files will cause the category to be displayed twice. Instead for .admx files, you must define the "category" element name once and then reference the category element name with the "using" element.
  • policies
  • policy
In the .admx file, the "policies" element contains individual "policy" elements that correspond to a policy setting.
PART elementspresentationIn ADM files, the PART statement specifies various policy setting options, such as drop-down list boxes, text boxes, and text in the lower pane of the Group Policy snap-in. ADMX files aggregate policy setting options for one policy setting into the "elements" element in the .admx file and the "presentation" element in the .adml file.
TEXTtextThe "text" element in the .adml file provides the string used as the parameter text prompt.
  • enum
  • item
ENDXML syntax includes termination of all its elements. There is no need to use special syntax to terminate an element.
Line Breaks \n or \n\nUse link breaks or blank lines within the string definitions.
Maximum string length for EXPLAIN text Limited by available memory only.
Maximum string length for CATEGORY EXPLAIN text Limited by available memory only.
Maximum string length for EDITTEXT stringMaximum string length for EDITTEXT string = 1023 characters.