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

사용법

deventitlementtool <command> /e <testaccountemail> /s <sandboxid> [/p <productid>] [...] 모든 명령에는 /e(이메일) 및 /s(샌드박스) 매개 변수가 필요합니다. 계정으로 처음 로그인하면 대화형 암호 입력 대화 상자가 호출됩니다. 성공적으로 로그인한 후에는 동일한 계정/샌드박스로의 후속 작업에서 디바이스에 암호 입력이 더 이상 필요하지 않습니다.

query

deventitlementtool query /e <testaccountemail> /s <sandboxid> [/d] 샌드박스에서 이 계정과 연결된 모든 직접 소유 자격을 나열합니다.

query 출력

query 예제

각 자격에 대한 자세한 정보를 표시하려면 /d를 사용하세요.

add

deventitlementtool add /e <testaccountemail> /s <sandboxid> /p <productid1> [<productid2> <productid3> ...] [/q <quantity>] [/d] 지정된 하나 이상의 제품에 대한 자격을 계정에 추가합니다. 이 명령은 Store에서 또는 구매 API를 통해 제품을 구매하는 것과 동일합니다. 이미 자격이 부여된 Game, Durable, Bundle 또는 개발자 관리 소비성 제품에 대해 add 작업을 수행하면 다른 자격이 추가되지 않으며 도구는 기존 자격을 보고합니다. Store 관리 소비성 제품의 경우 각 add 명령에서 기본 수량 1이 소비성 잔액에 추가됩니다. 선택적 수량 값을 지정하여 이 기본값을 변경할 수 있지만 quantity 필드는 /p와 함께 단일 productID를 전달할 때만 사용할 수 있습니다. 이 옵션은 구매 시 1보다 큰 수량을 부여하는 소비성 제품에 유용합니다. 자세한 정보를 위한 /d가 지원됩니다.
이 도구로는 수량을 확인할 수 없습니다.
항목의 현재 수량을 확인하려면 XStoreCollectionData 구조체를 확인하세요.
번들 제품에 대한 add 작업은 포함된 모든 제품을 부여합니다. 수량을 지정하고 번들에 Store 관리 소비성 제품이 포함되어 있으면 동일한 수량이 각 소비성 제품에 할당됩니다.
구독 제품은 지원되지 않습니다.

add 출력

add 예제

단일 자격 추가
여러 자격 추가
수량과 함께 소비성 제품 추가

delete

deventitlementtool delete /e <testaccountemail> /s <sandboxid> /p <productid1> [<productid2> <productid3> ...] [/all] [/d] 계정에서 하나 이상의 지정된 자격을 삭제합니다. /all이 지정된 경우, 계정과 샌드박스에 연결된 모든 자격을 삭제하려고 시도합니다. 이 도구로 부여된 자격을 삭제할 때는 Revoked 상태가 표시됩니다. Store 클라이언트 또는 인게임 API를 통해 일반적으로 구매한 자격을 삭제할 때는 Refunded 상태가 표시됩니다. 자세한 정보를 위한 /d가 지원됩니다.

delete 출력

delete 예제

catalog

deventitlementtool catalog /e <testaccountemail> /s <sandboxid> /p <productid1> [/m] 제공된 제품 ID가 판매할 수 있는 제품 집합을 표시합니다. 즉, 하위 추가 기능 제품과 Partner Center에서 productID와 사용 및 판매 가능 관계에 있는 제품입니다. 이 명령은 XStoreQueryAssociatedProductsAsync가 반환하는 것과 동일합니다. Partner Center에서 사용 가능하지만 Microsoft Store에서 검색할 수 없음으로 구성된 제품은 반환되지 않습니다. 선택적으로 특정 마켓의 가격을 검색하기 위해 마켓을 지정할 수 있습니다. 매개 변수는 ISO 2자 지역 코드여야 합니다(예: GB, CA, JP, ES 등).

catalog 출력

catalog 예제

설명

이 도구는 XBOX 테스트 계정 및 샌드박스 제품에만 사용됩니다. 소매 계정 및 시나리오에서의 사용은 차단됩니다. 계정당 하루에 add 및 delete 작업에 대한 제한이 있습니다. 이 제한은 관찰된 사용량에 따라 조정됩니다. 제한 증가 요청 또는 기타 피드백을 위해서는 Microsoft 계정 담당자를 통해 문의하세요.

API 참조 문서

마지막 수정일 2026년 8월 24일