Live Communications Resource Manager::ModifyResources

The ModifyResources method of the Live Communications Resource Manager Namespace modifies the capacity or provisionable status of specified resources.

Arguments

The ModifyResources method has the following required and optional input parameters.

Input Arguments	Required	Description
serverPoolsXmlString	No	Zero or more <server> elements containing: <name> - The internal NetBios name of an Live Communications Server 2005 Server. <preferredDomainController> - The name of the preferred domain controller.
Zero or more <server> elements containing	No	<capacity> - The number of users that the server can host. <provisionable> - A setting of "1" indicates that the server is available for user allocations. A setting of "0" indicates that the server is not available for user allocations.

Note

You cannot immediately restore a database from backup over an existing database. Wait at least five minutes before attempting the restore procedure.

Method Syntax

The ModifyResources method uses the following syntax:

public string ModifyResources(
string serverPoolsXmlString, 
string preferredDomainController)

Remarks

Sample Code

Typical C# Usage

Typical usage for the ModifyResources method is as follows:

//Get user name and password.
		string userName = this.Request.ServerVariables.Get("AUTH_USER");
		string pass = this.Request.ServerVariables.Get("AUTH_PASSWORD");

		//Set credentials.
		LiveCommunicationRM.PreAuthenticate = true;
		LiveCommunicationRM.Credentials = new NetworkCredential(userName,pass);

		lblMsg.InnerHtml = mpsResponseHeaderLabel;

		//Display response.
		this.mpsResponse.DocumentSource = "";
		response = LiveCommunicationRM.ModifyResources(serverPoolsXmlString, preferredDomainController,sendCredentials);

		// set the response XML to match the return from MPF
		responseXml.LoadXml(response);
		this.mpsResponse.Document = responseXml;
lblDone.InnerText = successMsg;

Applies To