Office의 볼륨 정품 인증을 관리하는 도구
적용 대상:볼륨 라이선스 버전의 Office LTSC 2024, Office LTSC 2021, Office 2019 및 Office 2016(Project 및 Visio 포함)
Office 소프트웨어 보호 플랫폼 스크립트(ospp.vbs), 소프트웨어 라이선스 관리자 스크립트(slmgr.vbs) 및 VAMT(볼륨 정품 인증 관리 도구)는 Project 및 Visio를 포함하여 볼륨 라이선스가 부여된 Office 버전을 구성하고 테스트하는 데 도움이 될 수 있습니다. 이 문서를 읽기 전에 다음 문서를 읽는 것이 좋습니다.
- Office 볼륨 정품 인증 개요
- MAK를 사용하여 볼륨 라이선스 버전의 Office 정품 인증
- Active Directory를 사용하여 볼륨 라이선스가 부여된 Office 버전을 활성화합니다.
ospp.vbs 스크립트
Office 소프트웨어 보호 플랫폼 스크립트(ospp.vbs)를 사용하면 Project 및 Visio를 비롯한 Office 제품의 볼륨 라이선스 버전을 구성할 수 있습니다. ospp.vbs 스크립트는 Program Files\Microsoft Office\Office16 폴더에 있습니다. 64비트 운영 체제에 32비트 버전의 Office를 설치한 경우 프로그램 파일(x86)\Microsoft Office\Office16 폴더로 이동합니다.
참고
ospp.vbs 스크립트는 Project 및 Visio의 Microsoft 365 앱 또는 구독 버전에서 작동하지 않습니다. 대신 vnextdiag.ps1 라는 PowerShell 스크립트를 사용할 수 있습니다. 자세한 내용은 라이선스 및 활성화 상태 Microsoft 365 앱 확인을 참조하세요.
ospp.vbs를 실행하려면 cscript.exe 스크립트 엔진이 필요합니다. 도움말 파일을 보려면 다음 명령을 입력한 다음 Enter 키를 누르세요.
cscript ospp.vbs /?
일반적인 구문은 다음과 같습니다.
cscript ospp.vbs [Option:Value] [ComputerName] [User] [Password]
선택 제품 활성화, 제품 키 설치 또는 제거, 라이선스 정보 설치 및 표시, KMS 호스트 이름 및 포트 설정, KMS 호스트 이름 및 포트 제거에 사용할 옵션 및 값을 지정합니다. 이 섹션의 표에 해당하는 옵션 및 값이 나와 있습니다.
ComputerName 원격 컴퓨터의 이름입니다. 컴퓨터 이름이 제공되지 않으면 로컬 컴퓨터가 사용됩니다.
사용자 원격 컴퓨터에 필요한 권한이 있는 계정입니다.
암호 계정의 암호입니다. 사용자 계정 및 암호가 제공되지 않으면 현재 자격 증명이 사용됩니다.
중요
ospp.vbs를 실행하기 전에 다음을 확인하세요.
- 원격 컴퓨터에서 스크립트를 실행하려는 경우 Windows 방화벽은 원격 컴퓨터에서 WMI(Windows Management Instrumentation) 트래픽을 허용합니다.
- 사용할 사용자 계정은 스크립트를 실행하는 컴퓨터의 Administrators 그룹 구성원입니다.
- 관리자 권한 명령 프롬프트에서 ospp.vbs 스크립트를 실행합니다.
ospp.vbs의 전역 옵션
| 전역 옵션 | 설명 |
|---|---|
| /행동 | 설치된 Office 제품 키를 활성화합니다. |
| /inpkey:value | 사용자가 입력한 제품 키를 사용하여 제품 키를 설치합니다(기존 키 대체). 값 옵션이 필요합니다. |
| /unpkey:value | /dstatus 옵션에 표시된 대로 제품 키의 마지막 5자리 숫자와 함께 설치된 제품 키를 제거합니다. 값 매개 변수가 필요합니다. |
| /inslic:value | 사용자가 입력한 .xrm-ms 라이선스의 경로를 사용하여 라이선스를 설치합니다. 값 매개 변수가 필요합니다. |
| /dstatus | 설치된 제품 키에 대한 라이선스 정보를 표시합니다. |
| /dstatusall | 설치된 모든 라이선스에 대한 라이선스 정보를 표시합니다. |
| /dhistoryacterr | MAK/일반 정품 인증 실패 기록을 표시합니다. |
| /dinstid | 오프라인 정품 인증에 사용하는 설치 ID를 표시합니다. |
| /actcid:value | 사용자가 입력한 확인 ID로 제품을 정품 인증합니다. 값 매개 변수가 필요합니다. |
| /rearm | 설치된 모든 Office 제품 키에 대한 라이선스 상태 다시 설정합니다. |
| /rearm:value | 사용자가 제공한 SKU ID 값으로 Office 라이선스에 대한 라이선스 상태 다시 설정합니다. 값 매개 변수가 필요합니다. 후방이 부족하고 KMS 또는 Active Directory 기반 정품 인증을 통해 Office를 정품 인증한 경우 /dstatus 옵션을 사용하여 지정한 SKU ID 값과 함께 이 옵션을 사용하여 다른 후방을 얻습니다. |
| /ddescr:value | 사용자가 입력한 오류 코드에 대한 설명을 표시합니다. 값 매개 변수가 필요합니다. |
다음 표에서는 KMS 클라이언트를 구성하기 위한 ospp.vbs 옵션에 대해 설명합니다.
ospp.vbs의 KMS 클라이언트 옵션
| KMS 클라이언트 옵션 | 설명 |
|---|---|
| /dhistorykms | KMS 클라이언트 정품 인증 기록을 표시합니다. |
| /dcmid | KMS 클라이언트 CMID(컴퓨터 ID)를 표시합니다. |
| /sethst:value | 사용자가 입력한 호스트 이름을 사용하여 KMS 호스트 이름을 설정합니다. 값 매개 변수가 필요합니다. 이 옵션을 사용하면 HKLM\Software\Microsoft\OfficeSoftwareProtectionPlatform\KeyManagementServiceName(REG_SZ) 이 설정됩니다. |
| /setprt:value | 사용자가 입력한 포트 번호를 사용하여 KMS 포트를 설정합니다. 기본 포트 번호는 1688입니다. 값 매개 변수가 필요합니다. 이 옵션을 사용하면 HKLM\Software\Microsoft\OfficeSoftwareProtectionPlatform\KeyManagementServicePort(REG_SZ) 가 설정됩니다. |
| /remhst | KMS 호스트 이름을 제거하고 포트를 기본값으로 설정합니다. 기본 포트는 1688입니다. |
| /cachst:value | KMS 호스트 캐싱을 허용하거나 거부합니다. 값 매개 변수가 필요합니다(TRUE 또는 FALSE). |
| /actype:value | (Windows 8.1 이상 버전만 해당) 볼륨 활성화 유형을 설정합니다. 값 매개 변수가 필요합니다. 값: 1(Active Directory 기반), 2(KMS), 0(둘 다) |
| /skms-domain:value | (Windows 8.1 이상 버전만 해당) 모든 KMS SRV 레코드를 찾을 수 있는 특정 DNS 도메인을 설정합니다. 특정 단일 KMS 호스트 이름이 /sethst 옵션으로 설정된 경우에는 이 설정이 적용되지 않습니다. 값 매개 변수는 FQDN(정규화된 도메인 이름)이며 필수입니다. |
| /ckms-domain | (Windows 8.1 이상 버전만 해당) 모든 KMS SRV 레코드를 찾을 수 있는 특정 DNS 도메인을 지웁니다. 특정 KMS 호스트는 /sethst 옵션으로 설정된 경우 사용됩니다. 그렇지 않으면 KMS 호스트 자동 검색이 사용됩니다. |
ospp.vbs를 사용하는 시나리오
다음 시나리오에서는 관리자 권한 명령 프롬프트에서 ospp.vbs 실행한다고 가정합니다.
참고
변경한 내용은 Office 클라이언트 제품에만 영향을 줍니다. slmgr.vbs 스크립트를 사용하여 Windows 클라이언트를 별도로 구성해야 합니다.
제품 키를 원격 컴퓨터의 MAK 키로 변경하려면
- 원격 컴퓨터 이름이 contoso1인 경우 다음 명령을 실행하여 제품 키를 입력합니다. 이때 원격 컴퓨터에 관리자 자격 증명이 있다고 간주합니다. 원격 컴퓨터의 자격 증명이 로그온 이름 및 암호와 다른 경우에는 명령줄에 로그온 이름 및 암호를 입력한 다음 Enter 키를 입력해야 합니다.
cscript ospp.vbs /inpkey:xxxxx-xxxxx-xxxxx-xxxxx-xxxxx contoso1
- 원격 컴퓨터를 정품 인증하려면 다음 명령을 입력한 다음 Enter 키를 입력합니다.
cscript ospp.vbs /act contoso1
KMS 정품 인증 오류를 진단하려면
- 컴퓨터에 KMS 클라이언트 키가 설치되어 있으면 라이선스 상태를 확인합니다. 이 작업을 수행하려면 다음 명령을 입력한 후 Enter 키를 누릅니다.
cscript ospp.vbs /dstatusall
- KMS 정품 기록을 확인하려면 다음 명령을 입력한 다음 Enter 키를 누릅니다.
cscript ospp.vbs /dhistorykms
- 정품 인증을 트리거하려면 다음 명령을 입력한 다음 Enter 키를 누릅니다.
cscript ospp.vbs /act
- 오류 메시지에서 오류 코드 0xC004F042를 확인합니다. 사용자에게 표시되는 알림 대화 상자에 오류 코드가 나타나면 해당 코드를 사용하여 오류 메시지를 확인할 수도 있습니다. 이 작업을 수행하려면 다음 명령을 입력한 후 Enter 키를 누릅니다.
cscript ospp.vbs /ddescr:0xC004F042
KMS 클라이언트의 KMS 호스트 캐싱을 켜거나 끄려면
- KMS 클라이언트 컴퓨터에서 캐싱을 켜려면 다음 명령을 입력한 다음 Enter 키를 누릅니다.
cscript ospp.vbs /cachst:TRUE
- KMS 클라이언트 컴퓨터에서 캐싱을 끄려면 다음 명령을 입력한 다음 Enter 키를 누릅니다.
cscript ospp.vbs /cachst:FALSE
KMS 호스트 이름을 테스트한 다음 자동 검색으로 설정하려면
- kmstest.contoso.com 라는 KMS 호스트를 테스트하고 KMS 클라이언트에서 지정하려는 경우 다음 명령을 입력한 다음 Enter 키를 누릅니다.
cscript ospp.vbs /sethst:kmstest.contoso.com
참고
KMS 호스트 컴퓨터에서 기본 포트를 변경하는 경우 /setprt 옵션을 사용하여 ospp.vbs 실행해야 합니다. 예를 들면 cscript ospp.vbs /setprt:1750과 같습니다.
- 정품 인증을 트리거하려면 다음 명령을 입력한 다음 Enter 키를 누릅니다.
cscript ospp.vbs /act
- KMS 정품 인증 기록을 확인하여 호스트가 제대로 연결되었는지 확인하려면 다음 명령을 입력한 다음 Enter 키를 누릅니다.
cscript ospp.vbs /dhistorykms
- 이제 이 KMS 클라이언트에서 DNS(Domain Name System)를 사용하여 제품 KMS 호스트를 자동 검색하려고 합니다. KMS 호스트 이름을 제거하려면 다음 명령을 입력한 다음 Enter 키를 누릅니다.
cscript ospp.vbs /remhst
slmgr.vbs 스크립트
Windows\system32 폴더에 있는 소프트웨어 라이선스 관리자(slmgr.vbs) 스크립트는 Office KMS 호스트 및 Windows 호스트에 대한 볼륨 정품 인증 정보를 구성하고 검색하는 데 사용됩니다. 자세한 내용은 Windows에 대한 KMS 호스트 구성을 참조하세요.
이 스크립트는 대상 컴퓨터에서 로컬로 또는 다른 컴퓨터에서 원격으로 실행할 수 있습니다. 이 스크립트를 사용하려면 관리자여야 합니다. 표준 사용자가 slmgr.vbs 를 실행하면 일부 라이선스 데이터가 누락되거나 잘못될 수 있고 많은 작업이 차단됩니다.
slmgr.vbs 스크립트는 Windows 기반 스크립트 호스트인 wscript.exe 또는 명령 기반 스크립트 호스트인 cscript.exe를 사용할 수 있으며, 관리자는 사용할 스크립트 엔진을 지정할 수 있습니다. 스크립트 엔진을 지정하지 않으면 기본 스크립트 엔진인 wscript.exe를 사용하여 slmgr.vbs가 실행됩니다. cscript.exe 스크립트 엔진을 사용하는 것이 좋습니다.
변경 내용을 적용하려면 소프트웨어 라이선스 서비스를 다시 시작해야 합니다. 소프트웨어 라이선스 서비스를 다시 시작하려면 MMC(Microsoft Management Console) 서비스 스냅인을 사용하거나 다음 명령을 실행합니다.
net stop sppsvc && net start sppsvc
slmgr.vbs 스크립트에는 매개 변수가 하나 이상 필요합니다. 매개 변수 없이 스크립트를 실행하면 도움말 정보가 표시됩니다. 다음 표에는 slmgr.vbs 명령줄 옵션 및 해당 옵션에 대한 설명이 나와 있습니다. 표에 있는 대부분의 매개 변수가 KMS 호스트 컴퓨터를 구성합니다. 그러나 매개 변수 /sai 및 /sri 는 KMS 클라이언트가 KMS 호스트 컴퓨터에 연결되면 KMS 클라이언트로 전달됩니다. slmgr.vbs 일반적인 구문은 다음과 같습니다(스크립트 엔진으로 cscript.exe 사용 중이라고 가정).
cscript slmgr.vbs [ComputerName] [User] [Password] [Option]
ComputerName 원격 컴퓨터의 이름입니다. 컴퓨터 이름을 제공하지 않으면 로컬 컴퓨터가 사용됩니다.
사용자 원격 컴퓨터에 필요한 권한이 있는 계정입니다.
암호 계정의 암호입니다. 사용자 계정 및 암호를 제공하지 않으면 현재 자격 증명이 사용됩니다.
선택 옵션은 다음 표에 나와 있습니다.
Slmgr.vbs 명령 옵션
| 옵션 | 설명 |
|---|---|
| / ipk ProductKey | 해당 제품 키로 확인한 다른 응용 프로그램 또는 Windows의 제품 키(기본값)를 설치합니다. |
| / ato ActivationID | 제공된 정품 인증 ID로 확인한 응용 프로그램 또는 Windows의 KMS 호스트(기본값)를 정품 인증합니다. |
| / dti ActivationID | 제공된 정품 인증 ID로 확인한 응용 프로그램 또는 Windows의 KMS 호스트 컴퓨터 전화 정품 인증에 사용되는 설치 ID(기본값)를 표시합니다. 전화기에 설치 ID를 입력하여 확인 ID를 받아 /atp 매개 변수로 KMS 호스트 컴퓨터를 정품 인증하는 데 사용합니다. |
| / atp ConfirmationIDActivationID | 확인 ID를 받은 후에는 제공된 정품 인증 ID로 확인한 응용 프로그램 또는 Windows의 KMS 호스트(기본값)를 정품 인증합니다. |
| / dlv ActivationID | 제공된 정품 인증 ID로 확인한 응용 프로그램 또는 Windows(기본값)의 자세한 라이선스 정보를 표시합니다. 예를 들어 Windows\system32 폴더의 관리자 권한 명령 프롬프트에서 다음 명령을 실행하여 Office KMS 호스트의 상태 가져옵니다. cscript slmgr.vbs /dlv 70512334-47B4-44DB-A233-BE5EA33B914C |
| / dli ActivationID | 제공된 정품 인증 ID로 확인한 응용 프로그램 또는 Windows(기본값)의 라이선스 정보를 표시합니다. |
| / upk ActivationID | 제공된 정품 인증 ID로 확인한 응용 프로그램 또는 Windows(기본값)의 제품 키를 제거합니다. 주의: 예를 들어 Office용 제품 키를 제거하고 정품 인증 ID를 입력하지 않으려는 경우 설치된 모든 제품 키가 제거됩니다. 여기에는 Windows용 제품 키가 포함됩니다. |
| / xpr ActivationID | 현재 라이선스 상태의 만료 날짜를 표시합니다. |
| / sprt PortNumber | KMS 호스트 컴퓨터에 TCP 통신 포트를 설정합니다. PortNumber를 사용할 TCP 포트 번호로 바꿉니다. 기본 설정은 1688 입니다. |
| / cdns | KMS 호스트 컴퓨터의 자동 DNS 게시를 사용하도록 설정하지 않습니다. |
| / sdns | KMS 호스트 컴퓨터의 자동 DNS 게시를 사용하도록 설정합니다. |
| / cpri | KMS 호스트 컴퓨터 프로세스의 우선 순위를 낮춥니다. |
| / sai ActivationInterval | KMS 호스트 컴퓨터를 찾을 수 없는 경우 KMS 클라이언트가 자체 정품 인증을 시도하는 빈도를 변경합니다. ActivationInterval을 분 단위로 표현된 값으로 대체합니다. 기본 설정은 120 분입니다. |
| / sri RenewalInterval | KMS 클라이언트가 KMS 호스트 컴퓨터에 연결하여 정품 인증 갱신을 시도할 간격을 변경합니다. RenewalInterval을 분 단위로 표시된 값으로 대체합니다. 기본 설정은 10080분(7일)입니다. 이 설정은 로컬 KMS 클라이언트 설정보다 우선시됩니다. |
참고
- Office LTSC 2024의 활성화 ID: 8D368FC1-9470-4BE2-8D66-90E836CBB051
- Office LTSC 2021의 정품 인증 ID: 47F3B983-7C53-4D45-ABC6-BCD91E2DD90A
- Office 2019 정품 인증 ID: 70512334-47B4-44DB-A233-BE5EA33B914C
- Office 2016 정품 인증 ID: 98EBFE73-2084-4C97-932C-C0CD1643BEA7
Slmgr.vbs 명령 옵션(Active Directory 기반 활성화)
다음 표에서는 Active Directory 기반 활성화를 사용하여 AD DS 포리스트를 활성화하기 위한 명령 옵션을 보여 줍니다.
| 옵션 | 설명 |
|---|---|
| / ad-activation-online ProductKey | 사용자가 제공한 제품 키를 통해 AD DS 포리스트를 정품 인증합니다. |
| / ad-activation-apply-get-iid ProductKey | AD DS 포리스트의 ID를 표시합니다. |
| / ad-activation-apply-cid ProductKeyConfirmationID | 사용자가 제공한 제품 키와 확인 ID를 통해 AD DS 포리스트를 정품 인증합니다. |
VAMT(볼륨 정품 인증 관리 도구)
VAMT(볼륨 정품 인증 관리 도구)는 볼륨 정품 인증을 관리하는 그래픽 사용자 인터페이스를 제공합니다. 자세한 내용은 VAMT(볼륨 정품 인증 관리 도구) 기술 참조를 참조하세요.
참고
- Office LTSC 2024, Office LTSC 2021 및 Office 2019에는 VAMT 3.1 이상이 필요합니다.
VAMT를 사용하여 Office LTSC 2024에 대한 볼륨 정품 인증 관리
VAMT를 사용하여 Office LTSC 2024에 대한 볼륨 정품 인증을 관리하려면 다음 단계를 수행합니다.
- VAMT의 설치 폴더(예:
C:\Program Files (x86)\Windows Kits\10\Assessment and Deployment Kit\VAMT3)를 식별합니다. - Office VAMT 다운로드 링크에서 Office LTSC 2024 지원 파일을 다운로드합니다.
-
pkeyconfig-office24-client.xrm-ms,pkeyconfig-office24-kmshost.xrm-ms및Office24.cilx파일을 적절한 VAMT 디렉터리에 복사합니다.-
.xrm-ms파일을 폴더에 복사합니다VAMT3\pkconfig. -
.cilx파일을 가져오기 위해 쉽게 액세스할 수 있는 위치에 복사합니다.
-
Office LTSC 2024 데이터를 VAMT로 가져오려면 다음을 수행합니다.
- VAMT를 엽니다.
- 오른쪽 작업 창에서 목록 가져오기 를 선택하여 목록 가져오기 대화 상자를 엽니다.
-
목록 가져오기 대화 상자에서 파일의
Office24.cilx위치로 이동하고 파일을 선택한 다음 열기를 선택합니다. - 볼륨 정품 인증 관리 도구 대화 상자에서 확인을 선택하여 가져오기를 시작합니다. VAMT는 파일을 가져오는 동안 진행률 메시지를 표시합니다. 가져오기가 성공적으로 완료되었음을 확인하는 메시지가 표시되면 확인을 선택합니다.