Installer des applications avec l’outil WinAppDeployCmd.exe

Le déploiement d’applications Windows (WinAppDeployCmd.exe) est un outil en ligne de commande qui peut être utilisé pour déployer une application de plateforme Windows universelle (UWP) à partir d’un PC Windows 10 sur n’importe quel appareil Windows 10. Vous pouvez utiliser cet outil pour déployer un package d’application lorsque l’appareil Windows 10 est connecté par USB ou disponible sur le même sous-réseau sans avoir besoin de Microsoft Visual Studio ou de la solution pour cette application. Vous pouvez également déployer l’application sans empaqueter d’abord sur un PC distant ou Xbox One. Cet article explique comment installer des applications UWP à l’aide de cet outil.

Vous avez simplement besoin du Kit de développement logiciel (SDK) Windows 10 installé pour exécuter l’outil WinAppDeployCmd à partir d’une invite de commandes ou d’un fichier de script. Lorsque vous installez une application avec WinAppDeployCmd.exe, cela utilise le fichier .appx/.msix ou AppxManifest(pour les fichiers libres) pour charger côte à côte votre application sur un appareil Windows 10. Cette commande n’installe pas le certificat requis pour votre application. Pour exécuter l’application, l’appareil Windows 10 doit être en mode développeur ou avoir déjà installé le certificat.

Pour effectuer un déploiement sur des appareils mobiles, vous devez d’abord créer un package. Vous pourrez trouver plus d’informations ici.

L’outil WinAppDeployCmd.exe se trouve ici sur votre PC Windows 10 : C :\Program Files (x86)\Windows Kits\10\bin\<version du SDK>\x86\WinAppDeployCmd.exe (en fonction de votre chemin d’installation pour le SDK).

Remarque

Dans la version 15063 et ultérieure du Kit de développement logiciel (SDK), le SDK est installé côte à côte dans des dossiers spécifiques à la version. Les kits SDK précédents (avant et incluant 14393) sont écrits directement dans le dossier parent.

Tout d’abord, connectez votre appareil Windows 10 au même sous-réseau ou connectez-le directement à votre ordinateur Windows 10 avec une connexion USB. Utilisez ensuite la syntaxe et les exemples suivants de cette commande plus loin dans cet article pour déployer votre application UWP :

Syntaxe et options WinAppDeployCmd

Il s’agit de la syntaxe générale utilisée pour WinAppDeployCmd.exe:

WinAppDeployCmd command -option <argument>

Voici quelques exemples de syntaxe supplémentaires pour utiliser différentes commandes :

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 mettre à jour une application déjà installée. Pour conserver les données ou les paramètres enregistrés par une application déjà installée, utilisez les options de mise à jour au lieu des options d’installation .

Le tableau suivant décrit les commandes pour WinAppDeployCmd.exe.

Commande	Description
Dispositifs	Affichez la liste des appareils réseau disponibles.
installer	Installez un package d’application UWP sur l’appareil cible.
mettre à jour	Mettez à jour une application UWP déjà installée sur l’appareil cible.
liste	Affichez la liste des applications UWP installées sur l’appareil cible spécifié.
désinstaller	Désinstallez le package d’application spécifié à partir de l’appareil cible.
deployfiles	Copiez l’application de fichier libre sur le chemin cible vers le chemin d’accès relatif distant sur l’appareil.
fichiers de registre	Inscrivez l’application de fichier libre dans le répertoire de déploiement distant.
addcreds	Ajoutez des informations d’identification à une Xbox pour lui permettre d’accéder à un emplacement réseau pour l’inscription d’application.
getcreds	Obtenez les informations d’identification réseau pour les utilisations cibles lors de l’exécution d’une application à partir d’un partage réseau.
deletecreds	Supprimez les informations d’identification réseau que la cible utilise lors de l’exécution d’une application à partir d’un partage réseau.

Le tableau suivant décrit les options de WinAppDeployCmd.exe.

