组策略ADM语法参考指南

ADMX语法参考指南WindowsServer2023本参考指南供给了关于创立和编辑自定义ADMX文件的信息。这些基于XML的文件允许治理员在组策略治理掌握台中或本地组策略编辑器中创立用户界面以显示组策略设置。阅读本文档的方法对于期望初步了解ADMX格式的人而言，可以从本参考指南中的概念主题开头入门。建议阅读以下主题：ADMXADMX.admx和.adml文件构造有关创立ADMX文件的最正确实践引用WindowsADMX文件ADMX文件将.admx和.adml参数信息相关联比较ADM和ADMX样例文件在您生疏ADMX文件和ADMXADMX语法局部用作技术参考.admx.admlADMX备注备注本文档在引用ADMX文件的不同局部时，将会使用以下规章。当引用WindowsVista注册表设置的治理模板文件的“ADMX“.admx文件”用附属语言的治理模板文件时将会引用“.admlADMXWindowsServer2023ADMX文件基于XMLXML语言构造和语法有一些根本了解。至少应当有以下了解：格式正确的XML文档的定义。XMLXMLXMLXML区分大小写。必需使用与本参考中所述一样的大小写格式输入全部元素和属性。可以使用任何可与XML兼容的编辑器〔可以像记事本一样根本〕ADMX文件。ADMXWindowsServer2023在WindowsVistaADMX文件显示基于注册表的策略设置ADMX文件是基于XML的文件，定义为一个中性语言的文件(.admx)ADMX(.adml)ADMXADMXADMXMicrosoft“://go.microsoft/fwlink/?LinkId=8609)4“.admx和.adml更时间:20234WindowsServer2023为了支持策略设置的多语言显示，必需将ADMX文件构造分成两种文件类型：.admx是中性语言文件，用于描述组策略治理掌握台(GPMC)或本地组策略编辑器中显示的类别和治理模板策略设置的构造。.adml是一组附属语言文件，用于供给GPMC.adml文件都代表要支持的一种语言。(.admx)构造中性语言文件.admx按GPMC或本地组策略编辑器中显示的类别确定策略设置的数量和类型及其位置。.admxXML声明XML的文件而需要。policyDefinitions，包含.admx文件的其他全部元素。policyNamespaces，定义该.admx文件的唯一命名空间。假设该.admx文件将引用其他.admx文件中定义的category元素，那么policyNamespaces元素也供给到外部文件命名空间的映射。有关映射到外Windows根本ADMX或ADMX。resources元素(.admx)，指定特定语言资源的要求；相关.adml文件的最低版本要求。supportedOn元素，指定对本地化文本字符串的引用，该字符串定义特定策略设置影响的操作系统或应用程Windows的supportedOnWindowsADMX文件。categories元素GPMC或本地组策略编辑器中将在其下显示该.admx文件中的策略设置的类别。如果在其他.admx文件中指定已存在的类别名称，那么将会创立重复节点。有关引用之前定义的类别名称以避开WindowsADMX文件或ADMX文件。policies元素，包含各个策略设置定义。(.adml)构造语言资源文件.adml供给中性语言文件所需的特定语言信息。然后，中性语言文件将引用语言资源文件的特定局部，GPMC.admlXML声明XML的文件而需要。policyDefinitionResources.adml文件的其他全部元素。resources元素(.adml)，包含针对指定语言的stringTable元素和presentationTable。依据ADMX.admlstringTableelement后面接presentationTableelement的特定挨次定义这两个元素。假设这两个元素的挨次颠倒，那么组策略工具的分析程序将显示错误。ADMX文件的最正确实践WindowsServer2023这是创作ADMX文件时所使用的一些最正确做法。全部ADMX文件都会创作为一个中性语言文件(.admx)和一组附属语言文件，这些文件将针对全部受支持的语言(.adml)假设要避开在组策略治理掌握台(GPMC)或本地组策略编辑器中显示重复节点，那么不要使用之前已在父类别下.admx文件，那么创立其次个具有该公司名称类别的.admx文件将导致在GPMC或本地组策略编辑器中创立两个名称一样的节点。而是创立一个公司的全部.admx文件都将引用的自定义根本文件。有关更多信息，请参ADMX文件。.admx文件不应当引用另一个.admx文件的类别元素。而且应当将组件根本类别.admx文件进展引用。有关更多信息，请参创立自ADMX。.admx.admx文件的target元素中定义的。XML区分大小写。必需使用与本参考中所述一样的大小写格式输入全部元素和属性。Windows根本ADMX文件WindowsServer2023Windows根本文件windows.admx为Windowswindows.admx.admxWindows根本文件Microsoft.Policies.Windows引用Windows根本文件。命名空间字符串区分大小写。假设要引用Windows使用policyNamespaces命名空间属性必需匹配Windows根本文件中定义的命名空间前缀属性可以是.admx文件中唯一的任一名称Windows根本文件中的前缀属性字符串。例如，example2.admxXMLpolicyNamespacesWindows根本文件。复制代码<policyNamespaces><policyNamespaces><targetprefix=“example2“namespace=“Microsoft.Policies.Example2“/><usingprefix=“windows“namespace=“Microsoft.Policies.Windows“/></policyNamespaces>Windowscategory元素Windows组件节点下的类别节点或策略设置。假设要实现这一点，必需引用Windows根本文件中的类别Windows根本文件类别元素可以用作.admx类别元素或策略元素的父类别.admx文件中定义类别Windows根本文件，那么组策略对象编辑器或组策略治理掌握台将显示重复节点类别元素评估为唯一元素。由于每个.admxWindows根本文件的现有节点下，请将“windows:”前缀添加父类别元素的ref属性。该XML片段演示将例如类别放置在基于Windows根本文件类别元素的父类别现有Windows复制代码<categoryname=“SAMPLE“displayName=“$(string.SAMPLE)“<categoryname=“SAMPLE“displayName=“$(string.SAMPLE)“explainText=“$(string.SAMPLEHELP)“><parentCategoryref=“windows:WindowsComponents“/></category>该XML片段演示将例如策略设置放置在基于Windows根本文件类别元素的父类别下。在组策略对象编辑器中，这等同Windows<policyname=“Sample_NoParamPolicy“class=“Both“<policyname=“Sample_NoParamPolicy“class=“Both“displayName=“$(string.Sample_NoParamPolicy)“explainText=“$(string.Sample_NoParamPolicy_Help)“key=“Software\Policies\Examples“valueName=“Example1NoParam“><parentCategoryref=“windows:WindowsComponents“/><supportedOnref=“SUPPORTED_ProductOnly“/><enabledValue><decimalvalue=“1“/></enabledValue><disabledValue><decimalvalue=“0“/></disabledValue></policy>WindowssupportedOn元素Windows产品名称支持Windows根本文件中供给的信息.admx文件的这些产品名称Windows根本文件中的支持信息，必需进展以下操作：在supportedOn元素中，将“windows:”前缀添加到refWindows根本文件。引用WindowssupportedOn元素。假设使用无效元素名称，那么组策略对象编辑器将不显示任何支持信息，也不显示错误消息。该XMLWindows产品信息引用策略设置支持的文本。复制代码<policyname=“Sample_NoParamPolicy“class=“Both“<policyname=“Sample_NoParamPolicy“class=“Both“displayName=“$(string.Sample_NoParamPolicy)“explainText=“$(string.Sample_NoParamPolicy_Help)“key=“Software\Policies\Examples“valueName=“Example1NoParam“><parentCategoryref=“SAMPLE“/><supportedOnref=“windows:SUPPORTED_WindowsXP“/><enabledValue><decimalvalue=“1“/></enabledValue><disabledValue><decimalvalue=“0“/></disabledValue></policy>创立自定义根本ADMXWindowsServer2023假设您的组织打算创立大量.admx文件以显示在本地组策略编辑器或组策略治理掌握台中的单个类别节点下，则您将需要构建一个自定义的根本文件。具有预定义类别和受文本支持的单个自定义根本文件可以由多.admx文件引用。本局部供给了关于创立和引用自定义根本文件中定义的信息。创立自定义根本文件假设要就创立自定义根本文件进展争论Contoso,Ltd.公司作为例如.admx文件。他们可能期望来自全部文件的全部策略设置都放置在本地组策略编辑器或称为“contoso”GPMC的中心类别节点下。最简洁的做法是，Contoso,Ltd..admx文件，用于定义此中心类别。简而言之，用于定义称为“contoso”的中心类别的.admx文件类似于以下状况。复制代码<?xmlversion=“1.0“encoding=“utf-8“?><?xmlversion=“1.0“encoding=“utf-8“?><policyDefinitions“:///2023/XMLSchema“xmlns:xsd=“:///2023/XMLSchema““:///2023/XMLSchema-instance“xmlns:xsi=“:///2023/XMLSchema-instance“revision=“1.0“schemaVersion=“1.0“xmlns=“://schemas.microsoft/GroupPolicy/2023/07/PolicyDefinitions““://schemas.microsoft/GroupPolicy/2023/07/PolicyDefinitions“><policyNamespaces><targetprefix=“contoso“namespace=“Contoso.Policies.Contoso“/></policyNamespaces><resourcesminRequiredRevision=“1.0“/><categories><categoryname=“ContosoCompany“displayName=“$(string.ContosoCompany)“explainText=“$(string.ContosoCompany_Help)“/></categories></categories></policyDefinitions>对应的.adml文件会为中心类别供给经过本地化的显示字符串。此文件如下所示。复制代码<?xmlversion=“1.0“encoding=“utf-8“?><?xmlversion=“1.0“encoding=“utf-8“?><policyDefinitionResources“:///2023/XMLSchema“xmlns:xsd=“:///2023/XMLSchema““:///2023/XMLSchema-instance“xmlns:xsi=“:///2023/XMLSchema-instance“xmlns=“://schemas.microsoft/GroupPolicy/2023/07/PolicyDefinitions““://schemas.microsoft/GroupPolicy/2023/07/PolicyDefinitions“revision=“1.0“schemaVersion=“1.0“><displayName>ContosoCompanybasefile</displayName><description>ThisfilecontainstheContosoparentcategory.</description><resources><stringTable><stringid=“ContosoCompany“>Contoso</string><stringid=“ContosoCompany_Help“>ContainsContosocompanyspecificconfigurationsettings.</string></stringTable></resources></policyDefinitionResources>引用自定义根本文件Contoso.Policies.Contoso引用Contoso自定义根本文件。命名空间字符串区分大小写。假设要引用Contoso根本文件，请将使用policyNamespaces元素中。命名空间属性必需匹配自定义根本文件中定义的命名空间。前缀属性可以是您的.admx文件中唯一的任何名称。为了避开冲突，建议您使用自定义根本文件中的前缀属性〔假设可能。例如，example2.admxXMLpolicyNamespacesContoso根本文件。<policyNamespaces><targetprefix=“example2“namespace=“Microsoft.Policies.Example2“/><policyNamespaces><targetprefix=“example2“namespace=“Microsoft.Policies.Example2“/><usingprefix=“contoso“namespace=“Contoso.Policies.Contoso“/></policyNamespaces>留意在创立自定义根本文件时，您必需留意，引用此根本文件的全部治理员在其治理计算机上都将具有此文件。您还可在创立自定义根本文件时，您必需留意，引用此根本文件的全部治理员在其治理计算机上都将具有此文件。您还可以使用中心存储来保证全部治理员都将使用自定义根本文件。引用自定义类别元素您可以在本地组策略编辑器或GPMC的单个公司节点下显示您的类别节点或策略设置。要实现这一点，您可以引用自定义根本文件中的类别类别.admx文件中的任何类别元素或策略元素的父类别元素。假设您在自己的.admx文件中定义了类别元素名称，而不是引用自定义根本文件，则本地组策略编辑器或GPMC将会显示类别元素由本地组策略编辑器或GPMC评估为唯一的元素。由.admx文件都是在唯一的命名空间中创立的，因此这会导致产生重复节点。假设将您的类别节点放置在例如中创立的自定义根本文件的例如Contoso节点下，请将“contoso:”父类别ref属性中。此XML片段说明白将您的例如类别放置父类别下的状况，具体取决于本地组策略编辑器或GPMC中的Contoso组件节点。复制代码<categoryname=“SAMPLE“displayName=“$(string.SAMPLE)“<categoryname=“SAMPLE“displayName=“$(string.SAMPLE)“explainText=“$(string.SAMPLEHELP)“><parentCategoryref=“contoso:ContosoCompany“/></category>此XML父类别下的状况，具体取决于本地组策略编辑器或GPMC中的Contoso节点。复制代码<policyname=“Sample_NoParamPolicy“class=“Both“<policyname=“Sample_NoParamPolicy“class=“Both“displayName=“$(string.Sample_NoParamPolicy)“explainText=“$(string.Sample_NoParamPolicy_Help)“key=“Software\Policies\Examples“valueName=“Example1NoParam“><parentCategoryref=“contoso:ContosoCompany“/><supportedOnref=“SUPPORTED_ProductOnly“/><enabledValue><decimalvalue=“1“/></enabledValue><disabledValue><decimalvalue=“0“/></disabledValue></policy>.admx和.admlWindowsServer2023ADM文件使用PART语句定义策略设置的单个参数ADMX.adml文件中定义的。定义参数的数据类型或值的信息是在.admx文件中定义的。该局部将描述如何将.admx和.adml两个文件中的不同元素用于创立策略设置的参数定义。“复选框”参数的例如来演示.admx和.adml文件是如何协作定义参数的是从example2.admx和example2.adml例如文件中抽取的片段。有关更多将例如文件下载和导入到组策略对象编辑器的信息，请参阅样例文件。该XML“复选框”.admx文件的策略设置。复制代码<policyname=“Sample_Checkbox“class=“Machine“displayName=“$(string.Sample_Checkbox)“explainText=“$(string.Sample_Checkbox_Help)“presentation=“$(presentation.Sample_Checkbox)“key=“Software\Policies\Examples“><parentCategoryref=“CHECKBOXTWOTYPES_CATEGORY“/><supportedOnref=“windows:SUPPORTED_ProductOnly“/><elements><booleanid=“Checkbox_1“valueName=“Example2Checkbox1“><trueValue><decimalvalue=“1“/></trueValue><falseValue><decimalvalue=“0“/></falseValue></boolean><booleanid=“Checkbox_2“valueName=“Example2Checkbox2“><trueValue><decimalvalue=“0“/></trueValue><falseValue><decimalvalue=“1“/></falseValue></boolean></elements></policy>该XML.adml文件中对应的演示信息。<presentationid=“Sample_Checkbox“><checkBoxrefId=“Checkbox_1“>Firstcheckboxparameter</checkBox><presentationid=“Sample_Checkbox“><checkBoxrefId=“Checkbox_1“>Firstcheckboxparameter</checkBox><checkBoxrefId=“Checkbox_2“defaultChecked=“true“>Secondcheckboxparameter-checkedbydefault</checkBox></presentation></presentation>这两个XML.admx和.adml文件中参数定义之间协调的起点。我们将查看.admx和.adml文件之间的两个协调区域。第一个是在策略设置及其参数显示之间进展引用的顶级区域elements元素中数据presentation元素中参数定义之间进展的引用。presentation元素.admx文件中通过policy元素定义的策略设置通过policy元素的presentation属性引用.adml文件中的特定presentation元素。使用两个复选框的示例，您可以参阅定义为presentation=“$(presentation.Sample_Checkbox)“的presentation属性。presentation.Sample_Checkbox.adml文件presentationTable元素，该元素使用设置为Sample_Checkbox的id属性。上面供给了具有该idpresentation且该元素通过该XML片段在此重复。<presentationid=“Sample_Checkbox“><checkBoxrefId=“Checkbox_1“>Firstcheckboxparameter</checkBox><presentationid=“Sample_Checkbox“><checkBoxrefId=“Checkbox_1“>Firstcheckboxparameter</checkBox><checkBoxrefId=“Checkbox_2“defaultChecked=“true“>Secondcheckboxparameter-checkedbydefault</checkBox></presentation>您可能想了解组策略对象编辑器如何找到正确的.adml文件来查询presentation元素。答案很简洁。组策略对象编辑器会搜寻与.admx文件具有一样文件名的.adml文件。假设组策略对象编辑器无法为读取的每个.admx文件找到.adml.admxelements元素中定义的数据类型的数量以及类booleandecimatextenumitem和lis必需匹配.admlpresentation元素〔checkBox、textBox、decimalTextBox、comboBox、dropdownList和listBox〕中的定义的参数数量和类型。我们将在下一局部介绍如何使数据类型匹配参数定义。引用参数定义elements元素中定义的数据类型的数量与presentation元素中确定的参数数量相匹配。在我们的例如中，elementsboolean元素：复制代码<elements><elements><booleanid=“Checkbox_1“valueName=“Example2Checkbox1“>„</boolean><booleanid=“Checkbox_2“valueName=“Example2Checkbox2“>„</boolean></elements>presentationcheckBox元素：复制代码<presentationid=“Sample_Checkbox“><presentationid=“Sample_Checkbox“><checkBoxrefId=“Checkbox_1“>„</checkBox><checkBoxrefId=“Checkbox_2“defaultChecked=“true“>„</checkBox></presentation>boolean(2)与checkBox(2)booleanid属性匹配关联的checkBox元素〔refId属性对其进展引用。下表显示如何使.admx文件中的数据类型〔在我们的例如中为boolean元素〕与.adml文件中的参数定义〔在我们checkBox元素〕相匹配。.admx.admx文件中的数据类型.adml文件中的参数定义boolean元素checkBox元素texttextBox元素decimal元素(elements)decimalTextBox元素textcomboBox元素enum元素item元素dropdownList元素listlistBox元素ADM和ADMXWindowsServer2023ADM.admx.adml注释ADM文件语言版 ADM.admx.adml注释ADM文件语言版 resources与ADM文件不同，ADMX文件有嵌入式版本管本〔#If版本〕 minRequiredRevision理并且不与操作系统版本关联。ADM文件语言版 resources不适用resourcesminRequiredRevision本〔#If版本〕 minRequiredRevision供.admx和.adml文件版本之间的协调ADM文件语言版 schemaVersionschemaVersionschemaVersion.admx本〔#If版本〕和.admlADMX架构版本。WindowsVistaADMX1.0架构版本号。<!----><!---->对于ADM文件，将“;”后面的全部文本视为ADMXGPXML注释。字符串引用字符串不适用在ADM文件中(!!)字符串。.adm<Strings>不适用stringTableCLASS类不适用ADMX文件为用户定义的功能。通过“both”分类，可以创立适用于计算机和用户注册表项的单个策略定义。CATEGORY

