CoreRMO::Add Resource Instance

Adds a new resource instance to the Resource Manager Database. Optionally adds the instance to a candidate set and assigns it 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
  <resourceInstance>1..1
	<instanceName>1..1</instanceName>
	<typeName>1..1</typeName>
	<instanceLocation>1..1</instanceLocation>
	<instanceDescription>0..1</instanceDescription>
	<instanceProvisionable>1..1</instanceProvisionable>
	<instanceOnline>1..1</instanceOnline>
   </resourceInstance>
  <candidates>0..1
	<targetSet>1..1</targetSet>
	<rank>0..1</rank>
  </candidates>
</executeData>

XML Output Schema

Add Resource 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:
executeData

Children:
targetSet (minOccurs="1" maxOccurs="1")
rank (minOccurs="0" maxOccurs="1")
executeData Description:
 Encapsulates the procedure's input data.

Children:
candidates(minOccurs="0" maxOccurs="1")
resourceInstance(minOccurs="1" maxOccurs="1")
instanceName Description:
Name of the resource instance.

Parent:
resourceInstance

instanceDescription Description:
Description of the resource instance.

Parent:
resourceInstance

instanceLocation Description:
Location of the resource instance.

Parent:
resourceInstance

instanceOnline Description:
Integer that indicates whether this instance is currently online. Refers to the resource's current status (0 or 1).

Parent:
resourceInstance

instanceProvisionable Description:
Integer (0 or 1) that indicates whether this instance can be used to provision new users. If specified, new users can be assigned to the resource.

Parent:
resourceInstance

rank Description:
Integer that specifies the rank to assign to the resource instance when it is added to the candidate set. If not specified, the default value is null.

Parent:
candidates

resourceInstance Description:
Encapsulates data needed to describe a resource instance. The new instance must be uniquely identified by the combination of typeName, instanceName, and instanceLocation.

Parent:
executeData

Children:
instanceDescription (minOccurs="0" maxOccurs="1")
instanceLocation (minOccurs="1" maxOccurs="1")
instanceName (minOccurs="1" maxOccurs="1")
instanceOnline (minOccurs="1" maxOccurs="1")
instanceProvisionable (minOccurs="1" maxOccurs="1")
typeName (minOccurs="1" maxOccurs="1")
targetSet Description:
Name of the candidate set to add the resource instance to.

Parent:
candidates

typeName Description:
Name of the resource type associated with this instance.

Parent:
resourceInstance

Example

<request>
  <data/>
  <procedure>  
	<execute procedure="Add Resource Instance" namespace="CoreRMO"> 
	<executeData>
		<resourceInstance>
		<instanceName>iis-1</instanceName>
		<instanceLocation>Lab A, Building B</instanceLocation>
		<instanceProvisionable>1</instanceProvisionable>
		<instanceOnline>1</instanceOnline>
		<typeName>IISServer</typeName>
		<instanceDescription>IIS Server Number 1</instanceDescription>
		</resourceInstance>
	</executeData>
	</execute>
  </procedure>
</request>

See Also

CoreRMO Provider, Delete Resource Instance, Resource Manager, Update Resource Instance

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