FPCNetworkTemplate Object
The FPCNetworkTemplate object represents a network template. A network template defines the relationships between a set of Forefront TMG networks and the policies that control traffic between those networks in a specific network topology. A network template is stored in an XML file. The FPCNetworkTemplate object properties allow you to set and get a name and description for the network template. You cannot use the Forefront TMG administration COM objects to change the XML file that defines a network template.
The XML file that contains a network template configuration includes:
- Networks and network sets
- Network rules that describe the relationships between various networks and network sets
- Policy elements
- Policies
By default, the following predefined network templates are supplied with Forefront TMG:
- Edge Firewall. A predefined network template for Forefront TMG computers with a network adapter that is connected to the Internal network and a second network adapter that is connected to the External network (the Internet).
- 3-Leg Perimeter. A predefined network template for Forefront TMG computers with a network adapter that is connected to the Internal network, a second network adapter that is connected to the External network (the Internet), and a third network adapter that is connected to a perimeter network, where published servers may reside.
- Front Firewall. A predefined network template for a back-to-back network topology with a Forefront TMG computer at the front end and a second firewall protecting the corporate network at the back end. The Forefront TMG computer has a network adapter that is connected to the External network (the Internet) and a second network adapter that is connected to the network where the back-end firewall resides.
- Back Firewall. A predefined network template for a back-to-back network topology with a Forefront TMG computer protecting the corporate network at the back end and a second firewall at the front end. The Forefront TMG computer has a network adapter that is connected to the Internal network and a second network adapter that is connected to the network where the front-end firewall resides.
- Single Network Adapter. A predefined network template for Forefront TMG computers with one network adapter, through which traffic can flow between internal clients and the Internet. In this configuration, the Forefront TMG computer serves as a Web proxy and a caching server.
A network template can be applied to an array using the SelectNetworkTemplateAndPolicy method of the FPCArray object.
The FPCNetworkTemplate object representing the network template used by an array is referenced through the FPCRef object held in the NetworkTemplateUsed property of the applicable FPCArray object.
This object is an element of an FPCNetworkTemplates collection, and a new object representing a network template can be created by calling the Add method of this collection.
.png "Dd436214.bkbutton(en-us,MSDN.10).png")
Click here to see the Forefront TMG object hierarchy.
Methods
The FPCNetworkTemplate object defines the following methods.
| Method | Description |
|---|---|
Recursively reads the values of all of the object's properties, including the properties of its subobjects and their elements (for collections), from persistent storage, overwriting any changes that were not saved. |
|
Writes the current values of the object's writable properties to persistent storage. |
Properties
The FPCNetworkTemplate object defines the following properties.
| Property | Description |
|---|---|
Gets or sets the description of the template. |
|
Gets the large bitmap (.bmp) file content of the network template. |
|
Gets the medium .bmp file content of the network template. |
|
Gets or sets the name of the template. |
|
Gets an FPCNetworksInTemplate collection that specifies the networks included in the template. |
|
Gets the ordinal position of the network template. |
|
Gets the persistent name of the network template. |
|
Gets an FPCPoliciesInTemplate collection that specifies the policies included in the template. |
|
Gets the small .bmp file content of the network template. |
|
Gets the name of the XML file that specifies the network configuration and policies in the network template. |
Interfaces for C++ Programming
This collection implements the IFPCNetworkTemplate interface.
Requirements
| Client | Requires Windows 7 or Windows Vista. |
| Server | Requires Windows Server 2008 R2 or Windows Server 2008 x64 Edition with SP2. |
| Version | Requires Forefront Threat Management Gateway (TMG) 2010. |
| IDL | Declared in Msfpccom.idl. |
See Also
Send comments about this topic to Microsoft
Build date: 6/30/2010