> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 管理套件 (wdapp.exe)
> 管理套件 (wdapp.exe)
使用此工具在通用 Windows 平台 (UWP) 裝置上註冊新位置、變更處理序生命週期管理 (PLM) 狀態、移除套件，以及操作套件的設定。
| 命令 | 描述 |
| - | - |
| [registernetworkshare](#wdapp_registernetworkshare) | 註冊位於網路共用資料夾中的應用程式 |
| [verifynetworkshare](#wdapp_verifynetworkshare) | 驗證網路共用的讀取存取權 |
| [registerscratch](#wdapp_registerscratch) | 從暫存磁碟機註冊套件 |
| [registertitlescratch](#wdapp_registertitlescratch) | 從遊戲暫存磁碟機註冊套件 |
| [launch](#wdapp_launch) | 啟動應用程式 |
| [query](#wdapp_query) | 查詢已安裝套件或應用程式的執行狀態 |
| [terminate](#wdapp_terminate) | 終止指定套件中的所有應用程式 |
| [suspend](#wdapp_suspend) | 模擬暫停應用程式 |
| [register](#wdapp_register) | 註冊應用程式 |
| [unregister](#wdapp_unregister) | 取消註冊應用程式 |
| [registerdrive](#wdapp_registerdrive) | 註冊磁碟機上的所有應用程式 |
| [list](#wdapp_list) | 列出應用程式 |
| [move](#wdapp_move) | 移動應用程式 |
| [copy](#wdapp_copy) | 複製應用程式 |
| [movedrive](#wdapp_movedrive) | 移動磁碟機上的所有應用程式 |
| [copydrive](#wdapp_copydrive) | 複製磁碟機上的所有應用程式 |
| [install](#wdapp_install) | 安裝封裝組建 |
| [uninstall](#wdapp_uninstall) | 解除安裝應用程式 |
| [applyconfig](#wdapp_applyconfig) | 以指定的設定啟動 Game OS |
| [queryconfig](#wdapp_queryconfig) | 列印執行中 Game OS 的四段式版本號碼 |
| [collectxip](#wdapp_collectxip) | 收集 XIP 追蹤 |
| [queryversioninfo](#wdapp_queryversioninfo) | 查詢指定套件的 Game OS 版本 |
| [overlayfolder](#wdapp_overlayfolder) | 處理覆疊資料夾作業 |
## wdapp registernetworkshare
註冊位於網路共用資料夾中的應用程式。
`wdapp registernetworkshare [Username] [Password]`
| 選項 | 描述 |
| - | - |
| `Network Path` | 網路共用的路徑。 |
| `Username` | 存取網路共用的使用者名稱。 |
| `Password` | 存取網路共用的密碼。 |
| `Verify` | 開啟網路位置中的檔案以驗證它們是否都能讀取。 |
## wdapp verifynetworkshare
驗證網路共用資料夾的讀取存取權。
`wdapp verifynetworkshare `
| 選項 | 描述 |
| - | - |
| `Network Path` | 網路共用的路徑。 |
## wdapp registerscratch
註冊位於暫存磁碟機上的應用程式。
`wdapp registerscratch `
| 選項 | 描述 |
| - | - |
| `Relative folder path` | 應用程式的相對路徑。 |
## wdapp registertitlescratch
註冊位於遊戲暫存磁碟機上的應用程式。
`wdapp registertitlescratch `
| 選項 | 描述 |
| - | - |
| `Relative folder path` | 應用程式的相對路徑。 |
## wdapp launch
啟動指定的應用程式。如果提供了可執行檔的路徑，則會視需要在啟動前註冊應用程式。
`wdapp launch [/WaitToExit [:timeoutInSeconds]] `
| 選項 | 描述 |
| - | - |
| `AUMID` | 要啟動之應用程式的應用程式使用者模型識別碼 (AUMID)。 |
| `exe` | 遊戲可執行檔。 |
| `uri` | 已註冊之自訂通訊協定或以遊戲為基礎之通訊協定的 URI，指定要啟動的遊戲以及要傳遞給遊戲的任何引數。例如，如果您的遊戲 ID 是 12345abcd，則可以使用以遊戲為基礎的通訊協定，以 URI ms-xbl-12345abcd://default 啟動您的產品。 |
| `unregv2:\{InstanceId}\{PackageAlias}\{AUMID}` | unregv2 可啟動與其他共用相同 ContentID 的套件並存安裝的未註冊套件。使用 wdapp list /d /u 取得 instanceID 與 PackageAlias 值 |
| WaitToExit \[:timeoutInSeconds] | 啟動應用程式並封鎖，直到遊戲結束為止。遊戲結束時，xbapp 接著會結束並傳回遊戲的結束代碼。選擇性的 timeoutInSeconds 引數可用來強制結束。如果在遊戲結束前達到逾時，則會傳回 "The user specified /WaitToExit timeout was exceeded before the game exited."。 |
## wdapp query
查詢已安裝套件或應用程式的執行狀態。
`wdapp query `
| 選項 | 描述 |
| - | - |
| `pfn` | 套件的套件完整名稱。 |
## wdapp terminate
終止指定套件中的所有應用程式。
`wdapp terminate`
`wdapp terminate `
| 選項 | 描述 |
| - | - |
| `pfn` | (選擇性) 套件的套件完整名稱。 |
## wdapp suspend
模擬暫停指定套件中的所有應用程式。
`wdapp suspend`
`wdapp suspend `
| 選項 | 描述 |
| - | - |
| `pfn` | (選擇性) 套件的套件完整名稱。 |
## wdapp register
註冊位於指定磁碟機上的指定應用程式。
`wdapp register `
| 選項 | 描述 |
| - | - |
| `pfn` | 套件的套件完整名稱。 |
| `drive` | 要註冊套件的磁碟機。 |
| `PackageAlias` | 您要安裝之套件的別名。安裝多個具有相同 ContentID 的套件時需要此參數。 |
## wdapp unregister
取消註冊指定的應用程式。
`wdapp unregister `
| 選項 | 描述 |
| - | - |
| `pfn` | 套件的套件完整名稱。 |
## wdapp registerdrive
註冊指定磁碟機上目前所有未註冊的應用程式。
`wdapp registerdrive `
| 選項 | 描述 |
| - | - |
| `drive` | 要註冊套件的磁碟機。 |
## wdapp list
列出所有應用程式，或指定各種旗標以控制要列舉哪些應用程式。
`wdapp list [/unregistered] [/system] [/detail] [/drive=] [/JSON]`
| 選項 | 描述 |
| - | - |
| `unregistered` | 列舉未註冊的應用程式。 |
| `system` | 列舉系統應用程式。 |
| `detail` | |
| `drive` | 要列舉應用程式的磁碟機。 |
| `JSON` | 只列印包含套件資訊的 JSON Blob |
## wdapp move
將應用程式移至不同的磁碟機。
`wdapp move [new folder name]`
| 選項 | 描述 |
| - | - |
| `pfn` | 套件的套件完整名稱。 |
| `destination drive` | 要將應用程式移至的磁碟機。 |
| `new folder name` | 要將應用程式移至的資料夾。 |
## wdapp copy
將應用程式複製到不同的磁碟機。
`wdapp copy [new folder name]`
| 選項 | 描述 |
| - | - |
| `pfn` | 套件的套件完整名稱。 |
| `destination drive` | 要將應用程式複製到的磁碟機。 |
| `new folder name` | 要將應用程式複製到的資料夾。 |
## wdapp movedrive
將所有應用程式從一個磁碟機移至另一個磁碟機。
`wdapp movedrive `
| 選項 | 描述 |
| - | - |
| `source drive` | 要從中移動應用程式的磁碟機。 |
| `destination drive` | 要將應用程式移至的磁碟機。 |
## wdapp copydrive
將所有應用程式從一個磁碟機複製到另一個磁碟機。
`wdapp copydrive `
| 選項 | 描述 |
| - | - |
| `source drive` | 要從中複製應用程式的磁碟機。 |
| `destination drive` | 要將應用程式複製到的磁碟機。 |
## wdapp install
從網頁伺服器、網路共用或本機系統檔案路徑將封裝組建串流至主機。
`wdapp install [/oddsim] [/drive=] [/=] [/PackageAlias:]`
| 選項 | 描述 |
| - | - |
| `package filepath` | |
| `oddsim` | |
| `drive` | |
| `tags` | |
| `PackageAlias` | 使用 PackageAlias 可並存安裝具有相同 ContentID 的套件。別名是實體套件位置。此別名值應只對此套件的這一個執行個體保持全域唯一。 |
## wdapp uninstall
解除安裝指定的應用程式。使用選擇性的 PackageAlias 與 InstanceID (使用 wdapp list /d 取得) 可解除安裝目前未註冊的已安裝套件。
`wdapp uninstall `
| 選項 | 描述 |
| - | - |
| `pfn` | 應用程式的套件完整名稱。根據預設，這會解除安裝目前已註冊的遊戲 |
## wdapp applyconfig
啟動指定的 Game OS、啟動 game.config 檔案所指定的 Game OS，或以預設設定啟動最近使用的 Game OS。
`wdapp applyconfig [game.config | gameos.xvd]`
| 選項 | 描述 |
| - | - |
| `game.config` | 用來指定要啟動之 Game OS 的 game.config 檔案。 |
| `gameos.xvd` | 要啟動的 Game OS。 |
## wdapp installkey
從網路共用或本機系統檔案路徑將指定的主機 EKB (CEKB) 安裝至主機。
`wdapp installkey [ekb filepath]`
| 選項 | 描述 |
| - | - |
| `ekb filepath` | 對遊戲執行 makepkg.exe 時產生的 EKB 檔案。 |
## wdapp queryconfig
列印執行中 Game OS 的四段式版本號碼。如果沒有 Game OS 在執行，則會傳回錯誤。
`wdapp queryconfig`
## wdapp collectxip
如果 XBOX One ERA 正在執行，則收集 XIP 追蹤，並將目前的追蹤以 `