Fournisseur de services de configuration CM_CellularEntries

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 CM_CellularEntries est utilisé pour configurer les entrées GPRS (General Packet Radio Service) sur l’appareil. Il définit chaque point d’accès aux données GSM.

Ce fournisseur de services de configuration nécessite que la fonctionnalité ID_CAP_NETWORKING_ADMIN soit accessible à partir d’une application de configuration réseau.

L’exemple suivant montre l’objet de gestion du fournisseur de services de configuration CM_CellularEntries au format d’arborescence utilisé par OMA CP (Open Mobile Alliance Client Provisioning). Le protocole DM OMA n’est pas pris en charge avec ce fournisseur de services de configuration.

CM_CellularEntries
----entryname
--------AlwaysOn
--------AuthType
--------ConnectionType
--------Desc.langid
--------Enabled
--------IpHeaderCompression
--------Password
--------SwCompression
--------UserName
--------UseRequiresMappingPolicy
--------Version
--------DevSpecificCellular
-----------GPRSInfoAccessPointName
--------Roaming
--------OEMConnectionID
--------ApnId
--------IPType
--------ExemptFromDisablePolicy
--------ExemptFromRoaming
--------TetheringNAI
--------IdleDisconnectTimeout
--------SimIccId
--------PurposeGroups

entryname Définit le nom de la connexion.

Le fournisseur de services de configuration CMPolicy utilise la valeur de nom_entrée pour identifier la connexion associée à une stratégie et CM_ProxyEntries fournisseur de services de configuration utilise la valeur de nom_entrée pour identifier la connexion associée à un proxy.

Alwayson Type : Int. Spécifie si l’Gestionnaire des connexions tente automatiquement de se connecter à l’APN lorsqu’une connexion est disponible.

La valeur « 0 » spécifie qu’AlwaysOn n’est pas pris en charge et que le Gestionnaire des connexions tente de se connecter à l’APN uniquement lorsqu’une application demande la connexion. Ce paramètre est recommandé pour les applications qui utilisent une connexion occasionnellement. Par exemple, un APN qui contrôle uniquement MMS.

La valeur « 1 » spécifie qu’AlwaysOn est pris en charge et que le Gestionnaire des connexions tente automatiquement de se connecter à l’APN lorsqu’il est disponible. Ce paramètre est recommandé pour les APN Internet à usage général.

Au moins une connexion Internet AlwaysOn doit être configurée pour l’opérateur mobile.

Authtype Optionnel. Type : Chaîne. Spécifie la méthode d’authentification utilisée pour une connexion.

La valeur « CHAP » spécifie le protocole d’application Challenge Handshake. La valeur « PAP » spécifie le protocole d’authentification par mot de passe. La valeur « None » spécifie que les paramètres UserName et Password sont ignorés. La valeur par défaut est « None ».

ConnectionType Optionnel. Type : Chaîne. Spécifie le type de connexion utilisé pour l’APN. Les types de connexion suivants sont disponibles :

Type de connexion	Utilisation
Gprs	Par défaut. Utilisé pour les connexions de type GPRS (GPRS + GSM + EDGE + UMTS + LTE).
Cdma	Utilisé pour les connexions de type CDMA (1XRTT + EVDO).
Lte	Utilisé pour les connexions de type LTE (eHRPD + LTE) lorsque l’appareil est inscrit HOME.
Héritage	Utilisé pour les connexions GPRS + GSM + EDGE + UMTS.
Lte_iwlan	Utilisé pour les connexions de type GPRS qui peuvent être déchargées via Wi-Fi.
Iwlan	Utilisé pour les connexions implémentées sur le déchargement Wi-Fi uniquement.

Desc.langid Facultatif. Spécifie la chaîne d’affichage de l’interface utilisateur utilisée par l’ID de langue défini.

