使用 WinAppDeployCmd.exe 工具安装应用
Windows 应用程序部署 (WinAppDeployCmd.exe) 是一个命令行工具，可用于将通用 Windows 平台 (UWP) 应用从 Windows 10 电脑部署到任意 Windows 10 设备。 当 Windows 10 设备通过 USB 进行连接或无需 Microsoft Visual Studio 或该应用的解决方案即可连接到同一子网时，可使用此工具部署应用包。 你还可以将事先未打包的应用部署到远程电脑或 Xbox One。 本文介绍如何使用此工具安装 UWP 应用。
你只需安装 Windows 10 SDK 即可从命令提示符或脚本文件中运行 WinAppDeployCmd 工具。 使用 WinAppDeployCmd.exe 安装应用时，此操作会使用 .appx/.msix 文件或 AppxManifest（适用于松散文件）将应用旁加载到 Windows 10 设备。 此命令不会安装应用所需的证书。 若要运行该应用，Windows 10 设备必须处于开发人员模式下或已经安装了证书。
若要部署到移动设备，必须首先创建程序包。 有关详细信息，请参阅此文。
WinAppDeployCmd.exe 工具位于你的 Windows 10 电脑上的以下位置：C:\Program Files (x86)\Windows Kits\10\bin\<SDK Version>\x86\WinAppDeployCmd.exe（基于 SDK 的安装路径）。
注意
在 15063 版本及更高版本的 SDK 中，SDK 并行安装到版本特定的文件夹中。 以前的 SDK（14393 及以前）直接写入父文件夹。
首先，将你的 Windows 10 设备连接到同一子网，或通过 USB 连接直接将其连接到你的 Windows 10 计算机。 然后使用以下语法和本文后面的此命令的示例部署 UWP 应用：
WinAppDeployCmd 语法和选项
这是用于 WinAppDeployCmd.exe 的常规语法：
WinAppDeployCmd command -option <argument>
下面是关于使用各种命令的一些其他语法示例：
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>
你可以在目标设备上安装或卸载应用，也可以更新已经安装的应用。 若要保留由已经安装的应用保存的数据或设置，请使用 update 选项而非 install 选项。
下表介绍了 WinAppDeployCmd.exe 命令。
| 命令 | 说明 |
|---|---|
| 设备 | 显示可用网络设备列表。 |
| 安装 | 将 UWP 应用包安装到目标设备。 |
| update | 更新已安装在目标设备上的 UWP 应用。 |
| list | 显示已安装在指定目标设备上的 UWP 应用列表。 |
| 卸载 | 从目标设备卸载指定的应用包。 |
| deployfiles | 将目标路径处的松散文件应用复制到设备上的远程相对路径。 |
| registerfiles | 将松散文件应用注册到远程部署目录。 |
| addcreds | 将凭据添加到 Xbox 以允许它访问应用注册的网络位置。 |
| getcreds | 从网络共享运行应用程序时，获取目标使用的网络凭据。 |
| deletecreds | 从网络共享运行应用程序时，删除目标使用的网络凭据。 |
下表介绍了用于 WinAppDeployCmd.exe 的选项。
| 命令 | 说明 |
|---|---|
| -h (-help) | 显示命令、选项和参数。 |
| -ip | 目标设备的 IP 地址。 |
| -g (-guid) | 目标设备的唯一标识符。 |
| -d (-dependency) | （可选）指定每个程序包依赖项的依赖项路径。 如果未指定任何路径，该工具会在应用包的根目录和 SDK 目录中搜索依赖项。 |
| -f (-file) | 要安装、更新或卸载的应用包的文件路径。 |
| -p (-package) | 要卸载的应用包的完整程序包名称。 （你可以使用列表命令查找已经安装在设备上的程序包的完整名称） |
| -pin | 与目标设备建立连接所需的引脚。 （如果需要身份验证，将提示你使用 -pin 选项重试） |
| -credserver | 供目标使用的网络凭据的服务器名称。 |
| -credusername | 供目标使用的网络凭据的用户名。 |
| -credpassword | 供目标使用的网络凭据的密码。 |
| -connecttimeout | 连接到设备时所使用的超时（以秒为单位）。 |
| -remotedeploydir | 要将文件复制到的远程设备上的相对目录路径/名称；这将是一个自动确定的已知远程部署文件夹。 |
| -deleteextrafile | 用于指示是否应清除远程目录中的现有文件以匹配源目录的开关。 |
下表介绍了用于 WinAppDeployCmd.exe 的选项。
| Argument | 说明 |
|---|---|
| <x> | 超时（以秒为单位）。 （默认值为 10 秒） |
| <address> | 目标设备的 IP 地址或唯一标识符。 |
| <a><b> ... | 每个应用包依赖项的依赖项路径。 |
| p<> | 在设备设置中显示的用于建立连接的字母数字引脚。 |
| <路径> | 文件系统路径。 |
| name<> | 要卸载的应用包的完整程序包名称。 |
| 服务器<> | 文件网络上的服务器。 |
| <username> | 有权访问文件网络上的服务器的凭据的用户。 |
| password<> | 有权访问文件网络上的服务器的凭据的密码。 |
| <remotedeploydir> | 设备上相对于部署位置的目录 |
WinAppDeployCmd.exe 示例
下面是一些示例，介绍了如何使用 WinAppDeployCmd.exe 的语法从命令行中进行部署。
显示可用于部署的设备。 命令超时 3 秒。
WinAppDeployCmd devices 3
将应用从电脑的“下载”目录中的 MyApp.appx 程序包安装到 IP 地址为 192.168.0.1、PIN 为 A1B2C3 的 Windows 10 设备，以与该设备建立连接
WinAppDeployCmd install -file "Downloads\MyApp.appx" -ip 192.168.0.1 -pin A1B2C3
从 IP 地址为 192.168.0.1 的 Windows 设备中卸载指定的程序包（基于其完整名称）。 你可以使用列表命令查看安装在设备上的任意程序包的完整名称。
WinAppDeployCmd uninstall -package Company.MyApp_1.0.0.1_x64__qwertyuiop -ip 192.168.0.1
使用指定的应用包更新已经安装在 IP 地址为 192.168.0.1 的 Windows 10 设备上的应用。
WinAppDeployCmd update -file "Downloads\MyApp.appx" -ip 192.168.0.1
将应用的文件部署到 IP 地址为 192.168.0.1 的电脑或 Xbox 中，这些文件与该设备的部署路径下的 app1_F5 目录中 AppxManifest 位于同一文件夹中。
WinAppDeployCmd deployfiles -file "C:\apps\App1\AppxManifest.xml" -remotedeploydir app1_F5 -ip 192.168.0.1
将应用注册在 IP 地址为 192.168.0.1 的电脑或 Xbox 的部署路径下的 app1_F5 目录。
WinAppDeployCmd registerfiles -remotedeploydir app1_F5 -ip 192.168.0.1
使用 WinAppDeployCmd 设置 Xbox One 上的从电脑运行部署。
从电脑运行使你无需复制二进制文件就可以将 UWP 应用程序部署到 Xbox One，而不是将这些二进制文件托管在 Xbox 所在同一网络的网络共享上。 为此，需要开发人员已解锁的 Xbox One 和 Xbox 可以访问的网络驱动器上的松散文件（即 UWP 应用程序）。
运行此命令注册应用：
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