Instalar aplicaciones con la herramienta WinAppDeployCmd.exeInstall apps with the WinAppDeployCmd.exe tool

Windows Application Deployment (WinAppDeployCmd.exe) es una herramienta de línea de comandos que se puede usar para implementar una aplicación de la Plataforma universal de Windows (UWP) desde un equipo con Windows 10 a cualquier dispositivo con 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. Puedes usar esta herramienta para implementar un paquete de la aplicación si el dispositivo con Windows 10 está conectado mediante USB o disponible en la misma subred sin necesidad de Microsoft Visual Studio ni de la solución para dicha aplicación.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. También puedes implementar la aplicación sin empaquetarla primero en un equipo remoto o en Xbox One.You can also deploy the app without packaging first to a remote PC or Xbox One. Este artículo describe cómo instalar aplicaciones para UWP con esta herramienta.This article describes how to install UWP apps using this tool.

Solo necesitas tener instalado el SDK de Windows 10 para ejecutar la herramienta WinAppDeployCmd desde un símbolo del sistema o un archivo de script.You just need the Windows 10 SDK installed to run the WinAppDeployCmd tool from a command prompt or a script file. Cuando se instala una aplicación con WinAppDeployCmd.exe, esta usa el archivo .appx o .msix, o AppxManifest (para los archivos sueltos), para transferir localmente la aplicación a un dispositivo con 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. Este comando no instala el certificado necesario para la aplicación.This command does not install the certificate required for your app. Para ejecutar la aplicación, el dispositivo con Windows 10 debe estar en modo de desarrollador o tener el certificado instalado.To run the app, the Windows 10 device must be in developer mode or already have the certificate installed.

Para implementar en dispositivos móviles, primero debes crear un paquete.To deploy to mobile devices, you must first create a package. Puedes obtener más información aquí.For more information, see here.

La herramienta WinAppDeployCmd.exe se encuentra aquí en el equipo con Windows 10: C:\Archivos de programa (x86)\Windows Kits\10\bin\<SDK Version>\x86\WinAppDeployCmd.exe (según la ruta de acceso de instalación del 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

El SDK de la versión 15063 y posteriores se instala en paralelo dentro de carpetas específicas de la versión.In version 15063 and later of the SDK, the SDK is installed side by side within version-specific folders. Los SDK de la versión 14393 y anteriores se escriben directamente en la carpeta principal.Previous SDKs (prior to and including 14393) are written directly to the parent folder.

En primer lugar, conecta el dispositivo con Windows 10 a la misma subred o directamente al equipo con Windows 10 mediante una conexión USB.First, connect your Windows 10 device to the same subnet or connect it directly to your Windows 10 machine with a USB connection. A continuación, usa la siguiente sintaxis y los ejemplos de este comando que se incluyen más adelante en este artículo para implementar la aplicación para UWP:Then use the following syntax and examples of this command later in this article to deploy your UWP app:

Opciones y sintaxis de WinAppDeployCmdWinAppDeployCmd syntax and options

Esta es la sintaxis general que se usa para WinAppDeployCmd.exe:This is the general syntax used for WinAppDeployCmd.exe:

WinAppDeployCmd command -option <argument>

Estos son algunos ejemplos de sintaxis adicionales para el uso de distintos comandos: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>

Puedes instalar o desinstalar una aplicación en el dispositivo de destino, o bien actualizar una aplicación que ya está instalada.You can install or uninstall an app on the target device, or you can update an app that's already installed. Para mantener los datos o la configuración guardados por una aplicación que ya está instalada, usa las opciones de update en lugar de las opciones de install .To keep data or settings saved by an app that's already installed, use the update options instead of the install options.

La siguiente tabla describe los comandos de WinAppDeployCmd.exe.The following table describes the commands for WinAppDeployCmd.exe.

ComandoCommand DescripciónDescription
dispositivosdevices Muestra la lista de dispositivos de red disponibles.Show the list of available network devices.
instalarinstall Instala un paquete de la aplicación para UWP en el dispositivo de destino.Install a UWP app package to the target device.
actualizaciónupdate Actualiza una aplicación para UWP que ya esté instalada en el dispositivo de destino.Update a UWP app that is already installed on the target device.
listlist Muestra la lista de aplicaciones para UWP instaladas en el dispositivo de destino especificado.Show the list of UWP apps installed on the specified target device.
uninstalluninstall Desinstala el paquete de la aplicación especificado del dispositivo de destino.Uninstall the specified app package from the target device.
deployfilesdeployfiles Copia la aplicación de archivos sueltos que está la ruta de destino a la ruta relativa remota del dispositivo.Copy over loose file app at the target path to the remote relative path on the device.
registerfilesregisterfiles Registra la aplicación de archivos sueltos en el directorio de implementación remoto.Register the loose file app at the remote deploy directory.
addcredsaddcreds Agrega credenciales a una consola Xbox para que pueda acceder a una ubicación de red para el registro de la aplicación.Add credentials to an Xbox to allow it to access a network location for app registration.
getcredsgetcreds Obtiene credenciales de red para los usos de destino cuando se ejecuta una aplicación desde un recurso compartido de red.Get network credentials for the target uses when running an application from a network share.
deletecredsdeletecreds Elimina credenciales de red que el destino usa cuando ejecuta una aplicación desde un recurso compartido de red.Delete network credentials the target uses when running an application from a network share.

La siguiente tabla describe las opciones de WinAppDeployCmd.exe.The following table describes the options for WinAppDeployCmd.exe.

ComandoCommand DescripciónDescription
-h (-help)-h (-help) Muestra los comandos, las opciones y los argumentos.Show the commands, options and arguments.
-ip-ip Dirección IP del dispositivo de destino.IP address of the target device.
-g (-guid)-g (-guid) Identificador único del dispositivo de destino.Unique identifier of the target device.
-d (-dependency)-d (-dependency) (Opcional) Especifica la ruta de dependencia de cada una de las dependencias del paquete.(Optional) Specifies the dependency path for each of the package dependencies. Si no se especifica ninguna ruta, la herramienta busca dependencias en el directorio raíz del paquete de la aplicación y los directorios del 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) Ruta de archivo del paquete de la aplicación que se va a instalar, actualizar o desinstalar.File path for the app package to install, update or uninstall.
-p (-package)-p (-package) Nombre completo del paquete de la aplicación que se va a desinstalar.The full package name for the app package to uninstall. (Puedes usar el comando de la lista para encontrar los nombres completos de los paquetes ya instalados en el dispositivo).(You can use the list command to find the full names for packages already installed on the device)
-pin-pin Pin si es necesario para establecer una conexión con el dispositivo de destino.A pin if it is required to establish a connection with the target device. (Se te pedirá que vuelvas a intentarlo con la opción -pin si se requiere autenticación).(You will be prompted to retry with the -pin option if authentication is required)
-credserver-credserver El nombre del servidor de las credenciales de red para su uso por parte del destino.The server name of the network credentials for use by the target.
-credusername-credusername El nombre de usuario de las credenciales de red para su uso por parte del destino.The user name of the network credentials for use by the target.
-credpassword-credpassword La contraseña de las credenciales de red para su uso por parte del destino.The password of the network credentials for use by the target.
-connecttimeout-connecttimeout El tiempo de espera en segundos que se usa para conectar con el dispositivo.The timeout in seconds used when connecting to the device.
-remotedeploydir-remotedeploydir Nombre y ruta de acceso relativa del directorio en el que se copiarán los archivos en el dispositivo remoto; se trata de una carpeta de implementación remota conocida que se determina automáticamente.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 Cambia para indicar si se deben purgar los archivos existentes en el directorio remoto para que coincidan con los del directorio de origen.Switch to indicate whether existing files in the remote directory should be purged to match the source directory.

