disabledList Element
Applies To: Windows Server 2008
The disabledList element is used to set the multiple registry values when a policy setting is disabled through the Local Group Policy Editor or Group Policy Management Console.
Syntax
<disabledList defaultKey="<placeholder for registry subkey>">
<item> … </item>
</disabledList>
Attributes
| Attributes | Required | Description |
|---|---|---|
No |
Represents a default registry subkey for all items. |
Child elements
| Element | Required | Description |
|---|---|---|
Yes |
Represents a registry subkey with an associated value. |
Note
For simplicity of documentation, nested elements located one level down, known as child elements, will only be described for a given element.
Remarks
The disabledList element is an optional element. If you use the disabledList element when defining a policy element, you must define at least one item element. If not, the Local Group Policy Editor or GPMC will display an error.
There is no limit to the number of items that can be defined for a single disabledList element.
Examples
This XML fragment demonstrates the use of the disabledList. The first two registry subkeys are set to a string value and a decimal value, respectively, when the policy setting is configured to the disabled state. The third subkey is deleted when the same policy setting is configured to the disabled state.
<disabledList>
<item key="Software\Policies\Examples"
valueName="Example2ActionList1">
<value>
<string>0</string>
</value>
</item>
<item key="Software\Policies\Examples"
valueName="Example2ActionList2">
<value>
<decimal value="10" />
</value>
</item>
<item key="Software\Policies\Examples"
valueName="Example2ActionList3">
<value>
<delete />
</value>
</item>
</disabledList>