Compartir a través de

ADMXIngestion (referencia del Diseñador de configuraciones de Windows)

  • Artículo

A partir de Windows 10, versión 1703, puede importar (ingerir) directiva de grupo plantillas administrativas (archivos ADMX) y configurar valores para las directivas respaldadas por ADMX en un paquete de aprovisionamiento. Para ver qué tipos de directivas respaldadas por ADMX se pueden aplicar, consulta Información general de configuración de directivas de aplicaciones de Puente de escritorio de dispositivo y Win32.

  • La configuración en ConfigADMXInstalledPolicy te permite establecer valores para directivas en el archivo ADMX importado.

  • La configuración en ConfigOperations especifica el archivo ADMX que se va a importar.

Importante

Solo se pueden establecer directivas de ámbito de dispositivo (class="Machine" o class="Both") mediante un paquete de aprovisionamiento.

Se aplica a

Grupos de configuraciones Cliente de Windows Surface Hub HoloLens IoT Enterprise
ConfigADMXInstalledPolicy ✅ ✅
ConfigOperations ✅ ✅

ConfigOperations

Use ConfigOperations para importar directivas ADMX desde un archivo ADMX.

  1. Escribe un nombre de aplicación y luego haz clic en Agregar. Este puede ser cualquier nombre que asignes; por tanto, elige algo descriptivo para que te ayuda a identificar su finalidad. Por ejemplo, si va a importar ADMX para Chromium Edge, escriba un nombre de aplicación. Ejemplo MSEdgeEfficiencyMode

  2. Selecciona el nombre de aplicación en el panel personalizaciones, un tipo de configuración y luego haz clic en Agregar. Las opciones, Directiva y Preferencia, no tienen ningún impacto en el comportamiento de la configuración y solo se proporciona para tu comodidad en el caso de que quieras clasificar la configuración que agregas.

  3. Selecciona el tipo de configuración en el panel Personalizaciones. En el campo AdmxFileUid, escribe el nombre del archivo ADMX o un identificador único para el archivo y luego haz clic en Agregar. El AdmxFileUid puede ser cualquier cadena, pero debe ser único en el paquete de aprovisionamiento. El nombre del archivo ADMX le ayudará a identificar el archivo en el futuro. Ejemplo MSEdgeEfficiencyMode

    Nota

    Mantener admxFileUid y AppName igual ayudará a evitar la autorización de errores.

  4. Selecciona el AdmxFileUid en el panel Personalizaciones y pega el contenido del archivo ADMX en el campo de texto. Antes de copiar el contenido del archivo ADMX, debes convertirlo en una sola línea. Consulta Convertir varias líneas en una sola para obtener instrucciones.

    Nota

    Cuando tengas un archivo ADMX grande, es posible que quieras incluir únicamente la configuración específica. En lugar de pegar todo el archivo ADMX, puedes pegar únicamente una o más directivas específicas (después de convertirlas en una línea única).

    Ejemplo, 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>

  5. Repite para cada ADMX o conjunto de directivas ADMX que quieras agregar y luego configura ConfigADMXInstalledPolicy para cada uno.

ConfigADMXInstalledPolicy

Importante

Define la configuración para importar el archivo ADMX en ConfigOperations primero.

En ConfigADMXInstalledPolicy, proporcionas una configuración de directiva y un valor para esa directiva desde el ADMX importado. Necesitarás información desde el ADMX que importes en ConfigOperations para completar ConfigADMXInstalledPolicy.

  1. Escribe un nombre de área y luego haz clic en Agregar. La estructura del nombre del área es la siguiente:<AppName (from ConfigOperations)>~<SettingType>~<category name from ADMX> Consulte Categoría y directiva en ADMX para obtener más información. Una configuración puede tener varios niveles de nombres de categoría, como se muestra en el siguiente ejemplo. Ejemplo: MSEdgeEfficiencyMode~Policy~microsoft_edge~Performance
  2. Selecciona el nombre del área en el panel Personalización, escribe un nombre de directiva del ADMX y luego haz clic en Agregar. Ejemplo, EfficiencyMode.
  3. Selecciona el nombre de la directiva en el panel Personalización y luego escribe un valor del ADMX en el campo de texto. Ejemplo, <enabled/><data id="EfficiencyMode" Value="2">.

Categoría y directiva en ADMX

