ADMXIngestion (referência do Designer de Configuração do Windows)
A partir de Windows 10, versão 1703, você pode importar (ingerir) Política de Grupo modelos administrativos (arquivos ADMX) e configurar valores para políticas apoiadas pelo ADMX em um pacote de provisionamento. Para ver quais tipos de políticas com suporte ADMX podem ser aplicados, consulte Visão geral de configuração de política de app Win32 e de Ponte de Desktop.
As configurações em ConfigADMXInstalledPolicy também permitem que você defina valores para políticas no arquivo ADMX importado.
As configurações em ConfigOperations especificam o arquivo ADMX a ser importado.
Importante
Somente as políticas de escopo do dispositivo (class="Machine" ou class="Both") podem ser definidas usando um pacote de provisionamento.
Aplicável a
| Configuração de grupos | Cliente Windows | Surface Hub | HoloLens | IoT Enterprise |
|---|---|---|---|---|
| ConfigADMXInstalledPolicy | ✅ | ✅ | ||
| ConfigOperations | ✅ | ✅ |
ConfigOperations
Use ConfigOperations para importar políticas do ADMX de um arquivo ADMX.
Insira um nome de app e clique em Adicionar. Pode ser qualquer nome que você atribua, portanto, escolha algo descritivo para ajudá-lo a identificar sua finalidade. Por exemplo, se você estiver importando o ADMX para Chromium Edge, insira um nome de aplicativo. Exemplo
MSEdgeEfficiencyModeSelecione o nome do app no painel Personalizações, selecione um tipo de configuração e então clique em Adicionar. As opções, Política e Preferência, não têm impacto sobre o comportamento das configurações e são fornecidas apenas para sua conveniência caso você queira categorizar as configurações adicionadas.
Selecione o tipo de configuração no painel Personalizações. No campo AdmxFileUid, insira o nome do arquivo ADMX ou uma ID exclusiva para o arquivo e então clique em Adicionar. O AdmxFileUid pode ser qualquer cadeia de caracteres, mas deve ser exclusivo no pacote de provisionamento. O uso do nome do arquivo ADMX ajudará você a identificar o arquivo no futuro. Exemplo
MSEdgeEfficiencyModeObservação
Manter o AdmxFileUid e o AppName o mesmo ajudará a evitar erros de autorização.
Selecione o AdmxFileUid no painel Personalizações e cole o conteúdo do arquivo ADMX no campo de texto. Antes de copiar o conteúdo do arquivo ADMX, você deverá convertê-lo em uma única linha. Consulte Converter multilinhas em linha única para obter instruções.
Observação
Quando você tiver um arquivo ADMX grande, convém incluir somente configurações específicas. Em vez de colar todo o arquivo ADMX, você pode colar apenas uma ou mais políticas específicas (depois de convertê-las em uma linha única).
Exemplo, EfficiencyMode
<policy class="Both" displayName="$(string.EfficiencyMode)" explainText="$(string.EfficiencyMode_Explain)" key="Software\Policies\Microsoft\Edge" name="EfficiencyMode" presentation="$(presentation.EfficiencyMode)"> <parentCategory ref="Performance"/> <supportedOn ref="SUPPORTED_WIN7_V96"/> <elements> <enum id="EfficiencyMode" valueName="EfficiencyMode"> <item displayName="$(string.EfficiencyMode_AlwaysActive)"> <value> <decimal value="0"/> </value> </item> <item displayName="$(string.EfficiencyMode_NeverActive)"> <value> <decimal value="1"/> </value> </item> <item displayName="$(string.EfficiencyMode_ActiveWhenUnplugged)"> <value> <decimal value="2"/> </value> </item> <item displayName="$(string.EfficiencyMode_ActiveWhenUnpluggedBatteryLow)"> <value> <decimal value="3"/> </value> </item> </enum> </elements> </policy>Repita para cada ADMX ou conjunto de políticas ADMX que você quiser adicionar e então configure ConfigADMXInstalledPolicy para cada uma delas.
ConfigADMXInstalledPolicy
Importante
Definir as configurações para importar o arquivo ADMX em ConfigOperations primeiro.
Em ConfigADMXInstalledPolicy, forneça uma configuração de política e um valor para essa política desde o ADMX importado. Você precisará de informações do ADMX importadas em ConfigOperations para concluir ConfigADMXInstalledPolicy.
- Insira um nome de área e clique em Adicionar. A estrutura do nome do área é a seguinte:
<AppName (from ConfigOperations)>~<SettingType>~<category name from ADMX>Consulte Categoria e política no ADMX para obter mais informações. Uma configuração pode ter vários níveis de nomes de categoria, como no exemplo a seguir. Exemplo:MSEdgeEfficiencyMode~Policy~microsoft_edge~Performance - Selecione o nome da área no painel de Personalização, insira um nome de política do ADMX e, em seguida, clique em Adicionar.
Exemplo,
EfficiencyMode. - Selecione o nome da política no painel de Personalização e insira um valor desde o ADMX no campo de texto.
Exemplo,
<enabled/><data id="EfficiencyMode" Value="2">.
Categoria e política no ADMX
Os exemplos a seguir mostram o arquivo ADMX para Chromium Edge usado nos exemplos nos procedimentos acima. O primeiro exemplo realça os nomes de categoria.
<categories>
<category displayName="$(string.microsoft_edge)" name="microsoft_edge"/>
<category displayName="$(string.Performance_group)" name="Performance">
<parentCategory ref="microsoft_edge"/>
</category>
</categories>
O próximo exemplo realça a política específica.
<policy class="Both" displayName="$(string.EfficiencyMode)" explainText="$(string.EfficiencyMode_Explain)" key="Software\Policies\Microsoft\Edge" name="EfficiencyMode" presentation="$(presentation.EfficiencyMode)">
<parentCategory ref="Performance"/>
<supportedOn ref="SUPPORTED_WIN7_V96"/>
<elements>
<enum id="EfficiencyMode" valueName="EfficiencyMode">
<item displayName="$(string.EfficiencyMode_AlwaysActive)">
<value>
<decimal value="0"/>
</value>
</item>
<item displayName="$(string.EfficiencyMode_NeverActive)">
<value>
<decimal value="1"/>
</value>
</item>
<item displayName="$(string.EfficiencyMode_ActiveWhenUnplugged)">
<value>
<decimal value="2"/>
</value>
</item>
<item displayName="$(string.EfficiencyMode_ActiveWhenUnpluggedBatteryLow)">
<value>
<decimal value="3"/>
</value>
</item>
</enum>
</elements>
</policy>
Converter multilinhas em linha única
Use o seguinte cmdlet do PowerShell para remover retornos de carro e alimentações de linha de um arquivo multilinhas para criar um arquivo de linha única que possa ser colado em AdmxFileUid.
$outputFile = "output.admx"
$inputFile = "input.admx"
(Get-Content $inputFile -Raw).Replace("`r`n","") | Set-Content $outputFile -Force
Exemplos de configuração
Exemplo: Modo de Eficiência de Borda
<?xml version="1.0" encoding="utf-8"?>
<WindowsCustomizations>
<PackageConfig xmlns="urn:schemas-Microsoft-com:Windows-ICD-Package-Config.v1.0">
<ID>{d1ab1e3e-6e6d-4bd5-b35b-34cca18d2e16}</ID>
<Name>MSEdgeEfficiencyMode</Name>
<Version>1.1</Version>
<OwnerType>OEM</OwnerType>
<Rank>0</Rank>
<Notes></Notes>
</PackageConfig>
<Settings xmlns="urn:schemas-microsoft-com:windows-provisioning">
<Customizations>
<Common>
<ADMXIngestion>
<ConfigADMXInstalledPolicy>
<AreaName>
<PolicyName AreaName="MSEdgeEfficiencyMode~Policy~microsoft_edge~Performance" Name="MSEdgeEfficiencyMode~Policy~microsoft_edge~Performance">
<SetAdmxPolicy PolicyName="EfficiencyMode" Name="EfficiencyMode"><enabled/><data id="EfficiencyMode" value="2"/></SetAdmxPolicy>
</PolicyName>
</AreaName>
</ConfigADMXInstalledPolicy>
<ConfigOperations>
<ADMXInstall>
<AppName>
<SettingType AppName="MSEdgeEfficiencyMode" Name="MSEdgeEfficiencyMode">
<ADMXFileUniqueID SettingType="Policy" Name="Policy">
<InsertADMXFile AdmxFileUid="MSEdgeEfficiencyMode" Name="MSEdgeEfficiencyMode"><?xml version="1.0" ?><policyDefinitions revision="1.0" schemaVersion="1.0" xmlns="http://www.microsoft.com/GroupPolicy/PolicyDefinitions"> <!--microsoft_edge version: 96.0.1054.62--> <policyNamespaces> <target namespace="Microsoft.Policies.Edge" prefix="microsoft_edge"/> <using namespace="Microsoft.Policies.Windows" prefix="windows"/> </policyNamespaces> <resources minRequiredRevision="1.0"/> <supportedOn> <definitions> <definition displayName="$(string.SUPPORTED_WIN7_V96)" name="SUPPORTED_WIN7_V96"/> </definitions> </supportedOn> <categories> <category displayName="$(string.microsoft_edge)" name="microsoft_edge"/> <category displayName="$(string.Performance_group)" name="Performance"> <parentCategory ref="microsoft_edge"/> </category> </categories> <policies> <policy class="Both" displayName="$(string.EfficiencyMode)" explainText="$(string.EfficiencyMode_Explain)" key="Software\Policies\Microsoft\Edge" name="EfficiencyMode" presentation="$(presentation.EfficiencyMode)"> <parentCategory ref="Performance"/> <supportedOn ref="SUPPORTED_WIN7_V96"/> <elements> <enum id="EfficiencyMode" valueName="EfficiencyMode"> <item displayName="$(string.EfficiencyMode_AlwaysActive)"> <value> <decimal value="0"/> </value> </item> <item displayName="$(string.EfficiencyMode_NeverActive)"> <value> <decimal value="1"/> </value> </item> <item displayName="$(string.EfficiencyMode_ActiveWhenUnplugged)"> <value> <decimal value="2"/> </value> </item> <item displayName="$(string.EfficiencyMode_ActiveWhenUnpluggedBatteryLow)"> <value> <decimal value="3"/> </value> </item> </enum> </elements> </policy> </policies></policyDefinitions></InsertADMXFile>
</ADMXFileUniqueID>
</SettingType>
</AppName>
</ADMXInstall>
</ConfigOperations>
</ADMXIngestion>
</Common>
</Customizations>
</Settings>
</WindowsCustomizations>