ADMXIngestion (référence du Concepteur de configuration Windows)

  • Article

À compter de Windows 10 version 1703, vous pouvez importer (ingérer) des modèles d’administration stratégie de groupe (fichiers ADMX) et configurer des valeurs pour les stratégies ADMX dans un package d’approvisionnement. Pour voir les types de stratégies ADMX sauvegardées qui peuvent être appliqués, consultez Présentation de la configuration de stratégie d'application Win32 et Desktop Bridge.

  • Les paramètres sous ConfigADMXInstalledPolicy vous permettent de définir des valeurs pour les stratégies dans le fichier ADMX importé.

  • Les paramètres sous ConfigOperations spécifient le fichier ADMX à importer.

Important

Seules les stratégies d’étendue d’appareil (class="Machine » ou class="Both ») peuvent être définies à l’aide d’un package d’approvisionnement.

S’applique à

Groupes de paramètres Client Windows Surface Hub HoloLens IoT Enterprise
ConfigADMXInstalledPolicy ✅ ✅
ConfigOperations ✅ ✅

ConfigOperations

Utilisez ConfigOperations pour importer des stratégies ADMX à partir d’un fichier ADMX.

  1. Entrez un nom d'application, puis cliquez sur Ajouter. Il peut s’agir de n’importe quel nom que vous attribuez, choisissez donc un nom descriptif pour vous aider à identifier son objectif. Par exemple, si vous importez ADMX pour Chromium Edge, entrez un nom d’application. Exemple MSEdgeEfficiencyMode

  2. Sélectionnez le nom d'application dans le volet Personnalisations, sélectionnez un type de paramètre, puis cliquez sur Ajouter. Les choix Stratégie et Préférence n’ont aucun impact sur le comportement des paramètres et sont uniquement fournis pour votre commodité si vous souhaitez catégoriser les paramètres que vous ajoutez.

  3. Sélectionnez le type de paramètre dans le volet Personnalisations. Dans le champ AdmxFileUid, entrez le nom du fichier ADMX ou un ID unique pour le fichier, puis cliquez sur Ajouter. Le AdmxFileUid peut être n’importe quelle chaîne, mais doit être unique dans le package d’approvisionnement. L'utilisation du nom du fichier ADMX vous aidera à identifier le fichier à l’avenir. Exemple MSEdgeEfficiencyMode

    Remarque

    Le fait de conserver les fichiers AdmxFileUid et AppName identiques permet d’éviter les erreurs d’autorisation.

  4. Sélectionnez le AdmxFileUid dans le volet Personnalisations et collez le contenu du fichier ADMX dans le champ texte. Avant de copier le contenu du fichier ADMX, vous devez le convertir en une seule ligne. Voir Convertir plusieurs lignes en une seule ligne pour obtenir des instructions.

    Remarque

    Lorsque vous disposez d’un fichier ADMX volumineux, vous souhaiterez peut-être inclure uniquement les paramètres spécifiques. Au lieu du coller dans le fichier ADMX entier, vous pouvez coller simplement une ou plusieurs stratégies spécifiques (après les avoir converties en une seule ligne).

    Exemple, 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. Répétez cette opération pour chaque ADMX ou un ensemble de stratégies ADMX que vous souhaitez ajouter, puis configurez ConfigADMXInstalledPolicy pour chacun d’eux.

ConfigADMXInstalledPolicy

Important

Configurez d'abord les paramètres pour importer le fichier ADMX dans ConfigOperations.

Dans ConfigADMXInstalledPolicy, vous fournissez un paramètre de stratégie et une valeur pour cette stratégie à partir de l’ADMX importé. Vous aurez besoin des informations de l’ADMX que vous importez dans ConfigOperations pour terminer ConfigADMXInstalledPolicy.

  1. Entrez un nom de zone, puis cliquez sur Ajouter. La structure du nom de la zone est la suivante :<AppName (from ConfigOperations)>~<SettingType>~<category name from ADMX> Pour plus d’informations, consultez Catégorie et stratégie dans ADMX . Un paramètre peut avoir plusieurs niveaux de noms de catégories, comme dans l’exemple suivant. Exemple: MSEdgeEfficiencyMode~Policy~microsoft_edge~Performance
  2. Sélectionnez le nom de la zone dans le volet Personnalisation, entrez un nom de stratégie à partir de l’ADMX, puis cliquez sur Ajouter. Exemple , EfficiencyMode.
  3. Sélectionnez le nom de la stratégie dans le volet Personnalisation, puis entrez un nom de valeur à partir de l’ADMX dans le champ texte. Exemple , <enabled/><data id="EfficiencyMode" Value="2">.

Catégorie et stratégie dans ADMX

Les exemples suivants montrent le fichier ADMX pour Chromium Edge utilisé dans les exemples des procédures ci-dessus. Le premier exemple met en évidence les noms de catégorie.

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

L’exemple suivant met en évidence la stratégie spécifique.

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

Convertir plusieurs lignes en une seule ligne

Utilisez l’applet de commande PowerShell suivante pour supprimer les retours de transport et les approvisionnements en ligne à partir d’un fichier sur plusieurs lignes pour créer un fichier à ligne unique que vous pouvez coller dans AdmxFileUid.

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

Exemples de configuration

Exemple : Mode d’efficacité de périphérie

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