Installare app con lo strumento WinAppDeployCmd.exe

Distribuzione di applicazioni Windows (WinAppDeployCmd.exe) è uno strumento da riga di comando che può usare per distribuire un'app UWP (Universal Windows Platform) da un PC Windows 10 a qualsiasi dispositivo Windows 10. È possibile usare questo strumento per distribuire un pacchetto di app quando il dispositivo Windows 10 è connesso tramite USB o disponibile nella stessa subnet senza che sia necessario Microsoft Visual Studio o la soluzione per tale app. Puoi anche distribuire l'app senza prima creare pacchetti su un PC remoto o su Xbox One. Questo articolo descrive come installare le app UWP usando questo strumento.

È sufficiente che Windows 10 SDK sia installato per eseguire lo strumento WinAppDeployCmd da un prompt dei comandi o da un file di script. Quando installi un'app con WinAppDeployCmd.exe, il processo utilizza il file .appx/.msix o AppxManifest (per i file non compressi) per caricare lateralmente l'app su un dispositivo Windows 10. Questo comando non installa il certificato necessario per l'app. Per eseguire l'app, il dispositivo Windows 10 deve essere in modalità sviluppatore o avere già installato il certificato.

Per eseguire la distribuzione nei dispositivi mobili, è prima necessario creare un pacchetto. Per ulteriori informazioni, vedi qui.

