マルチバリアント設定を含むプロビジョニングパッケージを作成する

[アーティクル]
07/17/2024
適用対象:

✅ Windows 11, ✅ Windows 10

組織では、管理デバイスの構成のさまざまな要件があります。組織内で異なる要件を持つデバイスのそれぞれのグループに、個別のプロビジョニングパッケージを作成できます。または、マルチバリアントプロビジョニングパッケージを使うと、複数の条件で機能する 1 つのプロビジョニングパッケージを作成することができます。たとえば、1 つのプロビジョニングパッケージで、フランス語用に設定されたデバイスに適用されるカスタマイズ設定の 1 つのセットと、日本語用に設定されたデバイス用に異なるカスタマイズ設定のセットを定義できます。

マルチバリアント設定をプロビジョニングするには、Windows 構成デザイナーを使って、すべてのデバイスに適用するすべてのカスタマイズ設定を含む、プロビジョニングパッケージを作成します。次に、プロジェクトの .XML ファイルを手動で編集し、デバイスの各セット (ターゲット) を定義します。それぞれのターゲットでは、少なくとも 1 つの条件の値を指定します。これによりデバイスが受信する構成を識別します。最後に、それぞれのターゲットで、それらのデバイスに適用するカスタマイズ設定を指定します。

まず、ターゲットの定義の方法から説明します。

ターゲット

XML ファイルで Id またはフレンドリ名を各 Target に指定します。各 Target は少なくとも 1 つの TargetState で定義されます。これには少なくとも 1 つの Condition が含まれます。 Condition 要素では、条件と指定された値との間の照合の種類を定義します。

Target には複数の TargetState を含むことができます。TargetState には複数の Condition を含むことができます。

複数のターゲットの状態と条件を持つターゲット。

次の情報では、ターゲット定義のロジックについて説明します。

すべての Condition 要素が TRUE の場合、 TargetState は TRUE です。
いずれかの TargetState 要素が TRUE の場合、Target は TRUE であり、ID を使用してカスタマイズを設定できます。

条件

次の表は、 TargetState の Windows クライアントプロビジョニングでサポートされる条件を示しています。

条件名	条件の優先順位	デスクトップエディション用の Windows クライアント	値の種類	値の説明
MNC	P0	サポートされています	数字列	Mobile Network Code (MNC) の値に基づいた設定を対象とするために使います。
MCC	P0	サポートされています	数字列	Mobile Country Code (MCC) の値に基づいた設定を対象とするために使います。
SPN	P0	サポートされています	文字列	サービスプロバイダー名 (SPN) の値に基づいた設定を対象とするために使います。
PNN	P0	サポートされています	文字列	公衆陸上移動網 (PLMN) におけるネットワーク名の値に基づいた設定を対象とするために使います。
GID1	P0	サポートされています	数字列	グループ識別子 (レベル 1) の値に基づいた設定を対象とするために使います。
ICCID	P0	サポートされています	数字列	集積回路カード識別子 (ICCID) の値に基づいた設定を対象とするために使います。
Roaming	P0	該当なし	ブール値	ローミングを指定するために使います。値を 1 (ローミング) または 0 (非ローミング) に設定します。
UICC	P0	該当なし	列挙値	Universal Integrated Circuit Card (UICC) の状態を指定するために使います。値を次のいずれかの値に設定します。 0 - 空 1 - 準備完了 2 - ロック
UICCSLOT	P0	該当なし	数字列	UICC のスロットを指定するために使います。値を次のいずれかの値に設定します。 0 - スロット 0 1 - スロット 1
ProcessorType	P1	サポートされています	文字列	プロセッサの種類に基づいた設定を対象とするために使います。
ProcessorName	P1	サポートされています	文字列	プロセッサの名前に基づいた設定を対象とするために使います。
AoAc ("Always On, Always Connected")	P1	サポートされています	ブール値	値を 0 (false) または 1 (true) に設定します。この状態が TRUE の場合、システムは S0 低電力アイドルモデルをサポートします。
PowerPlatformRole	P1	サポートされています	列挙値	優先する電源管理プロファイルを示します。 POWER_PLATFORM_ROLE 列挙に基づいて値を設定します。
SocIdentifier	P1	サポートされています	文字列	Soc 識別子に基づいて設定をターゲットにするには、を使用します。 25301 OS ビルドバージョン以降で使用できます。
Architecture	P1	サポートされています	文字列	PROCESSOR_ARCHITECTURE 環境変数と一致させます。
Server	P1	サポートされています	ブール値	値を 0 (false) に設定するか、1 (true) を設定してサーバーを識別します。
Region	P1	サポートされています	列挙値	ISO 3166-1 alpha-2 の 2 桁のアルファ ISO コードを使用して、リージョンに基づいて設定をターゲットに設定します。
Lang	P1	サポートされています	列挙値	を使用して、2 桁の ISO 639 alpha-2 コードを使用して、言語コードに基づいて設定をターゲットにします。

