볼륨 정품 인증 정보를 얻기 위한 Slmgr.vbs 옵션

여기서는 Slmgr.vbs 스크립트의 구문에 대해 설명하고, 이 문서의 표에는 각 명령줄 옵션에 대한 설명이 나와 있습니다.

slmgr.vbs [<ComputerName> [<User> <Password>]] [<Options>]

참고 항목

이 문서에서 대괄호([])는 선택적 인수를 묶고, 꺾쇠 괄호(<>)는 자리 표시자를 묶습니다. 이러한 명령문을 입력하는 경우 괄호를 생략하고 해당 값을 사용하여 자리 표시자를 바꿉니다.

참고 항목

볼륨 정품 인증을 사용하는 다른 소프트웨어 제품에 대한 자세한 내용은 해당 애플리케이션에 맞게 특별히 작성된 문서를 참조하세요.

원격 컴퓨터에서 Slmgr 사용

원격 클라이언트를 관리하려면 VAMT(볼륨 정품 인증 관리 도구) 버전 1.2 이상을 사용하거나 플랫폼 간의 차이점을 인식하는 사용자 지정 WMI 스크립트를 만듭니다. 볼륨 정품 인증용 WMI 속성 및 메서드에 대한 자세한 내용은 볼륨 정품 인증용 WMI 속성 및 메서드를 참조하세요.

Important

Windows 7 및 Windows Server 2008 R2의 WMI 변경 내용으로 인해 Slmgr.vbs 스크립트는 플랫폼 간에 작동하지 않습니다. Slmgr.vbs를 사용하여 Windows Vista® 운영 체제에서 Windows 7 또는 Windows Server 2008 R2 시스템을 관리하는 것은 지원되지 않습니다. Windows 7 또는 Windows Server 2008 R2에서 이전 시스템을 관리하려고 하면 특정 버전 불일치 오류가 생성됩니다. 예를 들어 cscript slmgr.vbs <vista_machine_name> /dlv를 실행하면 다음 출력이 생성됩니다.

Microsoft (R) Windows Script Host Version 5.8 Copyright (C) Microsoft Corporation. All rights reserved.

원격 머신에서 이 버전의 SLMgr.vbs를 지원하지 않습니다.

일반 Slmgr.vbs 옵션

옵션 설명
[<ComputerName>] 원격 컴퓨터의 이름(기본값은 로컬 컴퓨터)
[<User>] 원격 컴퓨터에 필요한 권한이 있는 계정
[<Password>] 원격 컴퓨터에 필요한 권한이 있는 계정의 암호

글로벌 옵션

