Поставщик служб конфигурации CM_CellularEntries
В таблице ниже показано применимость Windows:
| Выпуск | Windows 10 | Windows 11 |
|---|---|---|
| Домашняя | Да | Да |
| Pro | Да | Да |
| Windows SE | Нет | Да |
| Для бизнеса | Да | Да |
| Корпоративная | Да | Да |
| Для образовательных учреждений | Да | Да |
Поставщик службы конфигурации CM_CellularEntries используется для настройки записей СЛУЖБЫ общей службы передачи пакетов (JSON) на устройстве. Он определяет каждую точку доступа к данным GSM.
Этому поставщику службы конфигурации требуется доступ к ID_CAP_NETWORKING_ADMIN из приложения конфигурации сети.
В следующем примере показан объект управления CM_CellularEntries поставщика услуг конфигурации в формате дерева, используемый при подготовке клиента Open Mobile Alliance (OMA CP). Протокол 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, который управляет только MMS.
Значение "1" указывает, что поддерживается AlwaysOn, и диспетчер подключений будет автоматически пытаться подключиться к APN, когда он будет доступен. Этот параметр рекомендуется использовать для интернет-приложений общего назначения.
Для оператора мобильной связи должно быть подготовлено по крайней мере одно подключение к Интернету AlwaysOn.
AuthType Дополнительные. Тип: String. Указывает метод проверки подлинности, используемый для подключения.
Значение CHAP указывает протокол приложения подтверждения запроса. Значение "PAP" указывает протокол проверки подлинности по паролю. Значение None указывает, что параметры UserName и Password игнорируются. Значение по умолчанию — "Нет".
ConnectionType Дополнительные. Тип: String. Указывает тип подключения, используемого для APN. Доступны следующие типы подключений:
| Тип подключения | Использование |
|---|---|
| Gprs | По умолчанию. Используется для подключений типа ИНСТРУКЦИИ (ЗАПРОСЫ+ GSM + EDGE + UMTS + LTE). |
| Cdma | Используется для подключений типа CDMA (1XRTT + EVDO). |
| Lte | Используется для подключений типа LTE (eHRPD + LTE), когда устройство зарегистрировано HOME. |
| Наследие | Используется для подключений UMTS+GSM+EDGE+UMTS. |
| Lte_iwlan | Используется для подключений типа JSON, которые могут быть разгружены через Wi-Fi. |
| Ивлан | Используется для подключений, реализованных только через разгрузку Wi-Fi. |
Desc.langid Необязательный. Указывает строку отображения пользовательского интерфейса, используемую определенным идентификатором языка.
Имя параметра в формате Desc.langid будет использоваться в качестве идентификатора языка для указанной записи. Например, параметр, определенный как Desc.0409 со значением "GPRS Connection" , будет принудительно отображаться в пользовательском интерфейсе значение "ПОДКЛЮЧЕНИЕ С ПОМОЩЬЮ ИНСТРУКЦИИ" для представления этого подключения, если для устройства задано значение "Английский язык" (идентификатор языка 0409). С помощью этого механизма можно подготовить описания для нескольких языков, и система автоматически переключается между ними, если пользователь изменяет языковые настройки на устройстве. Если параметр Desc не подготовлен для заданного языка, система по умолчанию будет использовать имя, используемое для создания записи.
Включен Указывает, включено ли подключение.
Значение "0" указывает, что подключение отключено. Значение "1" указывает, что подключение включено.
IpHeaderCompression Дополнительные. Указывает, включено ли сжатие ip-заголовков.
Значение "0" указывает, что сжатие ip-заголовков для подключения отключено. Значение "1" указывает, что сжатие ip-заголовков для подключения включено.
Пароль Требуется, если для AuthType задано значение, отличное от "None". Указывает пароль, используемый для подключения к APN.
SwCompression Дополнительные. Указывает, включено ли программное сжатие.
Значение "0" указывает, что программное сжатие для подключения отключено. Значение "1" указывает, что для подключения включено программное сжатие.
Пользователя Требуется, если для AuthType задано значение, отличное от "None". Указывает имя пользователя, используемое для подключения к APN.
UseRequiresMappingsPolicy Дополнительные. Указывает, требуется ли для подключения соответствующая политика сопоставлений.
Значение "0" указывает, что подключение может использоваться для любых общих подключений через Интернет. Значение "1" указывает, что подключение используется только при наличии политики сопоставления.
Например, если служба обмена сообщениями мультимедиа (MMS) APN не должна иметь никакого другого трафика, кроме MMS, можно настроить политику сопоставления, которая отправляет MMS-трафик в это подключение. Затем задайте значение UseRequiresMappingsPolicy равным "1", и диспетчер подключений будет использовать подключение только для трафика MMS. Без этого диспетчер подключений попытается использовать подключение для любого интернет-трафика общего назначения.
Версия Тип: Int. Указывает номер версии XML и используется для проверки поддержки XML поставщиком службы конфигурации диспетчер подключений.
Это значение должно быть "1", если он включен.
ИМЕНОИМЯСхимя объектов доступа Указывает логическое имя для выбора шлюза JSON. Дополнительные сведения о допустимых значениях см. в спецификации GSM 07.07 "10.1.1 Определение контекста PDP +CGDCONT".
Роуминг Дополнительные. Тип: Int. Этот параметр указывает условия перемещения, при которых должно быть активировано подключение. Доступны следующие условия:
- 0 — только домашняя сеть.
- 1 (по умолчанию) — все условия роуминга (домашний и роуминг).
- 2 — только домашний и внутренний роуминг.
- 3 — только внутренний роуминг.
- 4 — только роуминг, не относясь к стране.
- 5 — только роуминг.
OEMConnectionID Дополнительные. Тип: GUID. Указывает ИДЕНТИФИКАТОР GUID, используемый для идентификации определенного подключения в модеме. Если значение не указано, значение по умолчанию — 000000000-0000-0000-0000-0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000 Этот параметр используется только на устройствах LTE.
ApnId Дополнительные. Тип: Int. Указывает назначение APN. Если значение не указано, по умолчанию используется значение "0" (none). Этот параметр используется только на устройствах LTE.
IPType Дополнительные. Тип: String. Указывает сетевой протокол подключения. Доступные значения: "IPv4", "IPv6", "IPv4v6" и "IPv4v6xlat". Если значение не указано, значение по умолчанию — "IPv4".
Warning
Не используйте IPv6 или IPv4v6xlat на устройстве или в сети, которые не поддерживают IPv6. Функциональность данных не будет работать. Кроме того, устройство не сможет подключиться к роуминговой сети, которая не поддерживает IPv6, если вы не настроите роуминговые подключения с IPType IPv4v6.
ExemptFromDisablePolicy Добавлено в Windows 10 версии 1511. Необязательно. Тип: Int. Это значение следует указывать только для подключений специального назначения, приложения которых непосредственно управляют состоянием отключения (например, MMS). Значение "0" указывает, что к подключению применяется политика отключения, используемая подключениями общего назначения (не исключается). Значение "1" указывает, что подключение является исключенным. Если значение не указано, по умолчанию используется значение "0" (не исключение).
Чтобы разрешить MMS, если для данных задано значение OFF, задайте для параметра ExemptFromDisablePolicy и UseRequiresMappingsPolicy значение "1". Эти параметры указывают, что подключение является выделенным MMS-подключением и что оно не должно быть отключено при отключении всех остальных подключений. В результате MMS можно отправлять и получать, если для данных задано значение OFF.
Примечание.
Отправка MMS в роуминге по-прежнему запрещена.
Важно.
Не устанавливайте для параметра ExemptFromDisablePolicy значение "1", exemptFromRoaming — "1", или UseRequiresMappingsPolicy значение "1" для подключений общего назначения.
Чтобы избежать несоответствия пользовательского интерфейса с определенными сочетаниями значений ExemptFromDisablePolicy и AllowMmsIfDataIsOff, если параметру ExemptFromDisablePolicy не присвоено значение 1 (значение по умолчанию равно 0), необходимо:
- Скройте переключатель AllowMmsIfDataIsOff, установив для параметра AllowMmsIfDataIsOffEnabled значение 0 (по умолчанию — 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-картами этот параметр является обязательным. Тип: String. Указывает ИДЕНТИФИКАТОР ICCID SIM-карты, который обслуживает подключение.
PurposeGroups Обязательно. Тип: String. Указывает цели соединения с помощью разделенного запятыми списка идентификаторов GUID, представляющих значения назначения. Доступны следующие значения целей:
- Интернет - 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
Настройка подключения ЧЕРЕЗС:
<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>
Пользовательские элементы Майкрософт
В следующей таблице показаны пользовательские элементы Майкрософт, которые этот поставщик служб конфигурации поддерживает для подготовки клиентов OMA.
| Элемент | Доступно |
|---|---|
| Nocharacteristic | Да |
| Запрос характеристик | Да |
| Parm-query | Да |