CSP CM_CellularEntries

La tabella seguente mostra l'applicabilità di Windows:

Edizione	Windows 10	Windows 11
Home	Sì	Sì
Pro	Sì	Sì
Windows SE	No	Sì
Lavoro	Sì	Sì
Per le aziende	Sì	Sì
Istruzione	Sì	Sì

Il provider del servizio di configurazione CM_CellularEntries viene usato per configurare le voci gprs (General Packet Radio Service) nel dispositivo. Definisce ogni punto di accesso ai dati GSM.

Questo provider di servizi di configurazione richiede l'accesso alla funzionalità ID_CAP_NETWORKING_ADMIN da un'applicazione di configurazione di rete.

L'esempio seguente mostra l'oggetto di gestione del provider di servizi di configurazione CM_CellularEntries in formato albero usato da Open Mobile Alliance Client Provisioning (OMA CP). Il protocollo OMA DM non è supportato con questo provider di servizi di configurazione.

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 Definisce il nome della connessione.

Il provider di servizi di configurazione CMPolicy usa il valore di entryname per identificare la connessione associata a un criterio e CM_ProxyEntries provider di servizi di configurazione usa il valore di entryname per identificare la connessione associata a un proxy.

Alwayson Tipo: Int. Specifica se il Gestione connessioni tenterà automaticamente di connettersi all'APN quando è disponibile una connessione.

Il valore "0" specifica che AlwaysOn non è supportato e il Gestione connessioni tenterà di connettersi all'APN solo quando un'applicazione richiede la connessione. Questa impostazione è consigliata per le applicazioni che usano occasionalmente una connessione. Ad esempio, un APN che controlla solo MMS.

Il valore "1" specifica che AlwaysOn è supportato e il Gestione connessioni tenterà automaticamente di connettersi all'APN quando è disponibile. Questa impostazione è consigliata per gli APN Internet per utilizzo generico.

È necessario effettuare il provisioning di almeno una connessione Internet AlwaysOn per l'operatore di telefonia mobile.

Authtype Opzionale. Tipo: Stringa. Specifica il metodo di autenticazione utilizzato per una connessione.

Il valore "CHAP" specifica il protocollo applicazione challenge handshake. Il valore "PAP" specifica il protocollo di autenticazione password. Il valore "None" specifica che i parametri UserName e Password vengono ignorati. Il valore predefinito è "None".

Connectiontype Opzionale. Tipo: Stringa. Specifica il tipo di connessione utilizzato per l'APN. Sono disponibili i tipi di connessione seguenti:

Tipo di connessione	Usage
Gprs	Predefinito. Usato per le connessioni di tipo GPRS (GPRS + GSM + EDGE + UMTS + LTE).
Cdma	Usato per le connessioni di tipo CDMA (1XRTT + EVDO).
Lte	Usato per le connessioni di tipo LTE (eHRPD + LTE) quando il dispositivo è registrato HOME.
Eredità	Usato per le connessioni GPRS + GSM + EDGE + UMTS.
Lte_iwlan	Usato per le connessioni di tipo GPRS che possono essere scaricate tramite Wi-Fi.
Iwlan	Usato per le connessioni implementate solo tramite offload Wi-Fi.

Desc.langid Facoltativo. Specifica la stringa di visualizzazione dell'interfaccia utente usata dall'ID lingua definito.

Un nome di parametro nel formato Desc.langid verrà usato come identificatore specifico della lingua per la voce specificata. Ad esempio, un parametro definito come Desc.0409 con un valore di forza la visualizzazione della "GPRS Connection" "connessione GPRS" nell'interfaccia utente per rappresentare questa connessione quando il dispositivo è impostato sulla lingua inglese (ID lingua 0409). È possibile effettuare il provisioning di descrizioni per più lingue usando questo meccanismo e il sistema passerà automaticamente tra di esse se l'utente modifica le preferenze di lingua nel dispositivo. Se non viene effettuato il provisioning di alcun parametro Desc per una determinata lingua, per impostazione predefinita verrà usato il nome usato per creare la voce.

Abilitato Specifica se la connessione è abilitata.

