Creates a duplicate request in Forefront Identity Manager Certificate Management (FIM CM).
Namespace: Mms_Metaverse
Assembly: ClmUtils (in clmutils.dll)

Usage

Visual Basic 
Dim instance As ClmUtils
Dim targetCLMMA As ConnectedMA
Dim aDObjectGUID As Guid
Dim profileTemplateName As String
Dim numberOfDuplicatesDesired As Short

instance.CreateDuplicateRequest(targetCLMMA, aDObjectGUID, profileTemplateName, numberOfDuplicatesDesired)

Syntax

Visual Basic 
Public Sub CreateDuplicateRequest ( _
		targetCLMMA As ConnectedMA, _
		aDObjectGUID As Guid, _
		profileTemplateName As String, _
		numberOfDuplicatesDesired As Short _
)
C# 
public void CreateDuplicateRequest (
		ConnectedMA targetCLMMA,
		Guid aDObjectGUID,
		string profileTemplateName,
		short numberOfDuplicatesDesired
)
C++ 
public:
void CreateDuplicateRequest (
		ConnectedMA^ targetCLMMA, 
		Guid aDObjectGUID, 
		String^ profileTemplateName, 
		short numberOfDuplicatesDesired
)
J# 
public void CreateDuplicateRequest (
		ConnectedMA targetCLMMA, 
		Guid aDObjectGUID, 
		String profileTemplateName, 
		short numberOfDuplicatesDesired
)
JScript 
public function CreateDuplicateRequest (
		targetCLMMA : ConnectedMA, 
		aDObjectGUID : Guid, 
		profileTemplateName : String, 
		numberOfDuplicatesDesired : short
)

Parameters

targetCLMMA

The FIM CM management agent through which the new object is provisioned.

aDObjectGUID

The objectGuid of the associated Active Directory Domain Services (AD DS) account for which you will create the request. This must be imported to the metaverse through the Active Directory management agent.

profileTemplateName

The name of the profile template to which you are trying to provision the request.

numberOfDuplicatesDesired

The desired number of duplicates per active/assigned profile. If the actual number is more than this number, a warning is logged in the event log so that it can be fixed through the FIM CM Web site.

Exceptions

Exception type Condition
System.ArgumentException

A required parameter is not present.
System.ArgumentNullException

A required parameter is null.
AttributeNotInInclusionListException

A required attribute is not selected in the management agent.
NoSuchObjectTypeException

The object type that is referenced is not in the schema.
UnexpectedDataException

There was an unexpected error, possibly because the request type was not valid.

Remarks

This method implements the following logic:

  • Verifies that there is at least one connected profile; otherwise, it throws an UnexpectedDataException exception.

  • Counts the number of existing duplicate profiles and requests. If the number is less than the requested number, it provisions the remaining requests.

  • If it finds that there are already more duplicate profiles than the requested number, it logs a message in the event log.


Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Target Platforms

See Also