categories 不适用 ADM文件假定类别嵌入在定义中ADMX文件.admxparentCategory元素“categories”元素category中定义单个类别。parentCategoryADM中允许的重复类别局部。

不同ADMX文件中不允许的重复类别局部。

不适用 假设一个.adm文件包含其他现有.adm文件中使用的重复“CATEGORY”条目，那么当组策略治理掌握台或本地组策略编辑器处理ADM文件时将合并策略设置ADMX文件具有唯一的命名空间在两个不同的.admx文件中定义同一“category”元素名称将导致类别显示两次。但对于.admx文件，您必需先定义一次“category”元素名称，然后再引用带有“using”元素的类别元素名称。SUPPORTED supportedOn 不适用POLICYpoliciespolicy

不适用 在.admx文件中，policies元素包含与策略设置对应的各个policy元素。PART elements presentation 在ADM文件中，PART语句指定各种策略设置选项，如下拉列表框、文本框和组策略治理单元下方窗格中的文字ADMX文件将一个策略设.admxelements.admlpresentation元素。CHECKBOXTEXT

boolean不适用

checkboxtext .adml文件中的text元素供给用做参数文本提示的字符串。EDITTEXTNUMERICCOMBOBOXDROPDOWNLIST

textdecimaltext

textBoxdecimalTextBoxcomboBoxdropdownListLISTBOXVALUEONVALUEOFFACTIONLISTONACTIONLISTOFFKEYNAMEEXPLAINVALUENAMECLIENTEXTEnd

listenabledValuedisabledValueenabledListdisabledListkeyexplainTextvalueNameclientExtension不适用

listBox不适用不适用不适用不适用不适用不适用不适用不适用不适用 XML语法包括其全部元素的终止。不需要使用特别语法来终止元素。DEFCHECKED\n或\n\n

defaultChecked在字符串定义中使用换行符或空行。EXPLAIN文本的最大字符串长度CATEGORYEXPLAIN文本的最大字符串长度EDITTEXT字符串的最大字符串长度样例文件

不适用 只受可用内存的限制。不适用 只受可用内存的限制。不适用 EDITTEXT字符串的最大字符串长度为1023个字符。WindowsServer2023ADM文件例如〔example1_SinglePolicySetting.adm和example2.adm〕ADMX文件。这些文件中包含的组策略设置功能齐全。通过使用这些例如文件显示的全部策略设置都将配置注册表项“[HKLM|HKCU]\Software\Policies\Examples”下的注册表设置。例如文件可加载到基于WindowsVistaWindowsServer