policy

A single policy setting definition.

Element hierarchy

<policyDefinitions>
<policies>
<policy>

Syntax

<policy name          = itemName
        class         = enumeration ("User"|"Machine"|"Both")
        displayName   = stringReference
        explainText?  = stringReference
        presentation? = presentationReference
        key           = registryKey
        valueName?    = registryValueName >

  <!-- Child elements -->
  annotation*,
  parentCategory?,
  seeAlso*,
  keywords?,
  supportedOn,
  enabledValue?,
  disabledValue?,
  enabledList?,
  disabledList?,
  elements?

</policy>

Key

?   optional (zero or one)
*   optional (zero or more)

Attributes and Elements

Attributes

AttributeDescriptionData typeRequiredDefault value
class

Whether the policy setting will be applicable to a user, machine, or both.

enumeration ("User"|"Machine"|"Both")Yes
displayName

A localized friendly name.

stringReferenceYes
explainText

An explanatory description.

stringReferenceNo
key

A valid registry key path, without reference to local system or user hive.

registryKeyYes
name

Name of the policy.

itemNameYes
presentation

A reference to a policy presentation in the localized presentation section/table.

presentationReferenceNo
valueName

A valid registry value name.

registryValueNameNo

 

Child Elements

Child ElementDescription
annotation

A comment string for .adml files. Strings added to this tag will not be processed by Group Policy tools.

disabledList

A list of items representing registry value names to be set when the owning policy is disabled.

disabledValue

A registry value name to be set when the owning policy is disabled.

elements

Defines the types of optional parameters defined in a policy setting. The number and type of PolicyElements must match the policy presentation elements.

enabledList

A list of items representing registry value names to be set when the owning policy is enabled.

enabledValue

A registry value name to be set when the owning policy is enabled.

keywords

Optional keywords associated with categories or policy definitions. Not supported by Group Policy tools.

parentCategory

A reference to the parent category of the current category.

seeAlso

An descriptor string used to reference related policy definitions. Optional and unsupported by Group Policy tools.

supportedOn (type: SupportedOnReference)

A reference to a supported product definition, either a single version or a complex definition.

 

Parent Elements

Parent ElementDescription
policies

A grouping of one or more policy setting definitions.

 

Requirements

Namespace

http://www.microsoft.com/GroupPolicy/PolicyDefinitions

 

 

Show: