Portale di dispositivi per Windows DesktopDevice Portal for Windows Desktop

Il portale di dispositivi di Windows è uno strumento di debug che consente di visualizzare informazioni di diagnostica e interagire con il PC desktop su HTTP da un Web browser.Windows Device Portal is a debugging tool that lets you view diagnostic information and interact with your desktop PC over HTTP from a web browser. Per eseguire il debug di altri dispositivi, vedere Panoramica del portale di dispositivi di Windows.To debug other devices, see Windows Device Portal overview.

Puoi usare Device Portal per eseguire le operazioni seguenti:You can use Device Portal to do the following:

  • Visualizzare e modificare un elenco di processi in esecuzioneSee and manipulate a list of running processes
  • Installare, eliminare, avviare e terminare le appInstall, delete, launch, and terminate apps
  • Modificare i profili Wi-Fi, visualizzare la potenza del segnale e vedere ipconfigChange Wi-Fi profiles, view signal strength, and see ipconfig
  • Visualizzare grafici animati relativi all'uso di CPU, memoria, I/O, rete e GPUView live graphs of CPU, memory, I/O, network, and GPU usage
  • Raccogliere i dump dei processiCollect process dumps
  • Raccogliere le tracce ETWCollect ETW traces
  • Modificare lo spazio di memorizzazione isolato delle app trasferite tramite sideloadManipulate the isolated storage of sideloaded apps

Configurare Portale di dispositivi in Windows DesktopSet up Device Portal on Windows Desktop

Abilitare la modalità sviluppatoreTurn on developer mode

A partire da Windows 10 versione 1607, alcune delle funzionalità più recenti per il desktop sono disponibili solo quando è abilitata la modalità sviluppatore.Starting in Windows 10, version 1607, some of the newer features for desktop are only available when developer mode is enabled. Per informazioni su come abilitare la modalità sviluppatore, vedi Abilita il tuo dispositivo per lo sviluppo.For information about how to enable developer mode, see Enable your device for development.

Importante

A volte, a causa di problemi di rete o di compatibilità, la modalità sviluppatore non viene installata correttamente nel dispositivo.Sometimes, due to network or compatibility issues, developer mode won't install correctly on your device. Vedi la relativa sezione di Abilitare il dispositivo per lo sviluppo per indicazioni sulla risoluzione di questi problemi.See the relevant section of Enable your device for development for help troubleshooting these issues.

Abilitare Portale di dispositiviTurn on Device Portal

Puoi abilitare Portale di dispositivi nella sezione Per sviluppatori di Impostazioni.You can enable Device Portal in the For developers section of Settings. Quando abiliti Portale di dispositivi, devi anche creare un nome utente e una password appositi.When you enable it, you must also create a corresponding username and password. Non usare l'account Microsoft o altre credenziali di Windows.Do not use your Microsoft account or other Windows credentials.

Sezione relativa a Portale di dispositivi dell'app Impostazioni

Una volta abilitato Portale di dispositivi, vedrai alcuni collegamenti Web in fondo alla sezione.Once Device Portal is enabled, you will see web links at the bottom of the section. Prendi nota del numero di porta alla fine degli URL elencati: questo numero viene generato in modo casuale quando Portale di dispositivi è abilitato, ma deve rimanere coerente tra un riavvio e l'altro del desktop.Take note of the port number appended to the end of the listed URLs: this number is randomly generated when Device Portal is enabled but should remain consistent between reboots of the desktop.

Questi link ti permettono di connetterti a Portale di dispositivi in due modi: tramite rete locale (inclusa una VPN) o tramite host locale.These links offer two ways to connect to Device Portal: over the local network (including VPN) or through the local host. Dopo la connessione, dovrebbe comparire una finestra simile alla seguente:Once you connect, it should look something like this:

Portale di dispositivi

Disattivare il portale di dispositiviTurn off Device Portal

È possibile disabilitare il portale di dispositivi nella sezione Per sviluppatori di Impostazioni.You can disable Device Portal in the For developers section of Settings.

Connessione a Portale di dispositiviConnect to Device Portal

Per connettersi tramite l'host locale, aprire una finestra del browser e immettere l'indirizzo indicato qui per il tipo di connessione usato.To connect through local host, open a browser window and enter the address shown here for the connection type you're using.

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

