Installer des applications avec l’outil WinAppDeployCmd.exeInstall apps with the WinAppDeployCmd.exe tool

Le déploiement d’applications Windows (WinAppDeployCmd.exe) est un outil de ligne de commande qui permet de déployer une application de plateforme Windows universelle (UWP) à partir d’un PC Windows 10 et vers tout appareil 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. Vous pouvez utiliser cet outil pour déployer un package d’application quand l’appareil Windows 10 est connecté par le biais d’un port USB ou disponible sur le même sous-réseau, sans avoir besoin de Microsoft Visual Studio ni de la solution pour cette application.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. Vous pouvez également déployer l’application sans créer de package au préalable vers un ordinateur distant ou une Xbox One.You can also deploy the app without packaging first to a remote PC or Xbox One. Cet article décrit comment installer des applications UWP à l’aide de cet outil.This article describes how to install UWP apps using this tool.

Vous devez simplement installer le SDK Windows 10 pour exécuter l’outil WinAppDeployCmd à partir d’une invite de commandes ou d’un fichier de script.You just need the Windows 10 SDK installed to run the WinAppDeployCmd tool from a command prompt or a script file. Quand vous installez une application avec WinAppDeployCmd.exe, celui-ci utilise le fichier .appx/.msix ou AppxManifest (pour les fichiers isolés) pour le chargement indépendant de votre application sur un appareil 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. Cette commande n’installe pas le certificat nécessaire pour votre application.This command does not install the certificate required for your app. Pour exécuter l’application, l’appareil Windows 10 doit être en mode développeur ou le certificat doit déjà avoir été installé.To run the app, the Windows 10 device must be in developer mode or already have the certificate installed.

Pour un déploiement vers des appareils mobiles, vous devez d’abord créer un package.To deploy to mobile devices, you must first create a package. Pour plus d’informations, voir cet article.For more information, see here.

L’outil WinAppDeployCmd.exe se trouve à cet emplacement sur votre PC Windows 10 : C:\Program Files (x86)\Windows Kits\10\bin\<SDK Version>\x86\WinAppDeployCmd.exe (selon votre chemin d’installation pour le 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).

Notes

Les versions 15063 et ultérieures du SDK sont installées côte-à-côte, dans des dossiers spécifiques à la version.In version 15063 and later of the SDK, the SDK is installed side by side within version-specific folders. Les SDK précédents (version 14393 et versions antérieures) sont écrits directement dans le dossier parent.Previous SDKs (prior to and including 14393) are written directly to the parent folder.

Tout d’abord, connectez votre appareil Windows 10 au même sous-réseau ou connectez-le directement à votre ordinateur Windows 10 par le biais d’un port USB.First, connect your Windows 10 device to the same subnet or connect it directly to your Windows 10 machine with a USB connection. Utilisez ensuite la syntaxe et les exemples suivants de la commande présentés plus loin dans cet article pour déployer votre application UWP :Then use the following syntax and examples of this command later in this article to deploy your UWP app:

Options et syntaxe WinAppDeployCmdWinAppDeployCmd syntax and options

Il s’agit de la syntaxe générale utilisée pour WinAppDeployCmd.exe :This is the general syntax used for WinAppDeployCmd.exe:

WinAppDeployCmd command -option <argument>

Voici quelques exemples de syntaxe supplémentaire associée à l’utilisation de diverses commandes :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>

Vous pouvez installer ou désinstaller une application sur l’appareil cible, ou vous pouvez mettre à jour une application déjà installée.You can install or uninstall an app on the target device, or you can update an app that's already installed. Pour conserver les données ou les paramètres enregistrés par une application déjà installée, utilisez les options update plutôt que les options install.To keep data or settings saved by an app that's already installed, use the update options instead of the install options.

Le tableau suivant décrit les commandes pour WinAppDeployCmd.exe.The following table describes the commands for WinAppDeployCmd.exe.