En los ejemplos siguientes se muestra el archivo ADMX para Chromium Edge usado en los ejemplos de los procedimientos anteriores. En el primer ejemplo se resaltan los nombres de categoría.

  <categories>
    <category displayName="$(string.microsoft_edge)" name="microsoft_edge"/>
    <category displayName="$(string.Performance_group)" name="Performance">
      <parentCategory ref="microsoft_edge"/>
    </category>
  </categories>

En el ejemplo siguiente se resalta la directiva 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>

Convierte varias líneas en una sola

Usa el siguiente cmdlet de PowerShell para quitar retornos de carro y avances de línea de un archivo multilínea para crear un archivo de una sola línea que puedes pegar en AdmxFileUid.

$outputFile = "output.admx"
$inputFile = "input.admx"
(Get-Content $inputFile -Raw).Replace("`r`n","") | Set-Content $outputFile -Force

Ejemplos de configuración

Ejemplo: Modo de eficiencia perimetral

<?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">&lt;enabled/&gt;&lt;data id="EfficiencyMode" value="2"/&gt;</SetAdmxPolicy>
              </PolicyName>
            </AreaName>
          </ConfigADMXInstalledPolicy>
          <ConfigOperations>
            <ADMXInstall>
              <AppName>
                <SettingType AppName="MSEdgeEfficiencyMode" Name="MSEdgeEfficiencyMode">
                  <ADMXFileUniqueID SettingType="Policy" Name="Policy">
                    <InsertADMXFile AdmxFileUid="MSEdgeEfficiencyMode" Name="MSEdgeEfficiencyMode">&lt;?xml version="1.0" ?&gt;&lt;policyDefinitions revision="1.0" schemaVersion="1.0" xmlns="http://www.microsoft.com/GroupPolicy/PolicyDefinitions"&gt;  &lt;!--microsoft_edge version: 96.0.1054.62--&gt;  &lt;policyNamespaces&gt;    &lt;target namespace="Microsoft.Policies.Edge" prefix="microsoft_edge"/&gt;    &lt;using namespace="Microsoft.Policies.Windows" prefix="windows"/&gt;  &lt;/policyNamespaces&gt;  &lt;resources minRequiredRevision="1.0"/&gt;  &lt;supportedOn&gt;    &lt;definitions&gt;      &lt;definition displayName="$(string.SUPPORTED_WIN7_V96)" name="SUPPORTED_WIN7_V96"/&gt;    &lt;/definitions&gt;  &lt;/supportedOn&gt;  &lt;categories&gt;    &lt;category displayName="$(string.microsoft_edge)" name="microsoft_edge"/&gt;    &lt;category displayName="$(string.Performance_group)" name="Performance"&gt;      &lt;parentCategory ref="microsoft_edge"/&gt;    &lt;/category&gt;  &lt;/categories&gt;  &lt;policies&gt;    &lt;policy class="Both" displayName="$(string.EfficiencyMode)" explainText="$(string.EfficiencyMode_Explain)" key="Software\Policies\Microsoft\Edge" name="EfficiencyMode" presentation="$(presentation.EfficiencyMode)"&gt;      &lt;parentCategory ref="Performance"/&gt;      &lt;supportedOn ref="SUPPORTED_WIN7_V96"/&gt;      &lt;elements&gt;        &lt;enum id="EfficiencyMode" valueName="EfficiencyMode"&gt;          &lt;item displayName="$(string.EfficiencyMode_AlwaysActive)"&gt;            &lt;value&gt;              &lt;decimal value="0"/&gt;            &lt;/value&gt;          &lt;/item&gt;          &lt;item displayName="$(string.EfficiencyMode_NeverActive)"&gt;            &lt;value&gt;              &lt;decimal value="1"/&gt;            &lt;/value&gt;          &lt;/item&gt;          &lt;item displayName="$(string.EfficiencyMode_ActiveWhenUnplugged)"&gt;            &lt;value&gt;              &lt;decimal value="2"/&gt;            &lt;/value&gt;          &lt;/item&gt;          &lt;item displayName="$(string.EfficiencyMode_ActiveWhenUnpluggedBatteryLow)"&gt;            &lt;value&gt;              &lt;decimal value="3"/&gt;            &lt;/value&gt;          &lt;/item&gt;        &lt;/enum&gt;      &lt;/elements&gt;    &lt;/policy&gt;  &lt;/policies&gt;&lt;/policyDefinitions&gt;</InsertADMXFile>
                  </ADMXFileUniqueID>
                </SettingType>
              </AppName>
            </ADMXInstall>
          </ConfigOperations>
        </ADMXIngestion>
      </Common>
    </Customizations>
  </Settings>
</WindowsCustomizations>