使用 WinAppDeployCmd.exe 工具安裝應用程式

Windows 應用程式部署 (WinAppDeployCmd.exe) 是一個命令列工具，可以用來從 Windows 10 電腦將通用 Windows 平台 (UWP) 應用程式部署到任何 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 版本>\x86\WinAppDeployCmd.exe (根據您的 SDK 安裝路徑)。

注意

在 SDK 15063 和更新版本，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 應用程式。
清單	顯示已安裝在指定的目標裝置上的 UWP 應用程式清單。
解除安裝	從目標裝置解除安裝指定的應用程式套件。
deployfiles	將位於目標路徑的鬆散檔案應用程式複製到遠端裝置上的相對路徑。
registerfiles	在遠端部署目錄註冊鬆散檔案應用程式。
addcreds	將認證新增到 Xbox 以允許它存取應用程式註冊的網路位置。
getcreds	取得目標從網路共用執行應用程式時所使用的網路認證。
deletecreds	刪除目標從網路共用執行應用程式時所使用的網路認證。

下表描述 WinAppDeployCmd.exe 的選項。

命令	說明
-h (-help)	顯示命令、選項和引數。
-ip	目標裝置的 IP 位址。
-g (-guid)	目標裝置的唯一識別碼。
-d (-dependency)	(選擇性) 指定每個套件相依性的相依性路徑。 如果未指定路徑，工具會在應用程式套件和 SDK 目錄的根目錄中搜尋相依性。
-f (-file)	要安裝、更新或解除安裝的應用程式套件檔案路徑。
-p (-package)	要解除安裝的應用程式套件的完整套件名稱。 (您可以使用清單命令來尋找已安裝在裝置上的套件完整名稱。)
-pin	如果與目標裝置建立連線需要的 PIN。 (如果需要驗證，系統會提示您使用 -pin 選項重試。)
-credserver	目標使用之網路認證的伺服器名稱。
-credusername	目標使用之網路認證的使用者名稱。
-credpassword	目標使用之網路認證的密碼。
-connecttimeout	連線到裝置時的逾時 (以秒為單位)。
-remotedeploydir	相對目錄路徑/名稱，檔案將複製到遠端裝置上的這個位置。這是已知且自動決定的遠端部署資料夾。
-deleteextrafile	切換來指示是否要清除遠端目錄中的現有檔案以符合來源目錄。

下表描述 WinAppDeployCmd.exe 的選項。

Argument	說明
<x>	逾時 (秒)。 (預設值為 10)
<address>	目標裝置的 IP 位址或唯一識別碼。
<a><b> ...	每個應用程式套件相依性的相依性路徑。
<p>	裝置設定中顯示用於建立連線的英數字元 PIN。
<path>	檔案系統路徑。
<name>	要解除安裝之應用程式套件的完整套件名稱。
<伺服器>	檔案網路上的伺服器。
<username>	具有檔案網路上伺服器存取權限之認證的使用者名稱。
<password>	具有檔案網路上伺服器存取權限之認證的密碼。
<remotedeploydir>	裝置上相對於部署位置的目錄

WinAppDeployCmd.exe 範例

以下列出一些有關如何從命令列使用 WinAppDeployCmd.exe 語法來部署的範例。

顯示可供部署的裝置。 命令會在 3 秒後逾時。

WinAppDeployCmd devices 3

將您電腦上 Downloads 目錄下 MyApp.appx 套件中的應用程式安裝到 IP 位址 192.168.0.1 的 Windows 10 裝置，並使用 PIN 值 A1B2C3 與裝置建立連線。

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 上；從和 AppxManifest 相同的資料夾，部署到該裝置部署路徑下的 app1_F5 目錄。

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

在位於 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