Portal de Dispositivos do Windows para Desktop

Windows Device Portal (WDP) é uma ferramenta de gerenciamento e depuração de dispositivos que permite configurar e gerenciar as configurações do dispositivo e exibir informações de diagnóstico via HTTP em um navegador da Web. Para obter detalhes sobre o WDP em outros dispositivos, consulte Visão geral do Portal de Dispositivos do Windows.

Você pode usar o WDP para o seguinte:

• Gerenciar configurações do dispositivo (semelhante ao aplicativo configurações do Windows)
• Ver e manipular uma lista de processos em execução
• Instalar, excluir, iniciar e encerrar aplicativos
• Alterar perfis Wi-Fi, exibir a força do sinal e ver os detalhes do ipconfig
• Exibir grafos dinâmicos de uso de CPU, memória, E/S, rede e GPU
• Coletar despejos de memória do processo
• Coletar rastreamentos de ETW
• Manipular o armazenamento isolado dos aplicativos de sideload

Configurar o Windows Device Portal em um dispositivo desktop

O Modo de Desenvolvedor é necessário antes de habilitar o Portal do Dispositivo.

Ativar o Portal de Dispositivos do Windows

Você pode habilitar o WDP na seção Para desenvolvedores de Configurações (Configurações Avançadas > do Sistema>).

Depois que o WDP estiver habilitado, você verá URIs na parte inferior da seção Portal do Dispositivo. Anote o número da porta acrescentado ao final das URLs listadas: esse número é gerado aleatoriamente quando o WDP está habilitado, mas deve permanecer consistente entre as reinicializações da área de trabalho.

Esses links oferecem duas maneiras de se conectar ao WDP: pela rede local (incluindo VPN) ou pelo host local.

Desativar o Portal de Dispositivos do Windows

Você pode desabilitar o WDP na seção For developers do Windows Settings (Settings > System > Advanced).

Conectar-se ao Windows Device Portal

Para se conectar por meio do host local, abra uma janela do navegador e insira uma das URIs mostradas aqui (com base no tipo de conexão que você está usando).

• Localhost: http://127.0.0.1:<PORT> ou http://localhost:<PORT>
• Rede Local: https://<IP address of the desktop>:<PORT>

O HTTPS é necessário para autenticação e comunicação segura.

Se você estiver usando o WDP em um ambiente protegido, por exemplo, em um laboratório de teste, no qual confia em todos em sua rede local, não tem informações pessoais no dispositivo e tem requisitos exclusivos, você pode desabilitar a opção autenticação. Isso permite a comunicação não criptografada e permite que qualquer pessoa com o endereço IP do computador se conecte e controle-a.

Conteúdo do Portal de Dispositivos do Windows

O WDP fornece o seguinte conjunto de páginas.

• Gerenciador de aplicativos
• Explorador de arquivos
• Processos em Execução
• Performance
• Debug
• Log do ETW (Rastreamento de Eventos para Windows)
• Rastreamento de desempenho
• Gerenciador de dispositivos
• Bluetooth
• Rede
• Dados de falha
• Features
• Localidade
• Scratch

Usando o Windows Device Portal para testar e depurar aplicativos MSIX

O vídeo a seguir descreve como testar e depurar aplicativos MSIX remotamente usando Windows Device Portal.

Mais opções do Portal do Dispositivo Windows

As seções a seguir fornecem detalhes sobre outras opções do Portal do Dispositivo Windows.

Configuração baseada em registro

Se você quiser selecionar números de porta para WDP (como 80 e 443), poderá definir as seguintes chaves de regkey:

• Em HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\WebManagement\Service
  • UseDynamicPorts: um DWORD necessário. Defina isso como 0 para manter os números de porta escolhidos.
  • HttpPort: um DWORD necessário. Contém o número da porta no qual o WDP escuta conexões HTTP.
  • HttpsPort: um DWORD necessário. Contém o número da porta no qual o WDP escuta conexões HTTPS.

No mesmo caminho da chave do registro, você também pode desativar o requisito de autenticação:

• UseDefaultAuthorizer - 0 para desabilitado, 1 para habilitado.
  • Isso controla o requisito básico de autenticação para cada conexão e o redirecionamento de HTTP para HTTPS.

Opções de linha de comando para Windows Device Portal

Em um prompt de comando administrativo, você pode habilitar e configurar partes do WDP. Para ver o conjunto mais recente de comandos com suporte em seu build, você pode executar webmanagement /?

• sc start webmanagement ou sc stop webmanagement
  • Ative ou desative o serviço. Isso ainda requer que o modo de desenvolvedor seja habilitado.
• -Credentials <username> <password>
  • Defina um nome de usuário e uma senha para WDP. O nome de usuário deve estar em conformidade com os padrões básicos de autenticação, portanto, não pode conter dois-pontos (:) e deve ser criado a partir de caracteres ASCII padrão, por exemplo, [a-zA-Z0-9], pois os navegadores não analisam o caractere completo definido de maneira padrão.
• -DeleteSSL
  • Isso redefine o cache de certificados SSL usado para conexões HTTPS. Se você encontrar erros de conexão TLS que não podem ser ignorados (em oposição ao aviso de certificado esperado), essa opção poderá corrigir o problema para você.
• -SetCert <pfxPath> <pfxPassword>
  • Consulte Provisionar o Portal de Dispositivos do Windows com um certificado SSL personalizado para obter detalhes.
  • Isso permite que você instale seu próprio certificado SSL para corrigir a página de aviso SSL que normalmente é vista no WDP.
• -Debug <various options for authentication, port selection, and tracing level>
  • Execute uma versão autônoma do WDP com uma configuração específica e mensagens de depuração visíveis. Isso é mais útil para criar um plug-in empacotado.
  • Consulte o artigo da Revista MSDN para obter detalhes sobre como executá-lo como Sistema para testar totalmente o plug-in empacotado.

Troubleshooting

Abaixo estão alguns erros comuns que você pode encontrar ao configurar o Portal de Dispositivos do Windows.

WindowsUpdateSearch retorna um número inválido de atualizações (0x800f0950)

Você pode receber esse erro ao tentar instalar os pacotes de desenvolvedor em uma compilação de pré-lançamento de Windows. Esses pacotes de FoD (recurso sob demanda) são hospedados no Windows Update e baixá-los em builds pré-lançamento exige que você aceite a liberação de versões de pré-lançamento. Se a instalação não tiver aceitado a liberação de versões de pré-lançamento para a combinação correta de build e anel, não será possível baixar o conteúdo. Verifique o seguinte:

1. Navegue até Configurações > Atualização e Segurança > Programa Windows Insider e confirme se a seção Conta do Windows Insider contém as informações corretas da sua conta. Se você não vir essa seção, selecione Vincular uma conta do Windows Insider, adicione sua conta de email e confirme se ela aparece no título da conta do Windows Insider (talvez seja necessário selecionar Vincular uma conta do Insider Windows uma segunda vez para vincular uma conta recém-adicionada).

2. Em Que tipo de conteúdo você gostaria de receber?, verifique se o desenvolvimento ativo de Windows está selecionado.

3. Em Em que ritmo você quer receber novas compilações?, verifique se Windows Insider Fast está selecionado.

4. Agora você já pode instalar os FoDs. Se você confirmou que está no Windows Insider Fast e ainda não pode instalar os FoDs, forneça comentários e anexe os arquivos de log em C:\Windows\Logs\CBS.

[SC] StartService: OpenService FAILED 1060: O serviço especificado não existe como um serviço instalado

Você poderá receber esse erro se os pacotes do desenvolvedor não estiverem instalados. Sem os pacotes de desenvolvedor, não há nenhum serviço de gerenciamento da Web. Tente instalar os pacotes do desenvolvedor novamente.

O CBS não pode iniciar o download porque o sistema está em uma rede limitada (CBS_E_METERED_NETWORK)

Você poderá receber esse erro se estiver em uma conexão de Internet limitada. Você não poderá baixar os pacotes do desenvolvedor em uma conexão limitada por dados.

Consulte também

• Visão geral do Portal do Dispositivo Windows
• Referência da API principal do Portal do Dispositivo Windows