Installieren von Apps mit dem WinAppDeployCmd.exe-Tool

Windows Application Deployment (WinAppDeployCmd.exe) ist ein Befehlszeilentool, das verwendet werden kann, um eine UWP-App (Universelle Windows-Plattform) von einem Windows 10-PC auf ein beliebiges Windows 10-Gerät bereitzustellen. Mit diesem Tool können Sie ein App-Paket bereitstellen, wenn das Windows 10-Gerät über USB verbunden ist oder im selben Subnetz verfügbar ist, ohne Microsoft Visual Studio oder die Lösung für diese App zu benötigen. Sie können die App auch bereitstellen, ohne sie zuerst für einen Remote-PC oder eine Xbox One zu verpacken. In diesem Artikel wird beschrieben, wie Sie UWP-Apps mit diesem Tool installieren.

Sie benötigen lediglich das Windows 10 SDK, um das WinAppDeployCmd-Tool über eine Eingabeaufforderung oder eine Skriptdatei auszuführen. Wenn Sie eine App mit WinAppDeployCmd.exeinstallieren, verwendet dies die datei .appx/.msix oder AppxManifest(für lose Dateien), um Ihre App auf ein Windows 10-Gerät querzuladen. Mit diesem Befehl wird das für Ihre App erforderliche Zertifikat nicht installiert. Zum Ausführen der App muss sich das Windows 10-Gerät im Entwicklermodus befinden oder das Zertifikat bereits installiert haben.

Zum Bereitstellen auf mobilen Geräten müssen Sie zuerst ein Paket erstellen. Weitere Informationen finden Sie hier.

Das WinAppDeployCmd.exe Tool befindet sich hier auf Ihrem Windows 10-PC: C:\Programme (x86)\Windows Kits\10\bin\<SDK Version>\x86\WinAppDeployCmd.exe (basierend auf Ihrem Installationspfad für das SDK).

Hinweis

In Version 15063 und höher des SDK wird das SDK nebeneinander in versionsspezifischen Ordnern installiert. Frühere SDKs (vor und einschließlich 14393) werden direkt in den übergeordneten Ordner geschrieben.

Verbinden Sie zunächst Ihr Windows 10-Gerät mit demselben Subnetz, oder verbinden Sie es direkt mit Ihrem Windows 10-Computer mit einer USB-Verbindung. Verwenden Sie dann die folgende Syntax und Beispiele für diesen Befehl weiter unten in diesem Artikel, um Ihre UWP-App bereitzustellen:

WinAppDeployCmd-Syntax und -Optionen

Dies ist die allgemeine Syntax, die für WinAppDeployCmd.exeverwendet wird:

WinAppDeployCmd command -option <argument>

Im Folgenden finden Sie einige zusätzliche Syntaxbeispiele für die Verwendung verschiedener Befehle:

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>

Sie können eine App auf dem Zielgerät installieren oder deinstallieren, oder Sie können eine bereits installierte App aktualisieren. Wenn Sie Daten oder Einstellungen beibehalten möchten, die von einer bereits installierten App gespeichert wurden, verwenden Sie die Updateoptionen anstelle der Installationsoptionen.

In der folgenden Tabelle werden die Befehle für WinAppDeployCmd.exebeschrieben.

Befehl	Beschreibung
Geräte	Zeigt die Liste der verfügbaren Netzwerkgeräte an.
installieren	Installieren Sie ein UWP-App-Paket auf dem Zielgerät.
Aktualisierung	Aktualisieren Sie eine UWP-App, die bereits auf dem Zielgerät installiert ist.
Liste	Zeigt die Liste der auf dem angegebenen Zielgerät installierten UWP-Apps an.
deinstallieren	Deinstallieren Sie das angegebene App-Paket vom Zielgerät.
Bereitstellungsdateien	Kopieren Sie die lose Datei-App vom Zielpfad auf den relativen Remotepfad auf dem Gerät.
Registerdateien	Registrieren Sie die Einzeldatei-App im Verzeichnis für die Remote-Bereitstellung.
addcreds	Fügen Sie einer Xbox Anmeldeinformationen hinzu, damit sie für die Registrierung von Apps auf einen Netzwerkort zugreifen kann.
getcreds	Rufen Sie Netzwerkanmeldeinformationen für die Nutzung ab, wenn Sie eine Anwendung von einer Netzwerkfreigabe ausführen.
deletecreds	Löschen Sie die Netzwerkanmeldeinformationen, die das Ziel beim Ausführen einer Anwendung aus einem Netzwerkfreigabeordner verwendet.

In der folgenden Tabelle werden die Optionen für WinAppDeployCmd.exebeschrieben.