Lo strumento WinAppDeployCmd.exe si trova qui nel PC Windows 10: C:\Programmi (x86)\Windows Kits\10\bin\<VERSIONE SDK>\x86\WinAppDeployCmd.exe (in base al percorso di installazione per l'SDK).

Annotazioni

Nella versione 15063 e successive dell'SDK, l'SDK viene installato affiancato all'interno di cartelle specifiche della versione. Gli SDK precedenti (fino alla versione 14393 inclusa) vengono scritti direttamente nella cartella principale.

Prima di tutto, connettere il dispositivo Windows 10 alla stessa subnet o connetterlo direttamente al computer Windows 10 con una connessione USB. Usa la seguente sintassi e gli esempi di questo comando, che troverai più avanti in questo articolo, per distribuire la tua app UWP.

Sintassi e opzioni di WinAppDeployCmd

Questa è la sintassi generale usata per WinAppDeployCmd.exe:

WinAppDeployCmd command -option <argument>

Ecco alcuni esempi di sintassi aggiuntivi per l'uso di vari comandi:

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>

È possibile installare o disinstallare un'app nel dispositivo di destinazione oppure aggiornare un'app già installata. Per mantenere i dati o le impostazioni salvate da un'app già installata, usare le opzioni di aggiornamento anziché le opzioni di installazione .

Nella tabella seguente vengono descritti i comandi per WinAppDeployCmd.exe.

Comando	Descrizione
dispositivi	Visualizzare l'elenco dei dispositivi di rete disponibili.
installare	Installare un pacchetto di app UWP nel dispositivo di destinazione.
aggiornare	Aggiornare un'app UWP già installata nel dispositivo di destinazione.
lista	Mostra l'elenco delle app UWP installate nel dispositivo di destinazione specificato.
disinstallare	Disinstallare il pacchetto dell'app specificato dal dispositivo di destinazione.
file di distribuzione	Copiare l'applicazione di file separati del percorso di destinazione verso il percorso relativo remoto nel dispositivo.
file di registri	Registra l'app "loose file" nella directory di distribuzione remota.
aggiungi credenziali	Aggiungere le credenziali a un'Xbox per consentirgli l'accesso a un percorso di rete per la registrazione dell'app.
getcreds	Ottenere le credenziali di rete per i target previsti durante l'esecuzione di un'applicazione da una condivisione di rete.
deletecreds (eliminare credenziali)	Eliminare le credenziali di rete usate dall'obiettivo durante l'esecuzione di un'applicazione da una condivisione di rete.

Nella tabella seguente vengono descritte le opzioni per WinAppDeployCmd.exe.

Comando	Descrizione
-h (-help)	Mostra i comandi, le opzioni e gli argomenti.
-Ip	Indirizzo IP del dispositivo di destinazione.
-g (-guid)	Identificatore univoco del dispositivo di destinazione.
-d (-dependency)	(Facoltativo) Specifica il percorso di dipendenza per ognuna delle dipendenze del pacchetto. Se non viene specificato alcun percorso, lo strumento cerca le dipendenze nella directory radice per il pacchetto dell'app e le directory SDK.
-f (-file)	Percorso del file del pacchetto dell'app da installare, aggiornare o disinstallare.
-p (-package)	Nome completo del pacchetto dell'app da disinstallare. È possibile usare il comando list per trovare i nomi completi dei pacchetti già installati nel dispositivo.
-spilla	Un pin se è necessario per stabilire una connessione con il dispositivo di destinazione. Verrà richiesto di riprovare con l'opzione -pin se è richiesta l'autenticazione.
-credserver	Nome del server delle credenziali di rete utilizzate dalla destinazione.
-credusername	Nome utente delle credenziali di rete da utilizzare per il target.
-credpassword	Password delle credenziali di rete da utilizzare per il target.
-connecttimeout	Timeout in secondi usato per la connessione al dispositivo.
-remotedeploydir	Percorso/nome della directory relativa in cui copiare i file nel dispositivo remoto; Si tratta di una cartella di distribuzione remota nota e determinata automaticamente.
-deleteextrafile	Passare per indicare se i file esistenti nella directory remota devono essere eliminati in modo che corrispondano alla directory di origine.

Nella tabella seguente vengono descritte le opzioni per WinAppDeployCmd.exe.

Argomento	Descrizione
<x>	Timeout (in secondi) (Il valore predefinito è 10)
<indirizzo>	Indirizzo IP o identificatore univoco del dispositivo di destinazione.
< >< > ...	Percorso di dipendenza per ognuna delle dipendenze del pacchetto dell'app.
<p>	Un PIN alfanumerico visualizzato nelle impostazioni del dispositivo per stabilire una connessione.
<percorso>	Percorso del file system.
< > nome	Nome completo del pacchetto dell'app da disinstallare.
<server>	Server nella rete di file.
<nome utente>	Utente con credenziali con accesso al server sulla rete di file.
<parola d’ordine>	Password per le credenziali con accesso al server nella rete di file.
<remotedeploydir>	Directory nel dispositivo relativa alla posizione di distribuzione

WinAppDeployCmd.exe esempi

Ecco alcuni esempi di come eseguire la distribuzione dalla riga di comando usando la sintassi per WinAppDeployCmd.exe.

Mostra i dispositivi disponibili per la distribuzione. Il comando va in timeout in 3 secondi.

WinAppDeployCmd devices 3

Installa l'app dal pacchetto MyApp.appx che si trova nella directory Download del PC su un dispositivo Windows 10 con l'indirizzo IP 192.168.0.1 e il PIN A1B2C3 per stabilire una connessione.

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

Disinstalla il pacchetto specificato (in base al nome completo) da un dispositivo Windows con un indirizzo IP 192.168.0.1. È possibile usare il comando list per visualizzare i nomi completi di tutti i pacchetti installati in un dispositivo.

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

Aggiorna l'app già installata nel dispositivo Windows 10 con un indirizzo IP 192.168.0.1 usando il pacchetto dell'app specificato.

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

Distribuisce i file di un'app su un PC o Xbox con un indirizzo IP 192.168.0.1 nella stessa cartella dell'AppxManifest nella sottodirectory app1_F5 all'interno del percorso di distribuzione del dispositivo.

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

Registra l'app nella directory app1_F5 sotto il percorso di distribuzione del PC o Xbox all'indirizzo 192.168.0.1.

WinAppDeployCmd registerfiles -remotedeploydir app1_F5 -ip 192.168.0.1

Uso di WinAppDeployCmd per configurare la distribuzione di Run from PC in Xbox One

L'esecuzione dal PC consente di distribuire un'applicazione UWP in una Xbox One senza copiare i file binari, ma i file binari sono ospitati in una condivisione di rete nella stessa rete di Xbox. A tale scopo, è necessaria una Xbox One sbloccata per sviluppatori e un'applicazione UWP di file non compressi in un'unità di rete accessibile dalla Xbox One.

Eseguire questa operazione per registrare l'app:

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