使用方式
deventitlementtool <command> /e <testaccountemail> /s <sandboxid> [/p <productid>] [...]
所有命令都需要 /e (電子郵件) 與 /s (沙箱) 參數。
首次以帳戶登入時,會叫用互動式密碼輸入對話方塊。
成功登入後,在該裝置上以相同帳戶/沙箱進行的後續作業就不再需要輸入密碼。
query
deventitlementtool query /e <testaccountemail> /s <sandboxid> [/d]
列出此帳戶在沙箱中直接擁有的所有權利。
query 輸出
query 範例
add
deventitlementtool add /e <testaccountemail> /s <sandboxid> /p <productid1> [<productid2> <productid3> ...] [/q <quantity>] [/d]
將一或多個指定產品的權利新增至帳戶。
此命令等同於從 Store 或透過購買 API 購買產品。
對已具備權利的遊戲、耐久性商品、組合包或開發人員管理的消耗性商品執行 add 作業時,不會新增另一項權利,此工具會回報現有的權利。
對於 Store 管理的消耗性產品,每次執行 add 命令都會在消耗性商品餘額中新增預設數量 1。
您可以指定選用的數量值來變更此預設值,但只有在以 /p 傳遞單一 productID 時才能使用數量欄位。
此選項適用於購買時授與大於 1 之數量的消耗性商品。
支援使用 /d 顯示更多詳細資料。
此工具無法驗證數量。
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 等。
