組策略ADM語法參考指南

ADMX語法參考指南WindowsServer2023本參考指南供給了關(guān)于創(chuàng)立和編輯自定義ADMX文件的信息。這些基于XML的文件允許治理員在組策略治理掌握臺中或本地組策略編輯器中創(chuàng)立用戶界面以顯示組策略設(shè)置。閱讀本文檔的方法對于期望初步了解ADMX格式的人而言，可以從本參考指南中的概念主題開頭入門。建議閱讀以下主題：ADMXADMX.admx和.adml文件構(gòu)造有關(guān)創(chuàng)立ADMX文件的最正確實(shí)踐引用WindowsADMX文件ADMX文件將.admx和.adml參數(shù)信息相關(guān)聯(lián)比較ADM和ADMX樣例文件在您生疏ADMX文件和ADMXADMX語法局部用作技術(shù)參考.admx.admlADMX備注備注本文檔在引用ADMX文件的不同局部時(shí)，將會使用以下規(guī)章。當(dāng)引用WindowsVista注冊表設(shè)置的治理模板文件的“ADMX“.admx文件”用附屬語言的治理模板文件時(shí)將會引用“.admlADMXWindowsServer2023ADMX文件基于XMLXML語言構(gòu)造和語法有一些根本了解。至少應(yīng)當(dāng)有以下了解：格式正確的XML文檔的定義。XMLXMLXMLXML區(qū)分大小寫。必需使用與本參考中所述一樣的大小寫格式輸入全部元素和屬性。可以使用任何可與XML兼容的編輯器〔可以像記事本一樣根本〕ADMX文件。ADMXWindowsServer2023在WindowsVistaADMX文件顯示基于注冊表的策略設(shè)置ADMX文件是基于XML的文件，定義為一個(gè)中性語言的文件(.admx)ADMX(.adml)ADMXADMXADMXMicrosoft“://go.microsoft/fwlink/?LinkId=8609)4“.admx和.adml更時(shí)間:20234WindowsServer2023為了支持策略設(shè)置的多語言顯示，必需將ADMX文件構(gòu)造分成兩種文件類型：.admx是中性語言文件，用于描述組策略治理掌握臺(GPMC)或本地組策略編輯器中顯示的類別和治理模板策略設(shè)置的構(gòu)造。.adml是一組附屬語言文件，用于供給GPMC.adml文件都代表要支持的一種語言。(.admx)構(gòu)造中性語言文件.admx按GPMC或本地組策略編輯器中顯示的類別確定策略設(shè)置的數(shù)量和類型及其位置。.admxXML聲明XML的文件而需要。policyDefinitions，包含.admx文件的其他全部元素。policyNamespaces，定義該.admx文件的唯一命名空間。假設(shè)該.admx文件將引用其他.admx文件中定義的category元素，那么policyNamespaces元素也供給到外部文件命名空間的映射。有關(guān)映射到外Windows根本ADMX或ADMX。resources元素(.admx)，指定特定語言資源的要求；相關(guān).adml文件的最低版本要求。supportedOn元素，指定對本地化文本字符串的引用，該字符串定義特定策略設(shè)置影響的操作系統(tǒng)或應(yīng)用程Windows的supportedOnWindowsADMX文件。categories元素GPMC或本地組策略編輯器中將在其下顯示該.admx文件中的策略設(shè)置的類別。如果在其他.admx文件中指定已存在的類別名稱，那么將會創(chuàng)立重復(fù)節(jié)點(diǎn)。有關(guān)引用之前定義的類別名稱以避開WindowsADMX文件或ADMX文件。policies元素，包含各個(gè)策略設(shè)置定義。(.adml)構(gòu)造語言資源文件.adml供給中性語言文件所需的特定語言信息。然后，中性語言文件將引用語言資源文件的特定局部，GPMC.admlXML聲明XML的文件而需要。policyDefinitionResources.adml文件的其他全部元素。resources元素(.adml)，包含針對指定語言的stringTable元素和presentationTable。依據(jù)ADMX.admlstringTableelement后面接presentationTableelement的特定挨次定義這兩個(gè)元素。假設(shè)這兩個(gè)元素的挨次顛倒，那么組策略工具的分析程序?qū)@示錯(cuò)誤。ADMX文件的最正確實(shí)踐WindowsServer2023這是創(chuàng)作ADMX文件時(shí)所使用的一些最正確做法。全部ADMX文件都會創(chuàng)作為一個(gè)中性語言文件(.admx)和一組附屬語言文件，這些文件將針對全部受支持的語言(.adml)假設(shè)要避開在組策略治理掌握臺(GPMC)或本地組策略編輯器中顯示重復(fù)節(jié)點(diǎn)，那么不要使用之前已在父類別下.admx文件，那么創(chuàng)立其次個(gè)具有該公司名稱類別的.admx文件將導(dǎo)致在GPMC或本地組策略編輯器中創(chuàng)立兩個(gè)名稱一樣的節(jié)點(diǎn)。而是創(chuàng)立一個(gè)公司的全部.admx文件都將引用的自定義根本文件。有關(guān)更多信息，請參ADMX文件。.admx文件不應(yīng)當(dāng)引用另一個(gè).admx文件的類別元素。而且應(yīng)當(dāng)將組件根本類別.admx文件進(jìn)展引用。有關(guān)更多信息，請參創(chuàng)立自ADMX。.admx.admx文件的target元素中定義的。XML區(qū)分大小寫。必需使用與本參考中所述一樣的大小寫格式輸入全部元素和屬性。Windows根本ADMX文件WindowsServer2023Windows根本文件windows.admx為Windowswindows.admx.admxWindows根本文件Microsoft.Policies.Windows引用Windows根本文件。命名空間字符串區(qū)分大小寫。假設(shè)要引用Windows使用policyNamespaces命名空間屬性必需匹配Windows根本文件中定義的命名空間前綴屬性可以是.admx文件中唯一的任一名稱Windows根本文件中的前綴屬性字符串。例如，example2.admxXMLpolicyNamespacesWindows根本文件。復(fù)制代碼<policyNamespaces><policyNamespaces><targetprefix=“example2“namespace=“Microsoft.Policies.Example2“/><usingprefix=“windows“namespace=“Microsoft.Policies.Windows“/></policyNamespaces>Windowscategory元素Windows組件節(jié)點(diǎn)下的類別節(jié)點(diǎn)或策略設(shè)置。假設(shè)要實(shí)現(xiàn)這一點(diǎn)，必需引用Windows根本文件中的類別Windows根本文件類別元素可以用作.admx類別元素或策略元素的父類別.admx文件中定義類別Windows根本文件，那么組策略對象編輯器或組策略治理掌握臺將顯示重復(fù)節(jié)點(diǎn)類別元素評估為唯一元素。由于每個(gè).admxWindows根本文件的現(xiàn)有節(jié)點(diǎn)下，請將“windows:”前綴添加父類別元素的ref屬性。該XML片段演示將例如類別放置在基于Windows根本文件類別元素的父類別現(xiàn)有Windows復(fù)制代碼<categoryname=“SAMPLE“displayName=“$(string.SAMPLE)“<categoryname=“SAMPLE“displayName=“$(string.SAMPLE)“explainText=“$(string.SAMPLEHELP)“><parentCategoryref=“windows:WindowsComponents“/></category>該XML片段演示將例如策略設(shè)置放置在基于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產(chǎn)品名稱支持Windows根本文件中供給的信息.admx文件的這些產(chǎn)品名稱Windows根本文件中的支持信息，必需進(jìn)展以下操作：在supportedOn元素中，將“windows:”前綴添加到refWindows根本文件。引用WindowssupportedOn元素。假設(shè)使用無效元素名稱，那么組策略對象編輯器將不顯示任何支持信息，也不顯示錯(cuò)誤消息。該XMLWindows產(chǎn)品信息引用策略設(shè)置支持的文本。復(fù)制代碼<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>創(chuàng)立自定義根本ADMXWindowsServer2023假設(shè)您的組織打算創(chuàng)立大量.admx文件以顯示在本地組策略編輯器或組策略治理掌握臺中的單個(gè)類別節(jié)點(diǎn)下，則您將需要構(gòu)建一個(gè)自定義的根本文件。具有預(yù)定義類別和受文本支持的單個(gè)自定義根本文件可以由多.admx文件引用。本局部供給了關(guān)于創(chuàng)立和引用自定義根本文件中定義的信息。創(chuàng)立自定義根本文件假設(shè)要就創(chuàng)立自定義根本文件進(jìn)展?fàn)幷揅ontoso,Ltd.公司作為例如.admx文件。他們可能期望來自全部文件的全部策略設(shè)置都放置在本地組策略編輯器或稱為“contoso”GPMC的中心類別節(jié)點(diǎn)下。最簡潔的做法是，Contoso,Ltd..admx文件，用于定義此中心類別。簡而言之，用于定義稱為“contoso”的中心類別的.admx文件類似于以下狀況。復(fù)制代碼<?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>對應(yīng)的.adml文件會為中心類別供給經(jīng)過本地化的顯示字符串。此文件如下所示。復(fù)制代碼<?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自定義根本文件。命名空間字符串區(qū)分大小寫。假設(shè)要引用Contoso根本文件，請將使用policyNamespaces元素中。命名空間屬性必需匹配自定義根本文件中定義的命名空間。前綴屬性可以是您的.admx文件中唯一的任何名稱。為了避開沖突，建議您使用自定義根本文件中的前綴屬性〔假設(shè)可能。例如，example2.admxXMLpolicyNamespacesContoso根本文件。<policyNamespaces><targetprefix=“example2“namespace=“Microsoft.Policies.Example2“/><policyNamespaces><targetprefix=“example2“namespace=“Microsoft.Policies.Example2“/><usingprefix=“contoso“namespace=“Contoso.Policies.Contoso“/></policyNamespaces>留意在創(chuàng)立自定義根本文件時(shí)，您必需留意，引用此根本文件的全部治理員在其治理計(jì)算機(jī)上都將具有此文件。您還可在創(chuàng)立自定義根本文件時(shí)，您必需留意，引用此根本文件的全部治理員在其治理計(jì)算機(jī)上都將具有此文件。您還可以使用中心存儲來保證全部治理員都將使用自定義根本文件。引用自定義類別元素您可以在本地組策略編輯器或GPMC的單個(gè)公司節(jié)點(diǎn)下顯示您的類別節(jié)點(diǎn)或策略設(shè)置。要實(shí)現(xiàn)這一點(diǎn)，您可以引用自定義根本文件中的類別類別.admx文件中的任何類別元素或策略元素的父類別元素。假設(shè)您在自己的.admx文件中定義了類別元素名稱，而不是引用自定義根本文件，則本地組策略編輯器或GPMC將會顯示類別元素由本地組策略編輯器或GPMC評估為唯一的元素。由.admx文件都是在唯一的命名空間中創(chuàng)立的，因此這會導(dǎo)致產(chǎn)生重復(fù)節(jié)點(diǎn)。假設(shè)將您的類別節(jié)點(diǎn)放置在例如中創(chuàng)立的自定義根本文件的例如Contoso節(jié)點(diǎn)下，請將“contoso:”父類別ref屬性中。此XML片段說明白將您的例如類別放置父類別下的狀況，具體取決于本地組策略編輯器或GPMC中的Contoso組件節(jié)點(diǎn)。復(fù)制代碼<categoryname=“SAMPLE“displayName=“$(string.SAMPLE)“<categoryname=“SAMPLE“displayName=“$(string.SAMPLE)“explainText=“$(string.SAMPLEHELP)“><parentCategoryref=“contoso:ContosoCompany“/></category>此XML父類別下的狀況，具體取決于本地組策略編輯器或GPMC中的Contoso節(jié)點(diǎn)。復(fù)制代碼<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語句定義策略設(shè)置的單個(gè)參數(shù)ADMX.adml文件中定義的。定義參數(shù)的數(shù)據(jù)類型或值的信息是在.admx文件中定義的。該局部將描述如何將.admx和.adml兩個(gè)文件中的不同元素用于創(chuàng)立策略設(shè)置的參數(shù)定義?！皬?fù)選框”參數(shù)的例如來演示.admx和.adml文件是如何協(xié)作定義參數(shù)的是從example2.admx和example2.adml例如文件中抽取的片段。有關(guān)更多將例如文件下載和導(dǎo)入到組策略對象編輯器的信息，請參閱樣例文件。該XML“復(fù)選框”.admx文件的策略設(shè)置。復(fù)制代碼<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文件中對應(yīng)的演示信息。<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>這兩個(gè)XML.admx和.adml文件中參數(shù)定義之間協(xié)調(diào)的起點(diǎn)。我們將查看.admx和.adml文件之間的兩個(gè)協(xié)調(diào)區(qū)域。第一個(gè)是在策略設(shè)置及其參數(shù)顯示之間進(jìn)展引用的頂級區(qū)域elements元素中數(shù)據(jù)presentation元素中參數(shù)定義之間進(jìn)展的引用。presentation元素.admx文件中通過policy元素定義的策略設(shè)置通過policy元素的presentation屬性引用.adml文件中的特定presentation元素。使用兩個(gè)復(fù)選框的示例，您可以參閱定義為presentation=“$(presentation.Sample_Checkbox)“的presentation屬性。presentation.Sample_Checkbox.adml文件presentationTable元素，該元素使用設(shè)置為Sample_Checkbox的id屬性。上面供給了具有該idpresentation且該元素通過該XML片段在此重復(fù)。<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文件。假設(shè)組策略對象編輯器無法為讀取的每個(gè).admx文件找到.adml.admxelements元素中定義的數(shù)據(jù)類型的數(shù)量以及類booleandecimatextenumitem和lis必需匹配.admlpresentation元素〔checkBox、textBox、decimalTextBox、comboBox、dropdownList和listBox〕中的定義的參數(shù)數(shù)量和類型。我們將在下一局部介紹如何使數(shù)據(jù)類型匹配參數(shù)定義。引用參數(shù)定義elements元素中定義的數(shù)據(jù)類型的數(shù)量與presentation元素中確定的參數(shù)數(shù)量相匹配。在我們的例如中，elementsboolean元素：復(fù)制代碼<elements><elements><booleanid=“Checkbox_1“valueName=“Example2Checkbox1“>?</boolean><booleanid=“Checkbox_2“valueName=“Example2Checkbox2“>?</boolean></elements>presentationcheckBox元素：復(fù)制代碼<presentationid=“Sample_Checkbox“><presentationid=“Sample_Checkbox“><checkBoxrefId=“Checkbox_1“>?</checkBox><checkBoxrefId=“Checkbox_2“defaultChecked=“true“>?</checkBox></presentation>boolean(2)與checkBox(2)booleanid屬性匹配關(guān)聯(lián)的checkBox元素〔refId屬性對其進(jìn)展引用。下表顯示如何使.admx文件中的數(shù)據(jù)類型〔在我們的例如中為boolean元素〕與.adml文件中的參數(shù)定義〔在我們checkBox元素〕相匹配。.admx.admx文件中的數(shù)據(jù)類型.adml文件中的參數(shù)定義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理并且不與操作系統(tǒng)版本關(guān)聯(lián)。ADM文件語言版 resources不適用resourcesminRequiredRevision本〔#If版本〕 minRequiredRevision供.admx和.adml文件版本之間的協(xié)調(diào)ADM文件語言版 schemaVersionschemaVersionschemaVersion.admx本〔#If版本〕和.admlADMX架構(gòu)版本。WindowsVistaADMX1.0架構(gòu)版本號。<!----><!---->對于ADM文件，將“;”后面的全部文本視為ADMXGPXML注釋。字符串引用字符串不適用在ADM文件中(!!)字符串。.adm<Strings>不適用stringTableCLASS類不適用ADMX文件為用戶定義的功能。通過“both”分類，可以創(chuàng)立適用于計(jì)算機(jī)和用戶注冊表項(xiàng)的單個(gè)策略定義。CATEGORY

