CM_CellularEntries 云解决方案提供商

下表显示了 Windows 的适用性:

版次 Windows 10 Windows 11
Home 键
专业版
Windows SE
商用版
企业
教育

CM_CellularEntries配置服务提供程序用于在设备上配置常规数据包无线电服务 (GPRS) 条目。 它定义每个 GSM 数据访问点。

此配置服务提供程序需要从网络配置应用程序访问ID_CAP_NETWORKING_ADMIN功能。

以下示例显示 Open Mobile Alliance 客户端预配 (OMA CP) 使用的树格式CM_CellularEntries配置服务提供程序管理对象。 此配置服务提供程序不支持 OMA DM 协议。

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 定义连接的名称。

CMPolicy 配置服务提供程序使用 entryname 的值来标识与策略关联的连接,CM_ProxyEntries配置服务提供程序使用 entryname 的值来标识与代理关联的连接。

AlwaysOn类型:Int。指定当连接可用时,连接管理器是否会自动尝试连接到 APN。

值为“0”指定不支持 AlwaysOn,并且仅当应用程序请求连接时,连接管理器才会尝试连接到 APN。 对于偶尔使用连接的应用程序,建议使用此设置。 例如,仅控制彩信的 APN。

值为“1”指定支持 AlwaysOn,连接管理器将在 APN 可用时自动尝试连接到该 APN。 建议将此设置用于常规用途 Internet APN。

必须为移动运营商至少预配一个 AlwaysOn Internet 连接。

AuthType 选。 类型:字符串。 指定用于连接的身份验证方法。

值“CHAP”指定质询握手应用程序协议。 值为“PAP”指定密码身份验证协议。 值为“None”指定忽略“用户名”和“密码”参数。 默认值为“None”。

ConnectionType 选。 类型:字符串。 指定用于 APN 的连接类型。 以下连接类型可用:

连接类型 用途
Gprs 默认值。 用于 GPRS 类型连接 (GPRS + GSM + EDGE + UMTS + LTE) 。
Cdma 用于 CDMA 类型连接 (1XRTT + EVDO) 。
Lte 用于在设备注册 HOME 时 (eHRPD + LTE) LTE 类型连接。
遗产 用于 GPRS + GSM + EDGE + UMTS 连接。
Lte_iwlan 用于可能通过 WiFi 卸载的 GPRS 类型连接。
Iwlan 仅用于通过 WiFi 卸载实现的连接。

Desc.langid 可选。 指定定义的语言 ID 使用的 UI 显示字符串。

格式为 Desc.langid 的参数名称将用作指定条目的语言特定标识符。 例如,如果设备设置为英语, (语言 ID 0409) ,则定义为 Desc.0409"GPRS Connection" 的参数将强制在 UI 中显示“GPRS 连接”来表示此连接。 可以使用此机制预配多种语言的说明,如果用户更改设备上的语言首选项,系统会自动在它们之间切换。 如果没有为给定语言预配 Desc 参数,则系统会默认使用用于创建条目的名称。

启用 指定是否启用连接。

值“0”指定禁用连接。 值“1”指定启用连接。

IpHeaderCompression 选。 指定是否启用 IP 标头压缩。

值“0”指定禁用连接的 IP 标头压缩。 值“1”指定为连接启用 IP 标头压缩。

密码 如果 AuthType 设置为“None”以外的值,则是必需的。 指定用于连接到 APN 的密码。

SwCompression 选。 指定是否启用软件压缩。

值为“0”指定禁用连接的软件压缩。 值“1”指定为连接启用软件压缩。

用户 如果 AuthType 设置为“None”以外的值,则是必需的。 指定用于连接到 APN 的用户名。

UseRequiresMappingsPolicy 选。 指定连接是否需要相应的映射策略。

值“0”指定连接可用于任何常规 Internet 通信。 值“1”指定仅当存在映射策略时才使用连接。

例如,如果彩信服务 (彩信) APN 不应有除彩信以外的任何其他流量,则可以配置将彩信流量发送到此连接的映射策略。 然后,将 UseRequiresMappingsPolicy 的值设置为“1”,连接管理器将仅对彩信流量使用连接。 如果没有此功能,连接管理器将尝试将连接用于任何常规用途的 Internet 流量。

版本类型:Int。指定 XML 版本号,用于验证 连接管理器 的配置服务提供程序是否支持 XML。

如果包含此值,此值必须为“1”。

GPRSInfoAccessPointName 指定要选择 GPRS 网关的逻辑名称。 有关允许值的详细信息,请参阅 GSM 规范 07.07 “10.1.1 定义 PDP 上下文 +CGDCONT”。

