CLMUtils.CreateDuplicateRequest Method
The CreateDuplicateRequest(ConnectedMA, Guid, String, Int16) method creates a duplicate request in CLM.
Syntax
public void CreateDuplicateRequest(
ConnectedMA targetCLMMA,
Guid aDObjectGuid,
String profileTemplateName,
Int16 numberOfDuplicatesDesired
);
Public Sub CreateDuplicateRequest( _
ByVal targetCLMMA As ConnectedMA, _
ByVal aDObjectGuid As Guid, _
ByVal profileTemplateName As String, _
ByVal numberOfDuplicatesDesired As Int16 _
)
Parameters
targetCLMMA
The CLM management agent through which the new object is provisioned.aDObjectGuid
The objectGuid of the associated Active Directory account for which you will create the request. This will need to 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 CLM Web site.
Return Value
This method does not return a value.
Exceptions
Exception type | Condition |
---|---|
ArgumentException | A required parameter is not present. |
ArgumentNullException | A required parameter is null. |
AttributeNotInInclusionListException | A required attribute is not selected in the management agent. |
NoSuchObjectTypeException | The object type 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:
- Checks to ensure that there is at least one connected profile, otherwise it throws an UnexpectedDataException.
- Counts the number of existing duplicate profiles and requests. If the number is less than the requested number, then it provisions the remaining requests.
- If it finds that there are already more duplicate profiles than the requested number, then it logs a message in the event log.
Requirements
Product | Microsoft Identity Integration Server 2003 SP2 |
Namespace | CLMUtils |
Assembly | CLMUtils |
.NET Framework | .NET Framework 3.0 |
See Also
Send comments about this topic to Microsoft
Build date: 2/16/2009