La siguiente tabla describe las opciones de WinAppDeployCmd.exe.The following table describes the options for WinAppDeployCmd.exe.

ArgumentoArgument DescripciónDescription
<x><x> Tiempo de expiración en segundos.Timeout in seconds. (El valor predeterminado es 10)(Default is 10)
<address><address> Dirección IP o identificador único del dispositivo de destino.IP address or unique identifier of the target device.
<a><b> ...<a><b> ... Ruta de dependencia de cada una de las dependencias del paquete de la aplicación.Dependency path for each of the app package dependencies.
<p><p> PIN alfanumérico que se muestra en la configuración del dispositivo para establecer una conexión.An alpha-numeric pin shown in the device settings to establish a connection.
<path><path> Ruta del sistema de archivos.File system path.
<name><name> El nombre completo del paquete de la aplicación que se va a desinstalar.Full package name for the app package to uninstall.
<server><server> El servidor de la red de archivos.Server on the file network.
<username><username> El usuario para las credenciales con acceso al servidor de la red de archivos.User for the credentials with access to the server on the file network.
<password><password> La contraseña para las credenciales con acceso al servidor de la red de archivos.Password for the credentials with access to the server on the files network.
<remotedeploydir><remotedeploydir> El directorio del dispositivo relativo a la ubicación de implementaciónDirectory on device relative to the deployment location

Ejemplos de WinAppDeployCmd.exeWinAppDeployCmd.exe examples

A continuación, presentamos algunos ejemplos de implementación desde la línea de comandos mediante la sintaxis de WinAppDeployCmd.exe.Here are some examples of how to deploy from the command-line using the syntax for WinAppDeployCmd.exe.

Muestra los dispositivos que están disponibles para la implementación.Shows the devices that are available for deployment. El comando expira en 3 segundos.The command times out in 3 seconds.

WinAppDeployCmd devices 3

Instala la aplicación desde el paquete MyApp.appx, que se encuentra en el directorio Descargas de tu PC, en un dispositivo con Windows 10 con la dirección IP 192.168.0.1 y el PIN A1B2C3 para establecer una conexión con el dispositivo.Installs 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

Desinstala el paquete especificado (basado en su nombre completo) de un dispositivo con Windows 10 y la dirección 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. Puedes usar el comando list para ver los nombres completos de todos los paquetes que están instalados en 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

Actualiza la aplicación que ya está instalada en el dispositivo con Windows 10 y la dirección IP 192.168.0.1 con el paquete de la aplicación especificado.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

Implementa los archivos de una aplicación que esté en un equipo o Xbox con la dirección IP 192.168.0.1 y en la misma carpeta que AppxManifest en el directorio app1_F5, en la ruta de implementación 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 la aplicación que está en el directorio app1_F5 en la ruta de acceso de implementación del equipo o Xbox en 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 de WinAppDeployCmd para configurar la implementación de Run from PC en Xbox OneUsing WinAppDeployCmd to set up Run from PC deployment on Xbox One

Run from PC permite implementar una aplicación para UWP en una consola Xbox One sin copiar los archivos binarios; en su lugar, los archivos binarios se hospedan en un recurso compartido de red en la misma red que la consola 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. Para hacerlo, necesitas una consola Xbox One desbloqueada por el desarrollador y una aplicación para UWP de archivos sueltos en una unidad de red a la que pueda acceder la consola 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.

Ejecuta lo siguiente para registrar la aplicación: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