Befehl	Beschreibung
-h (-help)	Zeigen Sie die Befehle, Optionen und Argumente an.
-ip	IP-Adresse des Zielgeräts.
-g (-guid)	Eindeutiger Bezeichner des Zielgeräts.
-d (-dependency)	(Optional) Gibt den Abhängigkeitspfad für jede der Paketabhängigkeiten an. Wenn kein Pfad angegeben ist, sucht das Tool nach Abhängigkeiten im Stammverzeichnis für das App-Paket und die SDK-Verzeichnisse.
-f (-file)	Dateipfad für das App-Paket zum Installieren, Aktualisieren oder Deinstallieren.
-p (-package)	Der vollständige Paketname für das zu deinstallierende App-Paket. (Sie können den Listenbefehl verwenden, um die vollständigen Namen für pakete zu finden, die bereits auf dem Gerät installiert sind)
-Stecknadel	Ein Pin, wenn benötigt, um eine Verbindung mit dem Zielgerät herzustellen. (Sie werden aufgefordert, den Vorgang mit der Option -pin erneut auszuführen, wenn die Authentifizierung erforderlich ist)
-credserver	Der Servername der Netzwerk-Anmeldeinformationen zur Verwendung durch das Ziel.
-credusername	Der Benutzername der Netzwerkanmeldeinformationen zur Nutzung durch das Ziel.
-credpassword	Das Kennwort der Netzwerkanmeldeinformationen für die Verwendung durch das Ziel.
-connecttimeout	Das Timeout in Sekunden, das beim Herstellen einer Verbindung mit dem Gerät verwendet wird.
-remotedeploydir	Relativer Verzeichnispfad/-name zum Kopieren von Dateien auf dem Remotegerät; Dies wird ein bekannter, automatisch bestimmter Remotebereitstellungsordner sein.
-deleteextrafile	Wechseln Sie, um anzugeben, ob vorhandene Dateien im Remoteverzeichnis gelöscht werden sollen, um dem Quellverzeichnis zu entsprechen.

In der folgenden Tabelle werden die Optionen für WinAppDeployCmd.exebeschrieben.

Argument	Beschreibung
<x>	Timeout in Sekunden. (Standardwert ist 10)
<Adresse>	IP-Adresse oder eindeutiger Bezeichner des Zielgeräts.
<a><b> ...	Abhängigkeitspfad für jede der App-Paketabhängigkeiten.
<p>	Ein alphanumerischer Pin, der in den Geräteeinstellungen angezeigt wird, um eine Verbindung herzustellen.
<Pfad>	Dateisystempfad.
<Namen>	Vollständiger Paketname für das zu deinstallierende App-Paket.
<Server>	Server im Dateinetzwerk.
<Benutzername>	Nutzer der Zugangsdaten mit Zugriff auf den Server des Dateinetzwerks.
<Kennwort>	Kennwort für den Zugriff auf den Server im Dateinetzwerk.
<remotedeploydir>	Verzeichnis auf dem Gerät relativ zum Bereitstellungsort

Beispiele für WinAppDeployCmd.exe

Hier sind einige Beispiele für die Bereitstellung über die Befehlszeile mithilfe der Syntax für WinAppDeployCmd.exe.

Zeigt die Geräte an, die für die Bereitstellung verfügbar sind. Der Befehl läuft nach 3 Sekunden ab.

WinAppDeployCmd devices 3

Installiert die App aus MyApp.appx Paket, das sich im Downloadverzeichnis Ihres PCs befindet, auf einem Windows 10-Gerät mit einer IP-Adresse von 192.168.0.1 mit einer PIN von A1B2C3, um eine Verbindung mit dem Gerät herzustellen.

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

Deinstalliert das angegebene Paket (basierend auf seinem vollständigen Namen) von einem Windows-Gerät mit einer IP-Adresse von 192.168.0.1. Sie können den Listenbefehl verwenden, um die vollständigen Namen aller Pakete anzuzeigen, die auf einem Gerät installiert sind.

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

Aktualisiert die App, die bereits auf dem Windows 10-Gerät mit der IP-Adresse 192.168.0.1 installiert ist, mithilfe des angegebenen App-Pakets.

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

Stellt die Dateien einer App auf einem PC oder einer Xbox mit der IP-Adresse 192.168.0.1 bereit, und zwar im selben Ordner wie das AppxManifest, in das Verzeichnis app1_F5 unter dem Bereitstellungspfad des Geräts.

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

Registriert die App im Verzeichnis app1_F5 unter dem Bereitstellungspfad des PCs oder der Xbox unter 192.168.0.1.

WinAppDeployCmd registerfiles -remotedeploydir app1_F5 -ip 192.168.0.1

Verwenden von WinAppDeployCmd zum Einrichten der Ausführung von einem PC aus auf der Xbox One

Wenn Sie von PC aus ausführen, können Sie eine UWP-Anwendung auf einer Xbox One bereitstellen, ohne die Binärdateien zu kopieren. Stattdessen werden die Binärdateien in einer Netzwerkfreigabe im selben Netzwerk wie die Xbox gehostet. Um dies zu tun, benötigen Sie eine entwicklerentsperrte Xbox One und eine UWP-Anwendung als lose Datei auf einem Netzlaufwerk, auf das die Xbox zugreifen kann.

Führen Sie dies aus, um die App zu registrieren:

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