policy

  • Article

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

Attribute Description Data type Required Default 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.

 stringReference Yes
explainText

An explanatory description.

 stringReference No
key

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

 registryKey Yes
name

Name of the policy.

 itemName Yes
presentation

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

 presentationReference No
valueName

A valid registry value name.

 registryValueName No

 

Child Elements

Child Element Description
[annotation](element-3-annotation.md)

A comment string for .adml files. Strings added to this tag will not be processed by Group Policy tools.
[disabledList](element-disabledlist.md)

A list of items representing registry value names to be set when the owning policy is disabled.
[disabledValue](element-disabledvalue.md)

A registry value name to be set when the owning policy is disabled.
[elements](element-elements.md)

Defines the types of optional parameters defined in a policy setting. The number and type of PolicyElements must match the policy presentation elements.
[enabledList](element-enabledlist.md)

A list of items representing registry value names to be set when the owning policy is enabled.
[enabledValue](element-enabledvalue.md)

A registry value name to be set when the owning policy is enabled.
[keywords](element-1-keywords.md)

Optional keywords associated with categories or policy definitions. Not supported by Group Policy tools.
[parentCategory](element-1-parentcategory.md)

A reference to the parent category of the current category.
[seeAlso](element-1-seealso.md)

An descriptor string used to reference related policy definitions. Optional and unsupported by Group Policy tools.
[supportedOn (type: SupportedOnReference)](element-1-supportedon.md)

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

 

Parent Elements

Parent Element Description
[policies](element-policies.md)

A grouping of one or more policy setting definitions.

 

Requirements

Namespace

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