2.2.1.17.1 Element-Specific Attributes

Attribute name

Description

action

(optional) If specified, the value MUST be C, D, R, or U, corresponding to Create, Delete, Replace, and Update. If unspecified, the default value is U.

  • Create: This action MUST be used to create a new registry value or key for computers or users.

  • Delete: This action MUST be used to remove a registry value or a registry key, and all of its values and subkeys, for computers or users.

  • Replace: This action MUST be used to delete and re-create a registry value or key for computers or users. If the target is a registry value, the net result of the Replace action MUST be to overwrite all existing settings associated with the registry value. If the target is a registry key, the net result MUST be to delete all values and subkeys in the key, leaving only a default value name with no data. If the registry value or key does not exist, then the Replace action MUST create a new registry value or key.

  • Update: This action MUST be used to modify settings of an existing registry value or key for computers or users. This action differs from Replace in that it MUST update only settings defined within the preference item. All other settings MUST remain as configured in the registry value or key. If the registry value or key does not exist, then the Update action MUST create a new registry value or key.

default

(optional) MUST be set to 1 to indicate that the registry key is setting the default value.

hive

MUST be set to the hive for the registry key.

  • HKEY_CLASSES_ROOT is an alias for HKEY_LOCAL_MACHINE\Software\Classes.

  • HKEY_CURRENT_USER is an alias for HKEY_USERS\<logged-on user's hive>.

  • HKEY_LOCAL_MACHINE is the default option for the computer policy. These settings affect all users of the computer.

  • HKEY_USERS is the default option for the user policy. These settings affect individual users.

  • HEKY_CURRENT_CONFIG is an alias for HEKY_LOCAL_MACHINE\System\CurrentControlSet\Hardware Profiles\Current.

key

MUST be set to the key path. Do not include the hive or a leading or trailing slash.

name

(optional) To configure a value, either <default> MUST set to configure the default value for the key, or the name of the value to configure MUST be set. To configure only a key, this field MUST be left blank.

type

(optional) To configure a value, the value type MUST be set. To configure only a key, this field MUST be left blank. If not blank, this field MUST be one of the following value types: REG_SZ, REG_DWORD, REG_EXPAND_SZ, or REG_MULTI_SZ.

value

(optional) This value MUST be set as the data for the registry value. To configure only a key, this field MUST be left blank. This option is applicable only if the action selected is Create, Replace, or Update and if <type> has also been set.

displayDecimal

(optional) This value is set to 1 to indicate if a numeric value is displayed as a decimal number.

bitfield

(optional) This value is set to 1 if the registry value represents a series of bit values.

defaultValue

(optional) This value sets the starting value for a registry value that represents a series of bit values; bitfield MUST be set to 1; otherwise the field is ignored.

SubProp

(optional) This element MUST contain three attributes (id, value, and mask):

  • id is a user defined name for a series of bits in the registry value.

  • value is a numeric value to be applied to the bits defined in the mask.

  • mask is a number representing the bits in the registry value to set.

desc

(optional) Contains a comment.