CM_CellularEntries CSP
아래 표에서는 Windows의 적용 가능성을 보여 줍니다.
버전 | Windows 10 | Windows 11 |
---|---|---|
Home | 예 | 예 |
Pro | 예 | 예 |
Windows SE | 아니요 | 예 |
Business | 예 | 예 |
Enterprise | 예 | 예 |
Education | 예 | 예 |
CM_CellularEntries 구성 서비스 공급자는 디바이스에서 GPRS(일반 패킷 라디오 서비스) 항목을 구성하는 데 사용됩니다. 각 GSM 데이터 액세스 지점을 정의합니다.
이 구성 서비스 공급자는 네트워크 구성 애플리케이션에서 ID_CAP_NETWORKING_ADMIN 기능에 액세스해야 합니다.
다음 예제에서는 OMA CP(Open Mobile Alliance Client Provisioning)에서 사용하는 트리 형식의 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
CMPolicy 구성 서비스 공급자는 entryname 값을 사용하여 정책과 연결된 연결을 식별하고 CM_ProxyEntries 구성 서비스 공급자는 entryname 값을 사용하여 프록시와 연결된 연결을 식별합니다.
Alwayson 형식: Int. 연결을 사용할 수 있을 때 연결 관리자 APN에 자동으로 연결을 시도할지 지정합니다.
값 "0"은 AlwaysOn이 지원되지 않도록 지정하며, 애플리케이션이 연결을 요청할 때만 연결 관리자 APN에 연결을 시도합니다. 이 설정은 가끔 연결을 사용하는 애플리케이션에 권장됩니다. 예를 들어 MMS만 제어하는 APN입니다.
값 "1"은 AlwaysOn이 지원되도록 지정하고 연결 관리자 APN을 사용할 수 있을 때 자동으로 연결을 시도합니다. 이 설정은 범용 인터넷 APN에 권장됩니다.
통신사에 대해 프로비전된 AlwaysOn 인터넷 연결이 하나 이상 있어야 합니다.
AuthType 선택적. 형식: 문자열입니다. 연결에 사용되는 인증 방법을 지정합니다.
"CHAP" 값은 Challenge 핸드셰이크 애플리케이션 프로토콜을 지정합니다. "PAP" 값은 암호 인증 프로토콜을 지정합니다. "None" 값은 UserName 및 Password 매개 변수가 무시되도록 지정합니다. 기본값은 "None"입니다.
ConnectionType 선택적. 형식: 문자열입니다. APN에 사용되는 연결 유형을 지정합니다. 사용할 수 있는 연결 유형은 다음과 같습니다.
연결 형식 | 사용 |
---|---|
Gprs | 기본. GPRS 형식 연결(GPRS + GSM + EDGE + UMTS + LTE)에 사용됩니다. |
Cdma | CDMA 형식 연결(1XRTT + EVDO)에 사용됩니다. |
Lte | 디바이스가 HOME에 등록될 때 LTE 유형 연결(eHRPD + LTE)에 사용됩니다. |
레거시 | GPRS + GSM + EDGE + UMTS 연결에 사용됩니다. |
Lte_iwlan | WiFi를 통해 오프로드될 수 있는 GPRS 형식 연결에 사용됩니다. |
Iwlan | WiFi 오프로드를 통해서만 구현되는 연결에 사용됩니다. |
Desc.langid 선택 사항입니다. 정의된 언어 ID에서 사용하는 UI 표시 문자열을 지정합니다.
Desc.langid 형식의 매개 변수 이름은 지정된 항목의 언어별 식별자로 사용됩니다. 예를 들어 값 "GPRS Connection"
으로 정의된 Desc.0409
매개 변수는 디바이스가 영어(언어 ID 0409)로 설정된 경우 UI에 "GPRS 연결"을 강제로 표시하여 이 연결을 나타냅니다. 이 메커니즘을 사용하여 여러 언어에 대한 설명을 프로비전할 수 있으며, 사용자가 디바이스에서 언어 기본 설정을 변경하면 시스템이 자동으로 해당 언어 간에 전환됩니다. 지정된 언어에 대해 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"이어야 합니다.
GPRSInfoAccessPointName GPRS 게이트웨이를 선택할 논리 이름을 지정합니다. 허용되는 값에 대한 자세한 내용은 GSM 사양 07.07 "10.1.1 PDP 컨텍스트 +CGDCONT 정의"를 참조하세요.
로밍 선택적. 형식: Int. 이 매개 변수는 연결을 활성화해야 하는 로밍 조건을 지정합니다. 사용할 수 있는 조건은 다음과 같습니다.
- 0 - 홈 네트워크만 해당됩니다.
- 1(기본값) - 모든 로밍 조건(홈 및 로밍).
- 2 - 가정 및 국내 로밍만 가능합니다.
- 3 - 국내 로밍만 가능합니다.
- 4 - 국내 이외의 로밍만 가능합니다.
- 5 - 로밍 전용입니다.
OEMConnectionID 선택적. 형식: GUID. 모뎀에서 특정 연결을 식별하는 데 사용되는 GUID를 지정합니다. 값을 지정하지 않으면 기본값은 000000000-0000-0000-0000-000000000000입니다. 이 매개 변수는 LTE 디바이스에서만 사용됩니다.
ApnId 선택적. 형식: Int. APN의 용도를 지정합니다. 값을 지정하지 않으면 기본값은 "0"(없음)입니다. 이 매개 변수는 LTE 디바이스에서만 사용됩니다.
IPType 선택적. 형식: 문자열입니다. 연결의 네트워크 프로토콜을 지정합니다. 사용 가능한 값은 "IPv4", "IPv6", "IPv4v6" 및 "IPv4v6xlat"입니다. 값을 지정하지 않으면 기본값은 "IPv4"입니다.
Warning
IPv6을 지원하지 않는 디바이스 또는 네트워크에서 IPv6 또는 IPv4v6xlat를 사용하지 마세요. 데이터 기능이 작동하지 않습니다. 또한 IPv4v6의 IPType을 사용하여 로밍 연결을 구성하지 않는 한 디바이스는 IPv6을 지원하지 않는 로밍 네트워크에 연결할 수 없습니다.
ExemptFromDisablePolicy Windows 10 버전 1511에 다시 추가되었습니다. 선택 사항. 형식: Int. 이 값은 애플리케이션이 사용 안 함 상태(예: MMS)를 직접 관리하는 특수 용도 연결에 대해서만 지정해야 합니다. 값 "0"은 연결이 범용 연결에서 사용하는 사용 안 함 정책의 적용을 받도록 지정합니다(제외되지 않음). 값 "1"은 연결이 제외되도록 지정합니다. 값을 지정하지 않으면 기본값은 "0"(제외되지 않음)입니다.
데이터가 OFF로 설정된 경우 MMS를 허용하려면 ExemptFromDisablePolicy 및 UseRequiresMappingsPolicy를 모두 "1"로 설정합니다. 이러한 설정은 연결이 전용 MMS 연결이며 다른 모든 연결을 사용하지 않도록 설정하면 안 됨을 나타냅니다. 따라서 데이터가 OFF로 설정되면 MMS를 보내고 받을 수 있습니다.
참고
로밍하는 동안 MMS를 보내는 것은 여전히 허용되지 않습니다.
중요
범용 연결을 위해 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의 쉼표로 구분된 목록으로 연결의 목적을 지정합니다. 사용할 수 있는 용도 값은 다음과 같습니다.
- 인터넷 - 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 사용자 지정 요소를 보여 줍니다.
요소 | 사용 가능 |
---|---|
무차원적 | 예 |
특성 쿼리 | 예 |
Parm 쿼리 | 예 |