옵션 설명
/ipk <ProductKey> 5×5 제품 키를 설치하려고 합니다. 매개 변수에서 제공하는 제품 키는 유효한 것으로 확인되며 설치된 운영 체제에 적용할 수 있습니다.
그렇지 않으면 오류가 반환됩니다.
키가 유효하고 적용 가능한 경우 키가 설치됩니다. 키가 이미 설치된 경우 자동으로 대체됩니다.
라이선스 서비스의 불안정을 방지하려면 시스템을 다시 시작하거나 소프트웨어 보호 서비스를 다시 시작해야 합니다.
관리자 권한으로 실행되는 명령 프롬프트 창에서 이 작업을 실행하거나, 권한이 없는 사용자가 소프트웨어 보호 서비스에 추가로 액세스할 수 있도록 표준 사용자 작업 레지스트리 값을 설정해야 합니다.
/ato [<Activation ID>] KMS 호스트 키 또는 MAK(복수 정품 인증 키)가 설치되어 있는 정품 버전 및 볼륨 시스템의 경우 /ato는 Windows에서 온라인 정품 인증을 시도하라는 메시지를 표시합니다.
GVLK(일반 볼륨 라이선스 키)가 설치되어 있는 시스템의 경우 KMS 정품 인증을 시도하라는 메시지를 표시합니다. 자동 KMS 정품 인증 시도(/stao)를 일시 중단하도록 설정된 시스템의 경우 /ato가 실행되는 경우에도 KMS 정품 인증을 시도합니다.
참고: Windows 8(및 Windows Server 2012) 부터 /stao 옵션은 더 이상 사용되지 않습니다. 대신 /act-type 옵션을 사용합니다.
<Activation ID> 매개 변수는 컴퓨터에 설치된 Windows 버전을 식별하도록 /ato 지원을 확장합니다. <Activation ID> 매개 변수를 지정하면 옵션의 효과를 해당 정품 인증 ID와 연결된 버전으로 격리합니다. 설치된 Windows 버전의 정품 인증 ID를 가져오려면 slmgr.vbs /dlv all을 실행합니다. 다른 애플리케이션을 지원해야 하는 경우 추가 지침은 해당 애플리케이션에서 제공하는 지침을 참조하세요.
KMS 정품 인증에는 상승된 권한이 필요하지 않습니다. 그러나 온라인 정품 인증에는 상승이 필요하거나, 권한 없는 사용자가 소프트웨어 보호 서비스에 대한 추가 액세스를 허용하도록 표준 사용자 작업 레지스트리 값을 설정해야 합니다.
/dli [<Activation ID> | All] 라이선스 정보를 표시합니다.
기본적으로 /dli설치된 활성 Windows 버전에 대한 라이선스 정보를 표시합니다. <Activation ID> 매개 변수를 지정하면 해당 정품 인증 ID와 연결된 특정 버전의 라이선스 정보가 표시됩니다. All을 매개 변수로 지정하면 해당하는 모든 설치된 제품의 라이선스 정보가 표시됩니다.
이 작업에는 상승된 권한이 필요하지 않습니다.
/dlv [<Activation ID> | All] 자세한 라이선스 정보를 표시합니다.
기본적으로 /dlv설치된 운영 체제에 대한 라이선스 정보를 표시합니다. <Activation ID> 매개 변수를 지정하면 해당 정품 인증 ID와 연결된 특정 버전의 라이선스 정보가 표시됩니다. All 매개 변수를 지정하면 해당하는 모든 설치된 제품의 라이선스 정보가 표시됩니다.
이 작업에는 상승된 권한이 필요하지 않습니다.
/xpr [<Activation ID>] 제품의 정품 인증 만료 날짜를 표시합니다. 기본적으로 이 기능은 현재 Windows 버전을 참조하며 MAK 및 정품 정품 인증이 영구적이므로 KMS 클라이언트에 주로 유용합니다.
<Activation ID> 매개 변수를 지정하면 해당 정품 인증 ID와 연결된 특정 버전의 정품 인증 만료 날짜가 표시됩니다. 이 작업에는 상승된 권한이 필요하지 않습니다.

고급 옵션