Il valore "0" specifica che la connessione è disabilitata. Il valore "1" specifica che la connessione è abilitata.

IpHeaderCompression Opzionale. Specifica se la compressione dell'intestazione IP è abilitata.

Il valore "0" specifica che la compressione dell'intestazione IP per la connessione è disabilitata. Il valore "1" specifica che la compressione dell'intestazione IP per la connessione è abilitata.

Password Obbligatorio se AuthType è impostato su un valore diverso da "None". Specifica la password usata per connettersi all'APN.

SwCompression Opzionale. Specifica se la compressione software è abilitata.

Il valore "0" specifica che la compressione software per la connessione è disabilitata. Il valore "1" specifica che la compressione software per la connessione è abilitata.

Nome utente Obbligatorio se AuthType è impostato su un valore diverso da "None". Specifica il nome utente utilizzato per connettersi all'APN.

UseRequiresMappingsPolicy Opzionale. Specifica se la connessione richiede un criterio di mapping corrispondente.

Il valore "0" specifica che la connessione può essere usata per qualsiasi comunicazione Internet generale. Il valore "1" specifica che la connessione viene utilizzata solo se è presente un criterio di mapping.

Ad esempio, se l'APN del servizio di messaggistica multimediale (MMS) non deve avere altro traffico tranne MMS, è possibile configurare un criterio di mapping che invia il traffico MMS a questa connessione. Impostare quindi il valore di UseRequiresMappingsPolicy su "1" e Gestione connessioni userà la connessione solo per il traffico MMS. In caso contrario, Gestione connessioni tenterà di utilizzare la connessione per qualsiasi traffico Internet per utilizzo generico.

Versione Tipo: Int. Specifica il numero di versione XML e viene utilizzato per verificare che il codice XML sia supportato dal provider di servizi di configurazione di Gestione connessioni.

Questo valore deve essere "1" se incluso.

GPRSInfoAccessPointName Specifica il nome logico per selezionare il gateway GpRS. Per altre informazioni sui valori consentiti, vedere specifica GSM 07.07 "10.1.1 Define PDP Context +CGDCONT".

Roaming Opzionale. Tipo: Int. Questo parametro specifica le condizioni di roaming in cui deve essere attivata la connessione. Sono disponibili le condizioni seguenti:

• 0 - Solo rete domestica.
• 1 (impostazione predefinita) - Tutte le condizioni di roaming (home e roaming).
• 2 - Solo roaming domestico e nazionale.
• 3 - Solo roaming nazionale.
• 4 - Solo roaming non nazionale.
• 5 - Solo roaming.

OEMConnectionID Opzionale. Tipo: GUID. Specifica un GUID utilizzato per identificare una connessione specifica nel modem. Se non viene specificato un valore, il valore predefinito è 000000000-0000-0000-0000-0000000000000000. Questo parametro viene usato solo nei dispositivi LTE.

ApnId Opzionale. Tipo: Int. Specifica lo scopo dell'APN. Se non viene specificato un valore, il valore predefinito è "0" (nessuno). Questo parametro viene usato solo nei dispositivi LTE.

IPType Opzionale. Tipo: Stringa. Specifica il protocollo di rete della connessione. I valori disponibili sono "IPv4", "IPv6", "IPv4v6" e "IPv4v6xlat". Se non viene specificato un valore, il valore predefinito è "IPv4".

Warning

Non usare IPv6 o IPv4v6xlat in un dispositivo o in una rete che non supporta IPv6. La funzionalità dei dati non funzionerà. Inoltre, il dispositivo non sarà in grado di connettersi a una rete mobile che non supporta IPv6 a meno che non si configurino connessioni mobili con un IPType di IPv4v6.

ExemptFromDisablePolicy Aggiunta di nuovo in Windows 10 versione 1511. Facoltativo. Tipo: Int. Questo valore deve essere specificato solo per le connessioni per scopi speciali le cui applicazioni gestiscono direttamente lo stato di disabilitazione , ad esempio MMS. Il valore "0" specifica che la connessione è soggetta ai criteri di disabilitazione usati dalle connessioni per utilizzo generico (non esenti). Il valore "1" specifica che la connessione è esente. Se non viene specificato un valore, il valore predefinito è "0" (non esente).

