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 版本>\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>
您可以在目標裝置上安裝或卸載應用程式，也可以更新已安裝的應用程式。 若要保留已安裝的應用程式所儲存的數據或設定，請使用 更新 選項，而不是 安裝 選項。
下表描述 WinAppDeployCmd.exe的命令。
| 命令 | 說明 |
|---|---|
| 裝置 | 顯示可用的網路裝置清單。 |
| 安裝 | 將 UWP 應用程式套件安裝到目標裝置。 |
| 更新 | 更新已在目標裝置上安裝的UWP應用程式。 |
| 清單 | 顯示安裝在指定目標裝置上的 UWP 應用程式清單。 |
| 卸載 | 從目標裝置卸載指定的應用程式套件。 |
| deployfiles | 將位於目標路徑的鬆散檔案應用程式複製到裝置上的遠端相對路徑。 |
| 暫存器檔案 | 在遠端部署目錄中註冊獨立檔案應用程式。 |
| addcreds | 將認證新增至 Xbox，以允許它存取應用程式註冊的網路位置。 |
| getcreds | 從網路共用執行應用程式時，取得使用目標的網路認證。 |
| deletecreds | 當從網路共用執行應用程式時，刪除目標使用的網路憑證。 |
下表描述 WinAppDeployCmd.exe的選項。
| 命令 | 說明 |
|---|---|
| -h （-help） | 顯示命令、選項和自變數。 |
| -ip | 目標裝置的IP位址。 |
| -g （-guid） | 目標裝置的唯一標識碼。 |
| -d （-dependency） | （選擇性）指定每個套件相依性的路徑。 如果未指定路徑，此工具會在根目錄中搜尋應用程式套件和 SDK 目錄的相依性。 |
| -f （-file） | 要安裝、更新或卸載之應用程式套件的檔案路徑。 |
| -p （-package） | 要卸載之應用程式套件的完整套件名稱。 （您可以使用 list 命令來尋找裝置上已安裝之套件的完整名稱） |
| -針 | 如果需要與目標裝置建立連線，則需要提供PIN碼。 （如果需要驗證，系統會提示您使用 [-pin] 選項重試） |
| -credserver | 要供目標使用之網路認證的伺服器名稱。 |
| -credusername | 要供目標使用之網路認證的使用者名稱。 |
| -credpassword (憑證密碼) | 供目標使用的網路憑證密碼。 |
| -connecttimeout | 連接到設備時使用的逾時設定（以秒為單位）。 |
| -remotedeploydir | 將檔案複製到遠端裝置上的相對目錄路徑/名稱;這會是已知且自動決定的遠端部署資料夾。 |
| -deleteextrafile（刪除額外文件） | 切換以指出是否應該清除遠端目錄中的現有檔案，以符合來源目錄。 |
下表描述 WinAppDeployCmd.exe的選項。
| 引數 | 說明 |
|---|---|
| <x> | 以秒為單位的逾時。 （預設值為 10） |
| <位址> | 目標裝置的IP位址或唯一標識碼。 |
| <a><b>... | 每個應用程式套件相依項目的相依路徑。 |
| <p> | 裝置設定中顯示的英數字PIN碼，以建立連線。 |
| <路徑> | 檔案系統路徑。 |
| <名稱> | 要卸載之應用程式套件的完整套件名稱。 |
| <伺服器> | 檔案網路上的伺服器。 |
| <用戶名稱> | 具有檔案網路上伺服器存取權的認證使用者。 |
| <密碼> | 登入檔案網路上伺服器所需的認證密碼。 |
| <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裝置卸載指定的套件（根據其完整名稱）。 您可以使用 list 命令來查看安裝在裝置上之任何套件的完整名稱。
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