CM_CellularEntries-Konfigurationsdienstanbieter

Die folgende Tabelle zeigt die Anwendbarkeit von Windows:

Edition	Windows 10	Windows 11
POS1	Ja	Ja
Vorteil	Ja	Ja
Windows SE	Nein	Ja
Business	Ja	Ja
Unternehmen	Ja	Ja
Bildung	Ja	Ja

Der CM_CellularEntries Konfigurationsdienstanbieter wird verwendet, um die GPRS-Einträge (General Packet Radio Service) auf dem Gerät zu konfigurieren. Es definiert jeden GSM-Datenzugriffspunkt.

Für diesen Konfigurationsdienstanbieter muss über eine Netzwerkkonfigurationsanwendung auf die ID_CAP_NETWORKING_ADMIN-Funktion zugegriffen werden.

Das folgende Beispiel zeigt das CM_CellularEntries Konfigurationsdienstanbieterverwaltungsobjekt im Strukturformat, das von Open Mobile Alliance Client Provisioning (OMA CP) verwendet wird. Das OMA DM-Protokoll wird von diesem Konfigurationsdienstanbieter nicht unterstützt.

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 Definiert den Namen der Verbindung.

Der CMPolicy-Konfigurationsdienstanbieter verwendet den Wert von entryname , um die Verbindung zu identifizieren, die einer Richtlinie zugeordnet ist, und CM_ProxyEntries Konfigurationsdienstanbieter verwendet den Wert von entryname , um die Verbindung zu identifizieren, die einem Proxy zugeordnet ist.

Alwayson Typ: Int. Gibt an, ob der Verbindungs-Manager automatisch versucht, eine Verbindung mit dem APN herzustellen, wenn eine Verbindung verfügbar ist.

Der Wert "0" gibt an, dass AlwaysOn nicht unterstützt wird, und der Verbindungs-Manager versucht nur, eine Verbindung mit dem APN herzustellen, wenn eine Anwendung die Verbindung anfordert. Diese Einstellung wird für Anwendungen empfohlen, die gelegentlich eine Verbindung verwenden. Beispielsweise ein APN, der nur MMS steuert.

Der Wert "1" gibt an, dass AlwaysOn unterstützt wird, und der Verbindungs-Manager versucht automatisch, eine Verbindung mit dem APN herzustellen, wenn er verfügbar ist. Diese Einstellung wird für allgemeine Internet-APNs empfohlen.

Es muss mindestens eine AlwaysOn-Internetverbindung für den Mobilfunkanbieter bereitgestellt werden.

Authtype Optional. Typ: Zeichenfolge. Gibt die Authentifizierungsmethode an, die für eine Verbindung verwendet wird.

Der Wert "CHAP" gibt das Challenge Handshake Application Protocol an. Der Wert "PAP" gibt das Kennwortauthentifizierungsprotokoll an. Der Wert "None" gibt an, dass die Parameter UserName und Password ignoriert werden. Der Standardwert ist "None".

ConnectionType Optional. Typ: Zeichenfolge. Gibt den Verbindungstyp an, der für den APN verwendet wird. Die folgenden Verbindungstypen sind verfügbar:

Verbindungstyp	Verwendungszweck
Gprs	Standard. Wird für GPRS-Verbindungen (GPRS + GSM + EDGE + UMTS + LTE) verwendet.
Cdma	Wird für CDMA-Verbindungen (1XRTT + EVDO) verwendet.
Lte	Wird für LTE-Verbindungen (eHRPD + LTE) verwendet, wenn das Gerät HOME registriert ist.
Hinterlassenschaft	Wird für GPRS +GSM + EDGE + UMTS-Verbindungen verwendet.
Lte_iwlan	Wird für GPRS-Verbindungen verwendet, die über WLAN ausgeladen werden können.
Iwlan	Wird nur für Verbindungen verwendet, die nur über WLAN-Auslagerung implementiert werden.

Desc.langid Optional. Gibt die Anzeigezeichenfolge der Benutzeroberfläche an, die von der definierten Sprach-ID verwendet wird.

