CoreRMO::Update Resource Instance


Updates one or more of the following values for each resource instance in the candidate 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
  <resourceInstance>1..1
	<instanceName>0..1</instanceName>
	<typeName>0..1</typeName>
	<instanceLocation>0..1</instanceLocation>
	<instanceDescription>0..1</instanceDescription>
	<instanceProvisionable>0..1</instanceProvisionable>
	<instanceOnline>0..1</instanceOnline>
   </resourceInstance>
  <candidates>1..1
	<targetSet>1..1</targetSet>
  </candidates>
</executeData>

XML Output Schema

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

<executeData>1..1
  <rowsAffected>1..1</rowsAffected>
</executeData>

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

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

executeData Description:
Encapsulates the procedure's input and output data.

Children:
candidates (minOccurs="1" maxOccurs="1", input only)
resourceInstance
(minOccurs="1" maxOccurs="1", input only)
rowsAffected (minOccurs="1" maxOccurs="1" output only)

resourceInstance Description:
Encapsulates data needed to describe a resource instance.

Parent:
executeData

Children:
instanceDescription (minOccurs="0" maxOccurs="1")
instanceLocation
(minOccurs="0" maxOccurs="1")
instanceName
(minOccurs="0" maxOccurs="1")
instanceOnline (minOccurs="0" maxOccurs="1")
instanceProvisionable (minOccurs="0" maxOccurs="1")
typeName (minOccurs="0" maxOccurs="1")

instanceDescription Description:
New description of the resource instance.

Parent:
resourceInstance

instanceLocation Description:
New location of the resource instance.

Parent:
resourceInstance

instanceName Description:
New name of the resource instance.

Parent:
resourceInstance

instanceOnline Description:
Integer that specifies the new online status of the instance (0 or 1).

Parent:
resourceInstance

instanceProvisionable Description:
Integer that specifies the new provisionable status of the instance (0 or 1).

Parent:
resourceInstance

rowsAffected Description:
Integer that specifies the number of resource instances updated by this operation.

Parent:
executeData

targetSet Description:
Name of the candidate that contains the set of resource instances to update.

Parent:
candidates

typeName Description:
New name of the resource type for this instance.

Parent:
resourceInstance

Example

<request>
  <data/>
  <procedure>  
	<execute procedure="Add Resource To Candidates" namespace="CoreRMO"> 
	<executeData>
		<resourceInstance>
		<instanceName>iis-1</instanceName>
		<typeName>IISServer</typeName>
		<instanceLocation>Lab A, Building B</instanceLocation>
		</resourceInstance>
		<candidates>
		<targetSet>serverSet</targetSet>
		</candidates>
	</executeData>
	</execute>
	<execute procedure="Update Resource Instance" namespace="CoreRMO"> 
	<executeData>
		<candidates>
		<targetSet>serverSet</targetSet>
		</candidates>
		<resourceInstance>
		<instanceDescription>A new description</instanceDescription>
		</resourceInstance>
	</executeData>
	</execute>
  </procedure>
</request>

Remarks

When values are updated, the resulting resource instances must still be uniquely identified by a combination of instance name, resource type name, and instance location.

If any resource instances fail to update, no instances are updated.

See Also

Add Resource Instance, CoreRMO, Delete Resource Instance, Resource Manager


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