About Persistence

The Forefront TMG administration COM model provides a persistence mechanism that enables you to export configuration settings to an .xml file, and to import the settings from a saved .xml file. This is done using methods of the FPC object, the FPCArrays collection, and any object or collection in the Forefront TMG administration COM object hierarchy that inherits from the FPCPersist object. Using these methods, you can import and export configuration settings, and have flexibility as to what elements are imported and exported.

You can use the persistence mechanism as a means of backing up your configuration from an enterprise (available only in Enterprise Edition), array, server, or lower-level object and restoring it when necessary. You can also use persistence to copy a configuration from an enterprise (available only in Enterprise Edition), array, server, or lower-level Forefront TMG COM object to another computer.

When you import a configuration, you must ascertain that the hierarchy of the imported configuration settings matches that of the objects to which you are importing the information. You cannot import array-level information to the server level. Similarly, you cannot import optional data to your configuration if that data was not exported.

The FPCPersistSink object provides the Progress method for handling progress events.

An example of how to use the persistence mechanism is provided in Exporting and Importing a Forefront TMG Configuration.

Send comments about this topic to Microsoft

Build date: 6/30/2010