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