OfficeSoftwareProtectionService クラス - WMI Library

OfficeSoftwareProtectionService クラスの説明

N/A
WMI Providerは、OSppProviderです。

---

プロパティ リスト

ClientMachineID

The GUID that identifies a KMS client to a KMS host. The client includes this in requests it sends to the KMS.

IsKeyManagementServiceMachine

Indicates whether KMS is enabled on the computer: 0 if false, 1 if true.

KeyManagementServiceActivationDisabled

Indicates whether the volume activation through key management service is disabled.

KeyManagementServiceCurrentCount

The count of currently active KMS clients on the KMS host. -1 indicates the computer is not enabled as a KMS, or has not received any client licensing-requests.

KeyManagementServiceDnsPublishing

Indicates the DNS publishing status of a KMS host: 0=Disabled, 1=Auto publish enabled (default).

KeyManagementServiceFailedRequests

The count of invalid KMS requests.

KeyManagementServiceHostCaching

Indicates the caching status of KMS host name and port: 0=Caching disabled, 1=Caching enabled (default).

KeyManagementServiceLicensedRequests

The count of KMS requests from clients with License Status=1 (Licensed).

KeyManagementServiceListeningPort

The TCP port the KMS host uses to listen for activation requests.

KeyManagementServiceLowPriority

Indicates the thread priority status of KMS service: 0=Normal Priority (default), 1=Low priority.

KeyManagementServiceMachine

The name of the KMS host. Returns null if SetKeyManagementServiceMachine has not been called.

KeyManagementServiceNonGenuineGraceRequests

The count of KMS requests from clients with License Status=4 (NonGenuineGrace).

KeyManagementServiceNotificationRequests

The count of KMS requests from clients with License Status=5 (Notification).

KeyManagementServiceOOBGraceRequests

The count of KMS requests from clients with License Status=2 (OOBGrace).

KeyManagementServiceOOTGraceRequests

The count of KMS requests from clients with License Status=3 (OOTGrace).

KeyManagementServicePort

The TCP port used by clients to send KMS-activation requests. Returns 0 if SetKeyManagementServicePort has not been called.

KeyManagementServiceTotalRequests

The total count of valid KMS requests.

KeyManagementServiceUnlicensedRequests

The count of KMS requests from clients with License Status=0 (Unlicensed).

PolicyCacheRefreshRequired

Indicates whether the licensing policy-cache needs to be updated: 0=not required, 1=Refresh required.

RequiredClientCount

The minimum number of clients required to connect to a KMS host in order to enable volume licensing.

Version

Version of the Software Licensing service

VLActivationInterval

The frequency, in minutes, of how often a client will contact the KMS host before the client is licensed.

VLRenewalInterval

The frequency, in minutes, of how often a client will contact the KMS host after the client is licensed.

---

メソッド リスト

AcquireGenuineTicket

Performs online Genuine Validation. Calling this method may change the Genuine status of the computer.

ClearKeyManagementServiceListeningPort

Clears any previously specified listening port. Applies to KMS hosts only.

ClearKeyManagementServiceMachine

Clears any previously configured KMS host name.

ClearKeyManagementServicePort

Clears any previously specified port number.

ClearProductKeyFromRegistry

Clears product key from the registry.

DisableKeyManagementServiceActivation

Enable/Disable volume activation through KMS machine: 0=Enable, 1=Disable.

DisableKeyManagementServiceDnsPublishing

Enable/Disable the DNS Publishing on a KMS host computer: 0=Enable, 1=Disable.

DisableKeyManagementServiceHostCaching

Enable/Disable the caching of the KMS hostname and port on a volume activation client computer: 0=Enable, 1=Disable.

EnableKeyManagementServiceLowPriority

Enable/Disable KMS service running with low priority: 0=Disable, 1=Enable.

InstallLicense

Installs a license.

InstallLicensePackage

Install a license package for the current product.

InstallProductKey

Install a product key.

SetKeyManagementServiceListeningPort

Sets the TCP port used by a KMS host to listen for activation requests. Applies to KMS hosts only. If not specified, 1688 is used.

SetKeyManagementServiceMachine

Sets the KMS host name to use for volume activation.

SetKeyManagementServicePort

Sets the TCP port used by a client to make requests of a KMS host. If not specified, port 1688 is used.

SetVLActivationInterval

The activation frequency, in minutes, of how often KMS-clients will contact the KMS host before they become licensed. The frequency must be greater than or equal to 15 and less than or equal to 43200. An error is returned if the method is called and the computer is not a KMS.

SetVLRenewalInterval

The renewal frequency, in minutes, of how often KMS-clients will contact the KMS host after they have become licensed. The frequency must be greater than or equal to 15 and less than or equal to 43200. An error is returned if the method is called and the computer is not a KMS.

---

WQL サンプル

SELECT * FROM OfficeSoftwareProtectionService

VB6/VBS
SWbemServicesクラスのExecQueryメソッドからWQLを実行可能です。
Set PrcSet = Service.ExecQuery("SELECT * FROM OfficeSoftwareProtectionService")

VB.Net
ObjectQueryクラスのQueryStringプロパティにWQLを設定し、ManagementObjectSearcherクラスのGetメソッドからWQLを実行可能です。
Searcher.Query.QueryString = "SELECT * FROM OfficeSoftwareProtectionService"
PrcSrc = Searcher.Get

PowerShell
Get-WmiObjectコマンドレットのqueryオプションを指定しWQLを実行可能です。
Get-WmiObject -query "SELECT * FROM OfficeSoftwareProtectionService"

---

このサイトの情報について

このコンテンツはWMIの各コンポーネントが持っているOfficeSoftwareProtectionServiceクラス情報を参照・抽出しリファレンスとして作成・提供しています。
参照したWMIの名前空間はroot/CIMV2、書き出し環境はWindows Server 2008 R2になります。

WMIの使い方(VB6, VBS, VBA, VB.NET, VC#, PowerShellを対象)に関してはWMI Stepも参考にしてみてください。(WMI初心者・入門編としてもおすすめです。) 各種言語を使用したWMIを使用するたたき台としてソーステンプレートも公開しています。プログラム/スクリプト作成時に役立てば…と思っています。

今後各WMI ClassをサポートしているOSの種類を掲載する予定です。
予定OS: Windows XP/Windows Vista/Windows 7/Windows Server 2003/Windows Server 2003 R2/Windows Server 2008/Windows Server 2008 R2

---