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:
executeDataChild:
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:
resourceGroupgroupName 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:
resourceGroupresourceGroup Description:
Encapsulates data needed to describe a resource group.Parent:
executeDataChildren:
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:
executeDatatargetSet Description:
Name of the candidate that contains the set of resource groups to update.Parent:
candidatesExample
<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
Top of Page
) 1999-2002 Microsoft Corporation. All rights reserved.