Fournisseur CSP CMPolicy

Article
03/18/2023

Le tableau ci-dessous montre l’applicabilité de Windows :

Édition	Windows 10	Windows 11
Accueil	Oui	Oui
Pro	Oui	Oui
Windows SE	Non	Oui
Entreprise	Oui	Oui
Enterprise	Oui	Oui
Éducation	Oui	Oui

Le fournisseur de services de configuration CMPolicy définit les règles que le Gestionnaire des connexions utilise pour identifier la connexion correcte pour une demande de connexion.

Remarque

Ce fournisseur de services de configuration nécessite l’accès aux fonctionnalités ID_CAP_CSP_FOUNDATION et ID_CAP_NETWORKING_ADMIN à partir d’une application de configuration réseau.

Chaque entrée de stratégie identifie une ou plusieurs applications en combinaison avec un modèle d’hôte. L’entrée de stratégie se voit attribuer une liste de détails de connexion que Gestionnaire des connexions utilise pour satisfaire les demandes de connexion correspondant aux modèles d’application et d’hôte. Le fournisseur de services de configuration CMPolicy peut avoir plusieurs stratégies

Classement des stratégies : il n’existe pas d’ordre explicite des stratégies. La règle générale est que les mappages de stratégie les plus concrets ou les plus spécifiques ont une priorité plus élevée.

Stratégies par défaut : les stratégies sont appliquées dans l’ordre de leur portée avec les stratégies les plus spécifiques prises en compte avant les stratégies plus générales. Le comportement par défaut du téléphone s’applique à toutes les applications et à tous les domaines et n’est utilisé que lorsqu’aucune autre stratégie plus spécifique n’est disponible. La stratégie par défaut consiste à utiliser d’abord tout réseau Wi-Fi disponible, puis tout APN disponible.

L’exemple suivant montre l’objet de gestion du fournisseur de services de configuration CMPolicy au format d’arborescence utilisé à la fois par le provisionnement du client Open Mobile Alliance (OMA) et le Gestion des appareils OMA.

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

policyName Définit le nom de la stratégie.

SID La valeur de SID dépend du Type Client.

Pour les stratégies de mappage basées sur les applications plateforme Windows universelle (UWP), SID est le nom de la famille de packages sans accolades {}, et non l’application.

Pour les stratégies de mappage basées sur des applications non UWP, SID est l’ID de produit d’application au format GUID. Les accolades {} autour du GUID sont requises.

Pour les stratégies de mappage basées sur l’hôte, le SID doit être défini sur *.

ClientType Spécifie le type de stratégie de mappage.

La liste suivante décrit les types de stratégies de mappage disponibles :

Les stratégies de mappage basées sur les applications sont appliquées aux applications. Pour spécifier ce type de mappage, utilisez la valeur app.
Les stratégies de mappage basées sur l’hôte sont appliquées à tous les types de clients demandant des connexions à un ou plusieurs hôtes spécifiés. Pour spécifier ce type de mappage, utilisez la valeur *.

Hôte Spécifie le nom d’un modèle d’hôte. Le nom d’hôte est mis en correspondance avec la demande de connexion pour sélectionner la stratégie appropriée à utiliser.

Le modèle hôte peut avoir deux caractères génériques, * et +. Le modèle d’hôte n’est pas un modèle d’URL et il n’existe aucun concept de transport ou de chemin d’accès sur l’hôte spécifique. Par exemple, le modèle hôte peut correspondre *.host_name.com à n’importe quel préfixe aux host_name.com domaines. Le modèle hôte correspondra www.host_name.com à et mail.host_name.com, mais il ne correspondra host_name.compas à .

OrderedConnections Spécifie si la liste des connexions est dans l’ordre de préférence.

La valeur « 0 » spécifie que les connexions ne sont pas répertoriées dans l’ordre de préférence. La valeur « 1 » indique que les connexions répertoriées sont dans l’ordre de préférence.

ConnXXX Énumère les connexions associées à la stratégie. Les noms d’éléments commencent par « Conn » suivi de trois chiffres, qui s’incrémentent à partir de « 000 ». Par exemple, une stratégie appliquée à cinq connexions aurait des entrées d’élément nommées « Conn000 », « Conn001 », « Conn002 », « Conn003 » et « Conn004 ».

