policyDefinitionResources Element
Applies To: Windows Server 2008
The policyDefinitionResources element is the document element for an .adml file that defines all the localized resource information with a single language/culture per file for each supported language/culture setting. The policyDefinitionResources element also declares a default namespace for all of the elements in the .adml file.
Syntax
<policyDefinitionResources xmlns:xsd="https://www.w3.org/2001/XMLSchema" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" revision="<MajorVerison.MinorVersion>" schemaVersion="<MajorVerison.MinorVersion>" xmlns= "https://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions" >
<displayName> … </displayName>
<description> … </description>
<annotation> … </annotation>
<resources> … </resources>
</policyDefinitionResources>
Attributes
| Attributes | Required | Description |
|---|---|---|
No |
Designation for elements and data types used in the schema that comes from the "https://www.w3.org/2001/XMLSchema" namespace. This attribute is typed as shown. |
|
No |
Designation for the "XML Schema Instance" namespace available is from the "https://www.w3.org/2001/XMLSchema-instance" namespace. This attribute is typed as shown. |
|
Yes |
Version of the .admx file for tracking purposes. |
|
Yes |
Schema version used by the Group Policy tools. For Windows Vista and Windows Server 2008 schemaVersion must be set as follows; schemaVersion="1.0" |
|
No |
The Group Policy schema namespace. |
Note
The Group Policy tools will successfully consume the .adml file that does not include the xmlns:xsd, xmlns:xsi, and xmlns attributes. The .adml file may not validate as a fully-formed XML file if the xmlns:xsd, xmlns:xsi, and xmlns attributes are not included in the .adml file.
Child elements
| Element | Required | Description |
|---|---|---|
Yes |
The localized friendly name of the .adml file. |
|
No |
The localized description of policy settings contained in the .adml file. |
|
Yes |
A localized comment at the beginning of the .adml file. |
|
No |
Contains the stringTable and presentationTable elements for specific MUI languages. |
Note
For simplicity of documentation, nested elements located one level down, known as child elements, will only be described for a given element.
Remarks
Because the policyDefinitionResources element is the document element, it contains all the other elements in the document representing the .adml file. The XML declaration is not part of the document element.
Examples
This XML fragment is the corresponding localized resources for the single policy setting example in the policyDefinitions element.
<?xml version="1.0" encoding="utf-8"?>
<policyDefinitionResources xmlns:xsd="https://www.w3.org/2001/XMLSchema" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" revision="1.0" schemaVersion="1.0" xmlns=" https://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions ">
<displayName>enter display name here</displayName>
<description>enter description here</description>
<resources>
<stringTable>
<string id="SAMPLE">Example 1 - Simplest single Group Policy setting</string>
<string id="Sample_NoParamPolicy">Set state only</string>
<string id="Sample_NoParamPolicy_Help">This is an example of a Group Policy setting that only sets a value for the enabled, disabled states.
If you enable this setting, the Example1NoParam value will be set to 1.
If you disable this setting, the Example1NoParam will be set to 0.
If you do not configure this setting, the value will be deleted, if currently set to a value.</string>
<string id="SAMPLEHELP">Example 1
Contains an example of the simplest policy setting that can be created.
This will be displayed as both a machine and user policy setting.</string>
<string id="SUPPORTED_ProductOnly">Only works on placeholder product</string>
</stringTable>
</resources>
</policyDefinitionResources>