옵션 설명
/cpky 일부 서비스 작업을 수행하려면 OOBE(Out-of-Box Experience) 작업 중에 레지스트리에서 제품 키를 사용할 수 있어야 합니다. /cpky 옵션은 이 키가 악성 코드에 의해 도난당하지 않도록 레지스트리에서 제품 키를 제거합니다.
배포 키 소매 설치의 경우 모범 사례에서 이 옵션을 실행하는 것이 좋습니다. MAK 및 KMS 호스트 키에는 이 옵션이 필요하지 않습니다. 이러한 키의 기본 동작이기 때문입니다. 이 옵션은 기본 동작에서 레지스트리의 키를 지우지 않는 다른 유형의 키에만 필요합니다.
이 작업은 관리자 권한으로 실행되는 명령 프롬프트 창에서 실행해야 합니다.
/ilc <license_file> 이 옵션은 필수 매개 변수로 지정된 라이선스 파일을 설치합니다. 이러한 라이선스는 문제 해결 방법으로 설치되거나, 토큰 기반 활성화를 지원하거나, 온보딩된 애플리케이션의 수동 설치의 일부로 설치될 수 있습니다.
이 프로세스 중에 라이선스의 유효성이 검사되지 않습니다. 라이선스 유효성 검사가 Slmgr.vbs의 범위를 벗어났습니다. 대신, 유효성 검사는 런타임에 소프트웨어 보호 서비스에 의해 처리됩니다.
관리자 권한으로 실행되는 명령 프롬프트 창에서 이 작업을 실행하거나, 권한이 없는 사용자가 소프트웨어 보호 서비스에 추가로 액세스할 수 있도록 표준 사용자 작업 레지스트리 값을 설정해야 합니다.
/rilc 이 옵션은 %SystemRoot%\system32\oem 및 %SystemRoot%\System32\spp\tokens에 저장된 모든 라이선스를 다시 설치합니다. 이러한 라이선스는 설치 중에 저장된 "유효한 것으로 알려진" 복사본입니다.
신뢰할 수 있는 저장소의 일치하는 라이선스가 대체됩니다. TA(신뢰할 수 있는 기관) ILS(발급 라이선스), 애플리케이션 라이선스와 같은 추가 라이선스는 영향을 받지 않습니다.
관리자 권한으로 실행되는 명령 프롬프트 창에서 이 작업을 실행하거나, 권한이 없는 사용자가 소프트웨어 보호 서비스에 추가로 액세스할 수 있도록 표준 사용자 작업 레지스트리 값을 설정해야 합니다.
/rearm 이 옵션은 활성화 타이머를 다시 설정합니다. /rearm 프로세스는 sysprep /generalize에서도 호출됩니다.
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\SoftwareProtectionPlatform\SkipRearm 레지스트리 항목이 1로 설정된 경우 이 작업은 수행되지 않습니다. 이 레지스트리 항목에 대한 자세한 내용은 볼륨 정품 인증에 대한 레지스트리 설정을 참조하세요.
관리자 권한으로 실행되는 명령 프롬프트 창에서 이 작업을 실행하거나, 권한이 없는 사용자가 소프트웨어 보호 서비스에 추가로 액세스할 수 있도록 표준 사용자 작업 레지스트리 값을 설정해야 합니다.
/rearm-app <Application ID> 지정된 앱의 라이선스 상태 다시 설정합니다.
/rearm-sku <Application ID> 지정된 SKU의 라이선스 상태 다시 설정합니다.
/upk [<Application ID>] 이 옵션은 현재 Windows 버전의 제품 키를 제거합니다. 다시 시작한 후 새 제품 키가 설치되지 않는 한 시스템은 허가되지 않은 상태가 됩니다.
필요에 따라 <Activation ID> 매개 변수를 사용하여 설치된 다른 제품을 지정할 수 있습니다.
이 작업은 관리자 권한으로 실행되는 명령 프롬프트 창에서 실행해야 합니다.
/dti [<Activation ID>] 오프라인 정품 인증에 대한 설치 ID를 표시합니다.
/atp <Confirmation ID> 사용자가 제공한 확인 ID를 사용하여 제품을 정품 인증합니다.

KMS 클라이언트 옵션

옵션 설명
/skms <Name[:Port] | : port> [<Activation ID>] 이 옵션은 이름 및 필요에 따라 연결할 KMS 호스트 컴퓨터의 포트를 지정합니다. 이 값을 설정하면 KMS 호스트의 자동 검색이 비활성화됩니다.
KMS 호스트에서 IPv6(인터넷 프로토콜 버전 6)만 사용하는 경우 주소는 <hostname>:<port> 형식으로 지정해야 합니다. IPv6 주소에는 Slmgr.vbs 스크립트에서 올바르게 구문 분석하지 않는 콜론(:)이 포함되어 있습니다.
이 작업은 관리자 권한으로 실행되는 명령 프롬프트 창에서 실행해야 합니다.
/skms-domain <FQDN> [<Activation ID>] 모든 KMS SRV 레코드를 찾을 수 있는 특정 DNS를 기본 설정합니다. /skms 옵션을 사용하여 특정 단일 KMS 호스트를 설정한 경우 이 설정이 적용되지 않습니다. 특히 연결되지 않은 네임스페이스 환경에서 KMS가 DNS 접미사 검색 목록을 무시하고 지정된 DNS에서 KMS 호스트 레코드를 찾도록 강제하려면 이 옵션을 사용합니다기본.
/ckms [<Activation ID>] 이 옵션은 레지스트리에서 지정된 KMS 호스트 이름, 주소 및 포트 정보를 제거하고 KMS 자동 검색 동작을 복원합니다.
이 작업은 관리자 권한으로 실행되는 명령 프롬프트 창에서 실행해야 합니다.
/skhc 이 옵션은 KMS 호스트 캐싱을 사용하도록 설정합니다(기본값). 클라이언트에서 작동하는 KMS 호스트를 검색한 후에 이 설정을 사용하면 DNS(Domain Name System) 우선 순위 및 가중치가 호스트와의 추가 통신에 영향을 주지 않습니다. 시스템에서 작동하는 KMS 호스트에 더 이상 연결할 수 없는 경우 클라이언트는 새 호스트를 검색하려고 시도합니다.
이 작업은 관리자 권한으로 실행되는 명령 프롬프트 창에서 실행해야 합니다.
/ckhc 이 옵션은 KMS 호스트 캐싱을 사용하지 않도록 설정합니다. 이 설정은 클라이언트에서 KMS 정품 인증을 시도할 때마다 DNS 자동 검색을 사용하도록 명령합니다(우선 순위 및 가중치를 사용하는 경우 추천됨).
이 작업은 관리자 권한으로 실행되는 명령 프롬프트 창에서 실행해야 합니다.

