CoreRMO::Add Candidates to Candidates


Copies all members of a source candidate set to a target candidate set and optionally assigns a rank to the copied candidates. Does not overwrite instances or groups that already exist in the target set. Used by Microsoft. Provisioning Framework (MPF).

XML Input Schema

The following code fragment shows the format for sending data to this procedure. For more information on individual elements and attributes, see the Elements and Attributes table.

<executeData>1..1
  <candidates>1..1
	<targetSet>1..1</targetSet>
	<sourceSet>1..1</sourceSet>
	<rank>0..1</rank>
  </candidates>
</executeData>

XML Output Schema

Add Candidates to Candidates does not return data.

Elements and Attributes

The following table describes the XML elements and attributes. Unless otherwise indicated, the data type is string.

Element Description, relationships, and attributes
candidates

Description:
Encapsulates data needed to interact with a candidate set.

Parent:
executeData

Children:
rank (minOccurs="0" maxOccurs="1")
sourceSet
(minOccurs="1" maxOccurs="1")
targetSet
(minOccurs="1" maxOccurs="1")

executeData Description:
Encapsulates the procedure's input data.

Child:
candidates (minOccurs="1" maxOccurs="1")

rank

Description:
Integer that specifies the rank to apply to candidates copied from the source set to the target set. If not specified, the default value is null.

Parent:
candidates

sourceSet

Description:
Name of the candidate set containing the set of candidates to copy.

Parent:
candidates

targetSet

Description:
Name of the candidate set to add candidates to.

Parent:
candidates

Example

<request>
  <data/>
  <procedure>  
	<execute procedure="Add Candidates to Candidates" namespace="CoreRMO"> 
	<executeData>
		<candidates>
		<targetSet>selectedServerSet</targetSet>
		<sourceSet>AllServerSet</sourceSet>
		<rank>1</rank>
		</candidates>
	</executeData>
	</execute>
  </procedure>
</request>

See Also

Add Consumer Group To Candidates, Add Consumer To Candidates, Add Resource Group To Candidates, Add Resource To Candidates, CoreRMO Provider, Resource Manager


Up Top of Page
) 1999-2002 Microsoft Corporation. All rights reserved.