CM_CellularEntries CSP

En la tabla siguiente se muestra la aplicabilidad de Windows:

Edición	Windows 10	Windows 11
Inicio	Sí	Sí
Pro	Sí	Sí
Windows SE	No	Sí
Negocios	Sí	Sí
Empresa	Sí	Sí
Educación	Sí	Sí

El proveedor de servicios de configuración de CM_CellularEntries se usa para configurar las entradas del Servicio general de radio de paquetes (GPRS) en el dispositivo. Define cada punto de acceso a datos GSM.

Este proveedor de servicios de configuración requiere que se acceda a la funcionalidad de ID_CAP_NETWORKING_ADMIN desde una aplicación de configuración de red.

En el ejemplo siguiente se muestra el objeto de administración del proveedor de servicios de configuración de CM_CellularEntries en formato de árbol, tal como lo usa Open Mobile Alliance Client Provisioning (OMA CP). El protocolo OMA DM no se admite con este proveedor de servicios de configuración.

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 Define el nombre de la conexión.

El proveedor de servicios de configuración de CMPolicy usa el valor de entryname para identificar la conexión asociada a una directiva y CM_ProxyEntries proveedor de servicios de configuración usa el valor de entryname para identificar la conexión asociada a un proxy.

Alwayson Tipo: Int. Especifica si el Administrador de conexiones intentará conectarse automáticamente al APN cuando haya una conexión disponible.

Un valor de "0" especifica que No se admite AlwaysOn y el Administrador de conexiones solo intentará conectarse al APN cuando una aplicación solicite la conexión. Esta configuración se recomienda para las aplicaciones que usan una conexión de vez en cuando. Por ejemplo, un APN que solo controla MMS.

Un valor de "1" especifica que se admite AlwaysOn y el Administrador de conexiones intentará conectarse automáticamente al APN cuando esté disponible. Esta configuración se recomienda para los APN de Internet de uso general.

Debe haber al menos una conexión a Internet AlwaysOn aprovisionada para el operador de telefonía móvil.

AuthType Opcional. Tipo: String. Especifica el método de autenticación usado para una conexión.

Un valor de "CHAP" especifica el protocolo de aplicación de protocolo de enlace de desafío. Un valor de "PAP" especifica el protocolo de autenticación de contraseña. Un valor de "None" especifica que se omiten los parámetros UserName y Password. El valor predeterminado es "None".

ConnectionType Opcional. Tipo: String. Especifica el tipo de conexión que se usa para el APN. Están disponibles los siguientes tipos de conexión:

Tipo de conexión	Uso
Gprs	Predeterminado. Se usa para conexiones de tipo GPRS (GPRS + GSM + EDGE + UMTS + LTE).
Cdma	Se usa para conexiones de tipo CDMA (1XRTT + EVDO).
Lte	Se usa para las conexiones de tipo LTE (eHRPD + LTE) cuando el dispositivo está registrado EN CASA.
Legado	Se usa para conexiones GPRS + GSM + EDGE + UMTS.
Lte_iwlan	Se usa para conexiones de tipo GPRS que se pueden descargar a través de WiFi.
Iwlan	Se usa para las conexiones que se implementan solo a través de la descarga de WiFi.

Desc.langid Opcional. Especifica la cadena de presentación de la interfaz de usuario utilizada por el identificador de idioma definido.

Se usará un nombre de parámetro con el formato Desc.langid como identificador específico del idioma para la entrada especificada. Por ejemplo, un parámetro definido como Desc.0409 con un valor de "GPRS Connection" obligará a que se muestre "Conexión GPRS" en la interfaz de usuario para representar esta conexión cuando el dispositivo esté establecido en idioma inglés (id. de idioma 0409). Las descripciones de varios idiomas se pueden aprovisionar mediante este mecanismo y el sistema cambiará automáticamente entre ellos si el usuario cambia las preferencias de idioma en el dispositivo. Si no se aprovisiona ningún parámetro Desc para un idioma determinado, el sistema tendrá como valor predeterminado el nombre usado para crear la entrada.

Habilitado Especifica si la conexión está habilitada.

