Portale di dispositivi di Windows per desktop

  • Articolo

Il Portale di dispositivi di Windows è uno strumento per la gestione e il debug di dispositivi che consente di configurare e gestire le impostazioni dei dispositivi e visualizzare le informazioni di diagnostica su HTTP da un Web browser. Per informazioni dettagliate sul Portale di dispositivi di Windows in altri dispositivi, vedere Panoramica del Portale di dispositivi di Windows.

È possibile usare il Portale di dispositivi di Windows per gli scopi seguenti:

  • Gestire le impostazioni dei dispositivi (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 la potenza del segnale e vedere i dettagli di ipconfig
  • Visualizzare grafici animati relativi all'uso di CPU, memoria, I/O, rete e GPU
  • Raccogliere i dump dei processi
  • Raccogliere le tracce ETW
  • Modificare lo spazio di memorizzazione isolato delle app trasferite tramite sideload

Configurare il Portale di dispositivi di Windows in un dispositivo desktop

Abilitare la modalità sviluppatore

A partire da Windows 10 versione 1607, alcune delle funzionalità più recenti per il desktop sono disponibili solo quando è abilitata la modalità sviluppatore. Per informazioni su come abilitare la modalità sviluppatore, vedi Abilita il tuo dispositivo per lo sviluppo.

Importante

A volte, a causa di problemi di rete o di compatibilità, la modalità sviluppatore non viene installata correttamente nel dispositivo. Vedi la relativa sezione di Abilitare il dispositivo per lo sviluppo per indicazioni sulla risoluzione di questi problemi.

Abilitare il Portale di dispositivi di Windows

È possibile abilitare WDP nella sezione per developer di Impostazioni (Impostazioni -> Privacy & sicurezza -> per developer). Quando abiliti Portale di dispositivi, devi anche creare un nome utente e una password appositi. Non usare l'account Microsoft o altre credenziali di Windows.

Windows Device Portal section of the Settings app

Dopo aver abilitato il Portale di dispositivi di Windows, verranno visualizzati alcuni collegamenti Web in fondo alla sezione. Prendere nota del numero di porta alla fine degli URL elencati. Questo numero viene generato in modo casuale quando il Portale di dispositivi di Windows è abilitato, ma deve rimanere coerente da un riavvio all'altro del desktop.

Questi collegamenti consentono di connettersi al Portale di dispositivi di Windows in due modi: tramite rete locale (inclusa VPN) o tramite host locale. Dopo la connessione, dovrebbe comparire una finestra simile alla seguente:

Windows Device Portal

Disabilitare il Portale di dispositivi di Windows

È possibile disabilitare il Portale di dispositivi di Windows nella sezione Per gli sviluppatori di Impostazioni di Windows.

Connessione a Portale di dispositivi di Windows

Per connettersi tramite host locale, aprire una finestra del browser e immettere uno degli URI qui visualizzato, 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>

È richiesto HTTPS per l'autenticazione e la comunicazione sicura.

Se si usa il Portale di dispositivi di Windows in un ambiente protetto, ad esempio in un lab di test, in cui vengono considerati attendibili tutti gli utenti della rete locale, non sono presenti informazioni personali nel dispositivo e si hanno requisiti univoci, è possibile disabilitare l'opzione di autenticazione. Questo rende possibile comunicazioni non crittografate e consente a chiunque abbia l'indirizzo IP del computer di connettersi a esso e controllarlo.

Contenuto del Portale di dispositivi di Windows

Il Portale di dispositivi di Windows è costituito dal set di pagine seguente.

  • Apps manager (Gestione app)
  • Xbox Live
  • File explorer (Esplora file)
  • Processi in esecuzione
  • Prestazioni
  • Debug
  • Registrazione ETW (Event Tracing for Windows)
  • Performance Tracing (Traccia prestazioni)
  • Gestione dispositivi
  • Bluetooth
  • Rete
  • Crash data
  • Funzionalità
  • Realtà mista
  • Streaming Install Debugger
  • Location
  • Scratch

Uso del Portale di dispositivi di Windows per il test e il debug delle app MSIX

Il video seguente descrive come testare ed eseguire il debug delle app MSIX in remoto utilizzando il Portale di dispositivi di Windows.

Altre opzioni del Portale di dispositivi di Windows

Le sezioni seguenti forniscono dettagli su altre opzioni del Portale di dispositivi di Windows.

Configurazione basata sul Registro di sistema

Se si vuole selezionare i numeri di porta per il Portale di dispositivi di Windows (ad esempio, 80 e 443), è possibile impostare le chiavi del Registro di sistema seguenti:

  • In HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\WebManagement\Service
    • UseDynamicPorts: valore DWORD obbligatorio. Imposta questo valore su 0 per mantenere i numeri di porta che hai scelto.
    • HttpPort: valore DWORD obbligatorio. Contiene il numero di porta su cui il Portale di dispositivi di Windows rimane in ascolto delle connessioni HTTP.
    • HttpsPort: valore DWORD obbligatorio. Contiene il numero di porta su cui il Portale di dispositivi di Windows rimane in ascolto delle connessioni HTTPS.

Nello stesso percorso delle chiavi del Registro di sistema puoi anche disabilitare il requisito dell'autenticazione:

  • UseDefaultAuthorizer - 0 per disabilitarlo, 1 per abilitarlo.
    • Questa chiave controlla anche il requisito dell'autenticazione di base per ogni connessione e il reindirizzamento da HTTP a HTTPS.

Opzioni della riga di comando per il Portale di dispositivi di Windows

Da un prompt dei comandi amministrativo è possibile abilitare e configurare parti del Portale di dispositivi di Windows. Per visualizzare il set di comandi più recente supportato nella tua build, puoi eseguire webmanagement /?

  • sc start webmanagement o sc stop webmanagement
    • Abilita o disabilita il servizio. Richiede comunque che sia abilitata la modalità sviluppatore.
  • -Credentials <username> <password>
    • Imposta un nome utente e una password per il Portale di dispositivi di Windows. Il nome utente deve essere conforme agli standard di autenticazione di base: pertanto non può contenere due punti (:) e deve essere costituito da caratteri ASCII standard, ad esempio [a-zA-Z0-9], in quanto i browser non analizzano l'intero set di caratteri in modo standard.
  • -DeleteSSL
    • Reimposta 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 per il certificato previsto), questa opzione può risolvere automaticamente il problema.
  • -SetCert <pfxPath> <pfxPassword>
  • -Debug <various options for authentication, port selection, and tracing level>
    • Esegue una versione autonoma del Portale di dispositivi di Windows con una configurazione specifica e messaggi di debug visibili. È particolarmente utile per la creazione di un plug-in del pacchetto.
    • Vedi l'articolo di MSDN Magazine per informazioni dettagliate su come eseguire questo comando con l'account di sistema per testare completamente il plug-in del pacchetto.

