跳轉到主要內容
用於查詢、新增與移除沙箱中 XBOX 測試帳戶之 Microsoft Store 權利的命令列工具。

使用方式

deventitlementtool <command> /e <testaccountemail> /s <sandboxid> [/p <productid>] [...] 所有命令都需要 /e (電子郵件) 與 /s (沙箱) 參數。 首次以帳戶登入時,會叫用互動式密碼輸入對話方塊。 成功登入後,在該裝置上以相同帳戶/沙箱進行的後續作業就不再需要輸入密碼。

query

deventitlementtool query /e <testaccountemail> /s <sandboxid> [/d] 列出此帳戶在沙箱中直接擁有的所有權利。

query 輸出

query 範例

使用 /d 顯示每項權利的更多詳細資料:

add

deventitlementtool add /e <testaccountemail> /s <sandboxid> /p <productid1> [<productid2> <productid3> ...] [/q <quantity>] [/d] 將一或多個指定產品的權利新增至帳戶。 此命令等同於從 Store 或透過購買 API 購買產品。 對已具備權利的遊戲、耐久性商品、組合包或開發人員管理的消耗性商品執行 add 作業時,不會新增另一項權利,此工具會回報現有的權利。 對於 Store 管理的消耗性產品,每次執行 add 命令都會在消耗性商品餘額中新增預設數量 1。 您可以指定選用的數量值來變更此預設值,但只有在以 /p 傳遞單一 productID 時才能使用數量欄位。 此選項適用於購買時授與大於 1 之數量的消耗性商品。 支援使用 /d 顯示更多詳細資料。
此工具無法驗證數量。
若要判斷項目的目前數量,請檢查 XStoreCollectionData 結構。
對組合包產品執行 add 作業會授與其包含的所有產品。 如果指定了數量且組合包包含 Store 管理的消耗性商品,則會為每個消耗性商品指派相同的數量。
不支援訂閱產品。

add 輸出

add 範例

新增單一權利
新增多項權利
以指定數量新增消耗性商品

delete

deventitlementtool delete /e <testaccountemail> /s <sandboxid> /p <productid1> [<productid2> <productid3> ...] [/all] [/d] 從帳戶刪除一或多個指定的權利。 如果指定 /all,則會嘗試刪除與該帳戶及沙箱相關聯的所有權利。 刪除由此工具授與的權利時,會顯示 Revoked 狀態。 刪除透過 Store 用戶端或遊戲內 API 以一般方式購買的權利時,會顯示 Refunded 狀態。 支援使用 /d 顯示更多詳細資料。

delete 輸出

delete 範例

catalog

deventitlementtool catalog /e <testaccountemail> /s <sandboxid> /p <productid1> [/m] 顯示所提供之產品 ID 可銷售的產品集合;也就是子附加元件產品,以及在 Partner Center 中與該 productID 具有 can use and sell 關聯性的產品。 此命令的結果等同於 XStoreQueryAssociatedProductsAsync 所傳回的內容。 在 Partner Center 中設定為 available but not discoverable in the Microsoft Store 的產品不會傳回。 您可以選擇性地指定市場,以擷取該特定市場的價格。 此參數必須是 ISO 雙字元區域代碼,例如 GB、CA、JP、ES 等。

catalog 輸出

catalog 範例

備註

此工具僅限用於 XBOX 測試帳戶與沙箱產品。 已封鎖用於零售帳戶與情境。 每個帳戶每天的 add 與 delete 作業次數有上限。 此上限會根據觀察到的使用情形進行調整。 若要要求提高上限或提供其他意見反應,請透過您的 Microsoft 帳戶代表聯絡。

參考 API 文件

最後修改於 2026年10月20日