CMPolicy CSP

[アーティクル]
03/18/2023

次の表は、Windows の適用性を示しています。

エディション	Windows 10	Windows 11
ホーム	はい	はい
Pro	はい	はい
Windows SE	いいえ	はい
Business	はい	はい
Enterprise	はい	はい
Education	はい	はい

CMPolicy 構成サービスプロバイダーは、接続マネージャーが接続要求の正しい接続を識別するために使用する規則を定義します。

注

この構成サービスプロバイダーでは、ネットワーク構成アプリケーションからID_CAP_CSP_FOUNDATIONとID_CAP_NETWORKING_ADMINの機能にアクセスする必要があります。

各ポリシーエントリは、ホストパターンと組み合わせて 1 つ以上のアプリケーションを識別します。ポリシーエントリには、アプリケーションとホストパターンに一致する接続要求を満たすために使用接続マネージャー接続の詳細の一覧が割り当てられます。 CMPolicy 構成サービスプロバイダーは、複数のポリシーを持つことができます

ポリシーの順序: ポリシーの明示的な順序はありません。一般的なルールは、最も具体的なポリシーマッピングまたは特定のポリシーマッピングが優先される点です。

既定のポリシー: ポリシーは、より一般的なポリシーの前に考慮される最も具体的なポリシーを使用して、スコープの順序で適用されます。電話の既定の動作は、すべてのアプリケーションとすべてのドメインに適用され、他のより具体的なポリシーが使用できない場合にのみ使用されます。既定のポリシーでは、使用可能な Wi-Fi ネットワークを最初に使用してから、使用可能な APN を使用します。

次に、Open Mobile Alliance (OMA) クライアントプロビジョニングと OMA デバイス管理の両方で使用される CMPolicy 構成サービスプロバイダー管理オブジェクトをツリー形式で示します。

./Vendor/MSFT
CMPolicy
----PolicyName
--------SID
--------ClientType
--------Host
--------OrderedConnections
--------Connections
------------ConnXXX
----------------ConnectionID
----------------Type

policyName ポリシーの名前を定義します。

Sid SID の値は ClientType によって異なります。

ユニバーサル Windows プラットフォーム (UWP) アプリベースのマッピングポリシーの場合、SID は、アプリケーションではなく、中かっこ{}のないパッケージファミリ名です。

UWP 以外のアプリケーションベースのマッピングポリシーの場合、SID は GUID 形式のアプリケーション製品 ID です。 GUID の周りの中かっこ {} が必要です。

ホストベースのマッピングポリシーの場合、SID はに設定する *必要があります。

ClientType マッピングポリシーの種類を指定します。

次の一覧では、使用可能なマッピングポリシーの種類について説明します。

アプリケーションベースのマッピングポリシーは、アプリケーションに適用されます。このマッピングの種類を指定するには、値 appを使用します。
ホストベースのマッピングポリシーは、指定されたホストへの接続を要求するすべての種類のクライアントに適用されます。このマッピングの種類を指定するには、値 *を使用します。

ホスト ホストパターンの名前を指定します。ホスト名が接続要求と一致して、使用する適切なポリシーを選択します。

ホストパターンには、2 つのワイルドカード * と +を含めることができます。ホストパターンは URL パターンではなく、特定のホストでのトランスポートまたはパスの概念はありません。たとえば、ホストパターンは *.host_name.com 、任意のプレフィックスをドメインに host_name.com 一致させる場合があります。ホストパターンはと一致 www.host_name.com します mail.host_name.comが、と一致 host_name.comしません。

OrderedConnections 接続の一覧が優先順かどうかを指定します。

値 "0" は、接続が優先順に一覧表示されていないことを指定します。値 "1" は、一覧表示されている接続が優先順であることを示します。

ConnXXX ポリシーに関連付けられている接続を列挙します。要素名は "Conn" で始まり、その後に 3 桁の数字が続きます。この数字は "000" から始まります。たとえば、5 つの接続に適用されるポリシーには、"Conn000"、"Conn001"、"Conn002"、"Conn003"、"Conn004" という名前の要素エントリがあります。

ConnectionID 接続のグループ内の接続の一意の識別子を指定します。正確な値は、Type パラメーターに基づいています。

