FPCNetworkTemplate object

Applies to: desktop apps only

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.

Ff825501.bkbutton(en-us,VS.85).png Click here to see the Forefront TMG object hierarchy.

Members

The FPCNetworkTemplate object has these types of members:

  • Methods
  • Properties

Methods

The FPCNetworkTemplate object has these methods.

Method Description
Refresh

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.

Save

Writes the current values of the object's writable properties to persistent storage.

 

Properties

The FPCNetworkTemplate object has these properties.

Property Access type Description

Description

Read/write

Gets or sets the description of the template.

LargeBMPName

Read-only

Gets the large bitmap (.bmp) file content of the network template.

MediumBMPName

Read-only

Gets the medium .bmp file content of the network template.

Name

Read/write

Gets or sets the name of the template.

NetworksInTemplate

Read-only

Gets an FPCNetworksInTemplate collection that specifies the networks included in the template.

Order

Read-only

Gets the ordinal position of the network template.

PersistentName

Read-only

Gets the persistent name of the network template.

PoliciesInTemplate

Read-only

Gets an FPCPoliciesInTemplate collection that specifies the policies included in the template.

SmallBMPName

Read-only

Gets the small .bmp file content of the network template.

XMLName

Read-only

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

Minimum supported client

Windows Vista, None supported

Minimum supported server

Windows Server 2008 R2, Windows Server 2008 with SP2 (64-bit only)

Version

Forefront Threat Management Gateway (TMG) 2010

IDL

Msfpccom.idl

See also

COM Objects

 

 

Build date: 7/12/2010