Enterprise object

The Enterprise object can be used for enterprise administration. You can create this object if the access control list on the AD RMS Administration website supports the Administrator (0x4) role. You can retrieve this object by calling the Enterprise property on the ConfigurationManager object. The object enables you to retrieve the following objects:

Members

The Enterprise object has these types of members:

Methods

The Enterprise object has these methods.

Method Description
ResetServiceKeyPassword Specifies a password used to encrypt the server licensor private key.
UpdateAdminContactEmail Specifies an email contact address.
UpdateExtranetCertificationClusterUrl Specifies an extranet URL for the certification cluster.
UpdateExtranetLicensingClusterUrl Specifies an extranet URL for the certification or licensing cluster.
UpdateIntranetLicensingClusterUrl Specifies an intranet URL for the licensing cluster.

Properties

The Enterprise object has these properties.

Property Description
EnterpriseDatabase
Retrieves an object that can be used to manage the configuration, directory services, and logging databases.
ExclusionPolicy
Retrieves an object that can be used to manage server exclusion policies.
IssuancePolicy
Retrieves an object that can be used to specify the amount of time for which rights account certificates (RACs) are valid.
ProxySettings
Retrieves an object that can be used to manage configuration settings of a proxy server.
SecurityPolicy
Retrieves an object that can be used to decommission a server and to specify a super users group.
ServerLicensorCertificate
Retrieves an object that can be used to manage the server licensor certificate.
ServiceConnectionPoint
Retrieves an object that can be used to manage a service connection point (SCP).
ServicePrivateKeyProtectionInformation
Retrieves an object that contains information about the server licensor private key.
TrustPolicy
Retrieves an object that can be used to define the server trust policy.

Examples

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

' *******************************************************************
' Retrieve the Enterprise object.

SUB GetEnterprise()

  DIM enterprise

  ' Retrieve the Enterprise object.
  SET enterprise = config_manager.Enterprise
  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

Minimum supported client
None supported
Minimum supported server
Windows Server 2008
Assembly
Microsoft.RightsManagementServices.Admin.dll

See also

Active Directory Rights Management Services Scripting API Reference