| Microsoft Internet Security and Acceleration Server 2000 |
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
Else
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.