SecurityPolicy.DecommissionNow
[This documentation is preliminary and is subject to change.]
The DecommissionNow method decommissions a server.
Sub DecommissionNow()
Parameters
This method has no parameters.
Return Value
This method does not return a value.
Remarks
After a server has been decommissioned, AD RMS issues an end user license to any user who requests content. You must call EnableDecommission before calling this method.
Example Code
DIM config_manager
DIM admin_role
' *******************************************************************
' Create and initialize a ConfigurationManager object.
SUB InitObject()
CALL WScript.Echo( "Create ConfigurationManager object...")
SET config_manager = CreateObject _
("Microsoft.RightsManagementServices.Admin.ConfigurationManager")
CheckError()
CALL WScript.Echo( "Initialize...")
admin_role=config_manager.Initialize(false,"localhost",80,"","","")
CheckError()
END SUB
' *******************************************************************
' Security policy.
SUB EnableSecurityPolicy()
DIM securityPolicy
' Create a SecurityPolicy object.
SET securityPolicy = config_manager.Enterprise.SecurityPolicy
CheckError()
' Enable the decommissioning process.
securityPolicy.EnableDecommission()
CheckError()
' Decommission the server.
securityPolicy.DecommissionNow()
CheckError()
END SUB
' *******************************************************************
' Error checking function.
FUNCTION CheckError()
CheckError = Err.number
IF Err.number <> 0 THEN
CALL WScript.Echo( vbTab & "*****Error Number: " _
& Err.number _
& " Desc:" _
& Err.Description _
& "*****")
WScript.StdErr.Write(Err.Description)
WScript.Quit( Err.number )
END IF
END FUNCTION
Requirements
| Product | Requires Windows ServerĀ "Longhorn". |
| Library | Use Microsoft.RightsManagementServices.Admin.dll registered as a custom type library. |