Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Windows Device Portal (WDP) är en webbserver som ingår i Windows enheter som gör att du kan konfigurera och hantera inställningarna för enheten via ett nätverk eller USB-anslutning (lokala anslutningar stöds också på enheter med en webbläsare).
WDP innehåller även avancerade diagnostikverktyg för felsökning och visning av realtidsprestanda för din Windows enhet.
WDP-funktioner exponeras programmässigt via en samling REST-API:er.
Den här artikeln innehåller en allmän beskrivning av Windows-enhetsportalen och innehåller länkar till artiklar med mer specifik information om varje Windows enhetsfamilj.
Note
En enhetsfamilj identifierar DE API:er, systemegenskaper och beteenden som du kan förvänta dig i en klass med enheter.
Varning
Enhetsportalen är inaktiverad som standard. Du måste aktivera utvecklarläge och sedan uttryckligen aktivera enhetsportalen i Inställningar > System > Avancerat innan du använder det.
Inställningar
Varje enhetsfamilj har en version av WDP, men funktionerna och konfigurationen varierar beroende på kraven för en enhet.
Det här är de grundläggande stegen för alla enheter.
Aktivera utvecklarläge. Anvisningar finns i Inställningar för utvecklare .
Aktivera enhetsportalen på din enhet (Inställningar > System > Avancerat).
Anslut enheten och datorn via ett lokalt nätverk eller med USB.
Gå till sidan Enhetsportal i webbläsaren. Den här tabellen visar portar och protokoll som används av varje enhetsfamilj.
Följande tabell innehåller enhetsspecifik information för WDP.
| Enhetsfamilj | Påslagen som standard? | HTTP | HTTPS | USB | Instruktioner |
|---|---|---|---|---|---|
| Desktop och IoT Enterprise | Aktivera i utvecklingsläge | 50080* | 50043* | N/A | Enhetsportal för skrivbords- eller IoT Enterprise-enhet |
* Detta är inte alltid fallet, eftersom Enhetsportalen på datorn reserverar portar i det efemära portintervallet (>50 000) för att förhindra kollisioner med befintliga portreservationer på enheten. Mer information finns i avsnittet Registerbaserad konfiguration i Windows Device Portal for Desktop.
Features
Verktygsfält och navigering
Verktygsfältet överst på sidan ger åtkomst till vanliga funktioner.
-
Ström: Åtkomst till energialternativ.
- Avstängning: Stänger av enheten.
- Starta om: Växlar ström på enheten.
- Hjälp: Öppnar hjälpsidan.
Använd länkarna i navigeringsfönstret till vänster på sidan för att navigera till de tillgängliga hanterings- och övervakningsverktygen för enheten.
Verktyg som är vanliga i enhetsfamiljer beskrivs här. Andra alternativ kan vara tillgängliga beroende på enheten. Mer information finns på den specifika sidan för din enhetstyp.
Apphanteraren
Apphanteraren tillhandahåller funktioner för installation, avinstallation och hantering av apppaket och bundlar på värdenheten.
- Distribuera appar: Distribuera paketerade appar från lokala värdar, nätverk eller webbvärdar och registrera lösa filer från nätverksresurser.
- Installerade appar: Använd den nedrullningsbara menyn för att ta bort eller starta appar som är installerade på enheten.
- Appar som körs: Hämta information om de appar som för närvarande körs och stäng dem efter behov.
Installera (sideladda) en app
Du kan sidladda appar under utveckling med hjälp av Windows Device Portal:
När du har skapat ett apppaket kan du fjärrinstallera det på enheten. När du har byggt den i Visual Studio genereras en utmatningsmapp.
I Windows enhetsportalen går du till sidan Apphanteraren.
I avsnittet Distribuera appar väljer du Lokal lagring.
Under Välj apppaketet väljer du Välj fil och bläddrar till det apppaket som du vill installera manuellt.
Under Välj certifikatfil (.cer) som används för att signera apppaketet väljer du Välj fil och bläddrar till certifikatet som är associerat med det apppaketet.
Markera respektive rutor om du vill installera valfria paket eller ramverkspaket tillsammans med appinstallationen och välj Nästa för att välja dem.
Välj Installera för att starta installationen.
Om enheten körs Windows 10 i S-läge och det är första gången som det angivna certifikatet har installerats på enheten startar du om enheten.
Installera ett certifikat
Du kan också installera certifikatet via Windows Enhetsportal och installera appen på annat sätt:
I Windows enhetsportalen går du till sidan Apphanteraren.
I avsnittet Distribuera appar väljer du Installera certifikat.
Under Välj certifikatfil (.cer) som används för att signera ett apppaket väljer du Välj fil och bläddrar till certifikatet som är associerat med det apppaket som du vill läsa in separat.
Välj Installera för att starta installationen.
Om enheten körs Windows 10 i S-läge och det är första gången som det angivna certifikatet har installerats på enheten startar du om enheten.
Avinstallera en app
- Kontrollera att appen inte körs.
- I så fall går du till Kör appar och stänger det. Om du försöker avinstallera medan appen körs orsakar det problem när du försöker installera om appen.
- Välj appen i listrutan och klicka på Ta bort.
Processer som körs
Den här sidan visar information om processer som för närvarande körs på värdenheten. Detta omfattar både appar och systemprocesser. Du kan avsluta både app- och systemprocesser från den här sidan.
Filutforskaren
På den här sidan kan du visa och ändra filer som lagras av alla separat inlästa appar. Se appens lokala lagring via sidan Utforskaren för att visa och hantera dina appdata.
Performance
På sidan Prestanda visas realtidsdiagram över systemdiagnostikinformation som energianvändning, bildfrekvens och CPU-belastning.
Det här är de tillgängliga måtten:
- CPU: Procent av den totala tillgängliga CPU-användningen
- Minne: Totalt, i användning, tillgängligt, bekräftat, sidbaserat och icke-sidiga
- I/O: Läs- och skrivdatakvantiteter
- Nätverk: Mottagna och skickade data
- GPU: Procent av den totala tillgängliga GPU-motoranvändningen
Händelsespårning för loggning av Windows (ETW)
Loggningssidan för ETW hanterar information i realtid för Event Tracing for Windows (ETW) på enheten.
Markera Dölj leverantörer så att endast händelselistan visas.
Registrerade leverantörer: Välj händelseprovidern och spårningsnivån. Spårningsnivån är ett av följande värden:
- Onormal avslutning eller terminering
- Allvarliga fel
- Warnings
- Icke-felrelaterade varningar
- Detaljerad spårning
Klicka eller tryck på Aktivera för att börja spåra. Providern läggs till i listrutan Aktiverade providers .
Anpassade leverantörer: Välj en anpassad ETW-provider och spårningsnivån. Identifiera providern med dess GUID. Ta inte med hakparenteser i GUID.
Aktiverade leverantörer: Här visas de aktiverade leverantörerna. Välj en provider i listrutan och klicka eller tryck på Inaktivera för att stoppa spårningen. Klicka eller tryck på Stoppa alla om du vill pausa all spårning.
Leverantörshistorik: Detta visar de ETW-providers som aktiverades under den aktuella sessionen. Klicka eller tryck på Aktivera för att aktivera en provider som har inaktiverats. Klicka eller tryck på Rensa för att rensa historiken.
Filter/händelser: I avsnittet Händelser visas ETW-händelser från de valda leverantörerna i tabellformat. Tabellen uppdateras i realtid. Använd menyn Filter för att konfigurera anpassade filter för vilka händelser som ska visas. Klicka på knappen Rensa för att ta bort alla ETW-händelser från tabellen. Detta inaktiverar inte några leverantörer. Du kan klicka på Spara till fil för att exportera de insamlade ETW-händelserna till en lokal CSV-fil.
Prestandaspårning
Windows Performance Toolkit innehåller sidan Prestandaspårning, där du kan visa Windows WPR-spårningar (Performance Recorder) från värdenheten.
- Tillgängliga profiler: Välj WPR-profilen i listrutan och klicka eller tryck på Starta för att börja spåra.
- Anpassade profiler: Klicka eller tryck på Bläddra för att välja en WPR-profil från datorn. Klicka eller tryck på Ladda upp och börja spåra.
Om du vill stoppa spårningen klickar du på Stoppa. Stanna kvar på den här sidan tills spårningsfilen (. ETL) har laddats ned.
Fångade. ETL-filer kan öppnas för analys i Windows Analyzátor výkonu.
Enhetshanteraren
Sidan Enhetshanterare räknar upp all kringutrustning som är ansluten till enheten. Du kan klicka på inställningsikonerna för att visa egenskaperna för var och en.
Nätverkande
Sidan Nätverk hanterar nätverksanslutningar på enheten. Om du inte är ansluten till enhetsportalen via USB kommer du troligen att kopplas från enhetsportalen om du ändrar de här inställningarna.
- Tillgängliga nätverk: Visar wi-fi-nätverken som är tillgängliga för enheten. Genom att klicka eller trycka på ett nätverk kan du ansluta till det och ange en nyckel om det behövs. Enhetsportalen har ännu inte stöd för företagsautentisering. Du kan också använda listrutan Profiler för att försöka ansluta till någon av de WiFi-profiler som enheten känner till.
- IP-konfiguration: Visar adressinformation om var och en av värdenhetens nätverksportar.
Tjänstfunktioner och anteckningar
DNS-SD
Enhetsportalen annonserar sin närvaro i det lokala nätverket med hjälp av DNS-SD. Alla instanser av enhetsportalen, oavsett enhetstyp, annonserar under "WDP._wdp._tcp.local". TXT-posterna för tjänstinstansen tillhandahåller följande:
| Key | Type | Beskrivning |
|---|---|---|
| S | int | Säker port för enhetsportalen. Om 0 (noll) lyssnar enhetsportalen inte efter HTTPS-anslutningar. |
| D | string | Typ av enhet. Detta kommer att vara i formatet "Windows.*", till exempel Windows. Skrivbord eller Windows. IoTEnterprise. |
| A | string | Enhetsarkitektur. Detta blir Arm, x86 eller AMD64. |
| T | stränglista avgränsad med nulltecken | Taggar som användaren har lagt till för enheten. Se REST API för taggar för hur du använder detta. Listan är dubbelnollterminerad. |
Det rekommenderas att ansluta via HTTPS-porten, eftersom inte alla enheter lyssnar på den HTTP-port som anges i DNS-SD-posten.
CSRF-skydd och skript
För att skydda mot CSRF-attacker krävs en unik token för alla icke-GET-begäranden. Den här tokenen, begärandehuvudet X-CSRF-Token, härleds från en sessionscookie, CSRF-Token. I webbgränssnittet för enhetsportalen kopieras den CSRF-Token cookien till X-CSRF-Token-huvudet på varje begäran.
Important
Det här skyddet förhindrar användning av REST-API:er från en fristående klient (till exempel kommandoradsverktyg). Detta kan lösas på tre sätt:
- Använd ett "auto-"-användarnamn. Klienter som lägger till "auto-" före sitt användarnamn kommer att kringgå CSRF-skyddet. Det är viktigt att det här användarnamnet inte används för att logga in på enhetsportalen via webbläsaren, eftersom det öppnar tjänsten för CSRF-attacker. Exempel: Om enhetsportalens användarnamn är "admin"
curl -u auto-admin:password <args>ska användas för att kringgå CSRF-skydd. - Implementera schemat cookie-to-header i klienten. Detta kräver att en GET-begäran görs för att etablera sessionscookien och att både headern och cookien sedan inkluderas i alla efterföljande begäranden.
- Inaktivera autentisering och använd HTTP. CSRF-skydd gäller endast HTTPS-slutpunkter, så anslutningar på HTTP-slutpunkter behöver inte göra något av ovanstående.
Skydd mot WebSocket-kapning mellan webbplatser
För att skydda mot CSWSH-attacker måste alla klienter som öppnar en WebSocket-anslutning till enhetsportalen också ange en Origin-rubrik som matchar värdrubriken. Detta bevisar för enhetsportalen att begäran kommer antingen från enhetsportalens användargränssnitt eller ett giltigt klientprogram. Utan ursprungsrubriken avvisas din begäran.
Se även
Windows developer