Windows クライアントでサポートされる一致する型は次のとおりです。

照合の種類	構文	例
完全一致の照合	照合の種類はそのまま指定されます。	`<Condition Name="ProcessorName" Value="Barton" />`
正規表現 (Regex) の一致	一致する型のプレフィックスは `Pattern:`	`<Condition Name="ProcessorName" Value="Pattern:.Celeron." />`
数値範囲の照合	一致する型のプレフィックスは `!Range:`	`<Condition Name="MNC" Value="!Range:400, 550" />`

TargetState の優先順位

デバイスの条件に一致するデバイスに設定を適用するように、プロビジョニングパッケージ内に複数の TargetState を定義できます。プロビジョニングエンジンが各 TargetState を評価すると、複数の TargetState が現在のデバイス条件に適合する可能性があります。設定の適用順序を決めるために、システムによってすべての TargetState に優先順位が割り当てられます。

優先順位の低い TargetState に一致する設定は、優先順位の高い TargetState に一致する設定の前に適用されます。つまり、優先順位の高い TargetState の設定は、優先順位の低い TargetState の設定を上書きできます。

同じ優先順位の複数の TargetState に一致する設定は、プロビジョニングパッケージで各 TargetState が定義されている順序に従って適用されます。

TargetState の優先順位は、条件の優先順位に基いて割り当てられます (優先順位については「Conditions の表」をご覧ください)。優先順位の評価ルールは、次のとおりです。

TargetState (P0 条件を満たす) は、TargetState (P0 条件を満たさない) よりも高い。
TargetState (P0 および P1 条件を満たす) は、TargetState (P0 条件のみを満たす) よりも高い。
より多くの P0 条件を満たす TargetState は、満たされる P1 条件の数にかかわらず、より少ない P0 条件を満たす TargetState よりも高い。
一致する P0 条件の数が等しい場合、最も一致する P1 条件を持つ TargetState の優先順位が高くなります。
満たされる P0 条件の数が等しく、満たされる P1 条件の数も等しい場合、満たされる条件の合計数が最も多い TargetState が高い優先順位となる。

マルチバリアント設定を含むプロビジョニングパッケージを作成する

マルチバリアント機能を含めてプロビジョニングパッケージを作成するには、次の手順に従います。

プロビジョニングパッケージをビルドし、特定の条件下で適用するカスタマイズを構成します。詳しくは、「プロビジョニングパッケージの作成」をご覧ください。
設定を構成したら、プロジェクトを保存します。
プロジェクトフォルダーを開き、customizations.xml ファイルを任意のローカルの場所にコピーします。

XML またはテキストエディターを使用して、customizations.xml ファイルを開きます。

customizations.xml ファイルには、パッケージのメタデータ (パッケージの所有者と順位を含む) と、プロビジョニングパッケージの作成時に構成した設定が記述されています。ファイルの Customizations ノードには Commonセクションがあり、カスタマイズの設定が含まれています。

次の例は、サンプルの customizations.xml ファイルの内容を示しています。

