> ## Documentation Index > Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # Store 개발 자격 도구 (DevEntitlementTool.exe) > 개발 샌드박스의 XBOX 테스트 계정에 대한 Microsoft Store 사용 권한을 조회, 추가, 제거하는 명령줄 DevEntitlementTool.exe 도구입니다. 샌드박스에서 XBOX 테스트 계정에 Microsoft Store 자격을 쿼리, 추가 및 제거하는 명령줄 도구입니다. ## 사용법 `deventitlementtool /e /s [/p ] [...]` | 명령 | 설명 | | ------------------- | ------------------------------------- | | [query](#query) | 계정이 소유한 자격을 조회합니다. | | [add](#add) | 계정에 하나 이상의 지정된 자격을 추가합니다. | | [delete](#delete) | 계정에서 하나 이상의 지정된 자격을 삭제합니다. | | [catalog](#catalog) | 지정된 상위 제품이 판매할 수 있는 사용 가능한 제품을 표시합니다. | 모든 명령에는 /e(이메일) 및 /s(샌드박스) 매개 변수가 필요합니다. 계정으로 처음 로그인하면 대화형 암호 입력 대화 상자가 호출됩니다. 성공적으로 로그인한 후에는 동일한 계정/샌드박스로의 후속 작업에서 디바이스에 암호 입력이 더 이상 필요하지 않습니다. ## query `deventitlementtool query /e /s [/d]` 샌드박스에서 이 계정과 연결된 모든 직접 소유 자격을 나열합니다. ### query 출력 ```text theme={null} Entitlements found: {Number of entitlements} {ProductID}: {Last Updated Date (UTC)} {Status} ... ``` ### 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 ``` 각 자격에 대한 자세한 정보를 표시하려면 /d를 사용하세요. ```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]` 지정된 하나 이상의 제품에 대한 자격을 계정에 추가합니다. 이 명령은 Store에서 또는 구매 API를 통해 제품을 구매하는 것과 동일합니다. 이미 자격이 부여된 Game, Durable, Bundle 또는 개발자 관리 소비성 제품에 대해 `add` 작업을 수행하면 다른 자격이 추가되지 않으며 도구는 기존 자격을 보고합니다. Store 관리 소비성 제품의 경우 각 add 명령에서 기본 수량 `1`이 소비성 잔액에 추가됩니다. 선택적 수량 값을 지정하여 이 기본값을 변경할 수 있지만 quantity 필드는 /p와 함께 단일 productID를 전달할 때만 사용할 수 있습니다. 이 옵션은 구매 시 `1`보다 큰 수량을 부여하는 소비성 제품에 유용합니다. 자세한 정보를 위한 /d가 지원됩니다. 이 도구로는 수량을 확인할 수 없습니다. 항목의 현재 수량을 확인하려면 [XStoreCollectionData](/reference/system/xstore/structs/xstorecollectiondata) 구조체를 확인하세요. 번들 제품에 대한 `add` 작업은 포함된 모든 제품을 부여합니다. 수량을 지정하고 번들에 Store 관리 소비성 제품이 포함되어 있으면 동일한 수량이 각 소비성 제품에 할당됩니다. 구독 제품은 지원되지 않습니다. ### add 출력 ```console theme={null} Entitlements added: {Number of entitlements} {ProductID}: {Last Updated Date (UTC)} {Status} ... ``` ### add 예제 단일 자격 추가 ```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 ``` 여러 자격 추가 ```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 ``` 수량과 함께 소비성 제품 추가 ```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]` 계정에서 하나 이상의 지정된 자격을 삭제합니다. `/all`이 지정된 경우, 계정과 샌드박스에 연결된 모든 자격을 삭제하려고 시도합니다. 이 도구로 부여된 자격을 삭제할 때는 Revoked 상태가 표시됩니다. Store 클라이언트 또는 인게임 API를 통해 일반적으로 구매한 자격을 삭제할 때는 Refunded 상태가 표시됩니다. 자세한 정보를 위한 /d가 지원됩니다. ### delete 출력 ```console theme={null} Entitlements deleted: {Number of entitlements} {ProductID}: {Last Updated Date (UTC)} {Status} ... ``` ### 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]` 제공된 제품 ID가 판매할 수 있는 제품 집합을 표시합니다. 즉, 하위 추가 기능 제품과 Partner Center에서 productID와 *사용 및 판매 가능* 관계에 있는 제품입니다. 이 명령은 [XStoreQueryAssociatedProductsAsync](/reference/system/xstore/functions/xstorequeryassociatedproductsasync)가 반환하는 것과 동일합니다. Partner Center에서 *사용 가능하지만 Microsoft Store에서 검색할 수 없음*으로 구성된 제품은 반환되지 않습니다. 선택적으로 특정 마켓의 가격을 검색하기 위해 마켓을 지정할 수 있습니다. 매개 변수는 ISO 2자 지역 코드여야 합니다(예: GB, CA, JP, ES 등). ### 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} ... ``` ### 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 ``` ## 설명 이 도구는 XBOX 테스트 계정 및 샌드박스 제품에만 사용됩니다. 소매 계정 및 시나리오에서의 사용은 차단됩니다. 계정당 하루에 add 및 delete 작업에 대한 제한이 있습니다. 이 제한은 관찰된 사용량에 따라 조정됩니다. 제한 증가 요청 또는 기타 피드백을 위해서는 Microsoft 계정 담당자를 통해 문의하세요. ## API 참조 문서 * [XStore (API 목차)](/reference/system/xstore/xstore_members) * 함수 * [XStoreQueryAssociatedProductsAsync](/reference/system/xstore/functions/xstorequeryassociatedproductsasync) * 구조체 * [XStoreCollectionData](/reference/system/xstore/structs/xstorecollectiondata) ## Related topics - [XBOX 서비스용 개발 도구](/ko/tools/tools-services/live-tools.md) - [XBOX 서비스용 도구](/ko/tools/tools-services/live-tools-nav.md) - [XStoreCollectionData](/ko/reference/system/xstore/structs/xstorecollectiondata.md) - [XBOX services 개발자 계정 도구 (XblDevAccount.exe)](/ko/tools/tools-services/live-dev-account-tool.md) - [XBOX 및 PlayFab을 위한 라이브 서비스 도구](/ko/tools/tools-services/index.md)