categories 不適用 ADM文件假定類別嵌入在定義中ADMX文件.admxparentCategory元素“categories”元素category中定義單個(gè)類別。parentCategoryADM中允許的重復(fù)類別局部。

不同ADMX文件中不允許的重復(fù)類別局部。

不適用 假設(shè)一個(gè).adm文件包含其他現(xiàn)有.adm文件中使用的重復(fù)“CATEGORY”條目，那么當(dāng)組策略治理掌握臺或本地組策略編輯器處理ADM文件時(shí)將合并策略設(shè)置ADMX文件具有唯一的命名空間在兩個(gè)不同的.admx文件中定義同一“category”元素名稱將導(dǎo)致類別顯示兩次。但對于.admx文件，您必需先定義一次“category”元素名稱，然后再引用帶有“using”元素的類別元素名稱。SUPPORTED supportedOn 不適用POLICYpoliciespolicy

不適用 在.admx文件中，policies元素包含與策略設(shè)置對應(yīng)的各個(gè)policy元素。PART elements presentation 在ADM文件中，PART語句指定各種策略設(shè)置選項(xiàng)，如下拉列表框、文本框和組策略治理單元下方窗格中的文字ADMX文件將一個(gè)策略設(shè).admxelements.admlpresentation元素。CHECKBOXTEXT

