다음을 통해 공유


스토어 개발 자격 도구(DevEntitlementTool.exe)

샌드박스의 Xbox 테스트 계정에서 Microsoft Store 자격을 쿼리, 추가 및 제거하는 명령줄 도구입니다.

사용법

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

명령 설명
query 계정이 소유한 자격 조회
추가 계정에 지정된 자격 추가
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

추가

deventitlementtool add /e <testaccountemail> /s <sandboxid> /p <productid1> [<productid2> <productid3> ...] [/q <quantity>] [/d]

지정된 제품에 대한 자격을 계정에 추가합니다. 이는 Store에서 또는 구매 API를 통해 제품을 구매하는 것과 동일합니다.

게임, 지속성, 번들 및 개발 관리형 소모품의 경우 이미 자격이 부여된 제품(또는 수량이 1개)에 추가를 시도하면 기존 자격이 보고됩니다. 새 자격 또는 수량이 추가되지 않습니다.

Store 관리형 소모품의 경우 각 추가 명령의 소모품 잔량에 기본 수량 1이 추가됩니다. 이 기본값을 변경하려면 선택적 수량 값을 지정할 수 있지만 수량 필드는 단일 productID가 /p와 함께 전달된 경우에만 사용할 수 있습니다. 이는 구매 시 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

catalog

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 계정 담당자에게 문의하세요.