Guia do desenvolvedor para criar metadados de serviço
Aviso de substituição do MBAE
Importante
A partir do Windows 10, versão 1803, a experiência do aplicativo MBAE é substituída por um aplicativo MO UWP. Para obter mais informações sobre aplicativos UWP mo, consulte Aplicativos de banda larga móvel UWP.
Este guia orienta você pelo processo de criação de um pacote de metadados de serviço no dashboard de hardware do Centro de Desenvolvimento do Windows, anteriormente conhecido como Sysdev. Os metadados de serviço são necessários para conectar um aplicativo de banda larga móvel ao seu dispositivo de hardware. Quando um usuário conecta um dispositivo de banda larga móvel em seu computador, os metadados de serviço associados são baixados e, em seguida, o aplicativo de banda larga móvel é baixado automaticamente.
Você pode aproveitar os metadados de serviço para criar uma experiência profundamente integrada com o Windows. Os pacotes de metadados de serviço permitem que você inclua informações de identidade visual, como ícones e o nome do operador, defina configurações e permissões para acessar o hardware do SIM e hotspots pessoais e provisione aplicativos de banda larga móvel para trabalhar com seu dispositivo de banda larga móvel.
Observação
Embora o aplicativo de banda larga móvel seja instalado automaticamente, o usuário deve fixá-lo na Tela Inicial manualmente.
Introdução
Para criar um pacote de metadados de serviço bem-sucedido, você deve concluir as etapas incluídas nesta seção.
Registrar sua empresa no dashboard de hardware do Centro de Desenvolvimento do Windows
Sua empresa tem uma conta ativa no dashboard de hardware do Centro de Desenvolvimento do Windows. Se sua empresa não tiver uma conta no dashboard de hardware do Centro de Desenvolvimento do Windows, você poderá criar uma nova conta e adicionar sua conta de usuário à sua empresa. Para obter mais informações, consulte Administração na ajuda dashboard de hardware do Centro de Desenvolvimento do Windows.
Sua empresa tem um certificado de assinatura de código VeriSign para assinar os pacotes.
Acesso ao assistente de metadados de serviço e registro de identificadores de serviço
MNOs e MVNOs devem concluir as seguintes etapas antes de criar um pacote de metadados de serviço:
Solicitar acesso ao assistente de Metadados de Serviço
Registrar seus identificadores de serviço
Para concluir as etapas acima, acesse o Partner Center dashboard suporte técnico e forneça as seguintes informações:
O nome da organização usado quando você se registrou no dashboard de hardware do Centro de Desenvolvimento do Windows.
Seja você uma operadora de rede móvel ou uma operadora de rede virtual móvel.
Seu site e justificativa sobre por que você precisa criar um pacote de metadados de serviço.
Inclua os seguintes identificadores de serviço conforme aplicável:
Lista de IDs do provedor GSM
Lista de nomes de provedor GSM
Lista de SIDs do CDMA
Lista de nomes de provedor cdma
Você deve receber emails de confirmação com 24 horas para que sua solicitação tenha sido recebida. No entanto, pode levar até 5 dias úteis para processar a solicitação. Se tivermos conflitos, enviaremos um email solicitando informações adicionais.
Aplicativo de banda larga móvel
Antes de criar seu pacote de metadados de serviço, verifique se o aplicativo de banda larga móvel foi desenvolvido e associado à Microsoft Store. Esse aplicativo deve fornecer experiências importantes, como compra de plano, uso de dados, ajuda e suporte, bem como realçar serviços de valor agregado do operador. Para obter mais informações sobre como criar o aplicativo de banda larga móvel, consulte os seguintes links:
Observação
O aplicativo de banda larga móvel não precisa ser publicado na Microsoft Store até que os metadados do serviço sejam testados e estejam prontos para serem publicados externamente. Recomendamos que o aplicativo seja publicado na Microsoft Store somente depois que o pacote de metadados do serviço passar no teste de modo de visualização.
Criando pacotes de metadados de serviço
A criação de um pacote de metadados de serviço começa com o assistente de Metadados de Serviço que está disponível no dashboard de hardware do Centro de Desenvolvimento do Windows. Para obter mais informações sobre o assistente de Metadados de Serviço, consulte Etapa 2 – Criar o pacote de metadados de serviço. Você pode usar o assistente de Metadados de Serviço para criar um novo ou editar um pacote de metadados de serviço existente. À medida que você passar pelo assistente e preencher os valores, o assistente validará e notificará você sobre erros ou avisos. Essa validação inclui a verificação de campos ausentes ou incorretos, a propriedade do identificador de serviço, a existência do aplicativo de banda larga móvel na Microsoft Store e assim por diante.
Quando você estiver na página de confirmação final e estiver pronto para enviar, terá a opção de enviar seu pacote no modo desenvolvedor ou no modo de visualização .
Modo de desenvolvedor Usado durante os estágios iniciais quando sua intenção é simplesmente criar pacotes de metadados de serviço e usá-los para fins de teste offline. Nesse modo, o pacote não será assinado e precisará ser baixado e instalado manualmente no computador de teste para fins de validação. Esse modo pode ser exibido como uma maneira rápida e rápida de criar e verificar se os pacotes de metadados de serviço funcionam com seu dispositivo.
Modo de visualização Usado quando você tem certeza de que o pacote foi criado corretamente e está pronto para envio para teste de ponta a ponta. Nesse modo, o pacote será assinado pelo dashboard de hardware do Centro de Desenvolvimento do Windows e será baixado automaticamente para computadores de teste, desde que seus computadores de teste sejam provisionados corretamente.
Depois de concluir o teste de versão prévia e verificar se o pacote funciona para todos os cenários, você pode publicar o pacote em tempo real.
O diagrama a seguir discute o fluxo de trabalho:
Para criar um novo pacote de metadados de serviço, consulte Etapas para criar um pacote de metadados de serviço.
Para editar um pacote de metadados de serviço existente, consulte Etapas para editar um pacote de metadados de serviço.
Etapas para criar um pacote de metadados de serviço
Use as seguintes etapas para criar um pacote de metadados de serviço no hardware do Centro de Desenvolvimento do Windows dashboard:
1- Coletar as informações necessárias para o pacote de metadados de serviço
3-Inserir o arquivo de manifesto da loja no aplicativo de dispositivo da Microsoft Store
1- Coletar as informações necessárias para o pacote de metadados de serviço
Conforme você percorre as etapas do Assistente de Metadados de Serviço na Etapa 2 deste tópico, várias informações armazenadas no arquivo package.appxmanifest do projeto de aplicativo de banda larga móvel que você deseja associar ao dispositivo são necessárias. Use as etapas a seguir para coletar as informações para que elas estejam prontas para a Etapa 2 deste tópico.
Cuidado
O aplicativo de banda larga móvel deve ser associado à Microsoft Store antes de reunir os valores nesta etapa. Quando você associa um aplicativo de banda larga móvel, os valores no arquivo de manifesto do pacote são atualizados para usar as informações de sua conta de desenvolvedor da Microsoft Store. No entanto, o aplicativo de banda larga móvel não precisa ser publicado na Microsoft Store. Ele pode permanecer em seu ambiente de desenvolvimento local até que você esteja pronto para publicar o pacote de metadados do serviço.
Para coletar informações do aplicativo de dispositivo UWP
Abra o projeto de aplicativo de banda larga móvel usando Visual Studio 2013.
No painel direito, clique com o botão direito do mouse no arquivo Package.appxmanifest e clique em Exibir Código.
Reúna os seguintes atributos do arquivo package.appxmanifest:
No elemento Identity , o atributo Name será usado para o campo Nome do pacote no Assistente de Metadados de Serviço.
No elemento Identity , o atributo Publisher será usado para o campo Publicador no Assistente de Metadados de Serviço.
No elemento Applications , o atributo Id do elemento filho Application será usado para o campo ID do Aplicativo no Assistente de Metadados de Serviço.
Feche o arquivo package.appxmanifest.
Você também pode concluir isso sem usar o Visual Studio executando as seguintes etapas:
Para coletar informações de aplicativo de banda larga móvel sem usar o Visual Studio
Navegue até o arquivo package.appxmanifest para seu aplicativo de banda larga móvel.
Clique com o botão direito do mouse no arquivo e clique em Abrir com.
Desmarque a caixa Usar este aplicativo para todos os arquivos .appxmanifest marcar, clique em Mais opções e clique em Bloco de Notas.
Reúna os seguintes atributos do arquivo package.appxmanifest:
No elemento Identity , o atributo Name será usado para o campo Nome do pacote no Assistente de Metadados de Serviço.
No elemento Identity , o atributo Publisher será usado para o campo Publicador no Assistente de Metadados de Serviço.
No elemento Applications , o atributo Id do elemento filho Application será usado para o campo ID do Aplicativo no Assistente de Metadados de Serviço.
Salve e feche o arquivo package.appxmanifest.
2- Criar o pacote de metadados de serviço
Os metadados de serviço são criados usando o Assistente de Metadados de Serviço no dashboard de hardware do Centro de Desenvolvimento do Windows.
Para criar um pacote de metadados de serviço
Navegue até sysdev.microsoft.com.
No título Metadados do dispositivo , clique em Criar experiência de banda larga móvel.
Na página Informações do serviço , preencha os campos a seguir e clique em Avançar.
Insira o nome da rede que será usada na interface do usuário de seleção de rede do Windows – o nome da sua rede que será exibida aos clientes no Windows Gerenciador de Conexões.
Insira o número de serviço – um GUID que deve corresponder ao campo ID da operadora nos metadados de provisionamento. Você pode criar um GUID usando Visual Studio 2013. Para obter mais informações sobre como criar um GUID, consulte Criar GUID (guidgen.exe).
Carregue o ícone que será mostrado na interface do usuário de seleção de rede do Windows – clique em Procurar e selecione o ícone mostrado aos clientes no Windows Gerenciador de Conexões.
Insira o manipulador de eventos de notificação do Windows em seu aplicativo (opcional, a menos que o direito marcar seja necessário abaixo) – Esse é o manipulador de notificação que foi registrado em seu aplicativo de banda larga móvel.
Deseja permitir que os usuários compartilhem sua conexão de banda larga móvel (hotspot pessoal)? – As opções possíveis são Sempre permitir, Permitir somente com marcar de direitos (manipulador de eventos de notificação do Windows necessário) e Nunca permitir. A opção padrão é sempre permitir.
Deseja exigir privilégios de administrador do sistema para executar o desbloqueio de PIN em SIMs? – Se você quiser exigir privilégios de administrador do sistema para desbloquear um cartão sim, clique na opção Sim.
Na página Informações de hardware , selecione as informações que devem ser usadas para identificar sua experiência. Depois que uma caixa de marcar for selecionada, você poderá adicionar os intervalos de rede apropriados. A ID gerada deve existir no banco de dados APN do Windows para que o assinante correto seja identificado. Para obter mais informações sobre o banco de dados APN, consulte Envio de banco de dados COSA/APN.
Se você for um provedor GSM que usa a IMSI (Identidade Internacional do Assinante Móvel), selecione a caixa marcar IMSI no título GSM. Na caixa ID do Provedor , insira a ID do provedor de serviços GSM. No título Intervalos IMSI/ICCID, insira o intervalo e clique em Adicionar.
Se você for um provedor GSM que usa o ICCID (identificador de cartão de circuito integrado), selecione a caixa marcar ID do ICC do SIM no título GSM. No título Inserir a ID do Provedor e o intervalo de ID do ICC , insira o intervalo e clique em Adicionar.
Se você for um provedor GSM que usa o nome do provedor inicial, selecione o nome do provedor inicial marcar caixa sob o título GSM. Em Inserir o Nome do Provedor Inicial ou insira o título ID do Provedor (MCC+MNC), insira a ID do provedor e o nome do provedor e clique em Adicionar.
Se você for um provedor cdma que usa o SID, selecione a caixa sid marcar sob o título CDMA. Na caixa Inserir o SID , insira o SID do CDMA.
Se você for um provedor cdma que usa o nome do provedor, selecione a caixa Nome do provedor marcar sob o título CDMA. Na caixa Inserir Nome do Provedor , insira o nome do provedor de serviços CDMA.
Clique em Próximo.
Na página Informações do aplicativo, insira as informações coletadas na Etapa 1 deste tópico. Se você quiser adicionar aplicativos com privilégios adicionais, clique em Adicionar e insira mais 7. Quando todos os aplicativos privilegiados forem inseridos, clique em Avançar.
Na página Confirmar , verifique se as informações estão corretas. Selecione a opção Modo de Desenvolvedor ou Modo de Visualização e clique em Enviar.
Modo de Desenvolvedor – o pacote não está assinado e deve ser baixado e instalado manualmente em todos os computadores. Use essa opção se quiser salvar o pacote para desenvolvimento offline.
Modo de Visualização – o pacote é assinado e baixado automaticamente da Microsoft para testar computadores com as configurações de registro apropriadas definidas. O Modo de Visualização não marcar para garantir que o aplicativo de banda larga móvel seja publicado na Microsoft Store.
3- Inserir o arquivo de manifesto da loja no aplicativo de dispositivo da Microsoft Store
Um arquivo de manifesto da loja deve ser incluído com um aplicativo de dispositivo UWP. Use as etapas a seguir para baixar o arquivo de manifesto da loja do pacote de metadados de serviço e inseri-lo no projeto de aplicativo de banda larga móvel.
Inserir o arquivo de manifesto do repositório
No dashboard de hardware do Centro de Desenvolvimento do Windows, na página gerenciar experiência do pacote de metadados de serviço, clique no pacote de metadados de serviço e clique emStoreManifest.xml para baixar o arquivo de manifesto da loja.
Abra o projeto de aplicativo de banda larga móvel usando Visual Studio 2013.
Clique com o botão direito do mouse no projeto, clique em Adicionare clique em Item Existente.
Navegue até o arquivo de manifesto do repositório baixado e clique em Adicionar.
Recompile o aplicativo de banda larga móvel e publique-o novamente na Microsoft Store.
4- Testar o pacote de metadados de serviço
Para testar o pacote de metadados de serviço, você deve ter o dispositivo de banda larga móvel e os arquivos de pacote de metadados de serviço. As instruções para configurar o sistema de teste e instalar o pacote de metadados de serviço dependem do modo do pacote.
Testar um pacote de metadados de serviço no modo de desenvolvedor
Você deve baixar manualmente o pacote e instalá-lo no local certo para que os cenários funcionem corretamente. Seu pacote de modo de desenvolvedor precisará ser acessado de dois pontos de entrada diferentes, dependendo se você criou um novo pacote ou de um pacote existente.
Se você criou um novo pacote, no dashboard de hardware do Centro de Desenvolvimento do Windows, clique em Gerenciar experiências e clique em Pacotes de Desenvolvimento Não Associados (a primeira entrada na tabela Gerenciar experiências). A seguinte figura mostra um exemplo:
Se você editou um pacote de metadados de serviço existente que já está associado a uma experiência, selecione a experiência na tabela Gerenciar experiências e verá o pacote do modo de desenvolvedor na tabela Pacotes de metadados . Clique em Baixar Edição do Pacote Zip do MBAE para baixá-lo.
Depois de baixar o pacote de metadados de serviço, você deve habilitar a assinatura de teste porque o pacote de metadados de serviço não está assinado. Para habilitar a assinatura de teste, execute bcdedit –set testsigning on de um prompt de comando com privilégios elevados e reinicie o computador.
Depois que a assinatura de teste estiver habilitada, copie o arquivo *.devicemetadata-ms do pacote de metadados de serviço para o seguinte local: %ProgramData%\Microsoft\Windows\DeviceMetadataStore\culture, em que cultura é o código de cultura atual do computador.
Testar um pacote de metadados de serviço no modo de visualização
Se o pacote de metadados de serviço estiver no modo de visualização, você deverá criar a entrada do registro PreviewKey no computador de teste. Para obter mais informações sobre como configurar a entrada do registro PreviewKey, consulte Criando um pacote de visualização.
Observação
Você não precisa habilitar a assinatura de teste para testar um pacote de metadados de serviço que está no modo de visualização.
Depois que a entrada do registro PreviewKey for criada, conecte seu dispositivo de banda larga móvel e verifique se ele aparece na lista Redes. Caso contrário, consulte a seção Solução de problemas para obter mais informações.
Limpar os metadados de serviço existentes
Quando os metadados de serviço são instalados em um computador, os valores contidos nos metadados são armazenados em muitos locais diferentes, incluindo o registro, o cache de metadados, o repositório de metadados, os perfis WWAN e o nó de desenvolvimento. Isso pode tornar desafiador repetir vários testes com os mesmos pacotes de metadados ou diferentes. Para garantir que os metadados de serviço sejam instalados corretamente, você deve limpar todos os metadados de serviço existentes. Você pode limpar os metadados de serviço existentes configurando seu computador de teste para executar um script do PowerShell que remove todos os rastreamentos. Primeiro, você deve configurar o ambiente no computador de teste:
Observação
Isso não funcionará em um dispositivo Windows RT. Use as etapas no procedimento chamado "Para limpar metadados de serviço em um dispositivo que executa Windows RT".
Para configurar o ambiente para limpar metadados do serviço
Baixe psexec.exe (https://go.microsoft.com/fwlink/p/?linkid=330071) e, em seguida, extraia-o para uma pasta.
Baixe e instale o Windows Driver Kit Windows 8.1 (https://go.microsoft.com/fwlink/?LinkId=330072).
Navegue até onde os arquivos WDK estão instalados. O local padrão é C:\Arquivos de Programas (x86)\Kits do Windows\8.1\Ferramentas. Se o computador de teste estiver executando x86, copie devcon.exe da pasta x86 para a mesma pasta que psexec.exe. Se o computador de teste estiver executando x64, copie devcon.exe da pasta x64.
Salve o script a seguir como MetadataRemovalScript.ps1 na mesma pasta que Devcon.exe e PsExec.exe.
Observação
Na caixa Salvar como tipo , selecione Todos os arquivos (*.*) antes de salvar o arquivo.
# DEVICE SHOULD BE CONNECTED TO MACHINE
Write-Host "Launching devcon to remove MBAE software device nodes devcon.exe remove @SWD\MBAE\*"
$DevconParameters = ' remove @SWD\MBAE\* '
try
{
Start-Process devcon.exe -ArgumentList $DevconParameters
}
catch
{
$Error[0] # Dump details about the last error
Write-Host "Error running devcon.exe " $DevconParameters
exit
}
Write-Host "Removing MB Profiles"
$mbprcmd = "mbn sh pr i=*"
$mddelprcmd = "mbn del pr i=* name="
$cmdout = $mbprcmd | netsh | Out-String
$tokens = $cmdout.Split( [String[]] ("`r`n"), [StringSplitOptions]::RemoveEmptyEntries)
if($tokens.Length -gt 3)
{
for($i=3;$i -lt $tokens.Length-1;$i++)
{
$x = $mddelprcmd + '"' + $tokens[$i].trim() +'"'
Write-Host "Deleting Profile Cmd :" $x
$x | netsh
}
}
Write-Host ""
Write-Host "Disabling ALL Mobile Broadband Adapters"
$MBAdapters = Get-Netadapter -Name "Mobile Broadband*"
foreach($MBAdapter in $MBAdapters)
{
Write-Host "Disabling MB Adapter :"$MBAdapter.Name
Disable-NetAdapter -Name $MBAdapter.Name -Confirm:$false
}
Write-Host "Stopping Device Setup Manager Service"
Stop-Service DsmSvc
Write-Host "Removing MBAE metadata packages in store"
#Find Package Ids
$MBAEPackageRegKeyHive = "HKLM:\SOFTWARE\Microsoft\WwanSvc\MobileBroadbandAccounts\Accounts\"
if(Test-Path $MBAEPackageRegKeyHive)
{
$DevMetadataStorePath = join-path -Path $Env:ProgramData -ChildPath "Microsoft\Windows\DeviceMetadataStore"
$PackageIds = Get-ChildItem $MBAEPackageRegKeyHive | ForEach-Object {Get-ItemProperty $_.pspath} | where-object {$_.MetadataPackageId} | Foreach-Object {$_.MetadataPackageId}
foreach($PackageId in $PackageIds)
{
$PackageStoreFile = $PackageId + ".devicemetadata-ms"
$PackageStorePath = Get-ChildItem $DevMetadataStorePath -Recurse -Filter $PackageStoreFile
if($PackageStorePath -ne $null)
{
Write-Host "Deleting Device Metadata Store @" $PackageStorePath.FullName
Remove-Item -Force $PackageStorePath.FullName
}
}
}
Write-Host "Removing all metadata from cache"
$DevMetadataCachePath = join-path -Path $Env:ProgramData -ChildPath "Microsoft\Windows\DeviceMetadataCache\*"
if(Test-Path $DevMetadataCachePath)
{
Write-Host "Delete All Metadata Packages under "$DevMetadataCachePath
Remove-Item -Recurse -Force $DevMetadataCachePath
}
Write-Host "Cleanup MBAE registry keys"
$MBAERegKeyPath = "HKLM:\SOFTWARE\Microsoft\WwanSvc\MobileBroadbandAccounts\*"
if(Test-Path $MBAERegKeyPath)
{
Write-Host "Found MBAE reg keys - deleting"
Remove-Item -Path $MBAERegKeyPath -Recurse
}
Write-Host "Enabling all MB Adapters, press any key to continue"
$keypress = $host.UI.RawUI.ReadKey("NoEcho,IncludeKeyUp")
$MBAdapters = Get-Netadapter -Name "Mobile Broadband*"
foreach($MBAdapter in $MBAdapters)
{
Write-Host "Enabling MB Adapter :"$MBAdapter.Name
Enable-NetAdapter -Name $MBAdapter.Name -Confirm:$false
}
Write-Host "END of Script"
# DEVICE SHOULD BE CONNECTED TO MACHINE
Write-Host "Launching devcon to remove MBAE software device nodes devcon.exe remove @SWD\MBAE\*"
$DevconParameters = ' remove @SWD\MBAE\* '
try
{
Start-Process devcon.exe -ArgumentList $DevconParameters
}
catch
{
$Error[0] # Dump details about the last error
Write-Host "Error running devcon.exe " $DevconParameters
exit
}
Write-Host "Removing MB Profiles"
$mbprcmd = "mbn sh pr i=*"
$mddelprcmd = "mbn del pr i=* name="
$cmdout = $mbprcmd | netsh | Out-String
$tokens = $cmdout.Split( [String[]] ("`r`n"), [StringSplitOptions]::RemoveEmptyEntries)
if($tokens.Length -gt 3)
{
for($i=3;$i -lt $tokens.Length-1;$i++)
{
$x = $mddelprcmd + '"' + $tokens[$i].trim() +'"'
Write-Host "Deleting Profile Cmd :" $x
$x | netsh
}
}
Write-Host ""
Write-Host "Please remove the MB device from the system and press any key to continue"
$keypress = $host.UI.RawUI.ReadKey("NoEcho,IncludeKeyDown")
Write-Host "Removing MBAE metadata packages in cache and store"
#Find Package Ids
$MBAEPackageRegKeyHive = "HKLM:\SOFTWARE\Microsoft\WwanSvc\MobileBroadbandAccounts\Accounts\"
if(Test-Path $MBAEPackageRegKeyHive)
{
$DevMetadataCachePath = join-path -Path $Env:ProgramData -ChildPath "Microsoft\Windows\DeviceMetadataCache"
$DevMetadataStorePath = join-path -Path $Env:ProgramData -ChildPath "Microsoft\Windows\DeviceMetadataStore"
$PackageIds = Get-ChildItem $MBAEPackageRegKeyHive | ForEach-Object {Get-ItemProperty $_.pspath} | where-object {$_.MetadataPackageId} | Foreach-Object {$_.MetadataPackageId}
foreach($PackageId in $PackageIds)
{
$PackageCacheFolder = Get-ChildItem $DevMetadataCachePath -Recurse -Filter $PackageId
if($PackageCacheFolder -ne $null)
{
Write-Host "Deleting Device Metadata Cache @" $PackageCacheFolder.FullName
Remove-Item -Recurse -Force $PackageCacheFolder.FullName
}
$PackageStoreFile = $PackageId + ".devicemetadata-ms"
$PackageStorePath = Get-ChildItem $DevMetadataStorePath -Recurse -Filter $PackageStoreFile
if($PackageStorePath -ne $null)
{
Write-Host "Deleting Device Metadata Store @" $PackageStorePath.FullName
Remove-Item -Force $PackageStorePath.FullName
}
}
}
Write-Host "Cleanup MBAE registry keys"
$MBAERegKeyPath = "HKLM:\SOFTWARE\Microsoft\WwanSvc\MobileBroadbandAccounts\*"
if(Test-Path $MBAERegKeyPath)
{
Write-Host "Found MBAE reg keys - deleting"
Remove-Item -Path $MBAERegKeyPath -Recurse
}
Write-Host "END"
Depois que o ambiente for configurado, execute as seguintes etapas sempre que quiser limpar os metadados de serviço existentes:
Para limpar os metadados de serviço
Verifique se o dispositivo de banda larga móvel está conectado ao computador de teste.
Em um prompt de comando com privilégios elevados, navegue até a pasta em que você extraiu psexec.exe e execute psexec /s /i powershell
No prompt de comando do PowerShell, navegue até a pasta em que você extraiu psexec.exe.
Digite set-executionpolicy irrestrito e pressione Enter.
Digite Y e, em seguida, Enter.
Digite .\MetadataRemovalScript.ps1 e pressione Enter.
Quando solicitado, remova o dispositivo de banda larga móvel e pressione Enter.
Repita essas etapas sempre que quiser limpar os metadados de serviço do computador de teste.
Para limpar metadados de serviço em um dispositivo que executa Windows RT
Remova os nós do dispositivo de software.
Em Gerenciador de Dispositivos, clique em Exibir e, em seguida, clique em Mostrar dispositivos ocultos.
Expanda Dispositivos de software.
Clique com o botão direito do mouse nos seguintes nós de dispositivo e clique em Desinstalar: Windows.Devices.Sms.SmsDevice e Windows.Networking/NetworkOperators.MobileBroadbandAccount
Remova todos os perfis de banda larga móvel de todas as interfaces.
Em um prompt de comandos com privilégios elevados, digite netsh mbn sho pro i=\*
Para cada um dos perfis, digite netsh mbn delete profile name = "The profile name here" i=\* e pressione Enter.
Desabilite todos os adaptadores de banda larga móvel.
Em Gerenciador de Dispositivos, expanda Adaptadores de rede.
Clique com o botão direito do mouse em cada dispositivo de banda larga móvel e clique em Desabilitar.
Em um prompt de comandos com privilégios elevados, interrompa o serviço DSM digitando sc stop dsmsvc e pressione Enter.
Remova seus pacotes de metadados de serviço do repositório de metadados do dispositivo excluindo qualquer pasta que contenha seu pacote de metadados de serviço de %ProgramData%\Microsoft\Windows\DeviceMetadataStore. Você pode identificar pacotes de metadados de serviço procurando o arquivo MobileBroadbandInfo.xml.
Exclua todas as entradas do Registro do MBAE do WWAN SVC.
No Editor do Registro, exclua a seguinte entrada do Registro e todas as entradas filho: HKEY_LOCAL_MACHINE\Software\Microsoft\WwanSvc\MobileBroadbandAccounts.
Se você não tiver acesso para excluir a entrada do Registro, deverá conceder a si mesmo permissões de Controle Total.
Habilite todos os adaptadores de banda larga móvel.
Em Gerenciador de Dispositivos, expanda Adaptadores de rede.
Clique com o botão direito do mouse em cada dispositivo de banda larga móvel e clique em Habilitar.
5- Publicar o pacote de metadados do serviço
Depois de confirmar que o pacote de metadados de serviço funciona corretamente, a etapa final é liberar o pacote. Você pode liberar o pacote selecionando o pacote anexado à experiência específica clicando no botão Liberar , conforme mostrado abaixo.
Etapas para editar um pacote de metadados de serviço
Você pode editar um pacote de metadados de serviço usando a página Gerenciar Experiências do dashboard de hardware do Centro de Desenvolvimento do Windows.
Solução de problemas
Abra a lista de redes e procure sua rede de banda larga móvel. Se a rede estiver listada usando o nome e o ícone que você usou no pacote de metadados de serviço ServiceInfo.xml arquivo, o pacote será analisado corretamente. Se você estiver atualizando um pacote de metadados de serviço com o mesmo nome e ícone ou se o nome ou ícone não tiver aparecido na lista após aproximadamente um minuto, execute etapas adicionais, conforme discutido aqui:
Forçar uma atualização de metadados
Verificar o cache de metadados
Verifique a configuração
Verificar os logs do WWAN
Forçar uma atualização de metadados
Algumas partes dos metadados e sistemas de aplicativos de banda larga móvel dependem do acesso à rede, o que pode falhar e deixar o computador em um estado inconsistente. Se isso acontecer, você poderá encontrar uma situação em que os metadados de serviço não estão instalados ou o aplicativo de banda larga móvel não está instalado. O sistema tenta corrigir periodicamente a situação, mas para conservar o poder, as tentativas são bastante pouco frequentes (apenas algumas vezes por dia). Em vez de aguardar a próxima repetição, você pode forçar manualmente uma atualização a acontecer imediatamente. Para fazer isso, execute estas etapas:
Abra a Painel de Controle da área de trabalho.
Abra Dispositivos e Impressoras.
No menu Exibir , clique em Atualizar ou pressione a tecla F5 . Essa ação faz com que os metadados sejam reparsados e os eventos em segundo plano sejam registrados novamente.
Importante
Se um pacote de metadados de serviço já tiver sido analisado com êxito, o sistema tratará essa atualização como uma atualização de metadados. Nesse caso, o pacote de metadados deve ter um GUID diferente em seu nome de arquivo e um carimbo de data/hora atualizado no elemento LastModifiedDate do PackageInfo.xml.
Verificar o cache de metadados
Se uma atualização de metadados não corrigiu o problema, verifique se o pacote de metadados de serviço é válido e se ele tem as IDs de Hardware corretas. Para fazer isso, execute estas etapas:
Navegue até %programdata%\Microsoft\Windows\DeviceMetadataCache\dmrccache\culture, onde cultura é o código de cultura para a cultura atual do computador de teste (por exemplo, en-us ou es-es).
Procure uma pasta que tenha o mesmo nome que o pacote de metadados (sem a extensão .devicemetadata-ms ). Se esse diretório não existir, isso poderá significar uma das quatro coisas:
O pacote de metadados de serviço está corrompido.
O pacote de metadados de serviço não tem as IDs de Hardware corretas.
O dispositivo de banda larga móvel não está em um estado em que os metadados podem ser baixados ou você conectou o dispositivo antes de copiar o pacote de metadados do serviço.
Ocorreu um problema ao verificar a assinatura digital no pacote de metadados. Isso geralmente é causado por não ter a assinatura de teste habilitada no computador de teste.
Se você tiver certeza de que o pacote não está corrompido e que você primeiro conectou o dispositivo de banda larga móvel depois de copiar o pacote de metadados de serviço, marcar os intervalos IMSI. É muito fácil digitar muitos ou poucos 0s ou 9s. Se o problema persistir depois de confirmar ou corrigir esses itens, você deverá examinar o registro.
Verificar o registro
Aviso
Você não deve editar dados do Registro que não pertencem ao seu aplicativo, a menos que sejam absolutamente necessários. Se houver um erro no Registro, o sistema poderá não funcionar corretamente. Não exclua, em nenhuma circunstância, a chave do Registro MobileBroadbandAccounts . O Windows não o recriará e você interromperá o recurso.
Execute as seguintes etapas para marcar o registro:
Abra o Editor do Registro.
Acesse HKLM\SOFTWARE\Microsoft\WwanSvc\MobileBroadbandAccounts.
Dentro dessa chave do Registro, procure três outras chaves: Contas, NetworkInterfaceBindings e Dados. Essas chaves não existem por padrão; eles são criados automaticamente na primeira vez que um dispositivo de banda larga móvel é inserido, ativado ou conectado.
Se as chaves Contas ou NetworkInterfaceBindings não existirem e você já tiver conectado ou ligado o adaptador de banda larga móvel, marcar os logs do WWAN.
Se algumas ou todas essas chaves existirem, expanda a chave Contas no modo de exibição Árvore . Uma ou mais chaves do Registro que têm nomes semelhantes a GUIDs devem existir dentro dela. As entradas da árvore do Registro devem ser semelhantes à árvore do Registro exibida abaixo:
Se a chave do Registro for semelhante à figura acima (os nomes dos valores variam ligeiramente dependendo se a conta está em uma rede GSM ou CDMA) e, se você não vir o ícone na lista de redes, deverá examinar os logs de eventos.
Se as entradas do Registro forem semelhantes à figura seguinte, isso significa que o adaptador de banda larga móvel foi inserido antes do pacote de metadados de serviço ser copiado para o repositório de metadados do dispositivo, o pacote de metadados de serviço está corrompido ou as IDs de Hardware estão incorretas. Para corrigir uma situação em que você conectou ou ativou o dispositivo antes de copiar o pacote de metadados para o repositório de metadados, execute as etapas em Forçar uma atualização de metadados. Caso contrário, siga as etapas em Verificar os logs do WWAN.
Verificar os logs do WWAN
Se não houver chaves do Registro Accounts ou NetworkInterfaceBindings em HKLM\SOFTWARE\Microsoft\WwanSvc\MobileBroadbandAccounts ou se houver entradas que não estão totalmente preenchidas, você deverá examinar os logs do WWAN. As etapas a seguir redefinirão o computador para um estado conhecido:
Desconecte ou desative o dispositivo de banda larga móvel (se o dispositivo estiver inserido, desabilite-o no Gerenciador de Dispositivos).
Exclua as seguintes chaves do Registro:
HKLM\SOFTWARE\Microsoft\WwanSvc\MobileBroadbandAccounts\Accounts
HKLM\SOFTWARE\Microsoft\WwanSvc\MobileBroadbandAccounts\NetworkInterfaceBindings
Aviso
Não exclua, em nenhuma circunstância, a chave do Registro HKLM\SOFTWARE\Microsoft\WwanSvc\MobileBroadbandAccounts \. O Windows não o recriará e você interromperá o recurso.
Há dois tipos de entradas que são de interesse nos logs: entradas de log de entradas de serviço WWAN de gerenciamento de conta e entradas de tarefa do analisador. O primeiro tipo pode ajudar a depurar problemas causados por problemas com o hardware de rede e o segundo tipo pode ajudar a depurar problemas de análise de metadados.
As entradas de log de entradas de serviço WWAN de gerenciamento de conta para uma rede processada com êxito são semelhantes às seguintes:
[0]02CC.0CD0::2012-01-04 09:22:26.567 [Microsoft-Windows-WWAN-SVC-EVENTS]Account Management: Account updater started for network interface {7a0a0dce-0a51-471a-8c16-6e767cd0b861.
[0]02CC.0CD0::2012-01-04 09:22:26.567 [Microsoft-Windows-WWAN-SVC-EVENTS]Account Management: Getting home provider ID from hardware device for network interface {7A0A0DCE-0A51-471A-8C16-6E767CD0B861}. Provider ID is "234567".
[0]02CC.0CD0::2012-01-04 09:22:26.567 [Microsoft-Windows-WWAN-SVC-EVENTS]Account Management: Getting home provider name from hardware device for network interface {7A0A0DCE-0A51-471A-8C16-6E767CD0B861}. Provider name is "MS GSM".
[0]02CC.0CD0::2012-01-04 09:22:26.586 [Microsoft-Windows-WWAN-SVC-EVENTS]Account Management: Network identity not recognized, assigning new network account ID.
[0]02CC.0CD0::2012-01-04 09:22:26.597 [Microsoft-Windows-WWAN-SVC-EVENTS]Account Management: Devnode create/update started.
[0]02CC.0CD0::2012-01-04 09:22:26.617 [Microsoft-Windows-WWAN-SVC-EVENTS]Account Management: Devnode create/update finished.
[0]02CC.0CD0::2012-01-04 09:22:26.617 [Microsoft-Windows-WWAN-SVC-EVENTS]Account Management: Data store create/update started.
[0]02CC.0CD0::2012-01-04 09:22:26.707 [Microsoft-Windows-WWAN-SVC-EVENTS]Account Management: Data store create/update finished.
[0]02CC.0CD0::2012-01-04 09:22:26.707 [Microsoft-Windows-WWAN-SVC-EVENTS]Account Management: Account updater finished for network interface {7a0a0dce-0a51-471a-8c16-6e767cd0b861}.
Você pode encontrar essas entradas pesquisando o log para Gerenciamento de Contas. Nesse caso, as entradas mais importantes são Criação/atualização do armazenamento de dados iniciada e Criação/atualização do armazenamento de dados concluída. Se essas entradas existirem e não tiverem mensagens de erro, o hardware estará se comportando corretamente. (O armazenamento de dados que é referenciado aqui contém as chaves do Registro discutidas em Verificar o registro.)
Por outro lado, em um dispositivo em que o SIM é removido, as entradas normalmente se parecem com o seguinte:
[0]02CC.03E4::2012-01-04 09:29:50.309 [Microsoft-Windows-WWAN-SVC-EVENTS]Account Management: Account updater started for network interface {7a0a0dce-0a51-471a-8c16-6e767cd0b861}.
[0]02CC.03E4::2012-01-04 09:29:50.309 [Microsoft-Windows-WWAN-SVC-EVENTS]Account Management: Detected removal of SIM from device bound to network interface {7A0A0DCE-0A51-471A-8C16-6E767CD0B861}.
[0]02CC.03E4::2012-01-04 09:29:50.309 [Microsoft-Windows-WWAN-SVC-EVENTS]Account Management: Devnode create/update started.
[0]02CC.03E4::2012-01-04 09:29:50.309 [Microsoft-Windows-WWAN-SVC-EVENTS]Account Management: Devnode create/update finished.
[0]02CC.03E4::2012-01-04 09:29:50.309 [Microsoft-Windows-WWAN-SVC-EVENTS]Account Management: Account updater finished for network interface {7a0a0dce-0a51-471a-8c16-6e767cd0b861}.
Observação
No último exemplo, não há entradas para criação/atualização do armazenamento de dados iniciada ou Criação/atualização do armazenamento de dados concluída. Como as informações armazenadas no SIM são essenciais para o processo de gerenciamento de conta, um dispositivo que não tem um SIM não terá os metadados associados necessários.
Se o hardware foi processado com êxito, mas seu logotipo ou nome não é exibido na lista de redes, pode haver um problema com o pacote de metadados. Isso pode ser investigado usando as entradas de tarefa do analisador no log. Para localizar essas entradas, pesquise Parser-Task. As entradas de log para uma análise bem-sucedida normalmente se parecem com o seguinte:
[0]0DA8.0A2C::2012-01-04 09:22:32.007 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Parser task started.
[0]0DA8.0A2C::2012-01-04 09:22:32.030 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Parsing metadata for device container with id "{972238E7-36F4-11E1-BC81-00155DE96B01}" for culture "en-US".
[0]0DA8.0A2C::2012-01-04 09:22:32.297 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Starting parse of mobile broadband service information file.
[0]0DA8.0A2C::2012-01-04 09:22:32.297 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Metadata package contains no data for culture "en-US". Using fallback data.
[0]0DA8.0A2C::2012-01-04 09:22:32.356 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Finished parse of mobile broadband service information file.
[0]0DA8.0A2C::2012-01-04 09:22:32.356 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Starting update of stored network account information.
[0]0DA8.0A2C::2012-01-04 09:22:32.377 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]The mobile broadband account now contains service provider information.
[0]0DA8.0A2C::2012-01-04 09:22:32.378 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Finished update of stored network account information.
[0]0DA8.0A2C::2012-01-04 09:22:32.378 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Applying WWAN profiles for service provider Contoso GSM.
[0]0DA8.0A2C::2012-01-04 09:22:32.378 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Starting creation and/or update of WWAN profiles.
[0]02CC.0CD0::2012-01-04 09:22:32.512 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: Profile Update Notification received
[0]02CC.0CD0::2012-01-04 09:22:32.519 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: Complete Scanning
[0]02CC.0CD0::2012-01-04 09:22:32.519 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: WWAN Interface information
[0]02CC.0CD0::2012-01-04 09:22:32.586 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: Profile Update Notification received
[0]02CC.0CD0::2012-01-04 09:22:32.651 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: Profile Update Notification received
[0]0DA8.0A2C::2012-01-04 09:22:32.659 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Finished creation and/or update of WWAN profiles.
[0]0DA8.0A2C::2012-01-04 09:22:32.659 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]WWAN profiles applied successfully for service provider Contoso GSM.
[0]0DA8.0A2C::2012-01-04 09:22:32.659 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Adding trusted provisioning certificates for service provider Contoso GSM.
[0]0DA8.0A2C::2012-01-04 09:22:32.659 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Starting setting of trusted certificates for network provisioning.
[0]0DA8.0A2C::2012-01-04 09:22:33.016 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Finished setting of trusted certificates for network provisioning.
[0]0DA8.0A2C::2012-01-04 09:22:33.016 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Trusted provisioning certificates added successfully for service provider Contoso GSM.
[0]0DA8.0A2C::2012-01-04 09:22:33.017 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Parser task finished.
[0]0DA8.0A2C::2012-01-04 09:22:33.017 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]MbaeParserTask completed successfully.
Esses logs mostram que o arquivo MobileBroadbandInfo.xml foi analisado corretamente, que a tarefa do analisador aplicou os perfis WWAN (juntamente com o log do serviço WWAN que atualizou os perfis com êxito) e que a tarefa do analisador definiu os certificados de provisionamento confiáveis mencionados no MobileBroadbandInfo.xml.
Se alguma parte do processo falhar, essa falha será registrada. Por exemplo, se a assinatura digital marcar falhar no arquivo de ícone do provedor de serviços, as entradas de log normalmente se parecerão com o seguinte:
[0]0F24.0C70::2012-01-04 10:09:49.271 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Parser task started.
[0]0F24.0C70::2012-01-04 10:09:49.288 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Parsing metadata for device container with id "{97223B34-36F4-11E1-BC81-00155DE96B01}" for culture "en-US".
[0]0F24.0C70::2012-01-04 10:09:49.483 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Starting parse of mobile broadband service information file.
[0]0F24.0C70::2012-01-04 10:09:49.483 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Metadata package contains no data for culture "en-US". Using fallback data.
[0]0F24.0C70::2012-01-04 10:09:49.547 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Finished parse of mobile broadband service information file.
[0]0F24.0C70::2012-01-04 10:09:49.547 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Starting update of stored network account information.
[0]0F24.0C70::2012-01-04 10:09:49.688 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Digital signature verification failed for file "c:\programdata\microsoft\windows\devicemetadatacache\dmrccache\en-us\B68264FF-E4D1-49B1-AB5F-2B9C1C16EF5D\ServiceInformation\ContosoBroadband.ico".
[0]0F24.0C70::2012-01-04 10:09:49.690 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Finished update of stored network account information.
[0]0F24.0C70::2012-01-04 10:09:49.692 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Parser task finished.
[0]0F24.0C70::2012-01-04 10:09:49.692 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]MbaeParserTask did not complete successfully. Error is 0x80070306: One or more errors occurred while processing the request.
Como é normal que a tarefa do analisador seja executada mais de uma vez, você pode ver mais de um conjunto de entradas de [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task] log. Nesse caso, os conjuntos de entradas normalmente são os mesmos – se não forem iguais, isso poderá indicar um problema intermitente.
Recursos adicionais
Use os links a seguir para saber mais sobre banda larga móvel em Windows 8.1 e Windows 10:
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de