Installera appar med verktyget WinAppDeployCmd.exe

Windows Application Deployment (WinAppDeployCmd.exe) är ett kommandoradsverktyg som kan använda för att distribuera en UWP-app (Universal Windows Platform) från en Windows 10-dator till valfri Windows 10-enhet. Du kan använda det här verktyget för att distribuera ett apppaket när Windows 10-enheten är ansluten via USB eller är tillgänglig i samma undernät utan att behöva Microsoft Visual Studio eller lösningen för den appen. Du kan också distribuera appen utan att först paketera den till en fjärrdator eller Xbox One. I den här artikeln beskrivs hur du installerar UWP-appar med det här verktyget.

Du behöver bara Windows 10 SDK installerat för att köra WinAppDeployCmd-verktyget från en kommandotolk eller en skriptfil. När du installerar en app med WinAppDeployCmd.exeanvänds filen .appx/.msix eller AppxManifest (för lösa filer) för att separat läsa in appen på en Windows 10-enhet. Det här kommandot installerar inte det certifikat som krävs för din app. Om du vill köra appen måste Windows 10-enheten vara i utvecklarläge eller redan ha certifikatet installerat.

Om du vill distribuera till mobila enheter måste du först skapa ett paket. Mer information finns här.

Verktyget WinAppDeployCmd.exe finns här på din Windows 10 PC: C:\Program Files (x86)\Windows Kits\10\bin\<SDK Version>\x86\WinAppDeployCmd.exe (baserat på din installationssökväg för SDK).

Anslut först din Windows 10-enhet till samma undernät eller anslut den direkt till din Windows 10-dator med en USB-anslutning. Använd sedan följande syntax och exempel på det här kommandot senare i den här artikeln för att distribuera UWP-appen:

WinAppDeployCmd-syntax och alternativ

Det här är den allmänna syntax som används för WinAppDeployCmd.exe:

WinAppDeployCmd command -option <argument>

Här följer några ytterligare syntaxexempel för att använda olika kommandon:

WinAppDeployCmd devices
WinAppDeployCmd devices <x>
WinAppDeployCmd install -file <path> -ip <address>
WinAppDeployCmd install -file <path> -guid <address> -pin <p>
WinAppDeployCmd install -file <path> -ip <address> -dependency <a> <b> 
WinAppDeployCmd install -file <path> -guid <address> -dependency <a> <b>
WinAppDeployCmd uninstall -file <path>
WinAppDeployCmd uninstall -package <name>
WinAppDeployCmd update -file <path>
WinAppDeployCmd list -ip <address>
WinAppDeployCmd list -guid <address>
WinAppDeployCmd deployfiles -file <path> -remotedeploydir <remoterelativepath> -ip <address>
WinAppDeployCmd registerfiles -remotedeploydir <remoterelativepath> -ip <address>
WinAppDeployCmd addcreds -credserver <server> -credusername <username> -credpassword <password> -ip <address>
WinAppDeployCmd getcreds -credserver <server> -ip <address>
WinAppDeployCmd deletecreds -credserver <server> -ip <address>

Du kan installera eller avinstallera en app på målenheten eller uppdatera en app som redan är installerad. Om du vill behålla data eller inställningar som sparats av en app som redan är installerad använder du uppdateringsalternativen i stället för installationsalternativen .

I följande tabell beskrivs kommandona för WinAppDeployCmd.exe.

I följande tabell beskrivs alternativen för WinAppDeployCmd.exe.

I följande tabell beskrivs alternativen för WinAppDeployCmd.exe.

WinAppDeployCmd.exe exempel

Här följer några exempel på hur du distribuerar från kommandoraden med hjälp av syntaxen för WinAppDeployCmd.exe.

Visar de enheter som är tillgängliga för distribution. Kommandot tidsbegränsas till 3 sekunder.

WinAppDeployCmd devices 3

Installerar appen från MyApp.appx paket som finns i datorns katalog För nedladdningar till en Windows 10-enhet med en IP-adress på 192.168.0.1 med en PIN-kod på A1B2C3 för att upprätta en anslutning till enheten

WinAppDeployCmd install -file "Downloads\MyApp.appx" -ip 192.168.0.1 -pin A1B2C3

Avinstallerar det angivna paketet (baserat på dess fullständiga namn) från en Windows-enhet med ip-adressen 192.168.0.1. Du kan använda listkommandot för att se de fullständiga namnen på alla paket som är installerade på en enhet.

WinAppDeployCmd uninstall -package Company.MyApp_1.0.0.1_x64__qwertyuiop -ip 192.168.0.1

Uppdaterar appen som redan är installerad på Windows 10-enheten med en IP-adress på 192.168.0.1 med det angivna apppaketet.

WinAppDeployCmd update -file "Downloads\MyApp.appx" -ip 192.168.0.1

Distribuerar filer i en app till en dator eller Xbox med en IP-adress på 192.168.0.1 i samma mapp som AppxManifest till app1_F5-katalogen under enhetens distributionssökväg.

WinAppDeployCmd deployfiles -file "C:\apps\App1\AppxManifest.xml" -remotedeploydir app1_F5 -ip 192.168.0.1

Registrerar appen i katalogen app1_F5 under distributionssökvägen för datorn eller Xbox på 192.168.0.1.

WinAppDeployCmd registerfiles -remotedeploydir app1_F5 -ip 192.168.0.1

Använda WinAppDeployCmd för att konfigurera Kör från PC-distribution på Xbox One

Kör från dator gör att du kan installera ett UWP-program på en Xbox One utan att kopiera binärfilerna, istället finns binärerna på en nätverksdelning inom samma nätverk som Xbox. För att göra detta behöver du en utvecklar-olåst Xbox One och en lös UWP-filapplikation på en nätverksdisk som Xbox kan komma åt.

Kör detta för att registrera appen:

WinAppDeployCmd registerfiles -ip <Xbox One IP> -remotedeploydir <location of app> -username <user for network> -password <password for user>

ex. WinAppDeployCmd register files -ip 192.168.0.1 -remotedeploydir \\driveA\myAppLocation -username admin -password A1B2C3