> ## Documentation Index > Fetch the complete documentation index at: https://docs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # Store Development Entitlements Tool (DevEntitlementTool.exe) > Outil en ligne de commande DevEntitlementTool.exe qui interroge, ajoute et supprime des droits Microsoft Store pour les comptes de test XBOX dans les bacs à sable de développement. Outil en ligne de commande permettant d'interroger, d'ajouter et de supprimer des droits Microsoft Store pour des comptes de test XBOX dans un bac à sable. ## Utilisation `deventitlementtool /e /s [/p ] [...]` | Commande | Description | | - | - | | [query](#query) | Recherche les droits détenus par un compte | | [add](#add) | Ajoute un ou plusieurs droits spécifiés au compte | | [delete](#delete) | Supprime un ou plusieurs droits spécifiés du compte | | [catalog](#catalog) | Affiche les produits disponibles pouvant être vendus par le produit parent spécifié | Toutes les commandes nécessitent les paramètres /e (adresse courriel) et /s (bac à sable). La première connexion avec un compte ouvre une boîte de dialogue interactive de saisie du mot de passe. Une fois la connexion réussie, les opérations suivantes avec le même compte et le même bac à sable sur l'appareil ne nécessitent plus la saisie du mot de passe. ## query `deventitlementtool query /e /s [/d]` Répertorie tous les droits détenus directement et associés à ce compte dans le bac à sable. ### Sortie de query ```text theme={null} Entitlements found: {Number of entitlements} {ProductID}: {Last Updated Date (UTC)} {Status} ... ``` ### Exemple de query ```text theme={null} > 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 ``` Utilisez /d pour afficher davantage de détails sur chaque droit : ```text theme={null} > 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 /s /p [ ...] [/q ] [/d]` Ajoute au compte un droit pour un ou plusieurs produits spécifiés. Cette commande équivaut à l'achat du produit depuis le Store ou par l'API d'achat. L'opération `add` sur un jeu, un produit durable, un bundle ou un consommable géré par le développeur pour lequel le compte détient déjà un droit n'ajoute pas de nouveau droit, et l'outil signale le droit existant. Pour les produits consommables gérés par le Store, une quantité par défaut de `1` est ajoutée au solde du consommable à chaque commande add. Une valeur de quantité facultative peut être spécifiée pour modifier cette valeur par défaut, mais le champ de quantité ne peut être utilisé que si un seul productID est passé avec /p. Cette option est utile pour les consommables qui accordent une quantité supérieure à `1` lors de l'achat. L'option /d pour plus de détails est prise en charge. \[!NOTE] La quantité n'est pas vérifiable avec cet outil. Pour déterminer la quantité actuelle d'un article, examinez la structure [XStoreCollectionData](https://docs.xbox.com/fr-CA/reference/system/xstore/structs/xstorecollectiondata.md). L'opération `add` sur un produit de type bundle accorde tous les produits qu'il inclut. Si une quantité est spécifiée et que le bundle inclut des consommables gérés par le Store, la même quantité est attribuée à chaque consommable. > [!NOTE] > > Les produits d'abonnement ne sont pas pris en charge. ### Sortie de add ```console theme={null} Entitlements added: {Number of entitlements} {ProductID}: {Last Updated Date (UTC)} {Status} ... ``` ### Exemples de add Ajout d'un seul droit ```console theme={null} > 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 ``` Ajout de plusieurs droits ```console theme={null} > DevEntitlementTool.exe add /e xdks-test00000@xboxtest.com /s XDKS.1 /p 9P23V43P0XZZ 9N30KZZF4BR9 9NCX1H100M18 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 ``` Ajout d'un consommable avec une quantité ```console theme={null} > 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 /s /p [ ...] [/all] [/d]` Supprime un ou plusieurs droits spécifiés du compte. Si `/all` est spécifié, l'outil tente de supprimer tous les droits associés au compte et au bac à sable. L'état Revoked s'affiche lors de la suppression de droits accordés par cet outil. L'état Refunded s'affiche lors de la suppression de droits achetés de façon classique par le client du Store ou l'API en jeu. L'option /d pour plus de détails est prise en charge. ### Sortie de delete ```console theme={null} Entitlements deleted: {Number of entitlements} {ProductID}: {Last Updated Date (UTC)} {Status} ... ``` ### Exemples de delete ```console theme={null} > 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 ``` ```console theme={null} > 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 /s /p [/m]` Affiche l'ensemble des produits pouvant être vendus par l'ID de produit fourni, c'est-à-dire les produits complémentaires enfants et les produits ayant une relation *can use and sell* avec le productID dans Partner Center. Cette commande retourne l'équivalent de [XStoreQueryAssociatedProductsAsync](https://docs.xbox.com/fr-CA/reference/system/xstore/functions/xstorequeryassociatedproductsasync.md). Les produits configurés dans Partner Center comme *available but not discoverable in the Microsoft Store* ne sont pas retournés. Vous pouvez éventuellement spécifier un marché pour récupérer les prix de ce marché particulier. Le paramètre doit être un code de région ISO à deux caractères, par exemple GB, CA, JP, ES, etc. ### Sortie de catalog ```console theme={null} 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} ... ``` ### Exemple de catalog ```console theme={null} > 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 ``` ## Remarques Cet outil est strictement réservé aux comptes de test XBOX et aux produits de bac à sable. Son utilisation pour des comptes et des scénarios RETAIL est bloquée. Le nombre d'opérations add et delete par compte et par jour est limité. Cette limite est ajustée en fonction de l'utilisation observée. Pour demander une augmentation des limites ou faire part d'autres commentaires, communiquez avec votre représentant de compte Microsoft. ## Documentation de référence de l'API * [XStore (contenu de l'API)](https://docs.xbox.com/fr-CA/reference/system/xstore/xstore_members.md) * Fonctions * [XStoreQueryAssociatedProductsAsync](https://docs.xbox.com/fr-CA/reference/system/xstore/functions/xstorequeryassociatedproductsasync.md) * Structures * [XStoreCollectionData](https://docs.xbox.com/fr-CA/reference/system/xstore/structs/xstorecollectiondata.md) ## Related topics - [XStoreCollectionData](https://docs.xbox.com/fr-CA/reference/system/xstore/structs/xstorecollectiondata.md) - [XStoreQueryAssociatedProductsAsync](https://docs.xbox.com/fr-CA/reference/system/xstore/functions/xstorequeryassociatedproductsasync.md) - [Outils de développement pour les services XBOX](https://docs.xbox.com/fr-CA/tools/tools-services/live-tools.md) - [Outils pour les services XBOX](https://docs.xbox.com/fr-CA/tools/tools-services/live-tools-nav.md) - [Consume Microsoft Store Entitlements](https://docs.xbox.com/api-reference/platform-specific-methods/consume-microsoft-store-entitlements.md)