命令行工具，用于向沙盒中的 Xbox 测试帐户查询、添加和删除 Microsoft Store 权限。
用法
deventitlementtool <command> /e <testaccountemail> /s <sandboxid> [/p <productid>] [...]
| 命令 | 说明 |
|---|---|
| query | 查找帐户拥有的权益 |
| add | 将指定的权利添加到帐户 |
| delete | 从帐户中删除指定权利 |
| 目录 | 显示指定父产品可销售的可用产品 |
所有命令都需要 /e (电子邮件) 和 /s (沙盒) 参数。 使用帐户的初始登录将调用交互式密码输入对话框。 成功登录后，在设备上使用相同帐户/沙盒进行的后续操作将不再需要输入密码。
query
deventitlementtool query /e <testaccountemail> /s <sandboxid> [/d]
在沙盒中列出与此帐户关联的所有直接拥有权利。
查询输出
Entitlements found: {Number of entitlements}
{ProductID}: {Last Updated Date (UTC)} {Status}
...
查询示例
> DevEntitlementTool.exe query /e xdks-testaccount00000@xboxtest.com /s XDKS.1
Entitlements found: 2
9MT5TGW893HV: 4/18/2023 5:05:19 PM Active
9N30KZZF4BR9: 7/24/2024 2:34:08 AM Active
使用 /d 显示每个权利的更多详细信息：
> DevEntitlementTool.exe query /e xdks-testaccount00000@xboxtest.com /s XDKS.1 /d
Entitlements found: 2
9MT5TGW893HV: 4/18/2023 5:05:19 PM Active Consumable ATG Sample Consumable 3
9N30KZZF4BR9: 7/24/2024 2:34:08 AM Active Durable ATG Sample Durable 1
add
deventitlementtool add /e <testaccountemail> /s <sandboxid> /p <productid1> [<productid2> <productid3> ...] [/q <quantity>] [/d]
将指定产品的权利添加到帐户中。 这相当于从 Store 或通过购买 API 购买产品。
对于游戏、耐用品、捆绑销售和开发人员管理的易耗品，如果尝试在已授权产品上添加（或数量为 1），它将报告现有授权；没有添加新的权利或数量。
对于 Store 管理的易耗品，每次添加命令都会将默认数量 1 添加到易耗品余额中。 可以指定可选的数量值来更改此默认值，但只有在使用 /p 传递单个 productID 时，才能使用“数量”字段。 这对于购买时授予数量大于 1 的易耗品非常有用。
支持 /d 了解更多详细信息。
注意
数量无法使用此工具进行验证。 检查 XStoreCollectionData 结构以确定数量。
添加捆绑销售将授予其包含的所有产品。 如果指定了数量，并且捆绑销售中包括 Store 管理的易耗品，则将为每个易耗品分配相同的数量。
注意
不支持订阅产品。
添加输出
Entitlements added: {Number of entitlements}
{ProductID}: {Last Updated Date (UTC)} {Status}
...
添加示例
添加了单一权利
> DevEntitlementTool.exe add /e xdks-test00000@xboxtest.com /s XDKS.1 /p 9MT5TGW893HV
Entitlements added: 1
9MT5TGW893HV: 2/20/2024 12:21:25 AM Active
添加了多项权利
> DevEntitlementTool.exe add /e xdks-test00000@xboxtest.com /s XDKS.1 /p 9P23V43P0XZZ 9N30KZZF4BR9 9NCX1H100M18 9NQWJKKNHF1L
Entitlements added: 4
9P23V43P0XZZ: 2/20/2024 12:33:20 AM Active
9N30KZZF4BR9: 2/20/2024 12:33:20 AM Active
9NCX1H100M18: 2/20/2024 12:33:20 AM Active
9NQWJKKNHF1L: 2/20/2024 12:33:20 AM Active
添加带数量的易耗品
> DevEntitlementTool.exe add /e xdks-test00000@xboxtest.com /s XDKS.1 /p 9MT5TGW893HV /q 4321
Entitlements added: 1
9MT5TGW893HV: 2/20/2024 12:34:35 AM Active
delete
deventitlementtool delete /e <testaccountemail> /s <sandboxid> /p <productid1> [<productid2> <productid3> ...] [/all] [/d]
从帐户中删除指定的权利。
如果指定了 /all，它将尝试删除与帐户和沙箱关联的所有权利。
将显示“已撤销”状态，用于删除此工具授予的权利。
删除通过 Store 客户端或游戏中 API 常规购买的权利将显示退款状态。
支持 /d 了解更多详细信息。
删除输出
Entitlements deleted: {Number of entitlements}
{ProductID}: {Last Updated Date (UTC)} {Status}
...
删除示例
> DevEntitlementTool.exe delete /e xdks-test00000@xboxtest.com /s XDKS.1 /p 9P23V43P0XZZ 9N30KZZF4BR9 9NCX1H100M18
Entitlements deleted: 3
9P23V43P0XZZ: 2/20/2024 2:26:13 AM Revoked
9N30KZZF4BR9: 2/20/2024 2:26:13 AM Revoked
9NCX1H100M18: 2/20/2024 2:26:13 AM Revoked
> DevEntitlementTool.exe delete /e xdks-test00000@xboxtest.com /s XDKS.1 /p 9PLRFWZWWF91
Entitlements deleted: 1
9PLRFWZWWF91: 1/1/0001 12:00:00 AM Refunded
目录
deventitlementtool catalog /e <testaccountemail> /s <sandboxid> /p <productid1> [/m]
按提供的产品 ID 显示可销售的产品集；即子附加内容产品和与合作伙伴中心中的 productID 具有可使用和销售关系的产品。 此命令等效于 XStoreQueryAssociatedProductsAsync 返回的命令。 此命令不会返回在合作伙伴中心中配置为可用但在 Microsoft Store 中无法发现的产品。 （可选）可以指定市场来检索该特定市场的价格。 这需要 ISO 2 个字符的国家/地区代码，例如 GB、CA、JP、ES 等。
目录输出
Parent product: {ProductID} ({Parent Product Name})
can sell {Number of products} products:
1. {ProductID} {Product Name} {Product Type} {Price}
2. {ProductID} {Product Name} {Product Type} {Price}
...
目录示例
> DevEntitlementTool.exe catalog /e xdks-test00000@xboxtest.com /s XDKS.1 /p 9NTL0QDWZ4FS /m SG
Parent product: 9NTL0QDWZ4FS (ATG In-Game Store)
can sell 16 products:
1. 9PHPTTDP88F7: ATG Season Pass 1 Durable 23.25 SGD
2. 9NMDDZC7ZWRM: ATG Sample Year 1 Pass Durable 2850 SGD
3. 9PGLXLWS7319: ATG Consumable Only Bundle Durable 7.2 SGD
4. 9P23V43P0XZZ: ATG Sample Durable 2 Durable 0 SGD
5. 9MZ0MGGFPLTP: ATG Sample Subscription 1 Durable 0 SGD
6. 9MT5TGW893HV: ATG Sample Consumable 3 Consumable 4.35 SGD
7. 9N30KZZF4BR9: ATG Sample Durable 1 Durable 0 SGD
8. 9PLRFWZWWF91: ATG Sample Durable 4 Durable 0 SGD
9. 9PLNMXRKNM4C: ATG Sample Durable 1 (with package) Durable 0 SGD
10. 9P8S15PJTB0P: ATG Sample Durable 3 Durable 48.75 SGD
11. 9NCX1H100M18: ATG Sample Consumable 2 Consumable 2.85 SGD
12. 9N0297GK108W: ATG Dev managed consumable 1 Consumable 2.1 SGD
13. 9NQWJKKNHF1L: ATG Downloadable Content Sample Game 0 SGD
14. 9NRGW2QG5PCW: ATG Sample Pre-Order 1 Durable 0 SGD
15. 9PHHWZ12RR23: ATG In-Game Store Deluxe Add-on Durable 0 SGD
16. 9PFL4RQTB1P6: ATG Sample Consumable 1 Consumable 1.5 SGD
备注
此工具严格用于 Xbox 测试帐户和沙盒产品。 阻止用于零售帐户和方案。
每个帐户每天有添加和删除操作的限制。 这将根据观察到的使用情况进行调整。 请联系 Microsoft帐户代表，请求提高限额。