Documentation about the OPTION flag in the machine activation utility of the Windows Rights Management client (837262)


The information in this article applies to:

  • Microsoft Windows Rights Management Services (RMS) for Windows Server 2003

SUMMARY

The computer activation utility, Actmachine.exe, is a command-line utility. This utility is included with the Microsoft Windows Rights Management Services (RMS) client and with the Windows Rights Management client Software Development Kit (SDK). However, although an additional option flag (/r) was also included before the final release, this option flag was not documented.

MORE INFORMATION

The computer activation utility, Actmachine.exe, is used to manually activate the RMS client.

Different option flags that you can use with the utility are documented in the Windows Rights Management client SDK documentation and in the Windows Rights Management Services Help file (Deploy.chm).

The /r flag is used to retain the current certificate store on the computer when the computer is reactivated. By default, when you try to activate a computer, any existing Rights Management (RM) licenses are deleted. However, if you use the /r flag, the following items are retained on the computer:
  • the computer certificate
  • the RM lockbox
  • any client licensor certificates
  • any RM account certificates
The syntax for the Actmachine.exe utility is as follows:

ActMachine [/n] [/p path] [/l path] [/r]

Note The Actmachine.exe utility recognizes the dash character (-) or the slash character (/) followed by option flags. The tool is not case sensitive.

REFERENCES

For more information, visit the following Microsoft Developer Network (MSDN) Web sites:

ActMachine
http://msdn.microsoft.com/library/en-us/drmclsdk/htm/actmachine.asp

About the Windows Rights Management Client SDK
http://msdn.microsoft.com/library/en-us/drmclsdk/htm/aboutthemicrosoftdrmclientapi.asp

Modification Type:MajorLast Reviewed:3/12/2004
Keywords:kbLicensing kbToolkit kbService kbSDK kbClient kbCertServices kbdocerr kbBug KB837262 kbAudDeveloper
©2004 Microsoft Corporation. All rights reserved.