に CMST_CONNECTION_NAME接続名を指定します。たとえば、CM_CellularEntries構成サービスプロバイダーを使用して構成された接続がある場合、接続名は接続の名前である可能性があります。 NAPID を "GPRS1" に設定して NAP を構成している場合、接続名は "GPRS1@WAP" である可能性があります。

に CMST_CONNECTION_TYPE、目的の接続の種類の GUID を指定します。 GUID の周りの中かっこ {} が必要です。次の接続の種類を使用できます。

接続の種類	GUID
Gsm	{A05DC613-E393-40ad-AA89-CCCE04277CD9}
Cdma	{274AD55A-4A70-4E35-93B3-AE2D2E6727FC}
レガシ 3GPP	{6DE4C04B-B74E-47FA-99E5-8F2097C06A92}
LTE	{2378E547-8312-46A5-905E-5C581E92693B}
Wi-Fi	{8568B401-858E-4B7B-B3DF-0FD4927F131B}
Wi-Fi ホットスポット	{072FC7DC-1D93-40D1-9BB0-2114D7D73434}

に CMST_CONNECTION_NETWORK_TYPE、目的のネットワークの種類の GUID を指定します。 GUID の周りの中かっこ {} が必要です。次のネットワークの種類を使用できます。

ネットワークの種類	GUID
GPRS	{AFB7D659-FC1F-4EA5-BDD0-0FDA62676D96}
1XRTT	{B1E700AE-A62F-49FF-9BBE-B880C995F27D}
EDGE	{C347F8EC-7095-423D-B838-7C7A7F38CD03}
WCDMA UMTS	{A72F04C6-9BE6-4151-B5EF-15A53E12C482}
WCDMA FOMA	{B8326098-F845-42F3-804E-8CC3FF7B50B4}
1XEVDO	{DD42DF39-EBDF-407C-8146-1685416401B2}
1XEVDV	{61BF1BFD-5218-4CD4-949C-241CA3F326F6}
HSPA HSDPA	{047F7282-BABD-4893-AA77-B8B312657F8C}
HSPA HSUPA	{1536A1C6-A4AF-423C-8884-6BDDA3656F84}
LTE	{B41CBF43-6994-46FF-9C2F-D6CA6D45889B}
EHRPD	{7CFA04A5-0F3F-445C-88A4-C86ED2AD94EA}
イーサネット 10 Mbps	{97D3D1B3-854A-4C32-BD1C-C13069078370}
イーサネット 100 Mbps	{A8F4FE66-8D04-43F5-9DD2-2A85BD21029B}
イーサネット Gbps	{556C1E6B-B8D4-448E-836D-9451BA4CCE75}

に CMST_CONNECTION_DEVICE_TYPE、目的のデバイスの種類の GUID を指定します。 GUID の周りの中かっこ {} が必要です。次のデバイスの種類を使用できます。

デバイスの種類	GUID
携帯ネットワークデバイス	{F9A53167-4016-4198-9B41-86D9522DC019}
Ethernet	{97844272-00C7-4572-B20A-D8D861C095F2}
Bluetooth	{1D793123-701A-4fd0-B6AE-9C3C57E99C2C}
仮想	{EAA02CE5-9C70-4E87-97FE-55C9DEC847D4}

型参照する接続の種類を指定します。次の一覧では、使用可能な接続の種類について説明します。

CMST_CONNECTION_NAME – 名前で指定された接続。
CMST_CONNECTION_TYPE – 指定した型の任意の接続。
CMST_CONNECTION_NETWORK_TYPE – 指定されたネットワークの種類の任意の接続。
CMST_CONNECTION_DEVICE_TYPE – 指定したデバイスの種類の任意の接続。

OMA クライアントプロビジョニングの例

アプリケーションベースのマッピングポリシーの追加。この例では、type CMST_CONNECTION_NAME の ConnectionId は、CM_CellularEntries構成サービスプロバイダーで構成されている接続 ("GPRSConn1") の名前に設定されます。