Ein Parametername im Format Desc.langid wird als sprachspezifischer Bezeichner für den angegebenen Eintrag verwendet. Beispielsweise erzwingt ein Parameter, der als Desc.0409 mit dem Wert definiert "GPRS Connection" ist, dass "GPRS-Verbindung" auf der Benutzeroberfläche angezeigt wird, um diese Verbindung darzustellen, wenn das Gerät auf Englisch festgelegt ist (Sprach-ID 0409). Beschreibungen für mehrere Sprachen können mithilfe dieses Mechanismus bereitgestellt werden, und das System wechselt automatisch zwischen ihnen, wenn der Benutzer die Spracheinstellungen auf dem Gerät ändert. Wenn für eine bestimmte Sprache kein Desc-Parameter bereitgestellt wird, verwendet das System standardmäßig den Namen, der zum Erstellen des Eintrags verwendet wurde.

Aktiviert Gibt an, ob die Verbindung aktiviert ist.

Der Wert "0" gibt an, dass die Verbindung deaktiviert ist. Der Wert "1" gibt an, dass die Verbindung aktiviert ist.

IpHeaderCompression Optional. Gibt an, ob die IP-Headerkomprimierung aktiviert ist.

Der Wert "0" gibt an, dass die IP-Headerkomprimierung für die Verbindung deaktiviert ist. Der Wert "1" gibt an, dass die IP-Headerkomprimierung für die Verbindung aktiviert ist.

Passwort Erforderlich, wenn AuthType auf einen anderen Wert als "None" festgelegt ist. Gibt das Kennwort an, das zum Herstellen einer Verbindung mit dem APN verwendet wird.

SwCompression Optional. Gibt an, ob die Softwarekomprimierung aktiviert ist.

Der Wert "0" gibt an, dass die Softwarekomprimierung für die Verbindung deaktiviert ist. Der Wert "1" gibt an, dass die Softwarekomprimierung für die Verbindung aktiviert ist.

Nutzername Erforderlich, wenn AuthType auf einen anderen Wert als "None" festgelegt ist. Gibt den Benutzernamen an, der zum Herstellen einer Verbindung mit dem APN verwendet wird.

UseRequiresMappingsPolicy Optional. Gibt an, ob für die Verbindung eine entsprechende Zuordnungsrichtlinie erforderlich ist.

Der Wert "0" gibt an, dass die Verbindung für jede allgemeine Internetkommunikation verwendet werden kann. Der Wert "1" gibt an, dass die Verbindung nur verwendet wird, wenn eine Zuordnungsrichtlinie vorhanden ist.

Wenn der MMS-APN (Multimedia Messaging Service) beispielsweise keinen anderen Datenverkehr außer MMS aufweisen soll, können Sie eine Zuordnungsrichtlinie konfigurieren, die MMS-Datenverkehr an diese Verbindung sendet. Anschließend legen Sie den Wert von UseRequiresMappingsPolicy auf "1" fest, und Verbindungs-Manager nur die Verbindung für MMS-Datenverkehr verwendet. Ohne dies versuchen Verbindungs-Manager, die Verbindung für allgemeinen Internetdatenverkehr zu verwenden.

Version Typ: Int. Gibt die XML-Versionsnummer an und wird verwendet, um zu überprüfen, ob die XML vom Konfigurationsdienstanbieter von Verbindungs-Manager unterstützt wird.

Dieser Wert muss "1" sein, wenn er enthalten ist.

GPRSInfoAccessPointName Gibt den logischen Namen zum Auswählen des GPRS-Gateways an. Weitere Informationen zu zulässigen Werten finden Sie unter GSM-Spezifikation 07.07 "10.1.1 PdP-Kontext +CGDCONT definieren".

Roaming Optional. Typ: Int. Dieser Parameter gibt die Roamingbedingungen an, unter denen die Verbindung aktiviert werden soll. Die folgenden Bedingungen sind verfügbar:

• 0 – Nur Heimnetzwerk.
• 1 (Standard) – Alle Roamingbedingungen (Home und Roaming).
• 2 – Nur Roaming für Privat- und Inlandsroaming.
• 3 – Nur Inländisches Roaming.
• 4 – Nur Nicht-Inlandsroaming.
• 5 – Nur Roaming.

