Portale di dispositivi di Windows per desktop

Windows Portale di dispositivi (WDP) è uno strumento di gestione e debug dei dispositivi che consente di configurare e gestire le impostazioni del dispositivo e visualizzare le informazioni di diagnostica su HTTP da un Web browser. Per informazioni dettagliate su WDP in altri dispositivi, vedere panoramica di Windows Device Portal.

È possibile usare il WDP per quanto segue:

• Gestire le impostazioni del dispositivo (in modo analogo all'app Impostazioni di Windows)
• Visualizzare e modificare un elenco di processi in esecuzione
• Installare, eliminare, avviare e terminare le app
• Modificare i profili Wi-Fi, visualizzare il livello del segnale e visualizzare i dettagli di ipconfig
• Visualizzare grafici in tempo reale relativi all'utilizzo di CPU, memoria, I/O, rete e GPU
• Raccogliere dump del processo
• Raccogli tracce ETW
• Gestire l'archiviazione isolata delle app installate localmente

Configurare Windows Device Portal su un dispositivo desktop

La modalità sviluppatore è necessaria prima di abilitare Device Portal.

Attivare Windows Portale di dispositivi

È possibile abilitare WDP nella sezione Per sviluppatori di Impostazioni (Impostazioni > sistema > avanzato).

Dopo aver abilitato WDP, gli URI verranno visualizzati nella parte inferiore della sezione Portale di dispositivi. Prendere nota del numero di porta aggiunto alla fine degli URL elencati: questo numero viene generato in modo casuale quando WDP è abilitato, ma deve rimanere coerente tra i riavvii del desktop.

Questi collegamenti offrono due modi per connettersi a WDP: tramite la rete locale (inclusa la VPN) o tramite l'host locale.

Disattiva Windows Device Portal

È possibile disabilitare WDP nelle Opzioni per sviluppatori di Impostazioni di Windows (Impostazioni > Sistema > Avanzate).

Connettersi al Device Portal di Windows

Per connettersi tramite host locale, aprire una finestra del browser e immettere uno degli URI mostrati qui (in base al tipo di connessione in uso).

• Localhost: http://127.0.0.1:<PORT> o http://localhost:<PORT>
• Rete locale: https://<IP address of the desktop>:<PORT>

HTTPS è necessario per l'autenticazione e la comunicazione sicura.

Se si usa WDP in un ambiente protetto, ad esempio in un lab di test, in cui tutti gli utenti della rete locale sono attendibili, non hanno informazioni personali sul dispositivo e hanno requisiti univoci, è possibile disabilitare l'opzione Autenticazione. Ciò consente la comunicazione non crittografata e consente a chiunque abbia l'indirizzo IP del computer di connettersi e controllarlo.

contenuto di Portale di dispositivi Windows

WDP fornisce il set di pagine seguente.

• Gestione app
• Esplora file
• Processi in esecuzione
• Performance
• Debug
• Registrazione eventi ETW (Event Tracing for Windows)
• Tracciamento delle prestazioni
• Gestione dispositivi
• Bluetooth
• Rete
• Dati sugli arresti anomali
• Features
• Posizione
• Scratch

Uso di Windows Device Portal per testare ed eseguire il debug di app MSIX

Il video seguente descrive come testare ed eseguire il debug di app MSIX in modalità remota usando Windows Portale di dispositivi.

Altre opzioni di Portale di dispositivi Windows

Le sezioni seguenti forniscono informazioni dettagliate su altre opzioni di Device Portal Windows.

Configurazione basata sul registro

Se si desidera selezionare i numeri di porta per WDP (ad esempio 80 e 443), è possibile impostare le seguenti chiavi di regkey:

• Di seguito HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\WebManagement\Service
  • UseDynamicPorts: DWORD obbligatorio. Impostare questo valore su 0 per conservare i numeri di porta scelti.
  • HttpPort: DWORD obbligatorio. Contiene il numero di porta in cui WDP è in ascolto delle connessioni HTTP.
  • HttpsPort: DWORD obbligatorio. Contiene il numero di porta in cui WDP è in ascolto delle connessioni HTTPS.

Nello stesso percorso regkey è anche possibile disattivare il requisito di autenticazione:

• UseDefaultAuthorizer - 0 per disabilitato, 1 per abilitato.
  • Questo controlla sia il requisito di autenticazione di base per ogni connessione che il reindirizzamento da HTTP a HTTPS.

Opzioni della riga di comando per il Portale per dispositivi Windows

Da un prompt dei comandi amministrativo è possibile abilitare e configurare parti di WDP. Per visualizzare il set più recente di comandi supportati nella compilazione, è possibile eseguire webmanagement /?

• sc start webmanagement oppure sc stop webmanagement
  • Attivare o disattivare il servizio. Questa operazione richiede comunque l'abilitazione della modalità sviluppatore.
• -Credentials <username> <password>
  • Impostare un nome utente e una password per WDP. Il nome utente deve essere conforme agli standard di autenticazione di base, quindi non può contenere due punti (:) e deve essere compilato con caratteri ASCII standard, ad esempio [a-zA-Z0-9] perché i browser non analizzano il set di caratteri completo in modo standard.
• -DeleteSSL
  • In questo modo viene reimpostata la cache dei certificati SSL usata per le connessioni HTTPS. Se si verificano errori di connessione TLS che non possono essere ignorati (anziché l'avviso del certificato previsto), questa opzione potrebbe risolvere il problema automaticamente.
• -SetCert <pfxPath> <pfxPassword>
  • Per informazioni dettagliate, vedere Provisioning Windows Device Portal con un certificato SSL personalizzato.
  • In questo modo è possibile installare il proprio certificato SSL per correggere la pagina di avviso SSL visualizzata in genere in WDP.
• -Debug <various options for authentication, port selection, and tracing level>
  • Eseguire una versione autonoma di WDP con una configurazione specifica e messaggi di debug visibili. Ciò è più utile per la creazione di un plug-in in pacchetto.
  • Consulta l'articolo di MSDN Magazine per i dettagli su come eseguire l'operazione come account di sistema per testare completamente il plug-in pacchettizzato.

Risoluzione dei problemi

Di seguito sono riportati alcuni errori comuni che possono verificarsi durante la configurazione di Windows Device Portal.

WindowsUpdateSearch restituisce un numero non valido di aggiornamenti (0x800f0950)

Questo errore può verificarsi quando si tenta di installare i pacchetti di sviluppo in una build non definitive di Windows. Questi pacchetti Feature on Demand (FoD) sono disponibili tramite Windows Update e, per scaricarli nelle build prerelease, è necessario aderire al programma flighting. Se l'installazione non è configurata per il flighting con la corretta combinazione di build e ring, il payload non sarà scaricabile. Verifica quanto segue:

1. Vai a Impostazioni > Aggiornamento e sicurezza > Programma Windows Insider e verifica che la sezione account Windows Insider contenga le informazioni corrette del tuo account. Se la sezione non viene visualizzata, selezionare Collega un account Windows Insider, aggiungere l'account di posta elettronica e verificare che venga visualizzato sotto l'intestazione Windows Account Insider (potrebbe essere necessario selezionare Collega un account Windows Insider una seconda volta per collegare effettivamente un account appena aggiunto).

2. In Quale tipo di contenuto si vuole ricevere?, assicurarsi che sia selezionato Sviluppo attivo di Windows.

3. In Quale ritmo vuoi ottenere nuove build?, assicurati che Windows Insider Fast sia selezionato.

4. Ora dovrebbe essere possibile installare i FoD. Se si è verificato che si è in Windows Insider Fast e non è ancora possibile installare i foD, inviare commenti e suggerimenti e allegare i file di log in C:\Windows\Logs\CBS.

[SC] StartService: OpenService FAILED 1060: il servizio specificato non esiste come servizio installato

Questo errore può verificarsi se i pacchetti per sviluppatori non sono installati. Senza i pacchetti per sviluppatori, non esiste alcun servizio di gestione Web. Provare a installare di nuovo i pacchetti per sviluppatori.

CBS non può avviare il download perché il sistema è connesso a una rete a consumo (CBS_E_METERED_NETWORK)

Questo errore può verificarsi se si usa una connessione Internet a consumo. Non sarà possibile scaricare i pacchetti per sviluppatori con una connessione a consumo.

Vedere anche

• Panoramica di Windows Device Portal
• Informazioni di riferimento sulle API principali di Device Portal Windows