È richiesto HTTPS per l'autenticazione e la comunicazione sicura.HTTPS is required for authentication and secure communication.

Se si usa il portale di dispositivi 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.If you are using Device Portal in a protected environment, for example, in a test lab, in which you trust everyone on your local network, have no personal information on the device, and have unique requirements, you can disable the Authentication option. Questo rende possibile comunicazioni non crittografate e consente a chiunque abbia l'indirizzo IP del computer di connettersi a esso e controllarlo.This enables unencrypted communication, and allows anyone with the IP address of your computer to connect to and control it.

Contenuto di Portale di dispositivi in Windows DesktopDevice Portal content on Windows Desktop

Nel portale di dispositivi in Windows Desktop viene visualizzata la serie di pagine descritta in Panoramica del portale di dispositivi di Windows.Device Portal on Windows Desktop will display the set of pages described in Windows Device Portal overview.

  • Apps manager (Gestione app)Apps manager
  • Xbox LiveXbox Live
  • Esplora fileFile explorer
  • Processi in esecuzioneRunning Processes
  • PrestazioniPerformance
  • DebugDebug
  • Registrazione ETW (Event Tracing for Windows)ETW (Event Tracing for Windows) logging
  • Traccia prestazioniPerformance tracing
  • Gestione dispositiviDevice manager
  • BluetoothBluetooth
  • ReteNetworking
  • Dati sugli arresti anomaliCrash data
  • FunzionalitàFeatures
  • Realtà mistaMixed Reality
  • Streaming Install DebuggerStreaming Install Debugger
  • PosizioneLocation
  • ScratchScratch

Uso del portale di dispositivi per Windows Desktop per il test e il debug delle app MSIXUsing Device Portal for Windows Desktop to test and debug MSIX apps

Altre opzioni di Portale di dispositiviMore Device Portal options

Configurazione basata sul Registro di sistema per Portale di dispositiviRegistry-based configuration for Device Portal

Se vuoi selezionare i numeri di porta per Device Portal (ad esempio 80 e 443), puoi impostare le chiavi del Registro di sistema seguenti:If you would like to select port numbers for Device Portal (such as 80 and 443), you can set the following regkeys:

  • In HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\WebManagement\ServiceUnder HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\WebManagement\Service
    • UseDynamicPorts: valore DWORD obbligatorio.UseDynamicPorts: A required DWORD. Imposta questo valore su 0 per mantenere i numeri di porta che hai scelto.Set this to 0 in order to retain the port numbers you've chosen.
    • HttpPort: valore DWORD obbligatorio.HttpPort: A required DWORD. Contiene il numero di porta in cui Device Portal rimarrà in ascolto delle connessioni HTTP.Contains the port number that Device Portal will listen for HTTP connections on.
    • HttpsPort: valore DWORD obbligatorio.HttpsPort: A required DWORD. Contiene il numero di porta in cui Device Portal rimarrà in ascolto delle connessioni HTTPS.Contains the port number that Device Portal will listen for HTTPS connections on.

Nello stesso percorso delle chiavi del Registro di sistema puoi anche disabilitare il requisito dell'autenticazione:Under the same regkey path, you can also turn off the authentication requirement:

  • UseDefaultAuthorizer - 0 per disabilitarlo, 1 per abilitarlo.UseDefaultAuthorizer - 0 for disabled, 1 for enabled.
    • Questa chiave controlla anche il requisito dell'autenticazione di base per ogni connessione e il reindirizzamento da HTTP a HTTPS.This controls both the basic auth requirement for each connection and the redirect from HTTP to HTTPS.

Opzioni della riga di comando per Portale di dispositiviCommand line options for Device Portal

