CoreProvider::Add Resource Group

Adds a new resource group to the Resource Manager Database. Optionally adds the new group 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
  <resourceGroup>1..1
	<groupName>1..1</groupName>
	<groupDescription>0..1</groupDescription>
  </resourceGroup>
  <candidates>0..1
	<targetSet>1..1</targetSet>
	<rank>0..1</rank>
 </candidates>
</executeData>

XML Output Schema

Add Resource Group 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:
rank (minOccurs="0" maxOccurs="1")
targetSet (minOccurs="1" maxOccurs="1")
executeData Description:
 Encapsulates the procedure's input data.

Children:
candidates (minOccurs="0" maxOccurs="1")
resourceGroup (minOccurs="1" maxOccurs="1")
groupDescription Description:
Description of the resource group.

Parent:
resourceGroup

groupName Description:
Name of the resource group.

Parent:
resourceGroup

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

Parent:
candidates

resourceGroup Description:
Encapsulates data needed to describe a resource group. Group name must be unique within the set of resource groups.

Parent:
executeData

Children:
groupName (minOccurs="1" maxOccurs="1")
groupDescription (minOccurs="0" maxOccurs="1")
targetSet Description:
Name of the candidate set to add the resource group to.

Parent:
candidates

Example

<request>
  <data/>
  <procedure>  
	<execute procedure="Add Resource Group" namespace="CoreRMO"> 
	<executeData>
		<resourceGroup>
		<groupName>BroadBandServerGroup</groupName>
		<groupDescription>Group of all servers connected with a high speed broad band  connection</groupDescription>
		</resourceGroup>
	</executeData>
	</execute>
  </procedure>
</request>

See Also

CoreRMO Provider, Delete Resource Group, Resource Manager, Update Resource Group

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