共用方式為

CM_CellularEntries CSP

  • 發行項

下表顯示 Windows 的適用性：

版本 Windows 10 Windows 11
Home 是 是
專業版 是 是
Windows SE 否 是
商務 是 是
企業 是 是
教育版 是 是

CM_CellularEntries組態服務提供者可用來設定裝置上的一般封包無線電服務 (GPRS) 專案。 它會定義每個 GSM 資料存取點。

此設定服務提供者需要從網路組態應用程式存取ID_CAP_NETWORKING_ADMIN功能。

下列範例示範 CM_CellularEntries 設定服務提供者管理對象的樹狀結構格式，如 Open Mobile Alliance Client Provisioning (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 的值來識別與 Proxy 相關聯的連線。

AlwaysOn類型：Int。指定當連線可用時，連線管理員 是否會自動嘗試連線到 APN。

值 「0」 指定不支援 AlwaysOn，且 連線管理員 只會在應用程式要求連線時嘗試連線到 APN。 對於偶爾使用連線的應用程式，建議使用此設定。 例如，只控制MMS的APN。

值 「1」 指定支援 AlwaysOn，而 連線管理員 會在可用時自動嘗試連線到 APN。 此設定建議用於一般用途的因特網 APN。

至少必須為電信業者布建一個 AlwaysOn 因特網連線。

AuthType 選。 類型：字串。 指定用於連接的驗證方法。

“CHAP” 的值會指定挑戰交握應用程式通訊協定。 “PAP” 的值會指定密碼驗證通訊協定。 值 「None」 指定忽略 UserName 和 Password 參數。 預設值為 「None」。。

ConnectionType 選。 類型：字串。 指定用於APN的連接類型。 以下是可用的連線類型：

連線類型 Usage
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 選擇性。 指定定義的語言識別碼所使用的UI顯示字串。

將使用 Desc.langid 格式的參數名稱作為指定項目的語言特定識別碼。 例如，當裝置設定為 Desc.0409 英文語言 (語言標識碼 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」 指定連線可用於任何一般因特網通訊。 值 「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。 如果未指定值，預設值為0000000000-0000-0000-0000-0000-00000000000000000。 此參數僅用於 LTE 裝置。

ApnId 選。 類型：Int。指定 APN 的用途。 如果未指定值，則預設值為 “0”， () 。 此參數僅用於 LTE 裝置。

IPType 選。 類型：字串。 指定連線的網路協定。 可用的值為 「IPv4」、“IPv6”、“IPv4v6” 和 “IPv4v6xlat”。 如果未指定值，則預設值為 「IPv4」。。

警告

請勿在不支援 IPv6 的裝置或網路上使用 IPv6 或 IPv4v6xlat。 數據功能將無法運作。 此外，除非您使用 IPv4v6 的 IPType 設定漫遊連線，否則裝置將無法連線到不支援 IPv6 的漫遊網路。

ExemptFromDisablePolicy已在 Windows 10 1511 版中新增。 選用。 類型：Int。這個值應該只針對特殊用途的連線指定，其應用程式會直接管理其停用狀態 (例如MMS) 。 值 “0” 指定連線受限於一般用途連線所使用的停用原則， (不豁免) 。 值 「1」 指定連接為豁免。 如果未指定值，則預設值為 “0” (不豁免) 。

若要在數據設定為 OFF 時允許 MMS，請將 ExemptFromDisablePolicy 和 UseRequiresMappingsPolicy 設定為 “1”。 這些設定表示連線是專用的多媒體簡訊連線，而且當所有其他連線停用時，不應該停用該連線。 因此，當數據設定為 OFF 時，可以傳送和接收MMS。

注意

仍然不允許在漫遊時傳送多媒體簡訊。

重要

請勿將 ExemptFromDisablePolicy 設定為 “1”、將 ExemptFromRoaming 設定為 “1”，或將一般用途連線的 UseRequiresMappingsPolicy 設定為 “1”。

若要避免 UX 與 ExemptFromDisablePolicy 和 AllowMmsIfDataIsOff 的特定值組合不一致，當您未將 ExemptFromDisablePolicy 設定為 1 (預設值為 0) 時，您應該：

  • 將 AllowMmsIfDataIsOff 設為 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 清單指定連接的目的，這些 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

其他資訊

若要刪除連線，您必須先刪除任何相關聯的 Proxy，然後刪除連線。 下列範例示範如何刪除 Proxy，然後刪除連線。

<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 是

設定服務提供者參考