Panoramica di Windows Device Portal

Windows Device Portal (WDP) è un server Web incluso nei dispositivi Windows che consente di configurare e gestire le impostazioni per il dispositivo tramite una connessione di rete o USB (le connessioni locali sono supportate anche nei dispositivi con un Web browser).

WDP offre anche strumenti di diagnostica avanzati per la risoluzione dei problemi e la visualizzazione delle prestazioni in tempo reale del dispositivo Windows.

La funzionalità WDP viene esposta a livello di codice tramite una raccolta di API REST .

Questo articolo fornisce una descrizione generale di Windows Device Portal e include collegamenti ad articoli con informazioni più specifiche su ogni famiglia di dispositivi Windows.

Configurazione

Ogni famiglia di dispositivi fornisce una versione del WDP, ma le funzionalità e la configurazione variano in base ai requisiti di un dispositivo.

Questi sono i passaggi di base per tutti i dispositivi.

1. Abilitare la modalità sviluppatore (impostazioni - sistema> -> per sviluppatori).

   

2. Abilitare Device Portal nel dispositivo (Impostazioni - sistema> -> per sviluppatori).

   

3. Connettere il dispositivo e il PC tramite una rete locale o usb.

4. Visita la pagina Portale del dispositivo nel browser. Questa tabella mostra le porte e i protocolli usati da ogni famiglia di dispositivi.

La tabella seguente include i dettagli specifici del dispositivo per il WDP.

* Questo non è sempre il caso, poiché Device Portal su desktop reclama porte nell'intervallo effimero (>50.000) per evitare conflitti con le rivendicazioni di porta esistenti sul dispositivo. Per altre informazioni, vedere la sezione di configurazione basata sul Registro di sistema di in Windows Device Portal per Desktop.

Caratteristiche

Barra degli strumenti e navigazione

La barra degli strumenti nella parte superiore della pagina consente di accedere alle funzionalità di uso comune.

• Power: Accedi alle opzioni di alimentazione.
  • Spegni: spegne il dispositivo.
  • Riavvia: Riavvia l'alimentazione del dispositivo.
• help: apre la pagina di help.

Usare i collegamenti nel riquadro di spostamento a sinistra della pagina per passare agli strumenti di gestione e monitoraggio disponibili per il dispositivo.

Gli strumenti comuni tra le famiglie di dispositivi sono descritti qui. Altre opzioni potrebbero essere disponibili a seconda del dispositivo. Per altre info, vedi la pagina specifica per il tipo di dispositivo.

Gestore di app

Gestione app offre funzionalità di installazione/disinstallazione e gestione per pacchetti e bundle dell'app nel dispositivo host.

• Distribuire app: distribuire app in pacchetto da host locali, di rete o Web e registrare file separati da condivisioni di rete.
• App installate: Utilizzare il menu a discesa per rimuovere o avviare le app installate sul dispositivo.
• App in esecuzione: Ottieni informazioni sulle app attualmente in esecuzione e chiudile in base alle esigenze.

Installare (caricare manualmente) un'app

Potete caricare lateralmente le app durante lo sviluppo utilizzando Windows Device Portal.

1. Dopo aver creato un pacchetto dell'app, è possibile installarlo in remoto nel dispositivo. Dopo averla compilata in Visual Studio, viene generata una cartella di output.

   

2. Nel Portale dispositivi di Windows, navigare alla pagina Gestore delle app .

3. Nella sezione Deploy apps selezionare Local Storage.

4. In selezionare il pacchetto dell'applicazione, poi cliccare su Scegli File e cercare il pacchetto dell'app che si desidera installare.

5. In seleziona il file di certificato (.cer) usato per firmare il pacchetto dell'app, seleziona Scegli file e individua il certificato associato a quel pacchetto dell'app.

6. Selezionare le rispettive caselle se si desidera installare pacchetti facoltativi o framework insieme all'installazione dell'app e selezionare Avanti per sceglierli.

7. Selezionare Installa per avviare l'installazione.

8. Se il dispositivo esegue Windows 10 in modalità S ed è la prima volta che il certificato specificato è stato installato nel dispositivo, riavviare il dispositivo.

Installare un certificato

In alternativa, è possibile installare il certificato tramite Windows Device Portal e installare l'app tramite altri mezzi:

1. Nel Portale dispositivi Windows, passare alla pagina gestione app.

2. Nella sezione Distribuzione delle app, selezionare Installa certificato.

3. In Selezionare il file di certificato (.cer) utilizzato per firmare un pacchetto dell'app, selezionare Scegli file e sfogliare fino al certificato associato al pacchetto dell'app che desideri installare manualmente.

4. Seleziona Installa per avviare l'installazione.

5. Se il dispositivo esegue Windows 10 in modalità S ed è la prima volta che il certificato specificato è stato installato nel dispositivo, riavviare il dispositivo.

Disinstallare un'app

1. Assicurati che l'app non sia in esecuzione.
2. In caso affermativo, passare a Esecuzione di app e chiuderla. Se si tenta di disinstallare mentre l'app è in esecuzione, si verificheranno problemi quando si tenta di reinstallare l'app.
3. Selezionare l'app dall'elenco a discesa e fare clic su Rimuovi.

Processi in esecuzione

Questa pagina mostra i dettagli sui processi attualmente in esecuzione nel dispositivo host. Sono incluse sia le app che i processi di sistema. In alcune piattaforme (Desktop, IoT e HoloLens), è possibile terminare i processi.

Esplora file

Questa pagina consente di visualizzare e gestire i file archiviati da qualsiasi app caricata manualmente. Consulta il post del blog Utilizzo di Esplora file dell'app per ulteriori informazioni su Esplora file e su come usarlo.

