Installare app con lo strumento WinAppDeployCmd.exeInstall apps with the WinAppDeployCmd.exe tool

Windows Application Deployment (WinAppDeployCmd.exe) è uno strumento della riga di comando che consente di distribuire un'app UWP (Universal Windows Platform) da un PC Windows 10 a qualsiasi dispositivo Windows 10.Windows Application Deployment (WinAppDeployCmd.exe) is a command line tool that can use to deploy a Universal Windows Platform (UWP) app from a Windows 10 PC to any Windows 10 device. Puoi usare questo strumento per distribuire un pacchetto dell'app quando il dispositivo Windows 10 è connesso tramite USB o disponibile nella stessa subnet senza dover usare Microsoft Visual Studio o la soluzione per tale app.You can use this tool to deploy an app package when the Windows 10 device is connected by USB or available on the same subnet without needing Microsoft Visual Studio or the solution for that app. Puoi anche distribuire l'app in un PC remoto o in Xbox One senza prima creare un pacchetto.You can also deploy the app without packaging first to a remote PC or Xbox One. Questo articolo descrive come installare le app UWP con questo strumento.This article describes how to install UWP apps using this tool.

È sufficiente che sia installato Windows 10 SDK per eseguire lo strumento WinAppDeployCmd da un prompt dei comandi o da un file script.You just need the Windows 10 SDK installed to run the WinAppDeployCmd tool from a command prompt or a script file. Quando installi un'app con WinAppDeployCmd.exe, lo strumento usa il file con estensione appx/msix oppure AppxManifest (per i file indipendenti) per trasferire localmente la tua app in un dispositivo Windows 10.When you install an app with WinAppDeployCmd.exe, this uses the .appx/.msix file or AppxManifest(for loose files) to side-load your app onto a Windows 10 device. Questo comando non installa il certificato necessario per la tua app.This command does not install the certificate required for your app. Per eseguire l'app, il dispositivo Windows 10 deve essere in modalità sviluppatore o il certificato deve essere già installato.To run the app, the Windows 10 device must be in developer mode or already have the certificate installed.

Per la distribuzione nei dispositivi mobili, devi prima creare un pacchetto.To deploy to mobile devices, you must first create a package. Per altre informazioni, vedi qui.For more information, see here.

