Testando seu envio de banco de dados COSA/APN da área de trabalho

  • Artigo

Antes de enviar uma solicitação de atualização de APN à Microsoft, é importante que o MNO ou o MVNO validem as entradas APN que estão prestes a enviar. A Microsoft não tem acesso à sua rede, portanto, é sua responsabilidade garantir que os valores que estão sendo enviados sejam válidos e funcionem corretamente.

Entre em contato com seu Microsoft TAM

A primeira etapa no teste e envio da atualização do APN é trabalhar com o TAM para abrir um caso de MS Solve com Os Serviços de Atendimento ao Cliente e Suporte da Microsoft. Esse caso é para fins de acompanhamento. Depois que um caso do MS Solve for aberto, forneça as seguintes informações ao engenheiro de suporte:

  • Uma planilha concluída que contém suas informações de APN.

Se você não tiver um TAM:

  • Entre em contato com o Atendimento ao Cliente e Suporte da Microsoft ligando para (800) MICROSOFT (642-7676).
  • Informe ao representante de atendimento ao cliente que uma atualização de banco de dados COSA/APN é necessária.
  • Forneça a planilha ao engenheiro de suporte.
  • Se solicitado, especifique Windows 8 ou Windows 10 como o produto, conforme apropriado.

Observação

Você precisará fornecer um cartão de crédito para abrir o incidente, mas não será cobrado.

Testar seu envio para COSA da área de trabalho

Use esse processo para Windows 10, versão 1703 e posterior.

Depois de enviar sua planilha completa que contém suas informações de APN para seu TAM, a Microsoft criará um arquivo de pacote de provisionamento (.ppkg) para você e o retornará para você para que você possa instalar e testar seu APN.

Para obter mais informações sobre como instalar um arquivo de pacote de provisionamento, consulte Aplicar um pacote de provisionamento.

Modificar o banco de dados COSA local (COSA da área de trabalho)

Siga estas etapas para testar o PPKG (Pacote de Provisionamento cosa) atualizado que você recebeu da Microsoft depois de concluir a planilha de informações do APN e enviá-la ao TAM.

Essas etapas exigem um script da Microsoft para aplicar e testar o arquivo PPKG. Baixe a versão mais recente do script.

Aplicar o arquivo PPKG de teste

Importante

Crie um backup do pacote de provisionamento original antes de executar as ações a seguir. O pacote de provisionamento original está localizado aqui: %systemroot%\Provisioning\Cosa\Microsoft\Microsoft.Windows.Cosa.Desktop.Client.ppkg.

  1. Remova qualquer SIM do dispositivo, se houver.
  2. Copie o script e o novo arquivo PPKG para um diretório local.
  3. Abra uma janela do Prompt de Comando com privilégios elevados e altere para o diretório que contém o script.
  4. Execute o script com essa sintaxe para aplicar o PPKG: ApplyCosaProvisioning.BAT -a <full path to the PPKG local directory>.
    1. Por exemplo: ApplyCosaProvisioning.BAT -a "C:\FromMicrosoft\Microsoft.Windows.Cosa.Desktop.Client.ppkg"
  5. Insira o SIM e aguarde o provisionamento.

Restaurar o arquivo PPKG original

Aviso

Depois que a validação do novo PPKG recebido da Microsoft for concluída, sempre restaure-o com as etapas a seguir. Restaurar de volta para o PPKG original garantirá que você receba as atualizações de COSA mais recentes por meio de Windows Update.

  1. Depois de validado, remova o SIM do dispositivo.
  2. Execute o script com essa sintaxe para restaurar o PPKG original: ApplyCosaProvisioning.BAT -r.
  3. Insira o SIM para que o provisionamento entre em vigor, lendo o PPKG original.

Coletar logs em caso de falha

Para coletar logs em caso de falha durante o processo de teste, siga estas etapas:

  1. Remova qualquer SIM do dispositivo.
  2. Execute o script com essa sintaxe para iniciar o registro em log netsh : ApplyCosaProvisioning.BAT -l.
  3. Insira o SIM e aguarde a falha do provisionamento.
  4. Siga os prompts da ferramenta para encerrar o registro em log.
  5. Envie os logs para a Microsoft em formato compactado.

Testar seu envio para o banco de dados APN (apndatabase.xml)

Use esse processo para Windows 8, Windows 8.1 e versões do Windows 10 antes do Windows 10, versão 1703.

Há duas maneiras de garantir que as entradas APN funcionem antes de enviá-las à Microsoft:

Editando valores de APN para o perfil atual