CommandeCommand DescriptionDescription
périphériquesdevices Affiche la liste des périphériques réseau disponibles.Show the list of available network devices.
installerinstall Installe un package d’application UWP sur l’appareil cible.Install a UWP app package to the target device.
mise à jourupdate Met à jour une application UWP déjà installée sur l’appareil cible.Update a UWP app that is already installed on the target device.
listlist Affiche la liste des applications UWP installées sur l’appareil cible spécifié.Show the list of UWP apps installed on the specified target device.
uninstalluninstall Désinstalle le package d’application spécifié de l’appareil cible.Uninstall the specified app package from the target device.
deployfilesdeployfiles Copie les fichiers isolés d’application présents dans le chemin d’accès cible vers le chemin d’accès relatif distant sur l’appareil.Copy over loose file app at the target path to the remote relative path on the device.
registerfilesregisterfiles Inscrit les fichiers isolés d’application dans le répertoire de déploiement distant.Register the loose file app at the remote deploy directory.
addcredsaddcreds Ajoute des informations d’identification à une Xbox pour lui permettre d’accéder à un emplacement réseau pour l’enregistrement d’applications.Add credentials to an Xbox to allow it to access a network location for app registration.
getcredsgetcreds Récupère les informations d’identification réseau utilisées par la cible lors de l’exécution d’une application depuis un partage réseau.Get network credentials for the target uses when running an application from a network share.
deletecredsdeletecreds Supprime les informations d’identification réseau utilisées par la cible lors de l’exécution d’une application depuis un partage réseau.Delete network credentials the target uses when running an application from a network share.

Le tableau suivant décrit les options pour WinAppDeployCmd.exe.The following table describes the options for WinAppDeployCmd.exe.

CommandeCommand DescriptionDescription
-h (-help)-h (-help) Affiche les commandes, les options et les arguments.Show the commands, options and arguments.
-ip-ip Adresse IP de l’appareil cible.IP address of the target device.
-g (-guid)-g (-guid) Identificateur unique de l’appareil cible.Unique identifier of the target device.
-d (-dependency)-d (-dependency) (Facultatif) Spécifie le chemin d’accès de dépendance pour chacune des dépendances du package.(Optional) Specifies the dependency path for each of the package dependencies. Si aucun chemin d’accès n’est spécifié, l’outil recherche des dépendances dans le répertoire racine pour le package d’application et les répertoires du kit de développement logiciel (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) Chemin d’accès de fichier pour le package d’application à installer, mettre à jour ou désinstaller.File path for the app package to install, update or uninstall.
-p (-package)-p (-package) Le nom complet du package pour le package d’application à désinstaller.The full package name for the app package to uninstall. (Vous pouvez utiliser la commande « list » pour rechercher le nom complet des packages déjà installés sur l’appareil.)(You can use the list command to find the full names for packages already installed on the device)
-pin-pin Un code confidentiel, s’il est nécessaire pour établir une connexion avec l’appareil cible.A pin if it is required to establish a connection with the target device. (Vous serez invité à réessayer avec l’option -pin si une authentification est nécessaire.)(You will be prompted to retry with the -pin option if authentication is required)
-credserver-credserver Nom de serveur des informations d’identification réseau à utiliser par la cible.The server name of the network credentials for use by the target.
-credusername-credusername Nom d’utilisateur des informations d’identification réseau à utiliser par la cible.The user name of the network credentials for use by the target.
-credpassword-credpassword Mot de passe des informations d’identification réseau à utiliser par la cible.The password of the network credentials for use by the target.
-connecttimeout-connecttimeout Délai d’expiration en secondes utilisé lors de la connexion à l’appareil.The timeout in seconds used when connecting to the device.
-remotedeploydir-remotedeploydir Le chemin/nom relatif du répertoire pour copier les fichiers sur l’appareil distant ; il s’agira d’un dossier de déploiement distant bien connu et automatiquement déterminé.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 Paramètre booléen servant à indiquer si les fichiers existants du répertoire distant doivent être supprimés pour que ce dernier corresponde au répertoire source.Switch to indicate whether existing files in the remote directory should be purged to match the source directory.