Prestazione

La pagina Prestazioni mostra grafici in tempo reale delle informazioni di diagnostica di sistema, ad esempio utilizzo energia, frequenza dei fotogrammi e carico della CPU.

Queste sono le metriche disponibili:

• CPU: percentuale dell'utilizzo totale della CPU disponibile
• memoria: totale, in uso, disponibile, committata, paginata e non paginata
• di I/O: quantità di dati di lettura e scrittura
• Rete: dati ricevuti e inviati
• GPU: percentuale di utilizzo totale della GPU disponibile

Registrazione del tracciamento eventi per Windows (ETW)

La pagina di registrazione ETW gestisce le informazioni ETW (Event Tracing for Windows) in tempo reale sul dispositivo.

Selezionare Nascondi provider per visualizzare solo l'elenco degli Eventi.

• Provider registrati: Selezionare il provider di eventi e il livello di traccia. Il livello di traccia è uno dei valori seguenti:

  1. Uscita o terminazione anomala
  2. Errori gravi
  3. Avvertenze
  4. Avvisi che non sono errori
  5. Traccia dettagliata

  Fare clic o toccare Abilita per avviare il monitoraggio. Il provider viene aggiunto al menu a tendina provider abilitati.

• Provider personalizzati: Selezionare un provider ETW personalizzato e il livello di tracciamento. Identificare il provider in base al suo GUID. Non includere parentesi quadre nel GUID.

• Provider abilitati: vengono elencati i provider abilitati. Selezionare un provider dall'elenco a discesa e fare clic o toccare Disabilita per fermare la tracciatura. Fare clic o toccare Arresta tutte le tracce per sospendere tutte le tracciature.

• Cronologia dei provider: Mostra i provider ETW che sono stati abilitati durante la sessione corrente. Fare clic o toccare Abilita per attivare un provider disabilitato. Fare clic o toccare Cancella per cancellare la cronologia.

• Filtri/Eventi: la sezione eventi elenca gli eventi ETW dei provider selezionati in formato tabella. La tabella viene aggiornata in tempo reale. Utilizzare il menu Filtri per configurare filtri personalizzati per la visualizzazione degli eventi. Fare clic sul pulsante Cancella per eliminare tutti gli eventi ETW dalla tabella. Ciò non disabilita alcun provider. È possibile fare clic Salva nel file per esportare gli eventi ETW attualmente raccolti in un file CSV locale.

Per altre informazioni sull'uso della registrazione ETW, vedere il post di blog Usare Device Portal per visualizzare i log di debug.

Monitoraggio delle prestazioni

Il Windows Performance Toolkit include la pagina di tracciamento delle prestazioni, che permette di visualizzare le tracce Windows Performance Recorder (WPR) dal dispositivo host.

• Profili disponibili: seleziona il profilo WPR dall'elenco a discesa e fai clic o tocca Avvia per iniziare il tracciamento.
• Profili personalizzati: fare clic o toccare Esplora per scegliere un profilo WPR dal PC. Fare clic o toccare Carica e avvia per avviare il tracciamento.

Per arrestare la traccia, fare clic su Arresta. Rimanere su questa pagina finché il file di traccia (.ETL) non ha terminato il download.

I file .ETL catturati possono essere aperti per l'analisi in Windows Performance Analyzer.

Gestione dispositivi

La pagina Gestione dispositivi enumera tutte le periferiche collegate al dispositivo. È possibile fare clic sulle icone delle impostazioni per visualizzare le proprietà di ognuna.

Rete

La pagina Rete gestisce le connessioni di rete nel dispositivo. A meno che non si sia connessi a Portale di dispositivi tramite USB, la modifica di queste impostazioni probabilmente disconnetterà l'utente dal portale di dispositivi.

• Reti disponibili: mostra le reti Wi-Fi disponibili per il dispositivo. Facendo clic o toccando su una rete sarà possibile connettersi a esso e fornire una passkey, se necessario. Device Portal non supporta ancora l'autenticazione aziendale. Puoi anche usare il menu a discesa "Profili" per tentare di connetterti a uno dei profili Wi-Fi noti al dispositivo.
• configurazione IP: mostra le informazioni sull'indirizzo relative a ognuna delle porte di rete del dispositivo host.

Funzionalità e note del servizio

DNS-SD

Device Portal annuncia la sua presenza nella rete locale usando DNS-SD. Tutte le istanze di Device Portal, indipendentemente dal tipo di dispositivo, annunciano mediante "WDP._wdp._tcp.local". I record TXT per l'istanza del servizio forniscono le seguenti informazioni:

La connessione sulla porta HTTPS è consigliata, poiché non tutti i dispositivi sono in ascolto sulla porta HTTP indicata dal record DNS-SD.

Protezione e script CSRF

Per proteggersi da attacchi CSRF , è necessario un token univoco in tutte le richieste non GET. Questo token, l'intestazione della richiesta X-CSRF-Token, è derivata da un cookie di sessione, CSRF-Token. Nell'interfaccia utente Web di Device Portal il cookie CSRF-Token viene copiato nell'intestazione X-CSRF-Token in ogni richiesta.

Protezione Cross-Site WebSocket Hijacking (CSWSH)

Per proteggersi dagli attacchi CSWSH , tutti i client che aprono una connessione WebSocket a Device Portal devono anche fornire un'intestazione Origin che corrisponde all'intestazione Host. Ciò dimostra a Device Portal che la richiesta proviene dall'interfaccia utente di Device Portal o da un'applicazione client valida. Senza l'intestazione Origin la richiesta verrà rifiutata.

Vedere anche

informazioni di riferimento sulle API di base di Device Portal