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

entryname 연결의 이름을 정의합니다.

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 쿼리	예

관련 항목

구성 서비스 공급자 참조