OEMConnectionID Optional. Typ: GUID. Gibt eine GUID an, die verwendet wird, um eine bestimmte Verbindung im Modem zu identifizieren. Wenn kein Wert angegeben wird, lautet der Standardwert 0000000000-0000-0000-0000-0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000 Dieser Parameter wird nur auf LTE-Geräten verwendet.

ApnId Optional. Typ: Int. Gibt den Zweck des APN an. Wenn kein Wert angegeben wird, lautet der Standardwert "0" (keine). Dieser Parameter wird nur auf LTE-Geräten verwendet.

IPType Optional. Typ: Zeichenfolge. Gibt das Netzwerkprotokoll der Verbindung an. Verfügbare Werte sind "IPv4", "IPv6", "IPv4v6" und "IPv4v6xlat". Wenn kein Wert angegeben wird, lautet der Standardwert "IPv4".

Warnung

Verwenden Sie IPv6 oder IPv4v6xlat nicht auf einem Gerät oder Netzwerk, das IPv6 nicht unterstützt. Die Datenfunktionalität funktioniert nicht. Darüber hinaus kann das Gerät keine Verbindung mit einem Roamingnetzwerk herstellen, das IPv6 nicht unterstützt, es sei denn, Sie konfigurieren Roamingverbindungen mit dem IPType IPv4v6.

ExemptFromDisablePolicy Zurück in Windows 10, Version 1511 hinzugefügt. Optional. Typ: Int. Dieser Wert sollte nur für spezielle Verbindungen angegeben werden, deren Anwendungen ihren Deaktivierungszustand direkt verwalten (z. B. MMS). Der Wert "0" gibt an, dass die Verbindung der Deaktivierungsrichtlinie unterliegt, die von allgemeinen Verbindungen verwendet wird (nicht ausgenommen). Der Wert "1" gibt an, dass die Verbindung ausgenommen ist. Wenn kein Wert angegeben wird, lautet der Standardwert "0" (nicht ausgenommen).

Um MMS zuzulassen, wenn daten auf OFF festgelegt sind, legen Sie sowohl ExemptFromDisablePolicy als auch UseRequiresMappingsPolicy auf "1" fest. Diese Einstellungen geben an, dass die Verbindung eine dedizierte MMS-Verbindung ist und nicht deaktiviert werden soll, wenn alle anderen Verbindungen deaktiviert sind. Daher kann MMS gesendet und empfangen werden, wenn Die Daten auf OFF festgelegt sind.

Hinweis

Das Senden von MMS während des Roamings ist immer noch nicht zulässig.

Wichtig

Legen Sie ExemptFromDisablePolicy nicht auf "1", ExemptFromRoaming auf "1" oder UseRequiresMappingsPolicy auf "1" für allgemeine Verbindungen fest.

Um UX-Inkonsistenzen mit bestimmten Wertkombinationen von ExemptFromDisablePolicy und AllowMmsIfDataIsOff zu vermeiden, sollten Sie Folgendes tun, wenn Sie ExemptFromDisablePolicy nicht auf 1 (Standardwert ist 0) festlegen:

• Blenden Sie die Umschaltfläche für AllowMmsIfDataIsOff aus, indem Sie AllowMmsIfDataIsOffEnabled auf 0 festlegen (Standardeinstellung: 1).
• Legen Sie AllowMMSIfDataIsOff auf 1 fest (Standardwert 0).

ExemptFromRoaming Zurück in Windows 10, Version 1511 hinzugefügt. Optional. Typ: Int. Dieser Wert sollte nur für spezielle Verbindungen angegeben werden, deren Anwendungen ihren Roamingstatus direkt verwalten. Es sollte niemals mit allgemeinen Verbindungen verwendet werden. Der Wert "0" gibt an, dass die Verbindung der Roamingrichtlinie unterliegt (nicht ausgenommen). Der Wert "1" gibt an, dass die Verbindung ausgenommen ist (nicht betroffen von der Roamingrichtlinie). Wenn kein Wert angegeben wird, lautet der Standardwert "0" (nicht ausgenommen).

