CoreRMO::Find Consumers

Finds consumer instances that match the values provided and adds them to a candidate set. For example, specifying consumer typeName returns all consumers of that type. If a sourceSet is provided, only consumers from that set are considered. If no values are specified, all consumers are found. Used by Microsoft Provisioning Framework (MPF).

Arguments

Remarks

Schema Definition

Input

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
  <consumerInstance>1..1
	<instanceName>0..1</instanceName>
	<typeName>0..1</typeName>
  </consumerInstance>
  <candidates>1..1
	<targetSet>1..1</targetSet>
	<sourceSet>0..1</sourceSet>
	<rank>0..1</rank>
  </candidates>
</executeData>

Sample Code

Example XML Request



<request>
  <data/>
  <procedure>  
	<execute procedure="Find Consumers" namespace="CoreRMO"> 
	<executeData>
		<consumerInstance>
		<typeName>Website</typeName>
		</consumerInstance>
		<candidates>
		<targetSet>siteSet</targetSet>
		<rank>1</rank>
		</candidates>
	</executeData>
	</execute>
	<execute procedure="List Candidates" namespace="CoreRMO"> 
	<executeData>
		<candidates>
		<targetSet>siteSet</targetSet>
		<category>consumerInstance</category>
		</candidates>
	</executeData>
	<after source="executeData" sourcePath="consumerInstances" destination="data" />
	</execute>
  </procedure>
</request>

Example XML Response

Find Consumers does not return data.

Applies To