ADMXIngestion(Windows 구성 디자이너 참조)

아티클
01/25/2024

Windows 10 버전 1703부터 ADMX 파일(관리 템플릿)그룹 정책 가져오고 프로비저닝 패키지에서 ADMX 지원 정책에 대한 값을 구성할 수 있습니다. 적용할 수 있는 ADMX 지원 정책의 유형을 보려면 Win32 및 데스크톱 브리지 앱 정책 구성 개요를 참조하세요.

ConfigADMXInstalledPolicy 아래에 있는 설정으로 가져온 ADMX 파일에 정책에 대한 값을 설정할 수 있습니다.
ConfigOperations 아래에 있는 설정으로 가져올 ADMX 파일을 지정할 수 있습니다.

중요

프로비저닝 패키지를 사용하여 디바이스 scope 정책(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 파일을 붙여넣는 대신 하나 이상의 특정 정책을 붙여넣을 수 있습니다(한 줄로 변환한 후).

예제, 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 cmdlet을 사용하여 여러 줄 파일에서 캐리지 반환 및 줄 피드를 제거하고 한 줄 파일을 만들어 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">&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>

ADMXIngestion(Windows 구성 디자이너 참조)

적용 대상

ConfigOperations

ConfigADMXInstalledPolicy

ADMX의 범주 및 정책

여러 줄을 한 줄로 변환

구성 샘플

피드백

피드백

추가 리소스

ADMXIngestion(Windows 구성 디자이너 참조)

적용 대상

ConfigOperations

ConfigADMXInstalledPolicy

ADMX의 범주 및 정책

여러 줄을 한 줄로 변환

구성 샘플

관련 항목

피드백

피드백

추가 리소스