Un nom de paramètre au format Desc.langid sera utilisé comme identificateur spécifique à la langue de l’entrée spécifiée. Par exemple, un paramètre défini comme Desc.0409 avec la valeur force l’affichage de "GPRS Connection" « Connexion GPRS » dans l’interface utilisateur pour représenter cette connexion lorsque l’appareil est défini sur la langue anglaise (ID de langue 0409). Les descriptions de plusieurs langues peuvent être configurées à l’aide de ce mécanisme, et le système basculera automatiquement entre elles si l’utilisateur modifie ses préférences linguistiques sur l’appareil. Si aucun paramètre Desc n’est provisionné pour une langue donnée, le système utilise par défaut le nom utilisé pour créer l’entrée.

Activé Spécifie si la connexion est activée.

La valeur « 0 » spécifie que la connexion est désactivée. La valeur « 1 » spécifie que la connexion est activée.

IpHeaderCompression Optionnel. Spécifie si la compression d’en-tête IP est activée.

La valeur « 0 » spécifie que la compression d’en-tête IP pour la connexion est désactivée. La valeur « 1 » spécifie que la compression d’en-tête IP pour la connexion est activée.

Mot de passe Obligatoire si AuthType est défini sur une valeur autre que « None ». Spécifie le mot de passe utilisé pour se connecter à l’APN.

SwCompression Optionnel. Spécifie si la compression logicielle est activée.

La valeur « 0 » spécifie que la compression logicielle pour la connexion est désactivée. La valeur « 1 » spécifie que la compression logicielle pour la connexion est activée.

Nom d'utilisateur Obligatoire si AuthType est défini sur une valeur autre que « None ». Spécifie le nom d’utilisateur utilisé pour se connecter à l’APN.

UseRequiresMappingsPolicy Optionnel. Spécifie si la connexion nécessite une stratégie de mappage correspondante.

La valeur « 0 » spécifie que la connexion peut être utilisée pour toutes les communications Internet générales. La valeur « 1 » spécifie que la connexion est utilisée uniquement si une stratégie de mappage est présente.

Par exemple, si l’APN du service de messagerie multimédia (MMS) ne doit pas avoir d’autre trafic que MMS, vous pouvez configurer une stratégie de mappage qui envoie le trafic MMS à cette connexion. Ensuite, vous définissez la valeur de UseRequiresMappingsPolicy sur « 1 » et Gestionnaire des connexions utiliserez uniquement la connexion pour le trafic MMS. Sans cela, Gestionnaire des connexions essaieront d’utiliser la connexion pour tout trafic Internet à usage général.

Version Type : Int. Spécifie le numéro de version XML et est utilisé pour vérifier que le code XML est pris en charge par le fournisseur de services de configuration de Gestionnaire des connexions.

Cette valeur doit être « 1 » si elle est incluse.

GPRSInfoAccessPointName Spécifie le nom logique pour sélectionner la passerelle GPRS. Pour plus d’informations sur les valeurs autorisées, consultez Spécification GSM 07.07 « 10.1.1 Définir le contexte PDP +CGDCONT ».

Itinérance Optionnel. Type : Int. Ce paramètre spécifie les conditions d’itinérance dans lesquelles la connexion doit être activée. Les conditions suivantes sont disponibles :

• 0 - Réseau domestique uniquement.
• 1 (par défaut) - Toutes les conditions d’itinérance (domicile et itinérance).
• 2 - Itinérance domestique et domestique uniquement.
• 3 - Itinérance nationale uniquement.
• 4 - Itinérance non nationale uniquement.
• 5 - Itinérance uniquement.

OEMConnectionID Optionnel. Type : GUID. Spécifie un GUID utilisé pour identifier une connexion spécifique dans le modem. Si aucune valeur n’est spécifiée, la valeur par défaut est 0000000-0000-0000-0000-0000000000000000. Ce paramètre est utilisé uniquement sur les appareils LTE.

ApnId Optionnel. Type : Int. Spécifie l’objectif de l’APN. Si aucune valeur n’est spécifiée, la valeur par défaut est « 0 » (aucun). Ce paramètre est utilisé uniquement sur les appareils LTE.

