CoreRMO::Discard Candidates By Mapping

Finds candidates (resource instances and groups, and consumer instances and groups) based on their mapping relationship with other instances or groups and removes them from the specified candidate set. Used by Microsoft Provisioning Framework (MPF).

Arguments

Remarks

Instances or groups of interest are found and removed by specifying:

One or both ends of the mapping relationship.
The categories of both objects in the relationship.
The relationship name (optional).

For example, suppose a mapping relationship called "allocation" exists from resourceInstance R to consumerInstance C. ResourceSet is a candidate set containing R, and ConsumerSet is a candidate set containing C. To discard C from ConsumerSet candidate set, you would pass the following XML.

<targetSet>ConsumerSet</targetSet>
<relatedFromSet>ResourceSet</relatedFromSet>
<relationship>allocation</relationship>
<sourceCategory>resourceInstance</sourceCategory>
<targetCategory>consumerInstance</targetCategory>

To discard R from ResourceSet candidate set, the XML would be:

<targetSet>ResourceSet</targetSet>
<relatedToSet>ConsumerSet</relatedToSet>
<relationship>allocation</relationship>
<sourceCategory>consumerInstance</sourceCategory>
<targetCategory>resourceInstance</targetCategory>

Schema Definition

Input



<executeData>1..1
  <candidates>1..1
	<targetSet>1..1</targetSet>
	<relatedFromSet>0..1</relatedFromSet>
	<relatedToSet>0..1</relatedToSet>
	<relationship>0..1</relationship>
	<sourceCategory>0..1</sourceCategory>
	<targetCategory>0..1</targetCategory>
  </candidates>
</executeData>

Sample Code

Applies To