CoreRMO::Add Consumer Instance
Adds a new consumer instance to the Resource Manager Database. Optionally adds the instance to a candidate set and assigns a rank. 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 <consumerInstance>1..1 <instanceName>1..1</instanceName> <typeName>1..1</typeName> <instanceDescription>0..1</instanceDescription> </consumerInstance> <candidates>0..1 <targetSet>1..1</targetSet> <rank>0..1</rank> </candidates> </executeData>XML Output Schema
Add Consumer Instance 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:
executeDataChildren:
rank (minOccurs="0" maxOccurs="1")
targetSet (minOccurs="1" maxOccurs="1")consumerInstance Description:
Encapsulates data needed to describe a consumer instance. Instances are identified by both name and type.Parent:
executeDataChildren:
instanceDescription (minOccurs="0" maxOccurs="1")
instanceName (minOccurs="1" maxOccurs="1")
typeName (minOccurs="1" maxOccurs="1")executeData Description:
Encapsulates the procedure's input data.Children:
candidates (minOccurs="0" maxOccurs="1")
consumerInstance (minOccurs="1" maxOccurs="1")instanceDescription Description:
Description of the consumer instance to be added.Parent:
consumerInstanceinstanceName Description:
Name of the consumer instance to be added.Parent:
consumerInstancerank Description:
Integer that specifies the rank to assign to the consumer instance when it is added to the candidate set. If not specified, the default value is null.Parent:
candidatestargetSet Description:
Name of the candidate set to add the consumer instance to.Parent:
candidatestypeName Description:
Name of the consumer type associated with this instance.Parent:
consumerInstanceExample
<request> <data/> <procedure> <execute procedure="Add Consumer Instance" namespace="CoreRMO"> <executeData> <consumerInstance> <instanceName>tailspintoys.com</instanceName> <typeName>Website</typeName> <instanceDescription>Tail Spin Toy store's website</instanceDescription> </consumerInstance> </executeData> </execute> </procedure> </request>See Also
CoreRMO Provider, Delete Consumer Instance, Resource Manager, Update Consumer Instance
Top of Page
) 1999-2002 Microsoft Corporation. All rights reserved.