TetheringNAI Optional. Typ: Nur Int. CDMA. Gibt an, ob die Verbindung eine Tetheringverbindung ist. Der Wert "0" gibt an, dass die Verbindung keine Tetheringverbindung ist. Der Wert "1" gibt an, dass die Verbindung eine Tetheringverbindung ist. Wenn kein Wert angegeben wird, lautet der Standardwert "0".

IdleDisconnectTimeout Optional. Typ: Int. Gibt an, wie lange eine bedarfsgesteuerte Verbindung nicht verwendet werden kann, bevor Verbindungs-Manager die Verbindung beendet. Dieser Wert wird in Sekunden angegeben. Gültiger Wertbereich ist 5 bis 60 Sekunden. Wenn nicht angegeben, beträgt der Standardwert 30 Sekunden.

Wichtig

Sie müssen den Wert IdleDisconnectTimeout angeben, wenn Sie eine bedarfsgesteuerte Verbindung aktualisieren, um sicherzustellen, dass der gewünschte Wert noch konfiguriert ist. Wenn sie nicht angegeben ist, kann der Standardwert von 30 Sekunden verwendet werden.

Hinweis

Wenn Abbruch-/Aktivierungsanforderungen zu häufig auftreten, sollte dieser Wert auf mehr als 5 Sekunden festgelegt werden.

SimIccId Für einzelne SIM-Telefone ist diese Parm optional. Es wird jedoch dringend empfohlen, diesen Wert beim Erstellen zukünftiger Updates einzuschließen. Für Dual-SIM-Telefone ist dieses Parm erforderlich. Typ: Zeichenfolge. Gibt die SIM-ICCID an, die die Verbindung bereitstellt.

PurposeGroups Erforderlich. Typ: Zeichenfolge. Gibt den Zweck der Verbindung durch eine durch Trennzeichen getrennte Liste von GUIDs an, die Zweckwerte darstellen. Die folgenden Zweckwerte sind verfügbar:

• Internet – 3E5545D2-1137-4DC8-A198-33F1C657515F
• LTE-Anschluss - 11A6FE68-5B47-4859-9CB6-1EAC96A8F0BD
• MMS - 53E2C5D3-D13C-4068-AA38-9C48FF2E55A8
• IMS – 474D66ED-0E4B-476B-A455-19BB1239ED13
• SUPL - 6D42669F-52A9-408E-9493-1071DCC437BD
• Kaufen - 95522B2B-A6D1-4E40-960B-05E6D3F962AB
• Administrativ – 2FFD9261-C23C-4D27-8DCF-CDE4E14A3364
• Anwendung : 52D7654A-00A8-4140-806C-087D66705306
• eSIM-Bereitstellung – A36E171F-2377-4965-88FE-1F53EB4B47C0

Weitere Informationen

Um eine Verbindung zu löschen, müssen Sie zuerst alle zugeordneten Proxys und dann die Verbindung löschen. Im folgenden Beispiel wird gezeigt, wie Sie den Proxy und dann die Verbindung löschen.

<wap-provisioningdoc>
   <characteristic type="CM_ProxyEntries">
      <nocharacteristic type="GPRS_Proxy"/>
   </characteristic>
   <characteristic type="CM_CellularEntries">
      <nocharacteristic type="GPRS1"/>
   </characteristic>
</wap-provisioningdoc>

Beispiele für die OMA-Clientbereitstellung

Konfigurieren einer GPRS-Verbindung:

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

Konfigurieren einer LTE-Verbindung:

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

Konfigurieren einer CDMA-Verbindung:

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

Benutzerdefinierte Microsoft-Elemente

Die folgende Tabelle zeigt die benutzerdefinierten Microsoft-Elemente, die dieser Konfigurationsdienstanbieter für die OMA-Clientbereitstellung unterstützt.

Element	Verfügbar
Nocharacteristic	Ja
Merkmalsabfrage	Ja
Parm-Query	Ja

Verwandte Themen

Referenz zum Konfigurationsdienstanbieter