KMS 호스트 구성 옵션

옵션 설명
/sai <Interval> 이 옵션은 정품 인증되지 않은 클라이언트에서 KMS에 연결하려고 시도하는 간격(분)을 설정합니다. 정품 인증 간격은 15분에서 30일 사이여야 하며, 기본값(2시간)이 추천됩니다.
KMS 클라이언트는 처음에 레지스트리에서 이 간격을 선택하지만 첫 번째 KMS 응답을 받은 후 KMS 설정으로 전환합니다.
이 작업은 관리자 권한으로 실행되는 명령 프롬프트 창에서 실행해야 합니다.
/sri <Interval> 이 옵션은 정품 인증된 클라이언트에서 KMS에 연결하려고 시도하는 갱신 간격(분)을 설정합니다. 갱신 간격은 15분에서 30일 사이여야 합니다. 이 옵션은 처음에 KMS 서버와 클라이언트 쪽 모두에서 설정됩니다. 기본값은 10,080분(7일)입니다.
KMS 클라이언트는 처음에 레지스트리에서 이 간격을 선택하지만 첫 번째 KMS 응답을 받은 후 KMS 설정으로 전환합니다.
이 작업은 관리자 권한으로 실행되는 명령 프롬프트 창에서 실행해야 합니다.
/sprt <Port> 이 옵션은 KMS 호스트가 클라이언트 정품 인증 요청을 수신 대기하는 포트를 설정합니다. 기본 TCP 포트는 1688입니다.
이 작업은 관리자 권한으로 실행되는 명령 프롬프트 창에서 실행해야 합니다.
/sdns KMS 호스트에서 DNS 게시를 사용하도록 설정합니다(기본값).
이 작업은 관리자 권한으로 실행되는 명령 프롬프트 창에서 실행해야 합니다.
/cdns KMS 호스트에서 DNS 게시를 사용하지 않도록 설정합니다.
이 작업은 관리자 권한으로 실행되는 명령 프롬프트 창에서 실행해야 합니다.
/spri KMS 우선 순위를 표준(기본값)으로 설정합니다.
이 작업은 관리자 권한으로 실행되는 명령 프롬프트 창에서 실행해야 합니다.
/cpri KMS 우선 순위를 낮게 설정합니다.
공동 호스팅 환경에서 KMS의 경합을 최소화하려면 이 옵션을 사용합니다. 이로 인해 다른 애플리케이션 또는 서버 역할이 활성 상태인지 여부에 따라 KMS가 고갈될 수 있습니다. 주의해서 사용합니다.
이 작업은 관리자 권한으로 실행되는 명령 프롬프트 창에서 실행해야 합니다.
/act-type [<Activation-Type>] [<Activation ID>] 이 옵션은 볼륨 정품 인증을 단일 형식으로 제한하는 레지스트리의 값을 설정합니다. 활성화 유형 1 은 Active Directory로만 활성화를 제한합니다.2 는 KMS 정품 인증으로 제한합니다. 토큰 기반 활성화에 대한 3 개입니다. 0 옵션은 활성화 유형을 허용하며 기본값입니다.

