ClmUtils.CreateDuplicateRequest Method

Creates a duplicate request in Forefront Identity Manager Certificate Management (FIM CM).

Namespace: Mms_Metaverse
Assembly: ClmUtils (in ClmUtils.dll)

Usage

'Usage
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

'Declaration
Public Sub CreateDuplicateRequest ( _
    targetCLMMA As ConnectedMA, _
    aDObjectGUID As Guid, _
    profileTemplateName As String, _
    numberOfDuplicatesDesired As Short _
)

public void CreateDuplicateRequest (
    ConnectedMA targetCLMMA,
    Guid aDObjectGUID,
    string profileTemplateName,
    short numberOfDuplicatesDesired
)

public:
void CreateDuplicateRequest (
    ConnectedMA^ targetCLMMA, 
    Guid aDObjectGUID, 
    String^ profileTemplateName, 
    short numberOfDuplicatesDesired
)

public void CreateDuplicateRequest (
    ConnectedMA targetCLMMA, 
    Guid aDObjectGUID, 
    String profileTemplateName, 
    short numberOfDuplicatesDesired
)

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

Reference

ClmUtils Class
ClmUtils Members
Mms_Metaverse Namespace
ClmUtils Class