Da un prompt dei comandi amministrativo, puoi abilitare e configurare componenti di Portale di dispositivi.From an administrative command prompt, you can enable and configure parts of Device Portal. Per visualizzare il set di comandi più recente supportato nella tua build, puoi eseguire webmanagement /?To see the latest set of commands supported on your build, you can run webmanagement /?

  • sc start webmanagement o sc stop webmanagementsc start webmanagement or sc stop webmanagement
    • Abilita o disabilita il servizio.Turn the service on or off. Richiede comunque che sia abilitata la modalità sviluppatore.This still requires developer mode to be enabled.
  • -Credentials <username> <password>
    • Imposta un nome utente e una password per Portale di dispositivi.Set a username and password for Device Portal. 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.The username must conform to Basic Auth standards, so cannot contain a colon (:) and should be built out of standard ASCII characters for example, [a-zA-Z0-9] as browsers do not parse the full character set in a standard way.
  • -DeleteSSL
    • Reimposta la cache dei certificati SSL usata per le connessioni HTTPS.This resets the SSL certificate cache used for HTTPS connections. 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.If you encounter TLS connection errors that cannot be bypassed (as opposed to the expected certificate warning), this option may fix the problem for you.
  • -SetCert <pfxPath> <pfxPassword>
  • -Debug <various options for authentication, port selection, and tracing level>
    • Esegue una versione autonoma di Portale di dispositivi con una configurazione specifica e messaggi di debug visibili.Run a standalone version of Device Portal with a specific configuration and visible debug messages. È particolarmente utile per la creazione di un plug-in del pacchetto.This is most useful for building a packaged plugin.
    • 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.See the MSDN Magazine article for details on how to run this as System to fully test your packaged plugin.

Risoluzione dei problemiTroubleshooting

Di seguito sono riportati alcuni errori comuni che possono verificarsi durante la configurazione di Portale di dispositivi.Below are some common errors that you may encounter when setting up Device Portal.

WindowsUpdateSearch restituisce un numero di aggiornamenti non valido (0x800f0950 CBS_E_INVALID_WINDOWS_UPDATE_COUNT)WindowsUpdateSearch returns invalid number of updates (0x800f0950 CBS_E_INVALID_WINDOWS_UPDATE_COUNT)

Potresti visualizzare questo errore quando tenti di installare i pacchetti sviluppatore su una build non definitiva di Windows 10.You may get this error when trying to install the developer packages on a pre-release build of Windows 10. 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.These Feature-on-Demand (FoD) packages are hosted on Windows Update, and downloading them on pre-release builds requires that you opt into flighting. Se tale operazione non viene eseguita per l'installazione per la combinazione di build e anello corretta, il payload non sarà scaricabile.If your installation is not opted into flighting for the right build and ring combination, the payload will not be downloadable. Verifica quanto segue:Double-check the following:

  1. Passa a Impostazioni > Aggiornamento e sicurezza > Programma Windows Insider e verifica che la sezione Account Windows Insider riporti le informazioni corrette sull'account.Navigate to Settings > Update & Security > Windows Insider Program and confirm that the Windows Insider account section has your correct account info. 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).If you don't see that section, select Link a Windows Insider account, add your email account, and confirm that it shows up under the Windows Insider account heading (you may need to select Link a Windows Insider account a second time to actually link a newly added account).

  2. In Che tipo di contenuto ti piacerebbe ricevere? verifica che sia selezionata l'opzione Sviluppo attivo di Windows.Under What kind of content would you like to receive?, make sure Active development of Windows is selected.

  3. In Con che frequenza vuoi ricevere le nuove build? verifica che sia selezionata l'opzione Windows Insider veloce.Under What pace do you want to get new builds?, make sure Windows Insider Fast is selected.

  4. A questo punto dovrebbe essere possibile installare i FoD.You should now be able to install the FoDs. 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.If you've confirmed that you're on Windows Insider Fast and still cannot install the FoDs, please provide feedback and attach the log files under C:\Windows\Logs\CBS.

[SC] StartService: OpenService FAILED 1060: il servizio specificato non esiste come servizio installato[SC] StartService: OpenService FAILED 1060: The specified service does not exist as an installed service

Potresti visualizzare questo errore se i pacchetti dello sviluppatore non sono installati.You may get this error if the developer packages aren't installed. Senza i pacchetti sviluppatore non è disponibile alcun servizio di gestione Web.Without the developer packages, there is no web management service. Prova a installare di nuovo i pacchetti sviluppatore.Try installing the developer packages again.

CBS non può avviare il download perché il sistema è in rete a consumo (CBS_E_METERED_NETWORK)CBS cannot start download because the system is on metered network (CBS_E_METERED_NETWORK)

Questo errore può verificarsi se si usa una connessione Internet a consumo.You may get this error if you're on a metered internet connection. Non sarà possibile scaricare i pacchetti sviluppatore in una connessione a consumo.You won't be able to download the developer packages on a metered connection.

Vedere ancheSee also