Översikt över Windows-enhetsportalen
Windows-enhetsportalen (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 EN 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.
Not
En enhetsfamilj identifierar DE API:er, systemegenskaper och beteenden som du kan förvänta dig i en klass med enheter.
Konfiguration
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 (inställningar –> System –> för utvecklare).
Aktivera enhetsportalen på enheten (Inställningar –> System –> För utvecklare).
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.
Not
Windows Mixed Reality körs på vanligt skrivbord, så det är samma portal som Desktop.
| Enhetsfamilj | På som standardinställning? | HTTP | HTTPS | USB | Instruktioner |
|---|---|---|---|---|---|
| Desktop och IoT Enterprise | Aktivera i utvecklingsläge | 50080* | 50043* | Ej tillämpligt | Enhetsportal för skrivbords- eller IoT Enterprise-enhet |
| Xbox | Aktivera i utvecklingsläge | Handikappad | 11443 | Ej tillämpligt | Enhetsportal för Xbox |
| HoloLens | Ja, i utvecklingsläge | 80 (förvalt) | 443 (förvalt) | http://127.0.0.1:10080 |
Enhetsportal för HoloLens |
| IoT Core | Ja, i utvecklingsläge | 8080 | Aktivera via regkey | Ej tillämpligt | Enhetsportal för IoT Core |
* Detta är inte alltid fallet, eftersom Device Portal på datorn tilldelar portar i det flyktiga intervallet (>50,000) för att förhindra kollisioner med redan befintliga portanspråk på enheten. För mer information, se avsnittet konfiguration baserad på registret i Windows Device Portal för Desktop.
Funktioner
Verktygsfält och navigering
Verktygsfältet överst på sidan ger åtkomst till vanliga funktioner.
-
Power: Å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 installations-/avinstallations- och hanteringsfunktionalitet för apppaket och buntar 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 (sidladdning) en app
Du kan läsa in appar manuellt medan du utvecklar med hjälp av Windows-enhetsportalen.
När du har skapat ett apppaket kan du fjärrinstallera det på enheten. Efter att du har byggt den i Visual Studio genereras en utdatamapp.
Gå till sidan Apps Manager i Windows-enhetsportalen.
I avsnittet Distribuera appar väljer du Lokal lagring.
I avsnittet Välj programpaketet, välj Välj fil och bläddra till det apppaket som du vill sido-ladda in.
Under Välj certifikatfil (.cer) som används för att signera apppaketvä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ör 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-enhetsportalen och installera appen på annat sätt:
Gå till sidan Apps Manager i Windows-enhetsportalen.
I avsnittet Distribuera appar väljer du Installera certifikat.
Under Välj certifikatfilen (.cer) som används för att signera ett applikationspaket, väljer du Välj fil och bläddrar till det certifikat som är kopplat till det applikationspaket du vill sidladda.
Välj Installera för att starta installationen.
Om enheten kör 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
- Säkerställ att appen inte körs.
- I så fall går du till Körande appar och stänger den. 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. På vissa plattformar (Desktop, IoT och HoloLens) kan du avsluta processer.
Filutforskaren
På den här sidan kan du visa och hantera filer som lagras av alla sidoladdade appar. Mer information om utforskaren och hur du använder det finns i blogginlägget Använda AppFilutforskaren.
Föreställning
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 processoranvändningen
- Minnes: Totalt, i användning, tillgängligt, bekräftat, sidsatta och icke-sidsatta
- I/O-: Läs- och skrivdatakvantiteter
- Network: Mottagna och skickade data
- GPU-: Procent av den totala tillgängliga GPU-motoranvändningen
Loggning för Event Tracing for Windows (ETW)
ETW-loggningssidan hanterar information om händelsespårning i realtid för Windows (ETW) på enheten.
Kontrollera Dölj leverantörer för att bara visa listan över händelser.
Registrerade leverantörer: Välj händelseleverantören och spårningsnivån. Spårningsnivån är ett av följande värden:
- Onormal avslutning eller upphörande
- Allvarliga fel
- Varningar
- Varningar utan fel
- Detaljerad spårning
Klicka eller tryck på Aktivera för att börja spåra. Providern läggs till i listrutan Aktiverade Leverantörer.
Anpassade leverantörer: Välj en anpassad ETW-leverantör och en spårningsnivå. Identifiera providern med dess GUID. Ta inte med hakparenteser i GUID.
Aktiverade providers: 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 för att avbryta all spårning.
Providers-historik: Detta visar de ETW-providers som aktiverades under den aktuella sessionen. Klicka eller tryck Aktivera för att aktivera en provider som har inaktiverats. Klicka eller tryck Rensa för att rensa historiken.
Filter/Händelser: Avsnittet Händelser visar 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.
Mer information om hur du använder ETW-loggning finns i det blogginlägget "Använda enhetsportalen för att visa felsökningsloggar".
Prestandaspårning
Windows Performance Toolkit innehåller sidan Prestandaspårning, som gör att du kan visa Windows Performance Recorder (WPR) spårningar 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 starta för att 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 Performance Analyzer.
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änsteinstansen ger följande:
| Nyckel | Typ | Beskrivning |
|---|---|---|
| S | Int | Säker port för enhetsportalen. Om 0 (noll) lyssnar enhetsportalen inte efter HTTPS-anslutningar. |
| D | sträng | Typ av enhet. Detta kommer att vara i formatet "Windows.*", till exempel Windows.Xbox eller Windows.Desktop |
| A | sträng | Enhetsarkitektur. Detta blir Arm, x86 eller AMD64. |
| T | nullteckenseparerad lista med strängar | Användartillämpade taggar för enheten. Se REST API för taggar för hur du använder detta. Listan är dubbel-null avslutad. |
Anslutning på HTTPS-porten föreslås eftersom inte alla enheter lyssnar på DEN HTTP-port som annonseras av DNS-SD posten.
CSRF-skydd och skript
För att skydda mot CSRF-attackerkrävs en unik token för alla icke-GET-begäranden. Den här token, X-CSRF-Token begärandehuvudet, 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.
Viktig
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 prefixet "auto-" före sina användarnamn undgår 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" ska
curl -u auto-admin:password <args>användas för att kringgå CSRF-skydd. - Implementera schemat cookie-to-header i klienten. Detta kräver en GET-begäran för att upprätta sessionscookien och sedan inkluderingen av både huvudet och cookien på 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 kapning mellan webbplatser med WebSocket (CSWSH)
För att skydda mot CSWSH-attackermåste alla klienter som öppnar en WebSocket-anslutning till enhetsportalen också ange en Origin-rubrik som matchar värdhuvudet. 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.