使用方法
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]
指定した 1 つ以上の製品のエンタイトルメントをアカウントに追加します。
このコマンドは、Store または購入 API を通じて製品を購入することと同等です。
既にエンタイトルされている Game、Durable、Bundle、または開発者管理型 (Developer-Managed) の Consumable に対する add 操作は、別のエンタイトルメントを追加せず、既存のエンタイトルメントを報告します。
Store 管理型 Consumable 製品の場合、各 add コマンドで既定の数量 1 が Consumable 残高に追加されます。
この既定値を変更するためにオプションで数量値を指定できますが、数量フィールドは /p で 1 つの productID が渡された場合にのみ使用できます。
このオプションは、購入時に 1 より大きい数量を付与する Consumable に役立ちます。
/d の詳細表示もサポートされています。
このツールでは数量を確認できません。
add 操作では、その Bundle に含まれるすべての製品が付与されます。
数量が指定され、Bundle に Store 管理型 Consumable が含まれている場合、各 Consumable に同じ数量が割り当てられます。
サブスクリプション製品はサポートされていません。
add の出力
add の例
単一のエンタイトルメントを追加delete
deventitlementtool delete /e <testaccountemail> /s <sandboxid> /p <productid1> [<productid2> <productid3> ...] [/all] [/d]
指定した 1 つ以上のエンタイトルメントをアカウントから削除します。
/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 が返すものと同等です。
パートナー センターで Microsoft Store で利用可能だが検出できない (available but not discoverable in the Microsoft Store) として構成されている製品は返されません。
オプションでマーケットを指定して、その特定のマーケットの価格を取得できます。
このパラメーターは、GB、CA、JP、ES など、ISO の 2 文字リージョン コードである必要があります。