Un valor de "0" especifica que la conexión está deshabilitada. Un valor de "1" especifica que la conexión está habilitada.

IpHeaderCompression Opcional. Especifica si la compresión del encabezado IP está habilitada.

Un valor de "0" especifica que la compresión del encabezado IP para la conexión está deshabilitada. Un valor de "1" especifica que la compresión del encabezado IP para la conexión está habilitada.

Contraseña Obligatorio si AuthType se establece en un valor distinto de "None". Especifica la contraseña usada para conectarse al APN.

SwCompression Opcional. Especifica si la compresión de software está habilitada.

Un valor de "0" especifica que la compresión de software para la conexión está deshabilitada. Un valor de "1" especifica que la compresión de software para la conexión está habilitada.

Nombre de usuario Obligatorio si AuthType se establece en un valor distinto de "None". Especifica el nombre de usuario usado para conectarse al APN.

UseRequiresMappingsPolicy Opcional. Especifica si la conexión requiere una directiva de asignaciones correspondiente.

Un valor de "0" especifica que la conexión se puede usar para cualquier comunicación general de Internet. Un valor de "1" especifica que la conexión solo se usa si hay una directiva de asignación.

Por ejemplo, si el APN del servicio de mensajería multimedia (MMS) no debe tener ningún otro tráfico excepto MMS, puede configurar una directiva de asignación que envíe tráfico MMS a esta conexión. A continuación, establezca el valor de UseRequiresMappingsPolicy en "1" y Administrador de conexiones solo usará la conexión para el tráfico MMS. Sin esto, Administrador de conexiones intentará usar la conexión para cualquier tráfico de Internet de uso general.

Versión Tipo: Int. Especifica el número de versión XML y se usa para comprobar que el xml es compatible con el proveedor de servicios de configuración de Administrador de conexiones.

Este valor debe ser "1" si se incluye.

GPRSInfoAccessPointName Especifica el nombre lógico para seleccionar la puerta de enlace GPRS. Para obtener más información sobre los valores permitidos, consulte la especificación GSM 07.07 "10.1.1 Definir contexto PDP +CGDCONT".

Roaming Opcional. Tipo: Int. Este parámetro especifica las condiciones de itinerancia en las que se debe activar la conexión. Están disponibles las condiciones siguientes:

• 0: solo red principal.
• 1 (valor predeterminado): todas las condiciones de itinerancia (hogar y itinerancia).
• 2 - Solo itinerancia doméstica y doméstica.
• 3 - Solo itinerancia nacional.
• 4 - Solo itinerancia no nacional.
• 5 - Solo itinerancia.

OEMConnectionID Opcional. Tipo: GUID. Especifica un GUID que se usa para identificar una conexión específica en el módem. Si no se especifica un valor, el valor predeterminado es 000000000-0000-0000-0000-00000000000000000. Este parámetro solo se usa en dispositivos LTE.

ApnId Opcional. Tipo: Int. Especifica el propósito del APN. Si no se especifica un valor, el valor predeterminado es "0" (ninguno). Este parámetro solo se usa en dispositivos LTE.

IPType Opcional. Tipo: String. Especifica el protocolo de red de la conexión. Los valores disponibles son "IPv4", "IPv6", "IPv4v6" y "IPv4v6xlat". Si no se especifica un valor, el valor predeterminado es "IPv4".

Advertencia

No use IPv6 o IPv4v6xlat en un dispositivo o red que no admita IPv6. La funcionalidad de datos no funcionará. Además, el dispositivo no podrá conectarse a una red móvil que no admita IPv6 a menos que configure conexiones móviles con un IPType de IPv4v6.

ExemptFromDisablePolicy Se ha agregado de nuevo en Windows 10, versión 1511. Opcional. Tipo: Int. Este valor solo debe especificarse para las conexiones de uso especial cuyas aplicaciones administran directamente su estado de deshabilitación (por ejemplo, MMS). Un valor de "0" especifica que la conexión está sujeta a la directiva de deshabilitación que usan las conexiones de uso general (no exentas). Un valor de "1" especifica que la conexión está exenta. Si no se especifica un valor, el valor predeterminado es "0" (no exento).