漫游 选。 类型:Int。此参数指定应在其中激活连接的漫游条件。 以下条件可用:

  • 0 - 仅限家庭网络。
  • 1 (默认) - 所有漫游条件 (家庭和漫游) 。
  • 2 - 仅限家庭和国内漫游。
  • 3 - 仅限国内漫游。
  • 4 - 仅限非国内漫游。
  • 5 - 仅漫游。

OEMConnectionID 选。 类型:GUID。 指定用于标识调制解调器中的特定连接的 GUID。 如果未指定值,则默认值为 00000000-0000-0000-0000-0000000000000。 此参数仅在 LTE 设备上使用。

ApnId 选。 类型:Int。指定 APN 的用途。 如果未指定值,则默认值为“0” (无) 。 此参数仅在 LTE 设备上使用。

IPType 选。 类型:字符串。 指定连接的网络协议。 可用值为“IPv4”、“IPv6”、“IPv4v6”和“IPv4v6xlat”。 如果未指定值,则默认值为“IPv4”。

警告

请勿在不支持 IPv6 的设备或网络上使用 IPv6 或 IPv4v6xlat。 数据功能将不起作用。 此外,除非使用 IPv4v6 IPType 配置漫游连接,否则设备将无法连接到不支持 IPv6 的漫游网络。

ExemptFromDisablePolicy在 Windows 10 版本 1511 中添加。 可选。 类型:Int。仅应为应用程序直接管理其禁用状态 ((如彩信) )的特殊用途连接指定此值。 值“0”指定连接受常规用途连接使用的禁用策略的约束, (不免除) 。 值“1”指定连接不受限制。 如果未指定值,则默认值为“0” (不免除) 。

若要在数据设置为 OFF 时允许 MMS,请将 ExemptFromDisablePolicy 和 UseRequiresMappingsPolicy 都设置为“1”。 这些设置指示连接是专用彩信连接,在禁用所有其他连接时不应禁用该连接。 因此,当数据设置为 OFF 时,可以发送和接收彩信。

注意

仍不允许在漫游时发送彩信。

重要提示

对于常规用途连接,请勿将 ExemptFromDisablePolicy 设置为“1”,将 ExemptFromRoaming 设置为“1”,或将 UseRequiresMappingsPolicy 设置为“1”。

若要避免与 ExemptFromDisablePolicy 和 AllowMmsIfDataIsOff 的某些值组合出现 UX 不一致,如果未将 ExemptFromDisablePolicy 设置为 1, (默认值为 0) ,则应:

  • 通过将 AllowMmsIfDataIsOffEnabled 设置为 0 来隐藏 AllowMmsIfDataIsOff 的切换, (默认值为 1)
  • 将 AllowMMSIfDataIsOff 设置为 1 (默认值为 0)

ExemptFromRoaming在 Windows 10 版本 1511 中添加。 可选。 类型:Int。应仅为应用程序直接管理其漫游状态的特殊用途连接指定此值。 它绝不应与常规用途连接一起使用。 值“0”指定连接受漫游策略的约束, (不免除) 。 值为“1”指定不受漫游策略) 影响 (免除连接。 如果未指定值,则默认值为“0” (不免除) 。

TetheringNAI 选。 类型:仅限 Int. CDMA。 指定连接是否为网络共享连接。 值为“0”指定连接不是网络连接。 值“1”指定连接是网络共享连接。 如果未指定值,则默认值为“0”。

IdleDisconnectTimeout 选。 类型:Int。指定在连接管理器断开连接之前,按需连接可以未使用多长时间。 此值以秒为单位指定。 有效值范围为 5 到 60 秒。 如果未指定,则默认值为 30 秒。

重要提示

更新按需连接时,必须指定 IdleDisconnectTimeout 值,以确保仍配置所需的值。 如果未指定,可以使用默认值 30 秒。

注意

如果删除/激活请求发生得太频繁,此值应设置为大于 5 秒。

SimIccId 对于单 SIM 卡手机,此参数为可选。 但是,强烈建议在创建将来的更新时包含此值。 对于双 SIM 卡手机,需要此参数。 类型:字符串。 指定为连接提供服务的 SIM ICCID。

PurposeGroups 必填。 类型:字符串。 通过表示用途值的 GUID 的逗号分隔列表指定连接的目的。 以下用途值可用:

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

其他信息

若要删除连接,必须先删除任何关联的代理,然后删除连接。 以下示例演示如何删除代理,然后删除连接。

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

OMA 客户端预配示例

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

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

配置 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自定义元素

下表显示了此配置服务提供程序支持 OMA 客户端预配的Microsoft自定义元素。

元素 可用
Nocharacteristic
特征查询
Parm-query

配置服务提供程序参考