组策略 ADMX 语法参考指南Word文件下载.docx
- 文档编号:16442550
- 上传时间:2022-11-23
- 格式:DOCX
- 页数:19
- 大小:37.16KB
组策略 ADMX 语法参考指南Word文件下载.docx
《组策略 ADMX 语法参考指南Word文件下载.docx》由会员分享,可在线阅读,更多相关《组策略 ADMX 语法参考指南Word文件下载.docx(19页珍藏版)》请在冰豆网上搜索。
ADMX文件基于XML。
您应该对XML语言结构和语法有一些基本了解。
至少应该有以下了解:
∙格式正确的XML文档的定义。
∙XML元素。
∙XML属性。
∙XML命名空间。
∙XML区分大小写。
必须使用与本参考中所述相同的大小写格式输入所有元素和属性。
可以使用任何可与XML兼容的编辑器(可以像记事本一样基本)创建和编辑ADMX文件。
ADMX架构
在WindowsVista中,本地组策略对象编辑器和组策略管理控制台使用ADMX文件显示基于注册表的策略设置。
ADMX文件是基于XML的文件,定义为一个中性语言的文件(.admx)和相关联的ADMX从属语言文件(.adml)的集合。
ADMX架构定义了ADMX文件的语法。
ADMX架构可以从Microsoft下载中心(
.admx和.adml文件结构
更新时间:
2007年4月
为了支持策略设置的多语言显示,必须将ADMX文件结构分成两种文件类型:
∙.admx是中性语言文件,用于描述组策略管理控制台(GPMC)或本地组策略编辑器中显示的类别和管理模板策略设置的结构。
∙.adml是一组从属语言文件,用于提供GPMC或本地组策略编辑器中显示的本地化部分。
每个.adml文件都代表要支持的一种语言。
中性语言文件(.admx)结构
中性语言文件.admx按GPMC或本地组策略编辑器中显示的类别确定策略设置的数量和类型及其位置。
.admx文件分为七个主要部分:
∙XML声明,为了验证为基于XML的文件而需要。
∙policyDefinitions元素,包含.admx文件的其他所有元素。
∙policyNamespaces元素,定义该.admx文件的唯一命名空间。
如果该.admx文件将引用其他.admx文件中定义的category元素,那么policyNamespaces元素也提供到外部文件命名空间的映射。
有关映射到外部文件命名空间的详细信息,请参阅引用Windows基本ADMX文件或创建自定义基本ADMX文件。
∙resources元素(.admx),指定特定语言资源的要求;
相关.adml文件的最低版本要求。
∙supportedOn元素,指定对本地化文本字符串的引用,该字符串定义特定策略设置影响的操作系统或应用程序。
有关映射到Windows的supportedOn文本的详细信息,请参阅引用Windows基本ADMX文件。
∙categories元素,指定GPMC或本地组策略编辑器中将在其下显示该.admx文件中的策略设置的类别。
如果在其他.admx文件中指定已存在的类别名称,那么将会创建重复节点。
有关引用之前定义的类别名称以避免重复节点的详细信息,请参阅引用Windows基本ADMX文件或创建自定义基本ADMX文件。
∙policies元素,包含各个策略设置定义。
语言资源文件(.adml)结构
语言资源文件.adml提供中性语言文件所需的特定语言信息。
然后,中性语言文件将引用语言资源文件的特定部分,以便GPMC或本地组策略编辑器以正确的语言显示策略设置。
.adml文件包含以下主要部分:
∙policyDefinitionResources元素,包含.adml文件的其他所有元素。
∙resources元素(.adml),包含针对指定语言的stringTable元素和presentationTable元素。
按照ADMX架构的要求,在.adml文件中必须以stringTableelement后面接presentationTableelement的特定顺序定义这两个元素。
如果这两个元素的顺序颠倒,那么组策略工具的分析程序将显示错误。
有关创建ADMX文件的最佳实践
这是创作ADMX文件时所使用的一些最佳做法。
1.所有ADMX文件都会创作为一个中性语言文件(.admx)和一组从属语言文件,这些文件将针对所有受支持的语言(.adml)进行本地化。
2.若要避免在组策略管理控制台(GPMC)或本地组策略编辑器中显示重复节点,那么不要使用之前已在父类别下定义的类别名称。
例如,如果公司创建了具有基于公司名称的类别的.admx文件,那么创建第二个具有该公司名称类别的.admx文件将导致在GPMC或本地组策略编辑器中创建两个名称相同的节点。
而是创建一个公司的所有.admx文件都将引用的自定义基本文件。
有关更多信息,请参阅创建自定义基本ADMX文件。
3.若要避免循环引用,一个.admx文件不应该引用另一个.admx文件的类别元素。
而且应该将组件基本类别放在单独的基本文件中,构建该基本文件是为了从多个.admx文件进行引用。
4..admx文件的每个策略命名空间都必须是唯一的。
策略命名空间是在.admx文件的target元素中定义的。
5.XML区分大小写。
引用Windows基本ADMX文件
Windows基本文件windows.admx为Windows产品提供了预定义类别和文本支持。
该部分提供了引用windows.admx文件中的定义以便在.admx文件中使用的信息。
引用Windows基本文件
使用唯一的命名空间Microsoft.Policies.Windows引用Windows基本文件。
命名空间字符串区分大小写。
若要引用Windows基本文件,那么将使用元素包含在policyNamespaces元素中。
命名空间属性必须匹配Windows基本文件中定义的命名空间。
尽管前缀属性可以是.admx文件中唯一的任一名称,但为了避免混淆,建议使用Windows基本文件中的前缀属性字符串。
例如,example2.admx文件中的该XML片段既定义其命名空间,也在policyNamespaces元素中引用Windows基本文件。
复制代码
<
policyNamespaces>
targetprefix="
example2"
namespace="
Microsoft.Policies.Example2"
/>
usingprefix="
windows"
Microsoft.Policies.Windows"
/policyNamespaces>
引用Windowscategory元素
可以显示组策略对象编辑器或组策略管理控制台的现有Windows组件节点下的类别节点或策略设置。
若要实现这一点,必须引用Windows基本文件中的类别元素。
Windows基本文件类别元素可以用作.admx文件中的任一类别元素或策略元素的父类别元素。
如果在自己的.admx文件中定义类别元素名称,而不引用Windows基本文件,那么组策略对象编辑器或组策略管理控制台将显示重复节点。
出现这种情况的原因是组策略对象编辑器将不同命名空间中定义的类别元素评估为唯一元素。
由于每个.admx文件都是在唯一的命名空间中创建的,因此这会导致产生重复节点。
若要将类别节点放在Windows基本文件的现有节点下,请将“windows:
”前缀添加到父类别元素的ref属性。
该XML片段演示将示例类别放置在基于Windows基本文件类别元素的父类别下。
在组策略对象编辑器中,这等同于在现有Windows组件节点下显示示例类别节点。
categoryname="
SAMPLE"
displayName="
$(string.SAMPLE)"
explainText="
$(string.SAMPLEHELP)"
>
parentCategoryref="
windows:
WindowsComponents"
/category>
该XML片段演示将示例策略设置放置在基于Windows基本文件类别元素的父类别下。
在组策略对象编辑器中,这等同于在现有Windows组件节点下显示示例策略设置。
policyname="
Sample_NoParamPolicy"
class="
Both"
$(string.Sample_NoParamPolicy)"
$(string.Sample_NoParamPolicy_Help)"
key="
Software\Policies\Examples"
valueName="
Example1NoParam"
supportedOnref="
SUPPORTED_ProductOnly"
enabledValue>
decimalvalue="
1"
/enabledValue>
disabledValue>
0"
/disabledValue>
/policy>
引用WindowssupportedOn元素
Windows产品名称支持Windows基本文件中提供的信息。
可以参考.admx文件的这些产品名称。
为了使用Windows基本文件中的支持信息,必须进行以下操作:
∙在supportedOn元素中,将“windows:
”前缀添加到ref属性中以引用Windows基本文件。
∙引用Windows基本文件中定义的supportedOn元素。
如果使用无效元素名称,那么组策略对象编辑器将不显示任何支持信息,也不显示错误消息。
该XML片段演示使用现有Windows产品信息引用策略设置支持的文本。
SUPPORTED_WindowsXP"
创建自定义基本ADMX文件
如果您的组织计划创建大量.admx文件以显示在本地组策略编辑器或组策略管理控制台中的单个类别节点下,则您将需要构建一个自定义的基本文件。
具有预定义类别和受文本支持的单个自定义基本文件可以由多个.admx文件引用。
本部分提供了关于创建和引用自定义基本文件中定义的信息。
创建自定义基本文件
若要就创建自定义基本文件进行讨论,我们将Contoso,Ltd.公司作为示例,此公司希望创建大量不同的.admx文件。
他们可能希望来自所有文件的所有策略设置都放置在本地组策略编辑器或称为“contoso”的GPMC的中心类别节点下。
最简单的做法是,Contoso,Ltd.管理员可以选择创建一个自定义的基本.admx文件,用于定义此中心类别。
简而言之,用于定义称为“contoso”的中心类别的.admx文件类似于下列情况。
?
xmlversion="
1.0"
encoding="
utf-8"
policyDefinitionsxmlns:
xsd="
http:
//www.w3.org/2001/XMLSchema"
xmlns:
xsi="
//www.w3.org/2001/XMLSchema-instance"
revision="
schemaVersion="
xmlns=
"
contoso"
Contoso.Policies.Contoso"
resourcesminRequiredRevision="
categories>
ContosoCompany"
$(string.ContosoCompany)"
$(string.ContosoCompany_Help)"
/categories>
/policyDefinitions>
对应的.adml文件会为中心类别提供经过本地化的显示字符串。
此文件如下所示。
policyDefinitionResourcesxmlns:
displayName>
ContosoCompanybasefile<
/displayName>
description>
ThisfilecontainstheContosoparentcategory.
/description>
resources>
stringTable>
stringid="
Contoso<
/string>
ContosoCompany_Help"
ContainsContosocompanyspecificconfigurationsettings.<
/stringTable>
/resources>
/policyDefinitionResources>
引用自定义基本文件
使用唯一的命名空间Contoso.Policies.Contoso引用Contoso自定义基本文件。
若要引用Contoso基本文件,请将使用属性包含在policyNamespaces元素中。
命名空间属性必须匹配自定义基本文件中定义的命名空间。
前缀属性可以是您的.admx文件中唯一的任何名称。
为了避免冲突,建议您使用自定义基本文件中的前缀属性(如果可能)。
例如,example2.admx文件中的该XML片段既定义其命名空间,也在policyNamespaces元素中引用Contoso基本文件。
注意
在创建自定义基本文件时,您必须注意,引用此基本文件的所有管理员在其管理计算机上都将具有此文件。
您还可以使用中央存储来保证所有管理员都将使用自定义基本文件。
引用自定义类别元素
您可以在本地组策略编辑器或GPMC的单个公司节点下显示您的类别节点或策略设置。
要实现这一点,您可以引用自定义基本文件中的类别元素。
自定义基本文件类别元素可以用作.admx文件中的任何类别元素或策略元素的父类别元素。
如果您在自己的.admx文件中定义了类别元素名称,而不是引用自定义基本文件,则本地组策略编辑器或GPMC将会显示重复节点。
会发生这种情况是因为在其他命名空间中定义的类别元素由本地组策略编辑器或GPMC评估为唯一的元素。
若将您的类别节点放置在示例中创建的自定义基本文件的示例Contoso节点下,请将“contoso:
”前缀添加到父类别元素的ref属性中。
此XML片段说明了将您的示例类别放置在父类别下的情况,具体取决于本地组策略编辑器或GPMC中的Contoso组件节点。
contoso:
此XML片段说明了将您的示例策略设置放置在父类别下的情况,具体取决于本地组策略编辑器或GPMC中的Contoso节点。
将.admx和.adml参数信息相关联
ADM文件使用PART语句定义策略设置的单个参数。
在ADMX语法中,控制参数演示或本地化显示的元素是在.adml文件中定义的。
定义参数的数据类型或值的信息是在.admx文件中定义的。
该部分将描述如何将.admx和.adml两个文件中的不同元素用于创建策略设置的参数定义。
我们将使用为单个策略设置创建两个“复选框”参数的示例来演示.admx和.adml文件是如何协作定义参数的。
该示例是从example2.admx和example2.adml示例文件中抽取的片段。
有关更多将示例文件下载和导入到组策略对象编辑器的信息,请参阅样例文件。
该XML片段显示了包含两个“复选框”参数的.admx文件的策略设置。
Sample_Checkbox"
Machine"
$(string.Sample_Checkbox)"
$(string.Sample_Checkbox_Help)"
presentation="
$(presentation.Sample_Checkbox)"
CHECKBOXTWOTYPES_CATEGORY"
elements>
booleanid="
Checkbox_1"
Example2Checkbox1"
trueValue>
/trueValue>
falseValue>
/falseValue>
/boolean>
Checkbox_2"
Example2Checkbox2"
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 组策略 ADMX 语法参考指南 策略 语法 参考 指南
![提示](https://static.bdocx.com/images/bang_tan.gif)