boolean不適用

checkboxtext .adml文件中的text元素供給用做參數(shù)文本提示的字符串。EDITTEXTNUMERICCOMBOBOXDROPDOWNLIST

textdecimaltext

textBoxdecimalTextBoxcomboBoxdropdownListLISTBOXVALUEONVALUEOFFACTIONLISTONACTIONLISTOFFKEYNAMEEXPLAINVALUENAMECLIENTEXTEnd

listenabledValuedisabledValueenabledListdisabledListkeyexplainTextvalueNameclientExtension不適用

listBox不適用不適用不適用不適用不適用不適用不適用不適用不適用 XML語法包括其全部元素的終止。不需要使用特別語法來終止元素。DEFCHECKED\n或\n\n

defaultChecked在字符串定義中使用換行符或空行。EXPLAIN文本的最大字符串長度CATEGORYEXPLAIN文本的最大字符串長度EDITTEXT字符串的最大字符串長度樣例文件

不適用 只受可用內(nèi)存的限制。不適用 只受可用內(nèi)存的限制。不適用 EDITTEXT字符串的最大字符串長度為1023個(gè)字符。WindowsServer2023ADM文件例如〔example1_SinglePolicySetting.adm和example2.adm〕ADMX文件。這些文件中包含的組策略設(shè)置功能齊全。通過使用這些例如文件顯示的全部策略設(shè)置都將配置注冊表項(xiàng)“[HKLM|HKCU]\Software\Policies\Examples”下的注冊表設(shè)置。例如文件可加載到基于WindowsVistaWindowsServer