Compartilhar via

Portal de Dispositivos do Windows para Área de Trabalho

  • Artigo

O WDP (Portal de Dispositivos do Windows) é uma ferramenta de gerenciamento e depuração de dispositivos que permite definir e gerenciar as configurações do dispositivo e exibir informações de diagnóstico por HTTP de um navegador da Web. Para obter detalhes do WDP sobre outros dispositivos, confira 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 de Configurações do Windows )
  • Ver e manipular uma lista de processos em execução
  • Instalar, excluir, iniciar e encerrar aplicativos
  • Alterar perfis de Wi-Fi, exibir a intensidade do sinal e ver 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 do ETW
  • Manipular o armazenamento isolado dos aplicativos de sideload

Configurar o Portal de Dispositivos do Windows em um dispositivo desktop

Ativar o modo de desenvolvedor

Você pode habilitar o Modo de Desenvolvedor na seção Para desenvolvedores de Configurações (Configurações –> Sistema –> Para desenvolvedores). A partir do Windows 10, versão 1607, alguns recursos mais recentes para área de trabalho só estão disponíveis quando o modo de desenvolvedor está habilitado.

Captura de tela das configurações – sistema de> – janela> para desenvolvedores mostrando o Modo de Desenvolvedor habilitado.

Importante

Às vezes, devido a problemas de rede ou compatibilidade, o modo de desenvolvedor não será instalado corretamente em seu dispositivo. Consulte a seção relevante de Habilitar seu dispositivo para desenvolvimento para obter ajuda para solucionar esses problemas.

Ativar o Portal de Dispositivos do Windows

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

Captura de tela da janela Configurações -> Sistema -> Para desenvolvedores que mostra a caixa de diálogo do pacote para Instalar o Modo de Desenvolvedor do Windows depois de habilitar o Portal de Dispositivos.

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.

Captura de tela da janela Configurações -> Sistema -> Para desenvolvedores que mostra as configurações do Portal de Dispositivos disponíveis após serem habilitadas.

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

Captura de tela do Portal de Dispositivos do Windows

Desativar o Portal de Dispositivos do Windows

Desabilite o WDP na seção Para desenvolvedores de Configurações do Windows.

Conectar-se ao Portal de Dispositivos do Windows

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
  • Xbox Live
  • Explorador de arquivos
  • Processos em execução
  • Desempenho
  • Depurar
  • Log do ETW (Rastreamento de Eventos para Windows)
  • Rastreamento de desempenho
  • Gerenciador de dispositivos
  • Bluetooth
  • Rede
  • Dados de falha
  • Características
  • Realidade Misturada
  • Depurador de instalação de streaming
  • Localização
  • Rascunho

Usando o Portal de Dispositivos do Windows para testar e depurar aplicativos MSIX

O vídeo a seguir descreve como testar e depurar aplicativos MSIX remotamente usando o Portal de Dispositivos do Windows.

Mais opções do Portal de Dispositivos do Windows

As seções a seguir fornecem detalhes sobre outras opções do Portal de Dispositivos do 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 o Portal de Dispositivos do Windows

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 do certificado 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>
  • -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.

Solução de problemas

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 do 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 Atualizar & Segurança Programa Windows Insider e confirme se a seção da conta do Windows Insider tem suas informações de conta corretas. 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 Windows Insider 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 do Windows está selecionado.

  3. Em Em que ritmo deseja receber novos builds? , selecione Windows Insider Rápido.

  4. Agora, você poderá 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 com limite de dados (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 de desenvolvedor em uma conexão com limite de dados.

Consulte também