Commande	Description
-h (-help)	Affichez les commandes, les options et les arguments.
-Ip	Adresse IP de l’appareil cible.
-g (-guid)	Identificateur unique de l’appareil cible.
-d (-dependency)	(Facultatif) Spécifie le chemin d’accès pour chaque dépendance du package. Si aucun chemin d’accès n’est spécifié, l’outil recherche les dépendances dans le répertoire racine du package d’application et les répertoires du SDK.
-f (-file)	Chemin d’accès au fichier du package d’application à installer, mettre à jour ou désinstaller.
-p (-package)	Nom complet du package d’application à désinstaller. (Vous pouvez utiliser la commande de liste pour rechercher les noms complets des packages déjà installés sur l’appareil)
-épingler	Un code PIN s’il est nécessaire pour établir une connexion avec l’appareil cible. (Vous serez invité à réessayer avec l’option -pin si l’authentification est requise)
-credserver	Nom du serveur des informations d’identification réseau à utiliser par la cible.
-credusername	Nom d’utilisateur des informations d’identification réseau à utiliser par la cible.
-credpassword	Mot de passe des informations d’identification réseau à utiliser par la cible.
-connecttimeout	Délai d’expiration en secondes utilisé lors de la connexion à l’appareil.
-remotedeploydir	Chemin/nom du répertoire relatif pour copier des fichiers sur l’appareil distant ; Il s’agit d’un dossier de déploiement distant bien connu et déterminé automatiquement.
-deleteextrafile (supprimer fichier supplémentaire)	Basculez pour indiquer si les fichiers existants dans le répertoire distant doivent être vidés pour correspondre au répertoire source.

Le tableau suivant décrit les options de WinAppDeployCmd.exe.

Argument	Description
<x>	Délai d’expiration en secondes. (La valeur par défaut est 10)
<adresse>	Adresse IP ou identificateur unique de l’appareil cible.
<a><a> ...	Chemin d'accès pour chaque dépendance de package d'application.
<p>	Code alphanumérique affiché dans les paramètres de l’appareil pour établir une connexion.
<chemin>	Chemin du système de fichiers.
<nom>	Nom complet du package d’application à désinstaller.
<serveur>	Serveur sur le réseau de fichiers.
<nom d’utilisateur>	Utilisateur ayant des informations d'identification permettant l'accès au serveur sur le réseau de fichiers.
<mot de passe>	Mot de passe pour les identifiants avec accès au serveur sur le réseau de données.
< > remotedeploydir	Répertoire sur l’appareil par rapport à l’emplacement de déploiement

Exemples de WinAppDeployCmd.exe

Voici quelques exemples de déploiement à partir de la ligne de commande à l’aide de la syntaxe de WinAppDeployCmd.exe.

Affiche les appareils disponibles pour le déploiement. La commande expire en 3 secondes.

WinAppDeployCmd devices 3

Installe l’application à partir de MyApp.appx package qui se trouve dans le répertoire Téléchargements de votre PC sur un appareil Windows 10 avec une adresse IP de 192.168.0.1 avec un code confidentiel D1B2C3 pour établir une connexion avec l’appareil

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 avec une adresse IP de 192.168.0.1. Vous pouvez utiliser la commande de liste pour afficher les noms complets des packages installés sur un appareil.

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

Met à jour l’application déjà installée sur l’appareil Windows 10 avec une adresse IP de 192.168.0.1 à l’aide du package d’application spécifié.

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

Déploie les fichiers d’une application sur un PC ou Xbox avec une adresse IP de 192.168.0.1 dans le même dossier que AppxManifest dans le répertoire app1_F5 sous le chemin de déploiement de l’appareil.

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 xbox à 192.168.0.1.

WinAppDeployCmd registerfiles -remotedeploydir app1_F5 -ip 192.168.0.1

Utilisation de WinAppDeployCmd pour configurer le déploiement depuis un PC sur Xbox One

L’exécution à partir du PC vous permet de déployer une application UWP sur une Xbox One sans copier les fichiers binaires, au lieu de cela, les fichiers binaires sont hébergés sur un partage réseau sur le même réseau que xbox. Pour ce faire, vous avez besoin d'une Xbox One déverrouillée pour les développeurs, et d'une application UWP sous forme de fichiers séparés sur un lecteur réseau auquel la Xbox peut accéder.

Exécutez cette opération pour inscrire l’application :

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