Portal de dispositivos Windows para área de trabalho

O Windows Device Portal (WDP) é uma ferramenta de gestão e depuração de dispositivos que lhe permite configurar e gerir definições do dispositivo e visualizar informações de diagnóstico via HTTP a partir de um navegador web. Para detalhes do WDP noutros dispositivos, consulte a visão geral do Portal de Dispositivos Windows.

Pode usar o WDP para o seguinte:

• Gerir definições do dispositivo (semelhante à aplicação Definições do Windows)
• Veja e manipule uma lista de processos em execução
• Instalar, apagar, lançar e terminar aplicações
• Altere Wi-Fi perfis, veja a intensidade do sinal e consulte os detalhes do ipconfig
• Ver gráficos em tempo real do uso da CPU, memória, E/S, rede e GPU
• Despejos de processo de recolha
• Recolher rastreios ETW
• Manipular o armazenamento isolado de aplicações instaladas por sideload

Configurar o Portal de Dispositivos do Windows num dispositivo de ambiente de trabalho

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

Ativar o Portal de Dispositivos Windows

Podes ativar o WDP na secção Para programadores de Definições (Definições > System > Advanced).

Assim que o WDP estiver ativado, verá os URIs no final da secção do Portal do Dispositivo. Note o número de porta acrescentado ao final das URLs listadas: este número é gerado aleatoriamente quando o WDP está ativado, mas deve manter-se consistente entre reinicios do ambiente de trabalho.

Estas ligações oferecem duas formas de se ligar ao WDP: através da rede local (incluindo VPN) ou através do host local.

Desligar o Portal de Dispositivos Windows

Podes desativar o WDP na secção Para programadores das Definições do Windows (Definições > System > Advanced).

Ligue-se ao Portal de Dispositivos Windows

Para ligares através do host local, abre uma janela do navegador e insere um dos URIs aqui mostrados (com base no tipo de ligação que estás a usar).

• 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 estiver a usar WDP num ambiente protegido, por exemplo, num laboratório de testes, onde confia em todos na sua rede local, não tem informações pessoais no dispositivo e tem requisitos únicos, pode desativar a opção de Autenticação. Isto permite comunicação não encriptada e permite que qualquer pessoa com o endereço IP do seu computador se ligue e controle.

Conteúdo do Portal de Dispositivos Windows

O WDP fornece o seguinte conjunto de páginas.

• Gestor de aplicações
• Explorador de ficheiros
• Processos em Execução
• Performance
• Debug
• Registo em ETW (Event Tracing for Windows)
• Rastreamento de desempenho
• Gestor de dispositivos
• Bluetooth
• Rede
• Dados de acidentes
• Features
• Location
• Scratch

Usar o Portal de Dispositivos Windows para testar e depurar aplicações MSIX

O vídeo seguinte descreve como testar e depurar aplicações MSIX remotamente usando o Windows Device Portal.

Mais opções do Portal de Dispositivos Windows

As secções seguintes fornecem detalhes sobre outras opções do Portal de Dispositivos Windows.

Configuração baseada no registo

Se quiser selecionar os números de porta para WDP (como 80 e 443), pode definir as seguintes chaves reguladoras:

• Sob HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\WebManagement\Service
  • UseDynamicPorts: Um DWORD obrigatório. Defina isto para 0 para manter os números de porta que escolheu.
  • HttpPort: Um DWORD obrigatório. Contém o número de porta onde o WDP escuta ligações HTTP.
  • HttpsPort: Um DWORD obrigatório. Contém o número de porta onde o WDP escuta ligações HTTPS.

No mesmo caminho da regkey, também pode desativar o requisito de autenticação:

• UseDefaultAuthorizer - 0 Para desativado, 1 para ativado.
  • Isto controla tanto o requisito básico de autenticação para cada ligação como o redirecionamento de HTTP para HTTPS.

Opções de linha de comandos para o Portal de Dispositivos Windows

Numa linha de comandos com privilégios de administrador, pode ativar e configurar componentes do WDP. Para ver o conjunto mais recente de comandos suportados na sua build, pode executar webmanagement /?

• sc start webmanagement ou sc stop webmanagement
  • Liga ou desliga o serviço. Isto ainda requer que o modo desenvolvedor esteja ativado.
• -Credentials <username> <password>
  • Defina um nome de utilizador e uma palavra-passe para o WDP. O nome de utilizador deve estar em conformidade com os padrões básicos de Autenticação, pelo que não pode conter dois pontos (:) e deve ser construído a partir de caracteres ASCII padrão, por exemplo, [a-zA-Z0-9], pois os navegadores não analisam o conjunto completo de caracteres de forma padrão.
• -DeleteSSL
  • Isto reinicia a cache do certificado SSL usada para ligações HTTPS. Se encontrar erros de ligação TLS que não possam ser contornados (ao contrário do esperado aviso de certificado), esta opção pode resolver o problema para si.
• -SetCert <pfxPath> <pfxPassword>
  • Consulte Provisionamento do Portal de Dispositivos Windows com um certificado SSL personalizado para mais detalhes.
  • Isto permite-lhe instalar o seu próprio certificado SSL para corrigir a página de aviso SSL que normalmente aparece 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. Isto é mais útil para criar um plugin em pacote.
  • Consulte o artigo da MSDN Magazine para obter detalhes sobre como executar este procedimento como SYSTEM, para testar exaustivamente o seu plug-in empacotado.

Troubleshooting

Abaixo estão alguns erros comuns que pode encontrar ao configurar o Windows Device Portal.

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

Pode aparecer este erro ao tentar instalar os pacotes de desenvolvimento numa versão pré-lançamento do Windows. Estes pacotes de Funcionalidades a Pedido (FoD) são disponibilizados no Windows Update e, para os transferir em compilações de pré-lançamento, é necessário aderir ao programa de flighting. Se a sua instalação não for optada para a combinação certa de build e anel, o payload não será descarregável. Verifique novamente o seguinte:

1. Navegue até Definições > Atualização e Segurança > Programa Windows Insider e confirme que a secção Conta do Windows Insider contém as informações corretas da sua conta. Se não vires essa secção, seleciona Ligar uma conta Windows Insider, adiciona a tua conta de email e confirma que aparece sob o título da conta Windows Insider (podes precisar de selecionar Ligar uma conta Windows Insider uma segunda vez para realmente ligar uma conta recém-adicionada).

2. Em Que tipo de conteúdo gostaria de receber?, certifique-se de que está selecionado Desenvolvimento Ativo do Windows.

3. Em que ritmo queres obter novas builds?, certifica-te de que o Windows Insider Fast está selecionado.

4. Agora deves conseguir instalar os FoDs. Se confirmou que está no Windows Insider Fast e ainda não consegue instalar os FoDs, por favor dê feedback e anexe os ficheiros de registo em C:\Windows\Logs\CBS.

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

Podes receber este erro se os pacotes de desenvolvimento não estiverem instalados. Sem os pacotes de programação, não existe serviço de gestão web. Tenta instalar novamente os pacotes de desenvolvimento.

A CBS não consegue iniciar o download porque o sistema está em rede medida (CBS_E_METERED_NETWORK)

Pode receber este erro se estiver numa ligação à internet com medidor. Não vais conseguir descarregar os pacotes de programação numa ligação com contador.

Consulte também

• Visão geral do Portal de Dispositivos Windows
• Referência da API central do Windows Device Portal