IPType Optionnel. Type : Chaîne. Spécifie le protocole réseau de la connexion. Les valeurs disponibles sont « IPv4 », « IPv6 », « IPv4v6 » et « IPv4v6xlat ». Si aucune valeur n’est spécifiée, la valeur par défaut est « IPv4 ».

Warning

N’utilisez pas IPv6 ou IPv4v6xlat sur un appareil ou un réseau qui ne prend pas en charge IPv6. La fonctionnalité de données ne fonctionne pas. En outre, l’appareil ne pourra pas se connecter à un réseau itinérant qui ne prend pas en charge IPv6, sauf si vous configurez des connexions itinérantes avec un IPType IPv4v6.

ExemptFromDisablePolicy Rajouté dans Windows 10, version 1511. Facultatif. Type : Int. Cette valeur doit être spécifiée uniquement pour les connexions à usage spécial dont les applications gèrent directement leur état de désactivation (par exemple, MMS). La valeur « 0 » spécifie que la connexion est soumise à la stratégie de désactivation utilisée par les connexions à usage général (non exemptées). La valeur « 1 » spécifie que la connexion est exemptée. Si aucune valeur n’est spécifiée, la valeur par défaut est « 0 » (non exemptée).

Pour autoriser MMS lorsque les données sont définies sur OFF, définissez ExemptFromDisablePolicy et UseRequiresMappingsPolicy sur « 1 ». Ces paramètres indiquent que la connexion est une connexion MMS dédiée et qu’elle ne doit pas être désactivée lorsque toutes les autres connexions sont désactivées. Par conséquent, mms peuvent être envoyés et reçus lorsque les données sont définies sur OFF.

Remarque

L’envoi de MMS en itinérance n’est toujours pas autorisé.

Important

Ne définissez pas ExemptFromDisablePolicy sur « 1 », ExemptFromRoaming sur « 1 » ou UseRequiresMappingsPolicy sur « 1 » pour les connexions à usage général.

Pour éviter l’incohérence de l’expérience utilisateur avec certaines combinaisons de valeurs exemptFromDisablePolicy et AllowMmsIfDataIsOff, lorsque vous ne définissez pas ExemptFromDisablePolicy sur 1 (la valeur par défaut est 0), vous devez :

• Masquez le bouton bascule pour AllowMmsIfDataIsOff en définissant AllowMmsIfDataIsOffEnabled sur 0 (la valeur par défaut est 1)
• Définissez AllowMMSIfDataIsOff sur 1 (la valeur par défaut est 0)

ExemptFromRoaming Rajouté dans Windows 10, version 1511. Facultatif. Type : Int. Cette valeur doit être spécifiée uniquement pour les connexions à usage spécial dont les applications gèrent directement leur état d’itinérance. Il ne doit jamais être utilisé avec des connexions à usage général. La valeur « 0 » spécifie que la connexion est soumise à la stratégie d’itinérance (non exemptée). La valeur « 1 » spécifie que la connexion est exemptée (non affectée par la stratégie d’itinérance). Si aucune valeur n’est spécifiée, la valeur par défaut est « 0 » (non exemptée).

TetheringNAI Optionnel. Type : Int. CDMA uniquement. Spécifie si la connexion est une connexion de connexion. La valeur « 0 » spécifie que la connexion n’est pas une connexion de liaison. La valeur « 1 » spécifie que la connexion est une connexion de connexion. Si aucune valeur n’est spécifiée, la valeur par défaut est « 0 ».

IdleDisconnectTimeout Optionnel. Type : Int. Spécifie la durée pendant laquelle une connexion à la demande peut être inutilisée avant que Gestionnaire des connexions l’arrêt de la connexion. Cette valeur est spécifiée en secondes. La plage de valeurs valide est comprise entre 5 et 60 secondes. S’il n’est pas spécifié, la valeur par défaut est 30 secondes.

Important

Vous devez spécifier la valeur IdleDisconnectTimeout lors de la mise à jour d’une connexion à la demande pour vous assurer que la valeur souhaitée est toujours configurée. S’il n’est pas spécifié, la valeur par défaut de 30 secondes peut être utilisée.