<wap-provisioningdoc>

   <characteristic type="CM_CellularEntries">
       <characteristic type="GPRSConn1">
          <parm name="ConnectionType" value="gprs" />
             <characteristic type="DevSpecificCellular">
                <parm name="GPRSInfoAccessPointName" value="apn.adatum.com" />
         </characteristic>
          <parm name="AlwaysOn" value="0" />
          <parm name="Enabled" value="1" />
       </characteristic>
    </characteristic>

   <characteristic type="CMPolicy">
      <characteristic type="Policy1">
       <parm name="SID" value="{A05D1234-F393-9385-AA89-CD3E049367D2}" />
       <parm name="ClientType" value="app" />
       <parm name="Host" value="*.+" />
       <parm name="OrderedConnections" value="1" />
       <characteristic type="Connections">
           <characteristic type="Conn000">
               <parm name="Type" value="CMST_CONNECTION_DEVICE_TYPE" />
               <parm name="ConnectionId" value="{F9A53167-4016-4198-9B41-86D9522DC019}" />
           </characteristic>
           <characteristic type="Conn001">
               <parm name="Type" value="CMST_CONNECTION_NETWORK_TYPE" />
               <parm name="ConnectionId" value="{AFB7D659-FC1F-4EA5-BDD0-0FDA62676D96}" />
           </characteristic>
           <characteristic type="Conn002">
               <parm name="Type" value="CMST_CONNECTION_NAME" />
               <parm name="ConnectionId" value="GPRSConn1" />
           </characteristic>
           <characteristic type="Conn003">
              <parm name="Type" value="CMST_CONNECTION_TYPE" />
              <parm name="ConnectionId" value="{072FC7DC-1D93-40d1-9BB0-2114D7D73434}" />
           </characteristic>
       </characteristic>
      </characteristic>
    </characteristic>
</wap-provisioningdoc>

ホストベースのマッピングポリシーの追加:

この例では、type CMST_CONNECTION_NAME の ConnectionId は、CM_CellularEntries構成サービスプロバイダーで構成されている接続 ("GPRSConn1") の名前に設定されます。

<wap-provisioningdoc>

   <characteristic type="CM_CellularEntries">
       <characteristic type="GPRSConn1">
          <parm name="ConnectionType" value="gprs" />
             <characteristic type="DevSpecificCellular">
                <parm name="GPRSInfoAccessPointName" value="apn.adatum.com" />
         </characteristic>
          <parm name="AlwaysOn" value="0" />
          <parm name="Enabled" value="1" />
       </characteristic>
    </characteristic>

   <characteristic type="CMPolicy">
      <characteristic type="Policy3">
       <parm name="SID" value="*" />
       <parm name="ClientType" value="*" />
       <parm name="Host" value="*.contoso.com" />
       <parm name="OrderedConnections" value="1" />
       <characteristic type="Connections">
           <characteristic type="Conn000">
               <parm name="Type" value="CMST_CONNECTION_DEVICE_TYPE" />
               <parm name="ConnectionId" value="{F9A53167-4016-4198-9B41-86D9522DC019}" />
           </characteristic>
           <characteristic type="Conn001">
               <parm name="Type" value="CMST_CONNECTION_NETWORK_TYPE" />
               <parm name="ConnectionId" value="{AFB7D659-FC1F-4EA5-BDD0-0FDA62676D96}" />
           </characteristic>
           <characteristic type="Conn002">
               <parm name="Type" value="CMST_CONNECTION_NAME" />
               <parm name="ConnectionId" value="GPRSConn1" />
           </characteristic>
           <characteristic type="Conn003">
               <parm name="Type" value="CMST_CONNECTION_TYPE" />
               <parm name="ConnectionId" value="{072FC7DC-1D93-40d1-9BB0-2114D7D73434}" />
           </characteristic>
       </characteristic>
      </characteristic>
    </characteristic>

</wap-provisioningdoc>

OMA DM の例

アプリケーションベースのマッピングポリシーの追加:

