ADMXIngestion (Referenz zu Windows Configuration Designer)

  • Artikel

Ab Windows 10 Version 1703 können Sie Gruppenrichtlinie administrative Vorlagen (ADMX-Dateien) importieren (erfassen) und Werte für ADMX-gestützte Richtlinien in einem Bereitstellungspaket konfigurieren. Welche Typen von ADMX-Backup-Richtlinien angewendet werden können, erfahren Sie unter Win32- und Desktop-Brücke App-Konfiguration (Übersicht).

  • Die Einstellungen unter ConfigADMXInstalledPolicy können für Werte für die Richtlinien in der importierten ADMX-Datei verwendet werden.

  • Die Einstellungen unter ConfigOperations geben die ADMX-Dateien an, die importiert werden sollen.

Wichtig

Nur Gerätebereichsrichtlinien (class="Machine" or class="Both") können mithilfe eines Bereitstellungspakets festgelegt werden.

Betrifft

Einstellungsgruppen Windows-Client Surface Hub HoloLens IoT Enterprise
ConfigADMXInstalledPolicy ✅ ✅
ConfigOperations ✅ ✅

ConfigOperations

Verwenden Sie ConfigOperations , um ADMX-Richtlinien aus einer ADMX-Datei zu importieren.

  1. Geben Sie einen App-Namen ein, und klicken Sie dann auf Add. Dies kann ein beliebiger Namen sein. Wählen Sie daher etwas Beschreibendes. Wenn Sie beispielsweise ADMX für Chromium Edge importieren, geben Sie einen App-Namen ein. Beispiel MSEdgeEfficiencyMode

  2. Wählen Sie den App-Namen im Bereich „Available customizations“ aus, wählen Sie einen Einstellungstyp und wählen Sie dann Add. Die Auswahlmöglichkeiten Policy und Preference haben keinen Einfluss auf das Verhalten der Einstellungen und sind nur der Einfachheit halber zum Kategorisierenden der Einstellungen da.

  3. Wählen Sie den Einstellungstyp im Anpassungsbereich. Im Feld AdmxFileUid geben Sie einen Namen der ADMX-Datei oder eine eindeutige ID für die Datei an und klicken Sie dann auf Add. Die AdmxFileUid kann eine beliebige Zeichenfolge sein, muss aber im Bereitstellungspaket eindeutig sein. Mit dem Namen der ADMX-Datei können Sie die Datei in Zukunft ermittelt. Beispiel MSEdgeEfficiencyMode

    Hinweis

    Wenn AdmxFileUid und AppName gleich bleiben, können Autorisierungsfehler vermieden werden.

  4. Wählen Sie die AdmxFileUid im Anpassungsbereich aus, und fügen Sie den Inhalt der ADMX-Datei in das Textfeld ein. Bevor Sie den Inhalt der ADMX-Datei kopieren, müssen Sie sie in eine einzige Zeile konvertieren. Weitere Informationen finden Sie unter Konvertieren von mehreren Zeilen zu einer Zeile.

    Hinweis

    Wenn Sie eine große ADMX-Datei haben, sollte sie möglicherweise nur bestimmte Einstellungen enthalten. Anstatt die gesamte ADMX-Datei einfügen, können Sie nur eine oder mehrere bestimmte Richtlinien (nach dem Konvertieren zu einer Zeile) einfügen.

    Beispiel: 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. Wiederholen Sie dies für jede ADMX oder jeden ADMX-Richtliniensatz, den Sie hinzufügen möchten, und konfigurieren Sie dann jeweils ConfigADMXInstalledPolicy.

ConfigADMXInstalledPolicy

Wichtig

Konfigurieren Sie erst die Einstellungen zum Importieren der ADMX-Datei in ConfigOperations.

In ConfigADMXInstalledPolicy stellen Sie eine Richtlinieneinstellung und einen Wert für diese Richtlinie aus den importierten ADMX-Dateien bereit. Sie benötigen Informationen aus den ADMX-Dateien, die Sie in ConfigOperations importieren, um ConfigADMXInstalledPolicy abzuschließen.

  1. Geben Sie einen Bereichsnamen ein, und klicken Sie dann auf Add. Die Struktur der Bereichsnamen lautet wie folgt:<AppName (from ConfigOperations)>~<SettingType>~<category name from ADMX> Weitere Informationen finden Sie unter Kategorie und Richtlinie in ADMX . Eine Einstellung hat möglicherweise mehrere Ebenen von Kategorienamen, wie im folgenden Beispiel. Beispiel: MSEdgeEfficiencyMode~Policy~microsoft_edge~Performance
  2. Wählen Sie den Bereichsnamen im Bereich „Customization“, geben Sie einen Richtliniennamen aus der ADMX ein und klicken Sie dann auf Add. Beispiel: EfficiencyMode.
  3. Wählen Sie den Richtliniennamen im Bereich „Customization“, und geben Sie einen Wert aus der ADMX im Textfeld ein. Beispiel: <enabled/><data id="EfficiencyMode" Value="2">.

Kategorie und Richtlinie in ADMX

Die folgenden Beispiele zeigen die ADMX-Datei für Chromium Edge, die in den Beispielen in den obigen Verfahren verwendet wird. Im ersten Beispiel werden die Kategorienamen hervorgehoben.

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

Im nächsten Beispiel wird die spezifische Richtlinie hervorgehoben.

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

Konvertieren von mehreren Zeilen zu einer Zeile

Verwenden Sie das folgende PowerShell-Cmdlet, um Absätze und Zeilenumbrüche aus einer mehrzeiligen-Datei zum Erstellen einer einzeiligen-Datei zu entfernen, die Sie in AdmxFileUid einfügen können.

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

Konfigurationsbeispiele

Beispiel: Edge-Effizienzmodus

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