ADMXIngestion (Windows 構成デザイナー リファレンス)
バージョン 1703 Windows 10以降、管理用テンプレート (ADMX ファイル) グループ ポリシーインポート (取り込み) し、プロビジョニング パッケージ内の ADMX に基づくポリシーの値を構成できます。 どの種類の ADMX ベースのポリシーを適用できるかについては、Win32 およびデスクトップ ブリッジのアプリ ポリシーの構成に関するページをご覧ください。
ConfigADMXInstalledPolicy の下の設定で、インポートされた ADMX ファイルのポリシーの値を設定できます。
ConfigOperations の下の設定で、インポートする ADMX ファイルを指定します。
重要
プロビジョニング パッケージを使用して設定できるのは、デバイス スコープ ポリシー (class="Machine" または class="Both") のみです。
適用対象
| 設定グループ | Windows クライアント | Surface Hub | HoloLens | IoT Enterprise |
|---|---|---|---|---|
| ConfigADMXInstalledPolicy | ✅ | ✅ | ||
| ConfigOperations | ✅ | ✅ |
ConfigOperations
ConfigOperations を使用して、ADMX ファイルから ADMX ポリシーをインポートします。
アプリ名を入力し、[追加] をクリックします。 これには任意の名前を割り当てることができるため、目的を識別するのに役立つわかりやすい名前を選択してください。 たとえば、Chromium Edge の ADMX をインポートする場合は、アプリ名を入力します。 例
MSEdgeEfficiencyMode[カスタマイズ] ウィンドウでアプリ名を選択し、設定の種類を選択して [追加] をクリックします。 [ポリシー] と [優先順位] を選択しても、設定の動作には影響がありません。これらは、追加する設定を分類するときに便利なように用意されています。
[カスタマイズ] ウィンドウで、設定の種類を選択します。 [AdmxFileUid] フィールドで、ADMX ファイルの名前またはファイルの一意の ID を入力し、[追加] をクリックします。 AdmxFileUid には任意の文字列を指定できますが、プロビジョニング パッケージ内で一意である必要があります。 ADMX ファイルの名前を使用すると、将来ファイルを識別するために役立ちます。 例
MSEdgeEfficiencyMode注
AdmxFileUid と AppName を同じにしておくことは、承認エラーを防ぐのに役立ちます。
[カスタマイズ] ウィンドウで [AdmxFileUid] を選択し、テキスト フィールドに ADMX ファイルの内容を貼り付けます。 ADMX ファイルの内容をコピーする前に、単一行に変換する必要があります。 手順については、「複数行を単一行に変換する」をご覧ください。
注
サイズの大きな ADMX ファイルがある場合は、固有の設定だけを含めることもできます。 ADMX ファイル全体を貼り付けるのではなく、1 つ以上の特定のポリシーだけを貼り付けることができます (単一行に変換後)。
例: 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>追加する ADMX または ADMX ポリシーのセットごとに繰り返し、それぞれで ConfigADMXInstalledPolicy を構成します。
ConfigADMXInstalledPolicy
重要
まず、ConfigOperations で ADMX ファイルをインポートする設定を構成します。
ConfigADMXInstalledPolicy で、インポートされた ADMX からポリシー設定とそのポリシーの値を提供します。 ConfigADMXInstalledPolicy を完了するには、ConfigOperations でインポートする ADMX からの情報が必要です。
- エリア名を入力し、[追加] をクリックします。 エリア名の構造は次のとおりです。
<AppName (from ConfigOperations)>~<SettingType>~<category name from ADMX>詳細については、「 ADMX のカテゴリとポリシー 」を参照してください。 設定には、次の例のように複数レベルのカテゴリ名が含まれます。 例：MSEdgeEfficiencyMode~Policy~microsoft_edge~Performance - [カスタマイズ] ウィンドウでエリア名を選択し、ADMX からのポリシー名を入力して、[追加] クリックします。
例:
EfficiencyMode。 - [カスタマイズ] ウィンドウでポリシー名を選択し、ADMX からの値をテキスト フィールドに入力します。
例:
<enabled/><data id="EfficiencyMode" Value="2">。
ADMX でのカテゴリとポリシー
次のサンプルは、上記の手順の例で使用Chromium Edge の ADMX ファイルを示しています。 最初のサンプルでは、カテゴリ名が強調表示されています。
<categories>
<category displayName="$(string.microsoft_edge)" name="microsoft_edge"/>
<category displayName="$(string.Performance_group)" name="Performance">
<parentCategory ref="microsoft_edge"/>
</category>
</categories>
次のサンプルでは、特定のポリシーが強調表示されています。
<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>
複数行を単一行に変換する
次の PowerShell コマンドレットを使用して、複数行のファイルから復帰および改行を削除し、AdmxFileUid に貼り付けることができる単一行ファイルを作成します。
$outputFile = "output.admx"
$inputFile = "input.admx"
(Get-Content $inputFile -Raw).Replace("`r`n","") | Set-Content $outputFile -Force
構成サンプル
例: エッジ効率モード
<?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>