ADMXIngestion (riferimento Progettazione configurazione di Windows)

  • Articolo

A partire da Windows 10 versione 1703, è possibile importare (inserire) Criteri di gruppo modelli amministrativi (file ADMX) e configurare i valori per i criteri supportati da ADMX in un pacchetto di provisioning. Per vedere quali tipi di criteri di backup ADMX possono essere applicati, vedi Panoramica sulla configurazione dei criteri delle app Win32 e Desktop Bridge.

Importante

Solo i criteri di ambito del dispositivo (class="Machine" o class="Both") possono essere impostati usando un pacchetto di provisioning.

Si applica a

Gruppi di impostazioni Client Windows Surface Hub HoloLens IoT Enterprise
ConfigADMXInstalledPolicy ✅ ✅
ConfigOperations ✅ ✅

ConfigOperations

Usare ConfigOperations per importare criteri ADMX da un file ADMX.

  1. Immetti un nome app e quindi fai clic su Aggiungi. Può essere un qualsiasi nome da te assegnato, quindi scegli un nome descrittivo per identificarne lo scopo. Ad esempio, se si importa ADMX per Chromium Edge, immettere un nome di app. Esempio MSEdgeEfficiencyMode

  2. Seleziona il nome app nel riquadro Personalizzazione, seleziona un tipo di impostazione e quindi fai clic su Aggiungi. Le scelte per Criteri e Preferenza, non hanno alcun effetto sul comportamento delle impostazioni e vengono fornite solo per comodità nel caso in cui desiderassi classificare le impostazioni aggiunte.

  3. Seleziona il tipo di impostazione nel riquadro Personalizzazioni. Nel campo AdmxFileUid, immetti il nome del file ADMX o un ID univoco per il file e quindi fai clic su Aggiungi. Il campo AdmxFileUid può essere una stringa qualsiasi, ma deve essere univoco nel pacchetto di provisioning. L'utilizzo del nome del file ADMX consente di identificare il file in futuro. Esempio MSEdgeEfficiencyMode

    Nota

    Mantenere gli stessi valori di AdmxFileUid e AppName consente di evitare errori di autorizzazione.

  4. Seleziona AdmxFileUid nel riquadro Personalizzazioni e incolla il contenuto del file ADMX nel campo di testo. Prima di copiare il contenuto del file ADMX, è necessario convertirlo in una riga singola. Vedi Convertire più righe in una riga singola per le istruzioni.

    Nota

    Quando disponi di un file ADMX di grandi dimensioni, è consigliabile includere solo impostazioni specifiche. Invece di incollare l'intero file ADMX, è possibile incollare solo uno o più criteri specifici (dopo la conversione a riga singola).

    Esempio, 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. Ripeti l'operazione per ogni ADMX o set di criteri ADMX che desideri aggiungere e quindi configura ConfigADMXInstalledPolicy per ciascuno di essi.

ConfigADMXInstalledPolicy

Importante

Configurare le impostazioni per importare prima il file ADMX in ConfigOperations.

In ConfigADMXInstalledPolicy, fornisci un'impostazione di criteri e il valore per tale criterio dal file ADMX importato. Avrai bisogno delle informazioni dal file ADMX che importi in ConfigOperations per completare ConfigADMXInstalledPolicy.

  1. Immetti un nome area e quindi fai clic su Aggiungi. La struttura del nome area è la seguente:<AppName (from ConfigOperations)>~<SettingType>~<category name from ADMX> Per altre informazioni, vedere Categoria e criteri in ADMX . Un'impostazione può avere più livelli di nomi di categoria, come nell'esempio seguente. Esempio: MSEdgeEfficiencyMode~Policy~microsoft_edge~Performance
  2. Seleziona il nome area nel riquadro Personalizzazione, immetti un nome di criterio da ADMX e quindi fai clic su Aggiungi. Esempio: EfficiencyMode.
  3. Seleziona il nome criterio nel riquadro Personalizzazione e quindi immetti un valore da ADMX nel campo di testo. Esempio: <enabled/><data id="EfficiencyMode" Value="2">.

Categoria e criteri in ADMX

Gli esempi seguenti mostrano il file ADMX per Chromium Edge usato negli esempi nelle procedure precedenti. Il primo esempio evidenzia i nomi delle categorie.

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

L'esempio successivo evidenzia i criteri specifici.

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

Convertire più righe in una riga singola

Utilizza il seguente cmdlet PowerShell per rimuovere i ritorni a capo e gli avanzamenti riga da un file a più righe per creare un file a riga singola che è possibile incollare in AdmxFileUid.

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

Esempi di configurazione

Esempio: Modalità efficienza edge

<?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>