CSP CM_CellularEntries
A tabela abaixo mostra a aplicabilidade do Windows:
| Edição | Windows 10 | Windows 11 |
|---|---|---|
| Home | Sim | Sim |
| Pro | Sim | Sim |
| Windows SE | Não | Sim |
| Negócios | Sim | Sim |
| Enterprise | Sim | Sim |
| Educação | Sim | Sim |
O provedor de serviços de configuração CM_CellularEntries é usado para configurar as entradas do GPRS (Serviço geral de Rádio de Pacote) no dispositivo. Ele define cada ponto de acesso de dados GSM.
Esse provedor de serviços de configuração exige que o recurso ID_CAP_NETWORKING_ADMIN seja acessado de um aplicativo de configuração de rede.
O exemplo a seguir mostra o objeto de gerenciamento do provedor de serviços de configuração CM_CellularEntries no formato de árvore, conforme usado pelo Open Mobile Alliance Client Provisioning (OMA CP). Não há suporte para o protocolo DM OMA com esse provedor de serviços de configuração.
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
Nome_da_entrada Define o nome da conexão.
O provedor de serviços de configuração CMPolicy usa o valor do nome de entrada para identificar a conexão associada a uma política e CM_ProxyEntries provedor de serviços de configuração usa o valor do nome de entrada para identificar a conexão associada a um proxy.
Alwayson Tipo: Int. Especifica se o Gerenciador de Conexões tentará se conectar automaticamente à APN quando uma conexão estiver disponível.
Um valor de "0" especifica que o AlwaysOn não tem suporte e o Gerenciador de Conexões só tentará se conectar à APN quando um aplicativo solicitar a conexão. Essa configuração é recomendada para aplicativos que usam uma conexão ocasionalmente. Por exemplo, uma APN que controla apenas o MMS.
Um valor de "1" especifica que o AlwaysOn tem suporte e o Gerenciador de Conexões tentará se conectar automaticamente à APN quando estiver disponível. Essa configuração é recomendada para APNs de Internet de uso geral.
Deve haver pelo menos uma conexão de Internet AlwaysOn provisionada para a operadora móvel.
Authtype Opcional. Tipo: Cadeia de caracteres. Especifica o método de autenticação usado para uma conexão.
Um valor de "CHAP" especifica o Protocolo de Aplicativo de Aperto de Mão de Desafio. Um valor de "PAP" especifica o Protocolo de Autenticação de Senha. Um valor de "Nenhum" especifica que os parâmetros UserName e Password são ignorados. O valor padrão é "Nenhum".
Connectiontype Opcional. Tipo: Cadeia de caracteres. Especifica o tipo de conexão usada para a APN. Os seguintes tipos de conexão estão disponíveis:
| Tipo de conexão | Utilização |
|---|---|
| Gprs | Padrão. Usado para conexões de tipo GPRS (GPRS + GSM + EDGE + UMTS + LTE). |
| Cdma | Usado para conexões de tipo CDMA (1XRTT + EVDO). |
| Lte | Usado para conexões de tipo LTE (eHRPD + LTE) quando o dispositivo está registrado HOME. |
| Legado | Usado para conexões GPRS + GSM + EDGE + UMTS. |
| Lte_iwlan | Usado para conexões de tipo GPRS que podem ser descarregadas por WiFi. |
| Iwlan | Usado apenas para conexões implementadas por meio de descarregamento wi-fi. |
Opcional Desc.langid . Especifica a cadeia de caracteres de exibição da interface do usuário usada pela ID do idioma definida.
Um nome de parâmetro no formato de Desc.langid será usado como o identificador específico do idioma para a entrada especificada. Por exemplo, um parâmetro definido como com um valor de forçará a exibição de "GPRS Connection" "Conexão GPRS" na interface do usuário para representar essa conexão quando o dispositivo estiver definido como Desc.0409 idioma inglês (ID do idioma 0409). As descrições de vários idiomas podem ser provisionadas usando esse mecanismo e o sistema alternará automaticamente entre eles se o usuário alterar as preferências de idioma no dispositivo. Se nenhum parâmetro Desc for provisionado para um determinado idioma, o sistema será padrão para o nome usado para criar a entrada.
Habilitado Especifica se a conexão está habilitada.
Um valor de "0" especifica que a conexão está desabilitada. Um valor de "1" especifica que a conexão está habilitada.
IpHeaderCompression Opcional. Especifica se a compactação de cabeçalho IP está habilitada.
Um valor de "0" especifica que a compactação de cabeçalho IP para a conexão está desabilitada. Um valor de "1" especifica que a compactação de cabeçalho IP para a conexão está habilitada.
Senha Necessário se o AuthType for definido como um valor diferente de "Nenhum". Especifica a senha usada para se conectar à APN.
SwCompression Opcional. Especifica se a compactação de software está habilitada.
Um valor de "0" especifica que a compactação de software para a conexão está desabilitada. Um valor de "1" especifica que a compactação de software para a conexão está habilitada.
Username Necessário se o AuthType for definido como um valor diferente de "Nenhum". Especifica o nome de usuário usado para se conectar à APN.
UseRequiresMappingsPolicy Opcional. Especifica se a conexão requer uma política de mapeamento correspondente.
Um valor de "0" especifica que a conexão pode ser usada para qualquer comunicação geral da Internet. Um valor de "1" especifica que a conexão só será usada se uma política de mapeamento estiver presente.
Por exemplo, se a APN do serviço de mensagens multimídia (MMS) não deve ter nenhum outro tráfego, exceto MMS, você poderá configurar uma política de mapeamento que envia tráfego MMS para essa conexão. Em seguida, você define o valor de UseRequiresMappingsPolicy como igual a "1" e Gerenciador de Conexões usará apenas a conexão para tráfego MMS. Sem isso, Gerenciador de Conexões tentará usar a conexão para qualquer tráfego de Internet de uso geral.
Versão Tipo: Int. Especifica o número da versão XML e é usado para verificar se o XML tem suporte pelo provedor de serviços de configuração do Gerenciador de Conexões.
Esse valor deve ser "1" se incluído.
GPRSInfoAccessPointName Especifica o nome lógico para selecionar o gateway GPRS. Para obter mais informações sobre valores permitidos, confira Especificação GSM 07.07 "10.1.1 Definir Contexto PDP +CGDCONT".
Roaming Opcional. Tipo: Int. Esse parâmetro especifica as condições de roaming nas quais a conexão deve ser ativada. As seguintes condições estão disponíveis:
- 0 – Somente rede inicial.
- 1 (padrão)- Todas as condições de roaming (home e roaming).
- 2 – Somente roaming doméstico e doméstico.
- 3 – Somente roaming doméstico.
- 4 – Somente roaming não doméstico.
- 5 – Somente roaming.
OEMConnectionID Opcional. Tipo: GUID. Especifica um GUID que é usado para identificar uma conexão específica no modem. Se um valor não for especificado, o valor padrão será 0000000-0000-0000-0000-0000-000000000000. Esse parâmetro é usado apenas em dispositivos LTE.
ApnId Opcional. Tipo: Int. Especifica a finalidade da APN. Se um valor não for especificado, o valor padrão será "0" (nenhum). Esse parâmetro é usado apenas em dispositivos LTE.
IPType Opcional. Tipo: Cadeia de caracteres. Especifica o protocolo de rede da conexão. Os valores disponíveis são "IPv4", "IPv6", "IPv4v6" e "IPv4v6xlat". Se um valor não for especificado, o valor padrão será "IPv4".
Aviso
Não use IPv6 ou IPv4v6xlat em um dispositivo ou rede que não dê suporte a IPv6. A funcionalidade de dados não funcionará. Além disso, o dispositivo não poderá se conectar a uma rede roaming que não dá suporte ao IPv6, a menos que você configure conexões roaming com um IPType de IPv4v6.
ExemptFromDisablePolicy Adicionado de volta no Windows 10, versão 1511. Opcional. Tipo: Int. Esse valor só deve ser especificado para conexões de finalidade especial cujos aplicativos gerenciam diretamente seu estado de desabilitação (como MMS). Um valor de "0" especifica que a conexão está sujeita à política de desabilitação usada por conexões de uso geral (não isenta). Um valor de "1" especifica que a conexão é isenta. Se um valor não for especificado, o valor padrão será "0" (não isento).
Para permitir o MMS quando os dados forem definidos como OFF, defina ExemptFromDisablePolicy e UseRequiresMappingsPolicy como "1". Essas configurações indicam que a conexão é uma conexão de MMS dedicada e que ela não deve ser desabilitada quando todas as outras conexões são desabilitadas. Como resultado, o MMS pode ser enviado e recebido quando os dados são definidos como OFF.
Observação
O envio de MMS durante o roaming ainda não é permitido.
Importante
Não defina ExemptFromDisablePolicy como "1", ExemptFromRoaming como "1" ou UseRequiresMappingsPolicy como "1" para conexões de uso geral.
Para evitar a inconsistência de UX com determinadas combinações de valor de ExemptFromDisablePolicy e AllowMmsIfDataIsOff, quando você não definir ExemptFromDisablePolicy como 1 (padrão é 0), você deve:
- Ocultar o alternância para AllowMmsIfDataIsOff definindo AllowMmsIfDataIsOffEnabled como 0 (padrão é 1)
- Defina AllowMMSIfDataIsOff como 1 (padrão é 0)
ExemptFromRoaming Adicionado de volta no Windows 10, versão 1511. Opcional. Tipo: Int. Esse valor deve ser especificado apenas para conexões de finalidade especial cujos aplicativos gerenciam diretamente seu estado de roaming. Ele nunca deve ser usado com conexões de uso geral. Um valor de "0" especifica que a conexão está sujeita à política de roaming (não isenta). Um valor de "1" especifica que a conexão é isenta (não afetada pela política de roaming). Se um valor não for especificado, o valor padrão será "0" (não isento).
TetheringNAI Opcional. Tipo: somente Int. CDMA. Especifica se a conexão é uma conexão de amarração. Um valor de "0" especifica que a conexão não é uma conexão de amarração. Um valor de "1" especifica que a conexão é uma conexão de amarração. Se um valor não for especificado, o valor padrão será "0".
IdleDisconnectTimeout Opcional. Tipo: Int. Especifica quanto tempo uma conexão sob demanda pode ser não utilizado antes que Gerenciador de Conexões reduza a conexão. Esse valor é especificado em segundos. O intervalo de valor válido é de 5 a 60 segundos. Se não for especificado, o padrão será de 30 segundos.
Importante
Você deve especificar o valor IdleDisconnectTimeout ao atualizar uma conexão sob demanda para garantir que o valor desejado ainda esteja configurado. Se não for especificado, o valor padrão de 30 segundos poderá ser usado.
Observação
Se as solicitações de demolição/ativação ocorrerem com muita frequência, esse valor deverá ser definido como maior que 5 segundos.
SimIccId Para telefones SIM únicos, esse parm é Opcional. No entanto, é altamente recomendável incluir esse valor ao criar atualizações futuras. Para telefones SIM duplos, esse parm é necessário. Tipo: Cadeia de caracteres. Especifica o SIM ICCID que presta serviços à conexão.
PurposeGroups Necessário. Tipo: Cadeia de caracteres. Especifica as finalidades da conexão por uma lista separada por vírgulas de GUIDs que representam valores de finalidade. Os seguintes valores de finalidade estão disponíveis:
- Internet - 3E5545D2-1137-4DC8-A198-33F1C657515F
- Anexação LTE - 11A6FE68-5B47-4859-9CB6-1EAC96A8F0BD
- MMS - 53E2C5D3-D13C-4068-AA38-9C48FF2E55A8
- IMS - 474D66ED-0E4B-476B-A455-19BB1239ED13
- SUPL - 6D42669F-52A9-408E-9493-1071DCC437BD
- Compra – 95522B2B-A6D1-4E40-960B-05E6D3F962AB
- Administrativo - 2FFD9261-C23C-4D27-8DCF-CDE4E14A3364
- Aplicativo – 52D7654A-00A8-4140-806C-087D66705306
- Provisionamento eSIM - A36E171F-2377-4965-88FE-1F53EB4B47C0
Informações adicionais
Para excluir uma conexão, primeiro você deve excluir quaisquer proxies associados e, em seguida, excluir a conexão. O exemplo a seguir mostra como excluir o proxy e, em seguida, a conexão.
<wap-provisioningdoc>
<characteristic type="CM_ProxyEntries">
<nocharacteristic type="GPRS_Proxy"/>
</characteristic>
<characteristic type="CM_CellularEntries">
<nocharacteristic type="GPRS1"/>
</characteristic>
</wap-provisioningdoc>
Exemplos de provisionamento de cliente OMA
Configurando uma conexão 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>
Configurando uma conexão 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>
Configurando uma conexão 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>
Elementos personalizados da Microsoft
A tabela a seguir mostra os elementos personalizados da Microsoft que esse provedor de serviços de configuração dá suporte ao Provisionamento de Cliente OMA.
| Elemento | Disponível |
|---|---|
| Nocharacteristic | Sim |
| Consulta característica | Sim |
| Consulta de parm | Sim |