Id de connexion Spécifie un identificateur unique pour une connexion au sein d’un groupe de connexions. La valeur exacte est basée sur le paramètre Type.

Pour CMST_CONNECTION_NAME, spécifiez le nom de la connexion. Par exemple, si vous avez configuré une connexion à l’aide du fournisseur de services de configuration CM_CellularEntries, le nom de la connexion peut être le nom de la connexion. Si vous disposez d’un nap configuré avec l’ID NAPID défini sur « GPRS1 », le nom de la connexion peut être « GPRS1@WAP ».

Pour CMST_CONNECTION_TYPE, spécifiez le GUID du type de connexion souhaité. Les accolades {} autour du GUID sont requises. Les types de connexion suivants sont disponibles :

Type de connexion	GUID
GSM	{A05DC613-E393-40ad-AA89-CCCE04277CD9}
CDMA	{274AD55A-4A70-4E35-93B3-AE2D2E6727FC}
3GPP hérité	{6DE4C04B-B74E-47FA-99E5-8F2097C06A92}
LTE	{2378E547-8312-46A5-905E-5C581E92693B}
Wi-Fi	{8568B401-858E-4B7B-B3DF-0FD4927F131B}
point d’accès Wi-Fi	{072FC7DC-1D93-40D1-9BB0-2114D7D73434}

Pour CMST_CONNECTION_NETWORK_TYPE, spécifiez le GUID du type de réseau souhaité. Les accolades {} autour du GUID sont requises. Les types de réseau suivants sont disponibles :

Type de réseau	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}
Ethernet 10 Mbits/s	{97D3D1B3-854A-4C32-BD1C-C13069078370}
Ethernet 100 Mbits/s	{A8F4FE66-8D04-43F5-9DD2-2A85BD21029B}
Ethernet Gbits/s	{556C1E6B-B8D4-448E-836D-9451BA4CCE75}

Pour CMST_CONNECTION_DEVICE_TYPE, spécifiez le GUID pour le type d’appareil souhaité. Les accolades {} autour du GUID sont requises. Les types d’appareils suivants sont disponibles :

Type de périphérique	GUID
Appareil cellulaire	{F9A53167-4016-4198-9B41-86D9522DC019}
Ethernet	{97844272-00C7-4572-B20A-D8D861C095F2}
Bluetooth	{1D793123-701A-4fd0-B6AE-9C3C57E99C2C}
Virtuel	{EAA02CE5-9C70-4E87-97FE-55C9DEC847D4}

Type Spécifie le type de connexion référencée. La liste suivante décrit les types de connexion disponibles :

CMST_CONNECTION_NAME : connexion spécifiée par son nom.
CMST_CONNECTION_TYPE : toute connexion d’un type spécifié.
CMST_CONNECTION_NETWORK_TYPE : toute connexion d’un type de réseau spécifié.
CMST_CONNECTION_DEVICE_TYPE : toute connexion du type d’appareil spécifié.

Exemples d’approvisionnement de client OMA

Ajout d’une stratégie de mappage basée sur l’application. Dans cet exemple, l’id de connexion du type CMST_CONNECTION_NAME est défini sur le nom de la connexion (« GPRSConn1 ») qui est configuré avec le fournisseur de services de configuration CM_CellularEntries.

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

Ajout d’une stratégie de mappage basée sur l’hôte :

Dans cet exemple, l’id de connexion du type CMST_CONNECTION_NAME est défini sur le nom de la connexion (« GPRSConn1 ») qui est configuré avec le fournisseur de services de configuration CM_CellularEntries.

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

Exemples OMA DM

Ajout d’une stratégie de mappage basée sur l’application :

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

Ajout d’une stratégie de mappage basée sur l’hôte :

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

Élément	Disponible
parm-query	Oui
Inhabituelle	Oui
characteristic-query	Oui Requête récursive : Oui Requête de niveau supérieur : Oui

Informations de référence sur les fournisseurs de services de configuration

Partager via

Fournisseur CSP CMPolicy

Exemples d’approvisionnement de client OMA

Exemples OMA DM

Microsoft Custom Elements

Commentaires

Ressources supplémentaires

Partager via

Fournisseur CSP CMPolicy

Exemples d’approvisionnement de client OMA

Exemples OMA DM

Microsoft Custom Elements

Rubriques connexes

Commentaires

Ressources supplémentaires