共用方式為


使用 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