CM_CellularEntries CSP

[アーティクル]
03/18/2023

次の表は、Windows の適用性を示しています。

エディション	Windows 10	Windows 11
ホーム	はい	はい
Pro	はい	はい
Windows SE	いいえ	はい
Business	はい	はい
Enterprise	はい	はい
Education	はい	はい

CM_CellularEntries構成サービスプロバイダーは、デバイスで General Packet Radio Service (GPRS) エントリを構成するために使用されます。各 GSM データアクセスポイントを定義します。

この構成サービスプロバイダーでは、ネットワーク構成アプリケーションからID_CAP_NETWORKING_ADMIN機能にアクセスする必要があります。

次の例は、Open Mobile Alliance Client Provisioning (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 への接続を試行します。この設定は、接続を使用する場合があるアプリケーションに推奨されます。たとえば、MMS のみを制御する APN です。

値 "1" は AlwaysOn がサポートされていることを指定し、接続マネージャーは使用可能な場合に APN への接続を自動的に試行します。この設定は、汎用インターネット APN に推奨されます。

携帯電話会社用に少なくとも 1 つの AlwaysOn インターネット接続がプロビジョニングされている必要があります。

AuthType オプション。型: 文字列。接続に使用される認証方法を指定します。

"CHAP" の値は、チャレンジハンドシェイクアプリケーションプロトコルを指定します。 "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) に設定されている場合に、この接続を表す "GPRS 接続" を UI に強制的に表示します。このメカニズムを使用して複数の言語の説明をプロビジョニングできます。ユーザーがデバイスの言語設定を変更すると、システムによって自動的に言語間が切り替わります。特定の言語に 対して 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 を指定します。値が指定されていない場合、既定値は 00000000-0000-0000-0000-00000000000 です。このパラメーターは、LTE デバイスでのみ使用されます。

ApnId オプション。型: Int。APN の目的を指定します。値が指定されていない場合、既定値は "0" (なし) です。このパラメーターは、LTE デバイスでのみ使用されます。

IPType オプション。型: 文字列。接続のネットワークプロトコルを指定します。使用可能な値は、"IPv4"、"IPv6"、"IPv4v6"、および "IPv4v6xlat" です。値が指定されていない場合、既定値は "IPv4" です。

Warning

IPv6 をサポートしていないデバイスまたはネットワークでは、IPv6 または IPv4v6xlat を使用しないでください。データ機能は機能しません。さらに、IPv4v6 の IPType を使用してローミング接続を構成しない限り、デバイスは IPv6 をサポートしないローミングネットワークに接続できません。

ExemptFromDisablePolicyバージョン 1511 Windows 10に再度追加されました。省略可能。型: 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バージョン 1511 Windows 10に再度追加されました。省略可能。型: Int。この値は、アプリケーションがローミング状態を直接管理する特殊な目的の接続にのみ指定する必要があります。汎用接続では使用しないでください。値 "0" は、接続がローミングポリシーの対象であることを指定します (除外されません)。値 "1" は、接続が除外されることを指定します (ローミングポリシーの影響を受けません)。値が指定されていない場合、既定値は "0" です (除外されません)。

テザリングNAI オプション。型: Int. CDMA のみ。接続がテザリング接続であるかどうかを指定します。値 "0" は、接続がテザリング接続ではないことを指定します。値 "1" は、接続がテザリング接続であることを指定します。値が指定されていない場合、既定値は "0" です。

IdleDisconnectTimeout オプション。型: Int。接続を切断するまでのオンデマンド接続接続マネージャー使用できる時間を指定します。この値は秒単位で指定されます。有効な値の範囲は 5 ~ 60 秒です。指定しない場合、既定値は 30 秒です。

重要

オンデマンド接続を更新するときに IdleDisconnectTimeout 値を指定して、必要な値が引き続き構成されていることを確認する必要があります。指定されていない場合は、既定値の 30 秒が使用される場合があります。

注

ティアダウン/アクティブ化要求が頻繁に発生する場合は、この値を 5 秒を超える値に設定する必要があります。

SimIccId 1 台の SIM 電話の場合、この parm は省略可能です。ただし、今後の更新プログラムを作成するときは、この値を含めておくことを強くお勧めします。デュアル SIM 電話の場合は、この parm が必要です。型: 文字列。接続を処理する 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 カスタム要素を示しています。

要素	利用可能
Nocharacteristic	はい
Characteristic-query	○
Parm-query	○

構成サービスプロバイダーのリファレンス

CM_CellularEntries CSP

追加情報

OMA クライアントプロビジョニングの例

Microsoft カスタム要素

フィードバック

フィードバック

その他のリソース

CM_CellularEntries CSP

追加情報

OMA クライアント プロビジョニングの例

Microsoft カスタム要素

関連トピック

フィードバック

フィードバック

その他のリソース

OMA クライアントプロビジョニングの例