category Element

Article
07/02/2012

Applies To: Windows Server 2008

The category element specifies the name of a unique category to be displayed in the Group Policy Management Console (GPMC) or the Local Group Policy Editor.

Syntax

The syntax of the category element declaration is:

  <category name="<placeholder for logical or friendly name>"   
     displayName="$( string.<placeholder for category text>)"
     explainText="$( string.<placeholder for help text>)">
     <parentCategory> … </parentCategory>
     <seeAlso> … </seeAlso>
     <keywords> … </keywords>
  </category>

Attributes

Attributes Required Description

Attributes	Required	Description
name Attribute	Yes	`name="<placeholder for logical or friendly name>"` Specifies a logical name to use for a specific supported application and revision.
displayName Attribute	Yes	`displayName="$( string.<placeholder for category text>)"` The reference to the category text string located in the string table of the .adml file.
explainText Attribute	No	`explainText="$( string.<placeholder for help text>)">` Explain or Help text associated with a specific category.

name Attribute

Yes

name="<placeholder for logical or friendly name>"

Specifies a logical name to use for a specific supported application and revision.

displayName Attribute

Yes

displayName="$( string.<placeholder for category text>)"

The reference to the category text string located in the string table of the .adml file.

explainText Attribute

explainText="$( string.<placeholder for help text>)">

Explain or Help text associated with a specific category.

Child elements

Element	Required	Description
parentCategory Element element	Yes	Reference to parent of the current category.
seeAlso Element element	No	Reference to another element that may be related. This element is not supported and will be ignored by current Group Policy.
keywords Element	No	Contains index words that could be used to search for elements. This element is not supported and will be ignored by current Group Policy tools.

Note

For simplicity of documentation, nested elements located one level down, known as child elements, will only be described for a given element.

Remarks

Each category element defines a text string representing the name of the category that includes Group Policy settings declared in this .admx file, in the GPMC or the Local Group Policy Editor. Duplicate category strings defined in different .admx files/policyNamespaces will be treated as separate categories. This will result in duplicate category titles in the GPMC or the Local Group Policy Editor display. Instead of creating a category, you must reference the existing category to avoid creating duplicate categories.

You cannot define more than one parentCategory for a category element.

Examples

This XML fragment is an example of a single category that will be displayed under the windows component category.

    <category name="SAMPLE" displayName="$(string.SAMPLE)"
       explainText="$(string.SAMPLEHELP)">  
       <!-- sample category -->
       <parentCategory ref="windows:WindowsComponents" />
       <seeAlso> policy </seeAlso>
       <keywords> Contoso </keywords>
    </category>

Additional references

categories Element

Partager via