<?xml version="1.0" encoding="utf-8"?>
<WindowsCustomizations>
 <PackageConfig xmlns="urn:schemas-Microsoft-com:Windows-ICD-Package-Config.v1.0">
   <ID>{6aaa4dfa-00d7-4aaa-8adf-73c6a7e2501e}</ID>
   <Name>My Provisioning Package</Name>
   <Version>1.0</Version>
   <OwnerType>OEM</OwnerType>
   <Rank>50</Rank>
 </PackageConfig>
 <Settings xmlns="urn:schemas-microsoft-com:windows-provisioning">
   <Customizations>
     <Common>
       <Policies>
         <AllowBrowser>0</AllowBrowser>
         <AllowCamera>0</AllowCamera>
         <AllowBluetooth>0</AllowBluetooth>
       </Policies>
       <HotSpot>
         <Enabled>0</Enabled>
       </HotSpot>
     </Common>
   </Customizations>
 </Settings>
</WindowsCustomizations>

customizations.xml ファイルを編集して Targets セクションを作成し、マルチバリアント設定を処理する条件を記述します。

次の例は、 ProcessorName、 ProcessorType、 MCC、 MNC など、いくつかの条件を含むように変更された customizations.xml を示しています。

<?xml version="1.0" encoding="utf-8"?>
<WindowsCustomizations>
 <PackageConfig xmlns="urn:schemas-Microsoft-com:Windows-ICD-Package-Config.v1.0">
   <ID>{6aaa4dfa-00d7-4aaa-8adf-73c6a7e2501e}</ID>
   <Name>My Provisioning Package</Name>
   <Version>1.0</Version>
   <OwnerType>OEM</OwnerType>
   <Rank>50</Rank>
 </PackageConfig>
 <Settings xmlns="urn:schemas-microsoft-com:windows-provisioning">
   <Customizations>
     <Common>
       <Policies>
         <AllowBrowser>0</AllowBrowser>
         <AllowCamera>0</AllowCamera>
         <AllowBluetooth>0</AllowBluetooth>
       </Policies>
       <HotSpot>
         <Enabled>0</Enabled>
       </HotSpot>
     </Common>
     <Targets>
       <Target Id="Unique target identifier for desktop">
         <TargetState>
           <Condition Name="ProcessorName" Value="Pattern:.*Celeron.*" />
           <Condition Name="ProcessorType" Value="Pattern:.*(I|i)ntel.*" />
         </TargetState>
         <TargetState>
           <Condition Name="ProcessorName" Value="Barton" />
           <Condition Name="ProcessorType" Value="Athlon MP" />
         </TargetState>
       </Target>
       <Target Id="Mobile target">
         <TargetState>
           <Condition Name="MCC" Value="Range:310, 320" />
           <Condition Name="MNC" Value="!Range:400, 550" />
         </TargetState>
       </Target>
     </Targets>
   </Customizations>
 </Settings>
</WindowsCustomizations>

customizations.xml ファイル内に、カスタマイズが必要な設定用に Variant セクションを作成します。そのためには、次の手順に従います。

a. 子 TargetRefs 要素を定義します。 b. TargetRefs 要素内に TargetRef 要素を定義します。カスタマイズ設定を適用する必要のある Id ごとに、複数の TargetRef 要素を定義することができます。 c. 準拠設定を Common セクションから Variant セクションに移動します。

いずれかの TargetRef 要素が Target に一致する場合 Variant内のすべての設定が適用されます。

注

複数の Variant セクションを定義できます。 Common セクション内に存在する設定は、すべてのトリガーイベントごとに無条件に適用されます。

次の例は、Variant セクションを含むように更新された customizations.xml と、 バリアント の条件が満たされた場合に適用される移動された設定を示しています。