Para permitir MMS cuando los datos se establecen en OFF, establezca ExemptFromDisablePolicy y UseRequiresMappingsPolicy en "1". Esta configuración indica que la conexión es una conexión MMS dedicada y que no debe deshabilitarse cuando se deshabilitan todas las demás conexiones. Como resultado, MMS se puede enviar y recibir cuando los datos se establecen en OFF.

Nota

No se permite el envío de MMS durante la itinerancia.

Importante

No establezca ExemptFromDisablePolicy en "1", ExemptFromRoaming en "1" o UseRequiresMappingsPolicy en "1" para las conexiones de uso general.

Para evitar la incoherencia de experiencia de usuario con ciertas combinaciones de valores de ExemptFromDisablePolicy y AllowMmsIfDataIsOff, cuando no establezca ExemptFromDisablePolicy en 1 (el valor predeterminado es 0), debe:

• Para ocultar el botón de alternancia de AllowMmsIfDataIsOff, establezca AllowMmsIfDataIsOffEnabled en 0 (el valor predeterminado es 1)
• Establezca AllowMMSIfDataIsOff en 1 (el valor predeterminado es 0)

ExemptFromRoaming Se ha agregado de nuevo en Windows 10, versión 1511. Opcional. Tipo: Int. Este valor solo debe especificarse para las conexiones de uso especial cuyas aplicaciones administran directamente su estado de itinerancia. Nunca se debe usar con conexiones de uso general. Un valor de "0" especifica que la conexión está sujeta a la directiva de itinerancia (no exenta). Un valor de "1" especifica que la conexión está exenta (no afectada por la directiva de itinerancia). Si no se especifica un valor, el valor predeterminado es "0" (no exento).

TetheringNAI Opcional. Tipo: Int. Solo CDMA. Especifica si la conexión es una conexión de anclaje. Un valor de "0" especifica que la conexión no es una conexión de anclaje. Un valor de "1" especifica que la conexión es una conexión de anclaje. Si no se especifica un valor, el valor predeterminado es "0".

IdleDisconnectTimeout Opcional. Tipo: Int. Especifica cuánto tiempo puede no usarse una conexión a petición antes de Administrador de conexiones desintega la conexión. Este valor se especifica en segundos. El intervalo de valores válido es de 5 a 60 segundos. Si no se especifica, el valor predeterminado es de 30 segundos.

Importante

Debe especificar el valor IdleDisconnectTimeout al actualizar una conexión a petición para asegurarse de que el valor deseado sigue configurado. Si no se especifica, se puede usar el valor predeterminado de 30 segundos.

Nota

Si las solicitudes de desactivación o activación se producen con demasiada frecuencia, este valor debe establecerse en más de 5 segundos.

SimIccId Para teléfonos SIM únicos, este parm es Opcional. Sin embargo, se recomienda encarecidamente incluir este valor al crear actualizaciones futuras. En el caso de los teléfonos SIM duales, se requiere este parm. Tipo: String. Especifica el ICCID de SIM que presta servicios a la conexión.

PurposeGroups Obligatorio. Tipo: String. Especifica los propósitos de la conexión mediante una lista separada por comas de GUID que representan valores de propósito. Los siguientes valores de propósito están disponibles:

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

Información adicional

Para eliminar una conexión, primero debe eliminar los servidores proxy asociados y, a continuación, eliminar la conexión. En el ejemplo siguiente se muestra cómo eliminar el proxy y, a continuación, la conexión.

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

Ejemplos de aprovisionamiento de clientes OMA

Configuración de una conexión 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>

Configuración de una conexión 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>

Configuración de una conexión 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>

Elementos personalizados de Microsoft

En la tabla siguiente se muestran los elementos personalizados de Microsoft que este proveedor de servicios de configuración admite para el aprovisionamiento de clientes OMA.

Elemento	Disponible
Nocharacteristic	Sí
Característica-consulta	Sí
Parm-query	Sí

Temas relacionados

Referencia de proveedor de servicios de configuración