Store Development Entitlements Tool (DevEntitlementTool.exe)

[アーティクル]
11/06/2024

サンドボックス内の Xbox テストアカウントで Microsoft Store エンタイトルメントを照会、追加、削除するためのコマンドラインツール。

使用方法

deventitlementtool <command> /e <testaccountemail> /s <sandboxid> [/p <productid>] [...]

コマンド	説明
query	アカウントが所有する権利を検索する
add	指定した権利をアカウントに追加する
delete	アカウントから指定した権利を削除する
catalog	指定された親製品によって販売可能な利用可能な製品を表示する

すべてのコマンドには、/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 を使用して製品を購入する場合と同じです。

Game、Durable、Bundle、および Dev-Managed コンシューマブル製品の場合、既に資格のある製品 (または数量が 1) に対して追加が試行された場合、既存の権利が報告されます。新しい権利または数量は追加されません。

ストアで管理されるコンシューマブル製品の場合、各 add コマンドで消費型の残高に既定の数量 1 が追加されます。オプションの数量値を指定してこの既定値を変更できますが、数量フィールドは、単一の productID が /p で渡された場合にのみ使用できます。これは、購入時に数量が 1 を超える消耗品に役立ちます。

詳細については/d がサポートされています。

注意

数量は、このツールでは検証できません。 XStoreCollectionData 構造体を調べて数量を決定します。

バンドルである製品を追加すると、含まれるすべての製品が付与されます。数量が指定され、バンドルにストアで管理される消耗品が含まれている場合、各消耗品に同じ数量が割り当てられます。

注意

サブスクリプション製品はサポートされていません。

出力を追加する

Entitlements added: {Number of entitlements}
{ProductID}: {Last Updated Date (UTC)} {Status}
...

例を追加する

1 つのエンタイトルメントが追加されました

> 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が指定されている場合、アカウントとサンドボックスに関連付けられているすべてのエンタイトルメントの削除が試行されます。

このツールによって付与された権利を削除すると、取り消された状態が表示されます。

ストアクライアントまたはゲーム内 API を通じて従来購入された権利を削除すると、払い戻された状態が表示されます。

詳細については/d がサポートされています。

出力を削除する

Entitlements deleted: {Number of entitlements}
{ProductID}: {Last Updated Date (UTC)} {Status}
...

delete の例

> 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

catalog

deventitlementtool catalog /e <testaccountemail> /s <sandboxid> /p <productid1> [/m]

指定された製品 ID で販売可能な製品のセットを表示します。つまり、パートナーセンターの productID との関係を 使用および販売できる 子アドオン製品と製品。このコマンドは、 XStoreQueryAssociatedProductsAsync によって返されるコマンドと同じです。パートナーセンターで使用可能として構成されている が、Microsoft Store で検出できない 製品は、このコマンドでは返されません。必要に応じて、その特定の市場の価格を取得するために市場を指定できます。これは、GB、CA、JP、ES など、ISO 2 文字の国コードである必要があります。

カタログ出力

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 テストアカウントとサンドボックス製品に対して厳密に使用されます。小売アカウントとシナリオの使用がブロックされています。

アカウントごとに 1 日あたりの追加操作と削除操作には制限があります。これは、観察された使用状況に基づいて調整されます。制限の引き上げを求める場合は、Microsoft アカウント担当者にお問い合わせください。

次の方法で共有