|Microsoft Internet Security and Acceleration Server 2000|
The FPC object is the root of the administration object hierarchy, and provides programmatic access to all of the other FPC objects. For a diagram of the entire hierarchy, see ISA Server Administration Object Model.
Creating this root object is the first step in making any programmatic changes to ISA. Using Visual Basic, you can create it with the following code:
Dim objFPC As New FPCLib.FPC
The CreateObject function is also available to Visual Basic programmers, and alternatively, the following can be used:
Dim objFPC Set objFPC = CreateObject("FPC.Root")
After the FPC object is created, objects below it in the hierarchy can be accessed through the properties of the root object. The Arrays property returns a collection of all ISA arrays within the root node, and it is through this property that you can access and change configuration settings of server arrays.
For multiple examples of use of the FPC root object, see ISA Administration Scripting.
Click here to see the ISA object hierarchy.
This object implements the IFPC interface.
When working from an administration-only computer, do not use the FPC object, as it will not provide access to the enterprise. Scripts run from an administration-only computer should use the FPCDS object, which is functionally identical to the FPC object but provides access to the active directory and therefore, to the enterprise.
In Visual Basic, create the root object for remote administration by using the following code:
Dim objFPC As New FPCLib.FPCDS
Optionally, you can use the CreateObject function:
Dim objFPC Set objFPC = CreateObject("FPCDS.Root")
The following table compares the FPC and FPCDS objects based on the type of installation on which the object is used.
|Installation Scenario||FPC Functionality||FPCDS Functionality|
|Remote administration only||Fails because FPC looks on that computer for an array.||Works for all arrays for which administrator has permissions.|
|Stand-alone server||Works, but only for the stand-alone server.||Works for all arrays, but not for astand-alone server.|
|Array||Works for all arrays for which administrator has permissions.||Works for all arrays for which administrator has permissions.|
Note In the remote administration only scenario, you can create an FPC object on a remote stand-alone server by using
Dim objFPC Set objFPC = CreateObject("FPC.Root", <ComputerName>)
Where <ComputerName> is the name of the computer on which the object should be created.
The following table lists the methods of the FPC root object.
|Refresh||Reads the object's configuration information from persistent storage, discarding any changes to the configuration that were not saved.|
The following table lists the properties of the FPC root object.
|Arrays||Gets a collection of all ISA arrays.|
|Enterprise||Gets an object that defines enterprise policy settings.|
|Type||Gets the type of the array.|
|VendorParametersSets||Gets a reference to an object that stores vendor-specific data.|
Windows NT/2000: Requires Windows 2000.
Version: Requires ISA Server 2000.