<?xml version="1.0" encoding="utf-8"?>
<WindowsCustomizations>
 <PackageConfig xmlns="urn:schemas-Microsoft-com:Windows-ICD-Package-Config.v1.0">
   <ID>{6aaa4dfa-00d7-4aaa-8adf-73c6a7e2501e}</ID>
   <Name>My Provisioning Package</Name>
   <Version>1.0</Version>
   <OwnerType>OEM</OwnerType>
   <Rank>50</Rank>
 </PackageConfig>
 <Settings xmlns="urn:schemas-microsoft-com:windows-provisioning">
   <Customizations>
     <Common>
     </Common>
     <Targets>
       <Target Id="Unique target identifier for desktop">
         <TargetState>
           <Condition Name="ProcessorName" Value="Pattern:.*Celeron.*" />
           <Condition Name="ProcessorType" Value="Pattern:.*(I|i)ntel.*" />
         </TargetState>
         <TargetState>
           <Condition Name="ProcessorName" Value="Barton" />
           <Condition Name="ProcessorType" Value="Athlon MP" />
         </TargetState>
       </Target>
       <Target Id="Mobile target">
         <TargetState>
           <Condition Name="MCC" Value="Range:310, 320" />
           <Condition Name="MNC" Value="!Range:400, 550" />
         </TargetState>
       </Target>
     </Targets>
     <Variant>
       <TargetRefs>
         <TargetRef Id="Unique target identifier for desktop" />
         <TargetRef Id="Mobile target" />
       </TargetRefs>
       <Settings>
         <Policies>
           <AllowBrowser>1</AllowBrowser>
           <AllowCamera>1</AllowCamera>
           <AllowBluetooth>1</AllowBluetooth>
         </Policies>
         <HotSpot>
           <Enabled>1</Enabled>
         </HotSpot>
       </Settings>
     </Variant>
   </Customizations>
 </Settings>
</WindowsCustomizations>

更新された customizations.xml ファイルを保存し、このファイルのパスを書き留めます。パスは、次の手順の値の 1 つとして必要になります。

Windows 構成デザイナーのコマンドラインインターフェイスで、更新された customizations.xml を使用してプロビジョニングパッケージを作成します。

次に、例を示します。

icd.exe /Build-ProvisioningPackage /CustomizationXML:"C:\CustomProject\customizations.xml" /PackagePath:"C:\CustomProject\output.ppkg" /StoreFile:C:\Program Files (x86)\Windows Kits\10\Assessment and Deployment Kit\Imaging and Configuration Designer\x86\Microsoft-Common-Provisioning.dat"

この例では、 StoreFile は、必要な Windows エディションのパッケージの作成に使用される設定ストアの場所に対応しています。

注

この手順で作成されたプロビジョニングパッケージには、多変量設定が含まれています。このパッケージは、Windows デバイスに適用できるスタンドアロンパッケージとして使うことも、別のプロジェクトを開始する際のベースとして使うこともできます。

プロビジョニングをトリガーするイベント

マルチバリアントプロビジョニングパッケージを Windows クライアントデバイスにインストールすると、プロビジョニングエンジンは、すべてのイベントで一致条件設定を適用し、プロビジョニングをトリガーします。

次のイベントは、Windows クライアントデバイスでのプロビジョニングをトリガーします。

イベント	デスクトップエディション用の Windows クライアント
システムの起動	サポートされています
オペレーティングシステムの更新	計画されています
デバイスの初回実行でのパッケージインストール	サポートされています
SIM の存在または更新の検出	サポートされています
実行時のパッケージインストール	サポートされています
ローミングの検出	サポートされていません

次の方法で共有

マルチバリアント設定を含むプロビジョニングパッケージを作成する

ターゲット

条件

TargetState の優先順位

マルチバリアント設定を含むプロビジョニングパッケージを作成する

プロビジョニングをトリガーするイベント

フィードバック

その他のリソース

次の方法で共有

マルチバリアント設定を含むプロビジョニング パッケージを作成する

ターゲット

条件

TargetState の優先順位

マルチバリアント設定を含むプロビジョニング パッケージを作成する

プロビジョニングをトリガーするイベント

フィードバック

その他のリソース

マルチバリアント設定を含むプロビジョニングパッケージを作成する

マルチバリアント設定を含むプロビジョニングパッケージを作成する