Microsoft Internet Security and Acceleration Server 2000

Configuring Arrays

Setting up a network can involve configuring many servers. With ISA, you can configure multiple servers at the same time through the array-level properties and methods of the FPCArray object, which is a member of the FPCArrays collection. ISA arrays are set up programmatically through individual FPCArray objects.

Each ISA array is a set of servers that have a similar configuration and share various resources to increase efficiency. For example, servers in an array share cached Web pages, so that a client attached to one of the computers benefits from pages cached on all of them.

The FPCArrays collection is a property of the ISA root object.

You can obtain a reference to a FPCArray object by using either of two methods of the FPCArrays collection:

The Item method of the FPCArrays collection returns a reference to any array you identify by index or name. Here is a VBScript example:

Set objMyArray = objFPCRoot.Arrays(1)

The GetContainingArray method of the FPCArrays collection returns a reference to the current array. The current array is the server array containing the server that executes this code. You can quickly obtain a reference to the current array by using code similar to this:

Set objCurArray = objFPCRoot.Arrays.GetContainingArray

Alternatively, you can use a more sophisticated scripting approach to allow real-time selection of an array while the script is running. The following code automatically inserts the name of the current array in the input box. The user can also type the name of a different array. If the input box is left empty, it is the equivalent of clicking Cancel.

Set objArrays = ISA.Arrays

		strArrayName = InputBox("Please enter the array name, or <ENTER> for the Containing Array:",,ISA.Arrays.GetContainingArray.Name)

		If strArrayName = "" Then
	'Cancel option
	Exit Sub
	On Error Resume Next
	Set Settings = objArrays(strArrayName).ClientConfig.Firewall.Settings
	If Err.Number <> 0 Then
		Wscript.Echo "The specified array was not found"
		Exit Sub
	End If
	On Error GoTo 0
		End If

The FPCArray object has properties that provide access to other parts of the administration object model, a factor that can be useful when setting up a network. For details see FPCArray in the ISA SDK reference.

See Also

ISA Array Examples