ConfigurationManager.ServiceIdentity property

Article
05/31/2018

The ServiceIdentity property retrieves a ServiceIdentity object that can be used to manage an AD RMS service account.

This property is read-only.

Syntax

ConfigurationManager.ServiceIdentity

Property value

This property returns a ServiceIdentity object. The property is read-only.

Remarks

A ServiceIdentity object is typically used to change the service account.

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

' *******************************************************************
' Change the service account.

SUB ChangeServiceAccount()
    
  DIM changeSvcAccount_manager
  SET changeSvcAccount_manager = config_manager.ServiceIdentity
  CheckError()
    
  DIM currentSvcAccount
  SET currentSvcAccount = _
    changeSvcAccount_manager.CurrentServiceAccount
  CheckError()

  DIM newSvcAccount
  SET newSvcAccount = changeSvcAccount_manager.NewServiceAccount
  CheckError()

  newSvcAccount.Type = _
    config_manager.Constants.ServiceAccountTypeDomainIdentity
  newSvcAccount.UserDomainAccount.Domain = "xxxx"
  newSvcAccount.UserDomainAccount.UserId = "yyyy"
  newSvcAccount.UserDomainAccount.Password = "zzzz"

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

' *******************************************************************
' Generate a runtime error.

SUB RaiseError(errId, desc)
  CALL Err.Raise( errId, "", desc )
  CheckError()
END SUB

Requirements


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