토큰 기반 정품 인증 구성 옵션

옵션 설명
/lil 설치된 토큰 기반 활성화 발급 라이선스를 나열합니다.
/ril <ILID><ILvID> 설치된 토큰 기반 정품 인증 발급 라이선스를 제거합니다.
이 작업은 관리자 권한으로 실행되는 명령 프롬프트 창에서 실행해야 합니다.
/stao 토큰 기반 정품 인증 전용 플래그를 설정하고 자동 KMS 정품 인증을 사용하지 않도록 설정합니다.
이 작업은 관리자 권한으로 실행되는 명령 프롬프트 창에서 실행해야 합니다.
이 옵션은 Windows Server 2012 R2 및 Windows 8.1에서 제거되었습니다. 대신 /act–type 옵션을 사용합니다.
/ctao 토큰 기반 정품 인증 전용 플래그(기본값)를 지우고 자동 KMS 정품 인증을 사용하도록 설정합니다.
이 작업은 관리자 권한으로 실행되는 명령 프롬프트 창에서 실행해야 합니다.
이 옵션은 Windows Server 2012 R2 및 Windows 8.1에서 제거되었습니다. 대신 /act–type 옵션을 사용합니다.
/ltc 설치된 소프트웨어를 활성화할 수 있는 유효한 토큰 기반 활성화 인증서를 나열합니다.
/fta <Certificate Thumbprint> [<PIN>] 식별된 인증서를 사용하여 토큰 기반 정품 인증을 강제로 적용합니다. 하드웨어(예: 스마트 카드)로 보호되는 인증서를 사용하는 경우 PIN(개인 식별 번호) 프롬프트 없이 프라이빗 키의 잠금을 해제하기 위해 선택적 PIN이 제공됩니다.

Active Directory 기반 정품 인증 구성 옵션

옵션 설명
/ad-activation-online <Product Key> [<Activation Object name>] 명령 프롬프트에서 실행하는 자격 증명을 사용하여 Active Directory 데이터를 수집하고 Active Directory 포리스트 정품 인증을 시작합니다. 로컬 관리자 액세스 권한은 필요하지 않습니다. 그러나 포리스트의 루트 도메인에 있는 정품 인증 개체 컨테이너에 대한 읽기/쓰기 액세스 권한이 필요합니다.
/ad-activation-get-IID <Product Key> 이 옵션은 휴대폰 모드에서 Active Directory 포리스트 활성화를 시작합니다. 인터넷 연결을 사용할 수 없는 경우 전화를 통해 포리스트를 정품 인증하는 데 사용할 수 있는 IID(설치 ID)가 출력됩니다. 활성화 전화 통화에서 IID를 제공하면 정품 인증을 완료하는 데 사용되는 CID가 반환됩니다.
/ad-activation-apply-cid <Product Key><Confirmation ID> [<Activation Object name>] 이 옵션을 사용하는 경우 정품 인증 전화 통화에서 제공된 CID를 입력하여 정품 인증을 완료합니다.
[/name: <AO_Name>] 필요에 따라 이러한 명령에 /name 옵션을 추가하여 Active Directory에 저장된 활성화 개체의 이름을 지정할 수 있습니다. 이름은 40자의 유니코드 문자를 초과할 수 없습니다. 큰따옴표를 사용하여 이름 문자열을 명시적으로 정의합니다.
Windows Server 2012 R2 및 Windows 8.1에서는 /name 옵션을 사용할 필요 없이 /ad-activation-online <Product Key>/ad-activation-apply-cid 바로 뒤에 이름을 추가할 수 있습니다.
/ao-list 로컬 컴퓨터에서 사용할 수 있는 모든 활성화 개체를 표시합니다.
/del-ao <AO_DN>
/del-ao <AO_RDN>
포리스트에서 지정된 활성화 개체를 삭제합니다.

추가 참조