TrustedPublishingDomain object
The TrustedPublishingDomain object contains information about a trusted publishing domain. This includes information about AD RMS servers that reside in a domain that has a different root of trust than the server currently being administered. By default, an AD RMS server can issue end-user licenses only for content published by itself or by another RMS server in the same cluster. To issue end-user licenses for content published on a server under a different root of trust, the following items must be imported:
- The server licensor certificate
- The private key used to sign end-user licenses
- All rights policy templates
These items are saved in a password-protected file. The file and the password are then securely shared to the current AD RMS server. The imported data is referred to as a trusted publishing domain. For more information, see the Import method on the TrustedPublishingDomainCollection object.
Members
The TrustedPublishingDomain object has these types of members:
Properties
The TrustedPublishingDomain object has these properties.
| Property | Description |
|---|---|
| CryptoSvcProvider |
Retrieves the name of the cryptographic service provider (CSP) for the trusted domain. |
| DisplayName |
Retrieves the display name for the trusted domain object. |
| Id |
Retrieves a unique ID for the trusted domain object. |
| IsImported |
Retrieves a Boolean value that specifies whether the trusted domain has been imported from another AD RMS installation. |
| KeyContainer |
Retrieves the name of the key container in the CSP. |
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 trusted publishing domain information.
SUB GetTPDInfo()
DIM trustPolicy
DIM TPDs
DIM TPD
DIM Index
' Retrieve the trust policy object.
SET trustPolicy = config_manager.Enterprise.TrustPolicy
CheckError()
' Retrieve the trusted publishing domain collection object.
SET TPDs = trustPolicy.TrustedPublishingDomains
CheckError()
' Import a trusted publishing domain into the collection.
SET TPD = TPDs.Import( "TPD_Name", _
"password", _
"c:\TPDfile.dat")
CheckError()
IF TPDs.Count < 1 OR IsNull(TPD.Id) THEN
CALL RaiseError(-610, "Import failed.")
END IF
CALL WScript.Echo("Trusted publishing domain information: ")
CALL WScript.Echo("Display name = " & _
TPD.DisplayName)
CALL WScript.Echo("Unique ID = " & _
TPD.Id)
CALL WScript.Echo("Imported = " & _
TPD.IsImported)
CALL WScript.Echo("CSP name = " & _
TPD.CryptoSvcProvider)
CALL WScript.Echo("Key container name = " & _
TPD.KeyContainer)
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 |
|