Office의 볼륨 정품 인증을 관리하는 도구

  • 아티클

적용 대상:볼륨 라이선스 버전의 Office LTSC 2021, Office 2019 및 Office 2016(Project 및 Visio 포함)

Office 소프트웨어 보호 플랫폼 스크립트(ospp.vbs), 소프트웨어 라이선스 관리자 스크립트(slmgr.vbs) 및 VAMT(볼륨 정품 인증 관리 도구)는 Project 및 Visio를 포함하여 볼륨 라이선스가 부여된 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의 전역 옵션

전역 옵션 설명
/act 설치된 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 키로 변경하려면

  1. 원격 컴퓨터 이름이 contoso1인 경우 다음 명령을 실행하여 제품 키를 입력합니다. 이때 원격 컴퓨터에 관리자 자격 증명이 있다고 간주합니다. 원격 컴퓨터의 자격 증명이 로그온 이름 및 암호와 다른 경우에는 명령줄에 로그온 이름 및 암호를 입력한 다음 Enter 키를 입력해야 합니다.
cscript ospp.vbs /inpkey:xxxxx-xxxxx-xxxxx-xxxxx-xxxxx contoso1
  1. 원격 컴퓨터를 정품 인증하려면 다음 명령을 입력한 다음 Enter 키를 입력합니다.
cscript ospp.vbs /act contoso1

KMS 정품 인증 오류를 진단하려면

  1. 컴퓨터에 KMS 클라이언트 키가 설치되어 있으면 라이선스 상태를 확인합니다. 이 작업을 수행하려면 다음 명령을 입력한 후 Enter 키를 누릅니다.
cscript ospp.vbs /dstatusall
  1. KMS 정품 기록을 확인하려면 다음 명령을 입력한 다음 Enter 키를 누릅니다.
cscript ospp.vbs /dhistorykms
  1. 정품 인증을 트리거하려면 다음 명령을 입력한 다음 Enter 키를 누릅니다.
cscript ospp.vbs /act
  1. 오류 메시지에서 오류 코드 0xC004F042를 확인합니다. 사용자에게 표시되는 알림 대화 상자에 오류 코드가 나타나면 해당 코드를 사용하여 오류 메시지를 확인할 수도 있습니다. 이 작업을 수행하려면 다음 명령을 입력한 후 Enter 키를 누릅니다.
cscript ospp.vbs /ddescr:0xC004F042

KMS 클라이언트의 KMS 호스트 캐싱을 켜거나 끄려면

  1. KMS 클라이언트 컴퓨터에서 캐싱을 켜려면 다음 명령을 입력한 다음 Enter 키를 누릅니다.
cscript ospp.vbs /cachst:TRUE
  1. KMS 클라이언트 컴퓨터에서 캐싱을 끄려면 다음 명령을 입력한 다음 Enter 키를 누릅니다.
cscript ospp.vbs /cachst:FALSE

KMS 호스트 이름을 테스트한 다음 자동 검색으로 설정하려면

  1. kmstest.contoso.com 라는 KMS 호스트를 테스트하고 KMS 클라이언트에서 지정하려는 경우 다음 명령을 입력한 다음 Enter 키를 누릅니다.
cscript ospp.vbs /sethst:kmstest.contoso.com

참고

KMS 호스트 컴퓨터에서 기본 포트를 변경하는 경우 /setprt 옵션을 사용하여 ospp.vbs 실행해야 합니다. 예를 들면 cscript ospp.vbs /setprt:1750과 같습니다.

  1. 정품 인증을 트리거하려면 다음 명령을 입력한 다음 Enter 키를 누릅니다.
cscript ospp.vbs /act
  1. KMS 정품 인증 기록을 확인하여 호스트가 제대로 연결되었는지 확인하려면 다음 명령을 입력한 다음 Enter 키를 누릅니다.
cscript ospp.vbs /dhistorykms
  1. 이제 이 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 입니다.
/Cdn KMS 호스트 컴퓨터의 자동 DNS 게시를 사용하도록 설정하지 않습니다.
/ sdns KMS 호스트 컴퓨터의 자동 DNS 게시를 사용하도록 설정합니다.
/ cpri KMS 호스트 컴퓨터 프로세스의 우선 순위를 낮춥니다.
/ sai ActivationInterval KMS 호스트 컴퓨터를 찾을 수 없는 경우 KMS 클라이언트가 자체 정품 인증을 시도하는 빈도를 변경합니다. ActivationInterval을 분 단위로 표현된 값으로 대체합니다. 기본 설정은 120 분입니다.
/ sri RenewalInterval KMS 클라이언트가 KMS 호스트 컴퓨터에 연결하여 정품 인증 갱신을 시도할 간격을 변경합니다. RenewalInterval을 분 단위로 표시된 값으로 대체합니다. 기본 설정은 10080 분(7일)입니다. 이 설정은 로컬 KMS 클라이언트 설정보다 우선시됩니다.

참고

  • 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 2021 및 Office 2019에는 적어도 VAMT 3.1이 필요합니다.