Remarque

Si les demandes de désactivation/activation se produisent trop fréquemment, cette valeur doit être définie sur plus de 5 secondes.

SimIccId Pour les téléphones SIM simples, ce paramètre est facultatif. Toutefois, il est fortement recommandé d’inclure cette valeur lors de la création de mises à jour ultérieures. Pour les téléphones double SIM, ce paramètre est obligatoire. Type : Chaîne. Spécifie l’ICCID SIM qui dessert la connexion.

PurposeGroups Obligatoire. Type : Chaîne. Spécifie les objectifs de la connexion par une liste de GUID séparés par des virgules représentant des valeurs d’objectif. Les valeurs d’objectif suivantes sont disponibles :

• Internet - 3E5545D2-1137-4DC8-A198-33F1C657515F
• Attachement LTE - 11A6FE68-5B47-4859-9CB6-1EAC96A8F0BD
• MMS - 53E2C5D3-D13C-4068-AA38-9C48FF2E55A8
• IMS - 474D66ED-0E4B-476B-A455-19BB1239ED13
• SUPL - 6D42669F-52A9-408E-9493-1071DCC437BD
• Achat - 95522B2B-A6D1-4E40-960B-05E6D3F962AB
• Administration - 2FFD9261-C23C-4D27-8DCF-CDE4E14A3364
• Application - 52D7654A-00A8-4140-806C-087D66705306
• Provisionnement eSIM - A36E171F-2377-4965-88FE-1F53EB4B47C0

Informations complémentaires

Pour supprimer une connexion, vous devez d’abord supprimer tous les proxys associés, puis supprimer la connexion. L’exemple suivant montre comment supprimer le proxy, puis la connexion.

<wap-provisioningdoc>
   <characteristic type="CM_ProxyEntries">
      <nocharacteristic type="GPRS_Proxy"/>
   </characteristic>
   <characteristic type="CM_CellularEntries">
      <nocharacteristic type="GPRS1"/>
   </characteristic>
</wap-provisioningdoc>

Exemples d’approvisionnement de client OMA

Configuration d’une connexion GPRS :

<wap-provisioningdoc>
   <characteristic type="CM_CellularEntries">
      <characteristic type="GPRSConn">
         <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>
</wap-provisioningdoc>

Configuration d’une connexion LTE :

<wap-provisioningdoc>
   <characteristic type="CM_CellularEntries">
      <characteristic type="LteConn">
         <parm name="ConnectionType" value="lte" />
         <characteristic type="DevSpecificCellular">
            <parm name="GPRSInfoAccessPointName" value="INTERNET_LTE" />
         </characteristic>
         <parm name="ApnId" value="0" />
         <parm name="IPType" value="IPv4v6" />
         <parm name="Enabled" value="1" />
         <parm name="OemConnectionId" value="01234567-89AB-CDEF-0123-456789ABCDEF" />
      </characteristic>
   </characteristic>
</wap-provisioningdoc>

Configuration d’une connexion CDMA :

<wap-provisioningdoc>
   <characteristic type="CM_CellularEntries">
      <characteristic type="CDMAConn">
         <parm name="Version" value="1"/>
         <parm name="AuthType" value="chap" />
         <parm name="ConnectionType" value="cdma"/>
         <parm name="Enabled" value="1"/>
         <parm name="AlwaysOn" value="0"/>
         <parm name="UseRequiresMappingsPolicy" value="0"/>
         <parm name="UserName" value="user@adatum.com"/>
         <parm name="Password" value="fakeuserpassword"/>
      </characteristic>
   </characteristic>
</wap-provisioningdoc>

Microsoft Custom Elements

Le tableau suivant présente les éléments personnalisés Microsoft pris en charge par ce fournisseur de services de configuration pour l’approvisionnement du client OMA.

Élément	Disponible
Nocharacteristic	Oui
Caractéristique-query	Oui
Parm-query	Oui

Rubriques associées

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