Per consentire MMS quando i dati sono impostati su OFF, impostare Sia ExemptFromDisablePolicy che UseRequiresMappingsPolicy su "1". Queste impostazioni indicano che la connessione è una connessione MMS dedicata e che non deve essere disabilitata quando tutte le altre connessioni sono disabilitate. Di conseguenza, MMS può essere inviato e ricevuto quando i dati sono impostati su OFF.

Nota

L'invio di MMS durante il roaming non è ancora consentito.

Importante

Non impostare ExemptFromDisablePolicy su "1", ExemptFromRoaming su "1" o UseRequiresMappingsPolicy su "1" per le connessioni per utilizzo generico.

Per evitare incoerenze dell'esperienza utente con determinate combinazioni di valori di ExemptFromDisablePolicy e AllowMmsIfDataIsOff, quando non si imposta ExemptFromDisablePolicy su 1 (il valore predefinito è 0), è necessario:

• Nascondere l'interruttore per AllowMmsIfDataIsOff impostando AllowMmsIfDataIsOffEnabled su 0 (il valore predefinito è 1)
• Impostare AllowMMSIfDataIsOff su 1 (il valore predefinito è 0)

ExemptFromRoaming Aggiunta di nuovo in Windows 10 versione 1511. Facoltativo. Tipo: Int. Questo valore deve essere specificato solo per le connessioni per scopi speciali le cui applicazioni gestiscono direttamente il proprio stato di roaming. Non deve mai essere usato con connessioni per utilizzo generico. Il valore "0" specifica che la connessione è soggetta ai criteri di roaming (non esenti). Il valore "1" specifica che la connessione è esente (non interessata dai criteri di roaming). Se non viene specificato un valore, il valore predefinito è "0" (non esente).

TetheringNAI Opzionale. Tipo: solo INT. CDMA. Specifica se la connessione è una connessione a tethering. Il valore "0" specifica che la connessione non è una connessione di tethering. Il valore "1" specifica che la connessione è una connessione di tethering. Se non viene specificato un valore, il valore predefinito è "0".

IdleDisconnectTimeout Opzionale. Tipo: Int. Specifica per quanto tempo una connessione su richiesta può essere inutilizzata prima che Gestione connessioni la connessione venga arrestata. Questo valore viene specificato in secondi. L'intervallo di valori valido è compreso tra 5 e 60 secondi. Se non specificato, il valore predefinito è 30 secondi.

Importante

È necessario specificare il valore IdleDisconnectTimeout quando si aggiorna una connessione su richiesta per assicurarsi che il valore desiderato sia ancora configurato. Se non viene specificato, è possibile usare il valore predefinito di 30 secondi.

Nota

Se le richieste di disinstallazione/attivazione si verificano troppo spesso, questo valore deve essere impostato su maggiore di 5 secondi.

SimIccId Per i telefoni SIM singoli, questo parm è Facoltativo. Tuttavia, è consigliabile includere questo valore durante la creazione di aggiornamenti futuri. Per i telefoni a doppia SIM, questo parm è necessario. Tipo: Stringa. Specifica l'ICCID SIM che esegue la connessione.

PurposeGroups Obbligatorio. Tipo: Stringa. Specifica gli scopi della connessione da un elenco delimitato da virgole di GUID che rappresentano valori di scopo. Sono disponibili i valori di scopo seguenti:

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

Altre informazioni

Per eliminare una connessione, è prima necessario eliminare eventuali proxy associati e quindi eliminare la connessione. Nell'esempio seguente viene illustrato come eliminare il proxy e quindi la connessione.

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

Esempi di provisioning client OMA

Configurazione di una connessione 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>

Configurazione di una connessione 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>

Configurazione di una connessione 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>

Elementi personalizzati Microsoft

La tabella seguente mostra gli elementi personalizzati Microsoft supportati da questo provider di servizi di configurazione per il provisioning client OMA.

Elemento	Disponibile
Nocharacteristic	Sì
Caratteristica-query	Sì
Parm-query	Sì

Argomenti correlati

Riferimento del provider di servizi di configurazione