Risoluzione dei problemi

Di seguito sono riportati alcuni errori comuni che possono verificarsi durante la configurazione del Portale di dispositivi di Windows.

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

Potresti visualizzare questo errore quando tenti di installare i pacchetti sviluppatore su una build non definitiva di Windows. Questi pacchetti di funzionalità su richiesta (FoD) sono ospitati in Windows Update e il download nelle build non definitive richiede di acconsentire esplicitamente alla distribuzione di versioni di anteprima. Se tale operazione non viene eseguita per l'installazione per la combinazione di build e anello corretta, il payload non sarà scaricabile. Verifica quanto segue:

  1. Passare a Impostazioni > Aggiornamento & Sicurezza > Programma Windows Insider e confermare che la sezione account Windows Insider riporti le informazioni corrette sull'account. Se questa sezione non viene visualizzata, seleziona Collega un account Windows Insider, aggiungi il tuo account di posta elettronica e verifica che l'account venga visualizzato sotto l'intestazione Account Windows Insider (potrebbe essere necessario selezionare Collega un account Windows Insider una seconda volta per collegare effettivamente un nuovo account aggiunto).

  2. In Che tipo di contenuto ti piacerebbe ricevere? verifica che sia selezionata l'opzione Sviluppo attivo di Windows.

  3. In Con che frequenza vuoi ricevere le nuove build? verifica che sia selezionata l'opzione Windows Insider veloce.

  4. A questo punto dovrebbe essere possibile installare i FoD. Se hai verificato che ti trovi in Windows Insider veloce ma non sei ancora in grado di installare i FoD, invia un feedback e allega i file di registro in C:\Windows\Logs\CBS.

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

Potresti visualizzare questo errore se i pacchetti dello sviluppatore non sono installati. Senza i pacchetti sviluppatore non è disponibile alcun servizio di gestione Web. Prova a installare di nuovo i pacchetti sviluppatore.

CBS non può avviare il download perché il sistema è in 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 sviluppatore in una connessione a consumo.

Vedi anche