CoreRMO::Update Resource Group


Updates the group name and/or description attributes for the resource group 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
  <resourceGroup>1..1
	<groupName>0..1</groupName>
	<groupDescription>0..1</groupDescription>
  </resourceGroup>
  <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)
resourceGroup
(minOccurs="1" maxOccurs="1", input only)
rowsAffected (minOccurs="1" maxOccurs="1", output only)

groupDescription Description:
New description of the resource group.

Parent:
resourceGroup

groupName Description:
New name of the resource group. If the group name is to be updated, there must not be another group with the same group name, since group names must be unique.

Parent:
resourceGroup

resourceGroup Description:
Encapsulates data needed to describe a resource group.

Parent:
executeData

Children:
groupDescription (minOccurs="0" maxOccurs="1")
groupName
(minOccurs="0" maxOccurs="1")

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

Parent:
executeData

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

Parent:
candidates

Example

<request>
  <data/>
  <procedure>  
	<execute procedure="Add Resource Group To Candidates" namespace="CoreRMO"> 
	<executeData>
		<candidates>
		<targetSet>groupSet</targetSet>
		</candidates>
		<resourceGroup>
		<groupName>BroadBandServerGroup</groupName>
		</resourceGroup>
	</executeData>
	</execute>
	<execute procedure="Update Resource Group" namespace="CoreRMO"> 
	<executeData>
		<candidates>
		<targetSet>groupSet</targetSet>
		</candidates>
		<resourceGroup>
		<groupDescription>A new description</groupDescription>
		</resourceGroup>
	</executeData>
	</execute>
  </procedure>
</request>  

Remarks

If this function succeeds, all resource groups in the candidate set are updated. Conversely, if it fails, none are updated.

See Also

Add Resource Group, CoreRMO, Delete Resource Group, Resource Manager


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