<SyncML>
    <SyncBody>
        <Atomic>
    <CmdID>8000</CmdID>
    <Add>
        <CmdID>8051</CmdID>
        <Item>
            <Target>
                <LocURI>./Vendor/MSFT/CMPolicy/BTHPolicy4/SID</LocURI>
            </Target>
            <Data>{A05D1234-F393-9385-AA89-CD3E049367D2}</Data>
        </Item>
    </Add>
    <Add>
        <CmdID>8052</CmdID>
        <Item>
            <Target>
                <LocURI>./Vendor/MSFT/CMPolicy/BTHPolicy4/ClientType</LocURI>
            </Target>
            <Data>app</Data>
        </Item>
    </Add>
    <Add>
        <CmdID>8053</CmdID>
        <Item>
            <Target>
                <LocURI>./Vendor/MSFT/CMPolicy/BTHPolicy4/Host</LocURI>
            </Target>
            <Data>*.+</Data>
        </Item>
    </Add>
    <Add>
        <CmdID>8054</CmdID>
        <Item>
            <Target>
                <LocURI>./Vendor/MSFT/CMPolicy/BTHPolicy4/OrderedConnections</LocURI>
            </Target>
            <Data>1</Data>
        </Item>
    </Add>
    <Add>
        <CmdID>8055</CmdID>
        <Item>
            <Target>
                <LocURI>./Vendor/MSFT/CMPolicy/BTHPolicy4/Connections/Conn000/ConnectionId</LocURI>
            </Target>
            <Data>{A05DC613-E393-40AD-AA89-CCCE04277CD9}</Data>
        </Item>
    </Add>
    <Add>
        <CmdID>8056</CmdID>
        <Item>
            <Target>
                <LocURI>./Vendor/MSFT/CMPolicy/BTHPolicy4/Connections/Conn000/Type</LocURI>
            </Target>
            <Data>CMST_CONNECTION_DEVICE_TYPE</Data>
        </Item>
    </Add>
        </Atomic>
        <Final/>
    </SyncBody>
</SyncML>

ホストベースのマッピングポリシーの追加:

<SyncML>
    <SyncBody>
        <Atomic>
    <CmdID>8000</CmdID>
    <Add>
        <CmdID>8049</CmdID>
        <Item>
            <Target>
                <LocURI>./Vendor/MSFT/CMPolicy/BTHPolicy6/SID</LocURI>
            </Target>
            <Data>*</Data>
        </Item>
    </Add>
    <Add>
        <CmdID>8050</CmdID>
        <Item>
            <Target>
                <LocURI>./Vendor/MSFT/CMPolicy/BTHPolicy6/ClientType</LocURI>
            </Target>
            <Data>*</Data>
        </Item>
    </Add>
    <Add>
        <CmdID>8051</CmdID>
        <Item>
            <Target>
                <LocURI>./Vendor/MSFT/CMPolicy/BTHPolicy6/Host</LocURI>
            </Target>
            <Data>*.contoso.com</Data>
        </Item>
    </Add>
    <Add>
        <CmdID>8052</CmdID>
        <Item>
            <Target>
                <LocURI>./Vendor/MSFT/CMPolicy/BTHPolicy6/OrderedConnections</LocURI>
            </Target>
            <Data>1</Data>
        </Item>
    </Add>
    <Add>
        <CmdID>8053</CmdID>
        <Item>
            <Target>
                <LocURI>./Vendor/MSFT/CMPolicy/BTHPolicy6/Connections/Conn000/ConnectionId</LocURI>
            </Target>
            <Data>{AFB7D659-FC1F-4EA5-BDD0-0FDA62676D96}</Data>
        </Item>
    </Add>
    <Add>
        <CmdID>8054</CmdID>
        <Item>
            <Target>
                <LocURI>./Vendor/MSFT/CMPolicy/BTHPolicy6/Connections/Conn000/Type</LocURI>
            </Target>
            <Data>CMST_CONNECTION_NETWORK_TYPE</Data>
        </Item>
    </Add>
        </Atomic>
        <Final/>
    </SyncBody>
</SyncML>

Microsoft カスタム要素

要素	利用可能
parm-query	はい
珍しく	はい
characteristic-query	はい再帰クエリ: はい最上位レベルのクエリ: はい

構成サービスプロバイダーのリファレンス

次の方法で共有

CMPolicy CSP

OMA クライアントプロビジョニングの例

OMA DM の例

Microsoft カスタム要素

フィードバック

その他のリソース

次の方法で共有

CMPolicy CSP

OMA クライアント プロビジョニングの例

OMA DM の例

Microsoft カスタム要素

関連トピック

フィードバック

その他のリソース

OMA クライアントプロビジョニングの例