Uma maneira simples de testar se um APN pode se conectar à sua rede é editar o perfil atual e inserir o APN para testar no perfil. Para executar esse teste, siga estas etapas:

Observação

Esse teste não simula a experiência completa, que é descrita na seção Modificar o banco de dados APN local . 

  1. Insira um SIM no computador que funciona com o valor de APN que você deseja testar.

  2. Ative o computador, faça logon no Windows e abra o Windows Gerenciador de Conexões. A conexão de banda larga móvel deve aparecer.

  3. Clique com o botão direito do mouse na conexão de banda larga móvel e selecione Exibir propriedades de conexão.

  4. Insira o valor de APN a ser testado nessa caixa de diálogo.

  5. Salve suas alterações e tente se conectar à rede de banda larga móvel.

Modificar o banco de dados APN local

Antes de enviar uma atualização apn, você deve editar o banco de dados APN local ou criar um novo para teste. Ao fazer isso, você simula de perto a experiência completa porque a lógica de seleção de APN que o Windows Gerenciador de Conexões usa é totalmente testada.

Modificar o banco de dados de conectividade APN local

  1. Copiar todos os valores existentes do arquivo de banco de dados APN local – exiba as entradas existentes no banco de dados APN local em seu computador e copie essas entradas em um novo arquivo XML. Se você não tiver nenhuma entrada APN na cópia local do banco de dados APN, ignore esta etapa e comece com um arquivo XML em branco.

  2. Modificar valores no arquivo XML de acordo com o esquema APN publicado – verifique se as entradas APN seguem a referência de esquema de banco de dados APN.

  3. Gerar suas IDs de hardware – as IDs de hardware especificam uma ou mais cadeias de caracteres de identificação de hardware que correspondem às características do SIM a uma entrada APN no banco de dados. Cada cadeia de caracteres é especificada por um elemento HardwareId . Recomendamos que você use mbidgenerator.exe para gerar suas IDs de hardware. Para obter mais informações, consulte Usando mbidgenerator.exe para gerar IDs de hardware.

  4. Valide se o arquivo gerado está em conformidade com o esquema de banco de dados APN publicado – sempre execute um esquema marcar para garantir que o arquivo gerado esteja em conformidade com a referência de esquema de banco de dados APN.

  5. Substituir o banco de dados de conectividade APN no computador pelo novo banco de dados

    1. Em um prompt de comandos com privilégios elevados, digite cd %systemroot%\system32 e pressione ENTER.

    2. Digite takeown /f .\ApnDatabase.xml e pressione ENTER.

    3. Digite icacls .\ApnDatabase.xml /grant %username%:F e pressione ENTER.

    4. Copie sua versão personalizada do arquivo ApnDatabase.xml para o diretório.

  6. Valide se as entradas APN existem no banco de dados APN local:

    1. Verifique se não há perfis de banda larga móvel existentes executando o seguinte comando: netsh mb show profiles

    2. Se existir um perfil de banda larga móvel, digite netsh mb profile interface=Nome> da interface=<<Nome do perfil>

    3. Verifique se o dispositivo não tem um contexto provisionado executando o seguinte comando: netsh mb show provisionedcontext interface=<Interface name>

      Nota Se o dispositivo fornecer um contexto provisionado, o Windows usará o APN desse contexto provisionado em vez do banco de dados APN local e você não poderá testar suas APNs. Se o dispositivo tiver um contexto provisionado, você precisará adquirir outro dispositivo que não forneça um contexto provisionado.  

    4. Abra o Windows Gerenciador de Conexões. Ele mostrará as redes de banda larga móvel e Wi-Fi que estão dentro do alcance.

    5. Selecione a Rede Móvel e clique em Conectar.

    6. Se você tiver várias APNs que correspondam às propriedades do SIM, o Windows Gerenciador de Conexões tentará cada uma das APNs correspondentes até que ocorra uma conexão bem-sucedida. Se nenhuma das APNs se conectar, o Windows Gerenciador de Conexões mostrará um erro ou mostrará uma tela de entrada apn personalizada, permitindo que o usuário insira um APN personalizado.

      Nota A ordem de conexão automática especificada no banco de dados APN é usada para determinar a ordem na qual as APNs são tentadas.  

    7. Se você tiver apenas um APN no banco de dados APN, o Windows se conectará automaticamente à rede do operador.

Observação

Você pode ver qual APN foi aplicado ao perfil de conexão abrindo o Windows Gerenciador de Conexões, clicando com o botão direito do mouse na entrada banda larga móvel da rede e clicando em Propriedades.