用法
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 购买该产品。
对已授予权利的游戏、Durable、Bundle 或开发者管理的消耗品执行 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 可销售的产品集;即子插件产品以及在合作伙伴中心中与 productID 具有 can use and sell 关系的产品。
此命令等效于 XStoreQueryAssociatedProductsAsync 返回的内容。
在合作伙伴中心中配置为 available but not discoverable in the Microsoft Store(可用但在 Microsoft Store 中不可发现)的产品不会返回。
可选地,可以指定市场以检索该特定市场的价格。
该参数需要是 ISO 双字符区域代码,例如 GB、CA、JP、ES 等。