Le tableau suivant décrit les options pour WinAppDeployCmd.exe.The following table describes the options for WinAppDeployCmd.exe.

ArgumentArgument DescriptionDescription
<x><x> Délai d’expiration en secondes.Timeout in seconds. (La valeur par défaut est 10)(Default is 10)
<address><address> Adresse IP ou identificateur unique de l’appareil cible.IP address or unique identifier of the target device.
<a><b> ...<a><b> ... Chemin d’accès de dépendance pour chacune des dépendances du package d’application.Dependency path for each of the app package dependencies.
<p><p> Un PIN alphanumérique indiqué dans les paramètres de l’appareil pour établir une connexion.An alpha-numeric pin shown in the device settings to establish a connection.
<path><path> Chemin d’accès au système de fichiers.File system path.
<name><name> Nom complet du package pour le package d’application à désinstaller.Full package name for the app package to uninstall.
<server><server> Serveur sur le réseau de fichiers.Server on the file network.
<username><username> Nom d’utilisateur des informations d’identification pour l’accès au serveur sur le réseau de fichiers.User for the credentials with access to the server on the file network.
<password><password> Mot de passe des informations d’identification pour l’accès au serveur sur le réseau de fichiers.Password for the credentials with access to the server on the files network.
<remotedeploydir><remotedeploydir> Répertoire de l’appareil relatif à l’emplacement de déploiement.Directory on device relative to the deployment location

Exemples de WinAppDeployCmd.exeWinAppDeployCmd.exe examples

Voici quelques exemples montrant comment effectuer un déploiement à partir de la ligne de commande, à l’aide de la syntaxe de WinAppDeployCmd.exe.Here are some examples of how to deploy from the command-line using the syntax for WinAppDeployCmd.exe.

Affiche les appareils qui sont disponibles pour le déploiement.Shows the devices that are available for deployment. La commande expire au bout de 3 secondes.The command times out in 3 seconds.

WinAppDeployCmd devices 3

Installe l’application à partir du package MyApp.appx qui se trouve dans le répertoire Téléchargements de votre PC pour un appareil Windows 10 avec l’adresse IP 192.168.0.1 et avec le PIN A1B2C3 nécessaire pour établir une connexion avec l’appareil.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

Désinstalle le package spécifié (en fonction de son nom complet) à partir d’un appareil Windows 10 avec l’adresse 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. Vous pouvez utiliser la commande list pour afficher le nom complet de tous les packages installés sur un appareil.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

Met à jour l’application qui est déjà installée sur l’appareil Windows 10 avec l’adresse IP 192.168.0.1 à l’aide du package d’application spécifié.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

Déploie les fichiers d’une application présents dans le même dossier que le fichier AppxManifest vers un PC ou une Xbox avec l’adresse IP 192.168.0.1 dans le répertoire app1_F5 sous le chemin d’accès de déploiement de l’appareil.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

Inscrit l’application dans le répertoire app1_F5 sous le chemin de déploiement du PC ou de la Xbox à l’adresse 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

Utilisation de WinAppDeployCmd pour configurer un déploiement d’exécution à partir d’un PC sur une console Xbox OneUsing WinAppDeployCmd to set up Run from PC deployment on Xbox One

L’exécution à partir d’un PC vous permet de déployer une application UWP sur une console Xbox One sans copier les fichiers binaires dessus. Au lieu de cela, les fichiers binaires sont hébergés sur un partage réseau sur le même réseau que la 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. Pour ce faire, vous avez besoin d’une console Xbox One déverrouillée par le développeur et d’un application UWP à fichier libre sur un lecteur réseau auquel la Xbox peut accéder.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.

Exécutez la commande suivante pour inscrire l’application :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