Lo strumento WinAppDeployCmd.exe è disponibile qui sul PC Windows 10: C:\Programmi (x86)\Windows Kits\10\bin\<versione SDK>\x86\WinAppDeployCmd.exe (in base al percorso di installazione dell'SDK).The WinAppDeployCmd.exe tool is located here on your Windows 10 PC: C:\Program Files (x86)\Windows Kits\10\bin\<SDK Version>\x86\WinAppDeployCmd.exe (based on your installation path for the SDK).

Nota

Nella versione 15063 e versioni successive dell'SDK, questo è installato affiancato in cartelle specifiche della versione.In version 15063 and later of the SDK, the SDK is installed side by side within version-specific folders. Gli SDK precedenti (prima della versione 14393 inclusa) vengono scritti direttamente nella cartella padre.Previous SDKs (prior to and including 14393) are written directly to the parent folder.

Prima di tutto, connetti il dispositivo Windows 10 alla stessa subnet o direttamente al computer Windows 10 con una connessione USB.First, connect your Windows 10 device to the same subnet or connect it directly to your Windows 10 machine with a USB connection. Usa quindi la sintassi seguente e gli esempi di questo comando disponibili più avanti nell'articolo per distribuire l'app UWP:Then use the following syntax and examples of this command later in this article to deploy your UWP app:

Sintassi e opzioni di WinAppDeployCmdWinAppDeployCmd syntax and options

Questa è la sintassi generale usata per WinAppDeployCmd.exe:This is the general syntax used for WinAppDeployCmd.exe:

WinAppDeployCmd command -option <argument>

Ecco alcuni esempi aggiuntivi di sintassi per l'uso di vari comandi:Here are some additional syntax examples for using various commands:

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>

Puoi installare o disinstallare un'app nel dispositivo di destinazione oppure puoi aggiornare un'app già installata.You can install or uninstall an app on the target device, or you can update an app that's already installed. Per mantenere i dati o le impostazioni salvate da un’app già installata, usa le opzioni update invece delle opzioni install.To keep data or settings saved by an app that's already installed, use the update options instead of the install options.

La tabella seguente descrive i comandi per WinAppDeployCmd.exe.The following table describes the commands for WinAppDeployCmd.exe.

ComandoCommand DescrizioneDescription
dispositividevices Visualizza l'elenco dei dispositivi di rete disponibili.Show the list of available network devices.
installinstall Installa un pacchetto di app UWP nel dispositivo di destinazione.Install a UWP app package to the target device.
aggiornamentoupdate Aggiorna un'app UWP già installata nel dispositivo di destinazione.Update a UWP app that is already installed on the target device.
listlist Mostra l'elenco delle app UWP installate nel dispositivo di destinazione specificato.Show the list of UWP apps installed on the specified target device.
uninstalluninstall Disinstalla il pacchetto dell'app specificato dal dispositivo di destinazione.Uninstall the specified app package from the target device.
deployfilesdeployfiles Copia l'app di file indipendenti dal percorso di destinazione al percorso relativo remoto nel dispositivo.Copy over loose file app at the target path to the remote relative path on the device.
registerfilesregisterfiles Registra l'app di file indipendenti nella directory di distribuzione remota.Register the loose file app at the remote deploy directory.
addcredsaddcreds Aggiunge le credenziali a un dispositivo Xbox in modo che possa accedere a un percorso di rete per la registrazione dell'app.Add credentials to an Xbox to allow it to access a network location for app registration.
getcredsgetcreds Ottiene le credenziali di rete che la destinazione usa quando un'applicazione viene eseguita da una condivisione di rete.Get network credentials for the target uses when running an application from a network share.
deletecredsdeletecreds Elimina le credenziali di rete che la destinazione usa quando un'applicazione viene eseguita da una condivisione di rete.Delete network credentials the target uses when running an application from a network share.

La tabella seguente descrive le opzioni per WinAppDeployCmd.exe.The following table describes the options for WinAppDeployCmd.exe.

ComandoCommand DescrizioneDescription
-h (-help)-h (-help) Mostra i comandi, le opzioni e gli argomenti.Show the commands, options and arguments.
-ip-ip Indirizzo IP del dispositivo di destinazione.IP address of the target device.
-g (-guid)-g (-guid) Identificatore univoco del dispositivo di destinazione.Unique identifier of the target device.
-d (-dependency)-d (-dependency) (Facoltativo) Specifica il percorso di dipendenza per ognuna delle dipendenze del pacchetto.(Optional) Specifies the dependency path for each of the package dependencies. Se non viene specificato alcun percorso, lo strumento cerca le dipendenze nella directory radice del pacchetto dell'app e nelle directory dell'SDK.If no path is specified, the tool searches for dependencies in the root directory for the app package and the SDK directories.
-f (-file)-f (-file) Percorso del file per il pacchetto dell'app da installare, aggiornare o disinstallare.File path for the app package to install, update or uninstall.
-p (-package)-p (-package) Nome completo del pacchetto per il pacchetto dell'app da disinstallare.The full package name for the app package to uninstall. (Puoi usare il comando list per trovare i nomi completi per i pacchetti già installati nel dispositivo)(You can use the list command to find the full names for packages already installed on the device)
-pin-pin L'eventuale PIN necessario per stabilire una connessione con il dispositivo di destinazione.A pin if it is required to establish a connection with the target device. (Ti verrà chiesto di riprovare con l'opzione -pin se è necessaria l'autenticazione)(You will be prompted to retry with the -pin option if authentication is required)
-credserver-credserver Nome del server delle credenziali di rete che verranno usate dalla destinazione.The server name of the network credentials for use by the target.
-credusername-credusername Nome utente delle credenziali di rete che verranno usate dalla destinazione.The user name of the network credentials for use by the target.
-credpassword-credpassword Password delle credenziali di rete che verranno usate dalla destinazione.The password of the network credentials for use by the target.
-connecttimeout-connecttimeout Timeout in secondi usato per la connessione al dispositivo.The timeout in seconds used when connecting to the device.
-remotedeploydir-remotedeploydir Percorso relativo directory/nome in cui copiare i file nel dispositivo remoto. Deve trattarsi di una cartella di distribuzione remota ben nota, determinata automaticamente.Relative directory path/name to copy files over to on the remote device; This will be a well-known, automatically determined remote deployment folder.
-deleteextrafile-deleteextrafile Opzione che indica se i file esistenti nella directory remota devono essere ripuliti per creare una corrispondenza con la directory di origine.Switch to indicate whether existing files in the remote directory should be purged to match the source directory.

La tabella seguente descrive le opzioni per WinAppDeployCmd.exe.The following table describes the options for WinAppDeployCmd.exe.

ArgomentoArgument DescrizioneDescription
<x><x> Timeout in secondi.Timeout in seconds. Il valore predefinito è 10.(Default is 10)
<address><address> Indirizzo IP o identificatore univoco del dispositivo di destinazione.IP address or unique identifier of the target device.
<a><b> ...<a><b> ... Percorso di dipendenza per ognuna delle dipendenze del pacchetto dell'app.Dependency path for each of the app package dependencies.
<p><p> PIN alfanumerico mostrato nelle impostazioni del dispositivo per stabilire una connessione.An alpha-numeric pin shown in the device settings to establish a connection.
<path><path> Percorso del file system.File system path.
<name><name> Nome completo del pacchetto dell'app da disinstallare.Full package name for the app package to uninstall.
<server><server> Server nella rete di file.Server on the file network.
<username><username> Utente per le credenziali con accesso al server nella rete di file.User for the credentials with access to the server on the file network.
<password><password> Password per le credenziali con accesso al server nella rete di file.Password for the credentials with access to the server on the files network.
<remotedeploydir><remotedeploydir> Directory nel dispositivo relativa al percorso di distribuzioneDirectory on device relative to the deployment location

Esempi di WinAppDeployCmd.exeWinAppDeployCmd.exe examples

Ecco alcuni esempi di distribuzione dalla riga di comando usando la sintassi per WinAppDeployCmd.exe.Here are some examples of how to deploy from the command-line using the syntax for WinAppDeployCmd.exe.

Mostra i dispositivi disponibili per la distribuzione.Shows the devices that are available for deployment. Per il comando è previsto un timeout di 3 secondi.The command times out in 3 seconds.

WinAppDeployCmd devices 3

Installa l'app dal pacchetto MyApp.appx che si trova nella directory Download del PC in un dispositivo Windows 10 con indirizzo IP 192.168.0.1 e PIN A1B2C3 per stabilire una connessione con il dispositivoInstalls the app from MyApp.appx package that is in your PC's Downloads directory to a Windows 10 device with an IP address of 192.168.0.1 with a PIN of A1B2C3 to establish a connection with the device

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 10 con indirizzo IP 192.168.0.1.Uninstalls the specified package (based on its full name) from a Windows 10 device with an IP address of 192.168.0.1. Puoi usare il comando list per visualizzare i nomi completi di tutti i pacchetti installati in un dispositivo.You can use the list command to see the full names of any packages that are installed on a device.

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.Updates the app that is already installed on the Windows 10 device with an IP address of 192.168.0.1 using the specified app package.

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

Distribuisce i file di un'app in un PC o un dispositivo Xbox con un indirizzo IP 192.168.0.1 nella stessa cartella del file AppxManifest nella directory app1_F5 nel percorso di distribuzione del dispositivo.Deploys the files of an app to a PC or Xbox with an IP address of 192.168.0.1 in the same folder as the AppxManifest to the app1_F5 directory under the deployment path of the device.

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

Registra l'app nella directory app1_F5 nel percorso di distribuzione del PC o del dispositivo Xbox con indirizzo IP 192.168.0.1.Registers the app at the app1_F5 directory under the deployment path of the PC or Xbox at 192.168.0.1.

WinAppDeployCmd registerfiles -file app1_F5 -ip 192.168.0.1

Uso di WinAppDeployCmd per configurare la distribuzione dell'esecuzione da PC in Xbox OneUsing WinAppDeployCmd to set up Run from PC deployment on Xbox One

L'esecuzione da PC consente di distribuire un'applicazione UWP in una console Xbox One senza copiare i file binari, che saranno ospitati in una condivisione di rete nella stessa rete della console Xbox.Run from PC allows you to deploy a UWP application to an Xbox One without copying the binaries over, instead the binaries are hosted on a network share on the same network as the Xbox. A tale scopo, devi disporre di una console Xbox One sbloccata dallo sviluppatore e di un'applicazione UWP con file separati in un'unità di rete accessibile dalla console Xbox.In order to do this, you need a developer unlocked Xbox One, and a loose file UWP application on a network drive that the Xbox can access.

Esegui questa operazione per registrare l'app:Run this to register the 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