Share via

Exporting and importing configuration settings

  • Article

 

Applies to: Forefront Protection for Exchange

Using the Forefront Management Shell to enter Windows PowerShell commands, you can export your Forefront Protection 2010 for Exchange Server (FPE) configuration to an .xml file that you can then use to:

  • Customize your configuration settings after a new installation.

  • Duplicate that configuration on another system.

  • Help recover your system after a failure.

Warning

When importing configuration settings from one server to another, all of the settings on the target computer will be overwritten. It is recommended that you only export and import configuration settings onto computers with similar role configurations.

Note

  • This topic describes simple import and export procedures. If you are backing up and restoring FPE data to aid in a disaster recovery situation, see Backing up and restoring.

  • Forefront Online Protection for Exchange (FOPE) credentials must be entered prior to importing configuration settings that include FOPE configuration settings. This can be done by running the following Windows PowerShell command from the Forefront Management Shell: Set-FseHostedServicesCredentials

Tip

If you are managing FPE on multiple Exchange servers, for example, in an enterprise, you can simplify importing and exporting configuration settings for multiple instances of FPE with the Microsoft Forefront Protection Server Management Console (FPSMC). You can download FPSMC from the Microsoft Download Center at the following location: Microsoft Forefront Protection Server Management Console (FPSMC) 2010. Documentation for FPSMC can be found in the TechNet library at Forefront Protection Server Management Console.

To export your configuration settings

  1. Create a new folder for your settings (for example: **C:\**ConfigSettings).

  2. Export your configuration settings to an .xml file in that folder, by following these steps.

    1. Click Start, point to All Programs, point to Microsoft Forefront Server Protection, and then click Forefront Management Shell.

    2. To export the configuration file to an .xml file, enter the following Windows PowerShell command, using the -path parameter to identify the name of the .xml file to be created and the folder into which it should be placed:

      Export-FseSettings -path c:\ConfigSettings\Export.xml

      Note

      Extended options are not included when running this command.

  3. If you have set any extended options, you can export these settings to a text file that can be referenced if you will be configuring extended options on the target computer. To export all extended options to a text file called Extended.txt, type the following Windows PowerShell command (the "*" value of the -name parameter causes all extended options to be exported):

    Get-FseExtendedOption -name * >> c:\ConfigSettings\Extended.txt

To import your configuration settings

  1. Click Start, point to All Programs, point to Microsoft Forefront Server Protection, and then click Forefront Management Shell.

  2. To import the configuration file, enter the following Windows PowerShell command (where path is the location and name of the .xml file created in the previous procedure):

    Import-FseSettings -path c:\ConfigSettings\Export.xml

  3. To list all of your current extended options, along with their values, enter the following Windows PowerShell command:

    Get-FseExtendedOption -name *

  4. Compare your current extended options to the options you previously exported to the Extended.txt file.

  5. If you want to modify any of your current extended options, enter the following Windows PowerShell command:

    Set-FseExtendedOption -name name-Valuevalue

    Where name is the parameter name and value is the new parameter value. You must enter each extended option separately.

  6. If you want to recreate extended options that do not exist on your current system, enter the following Windows PowerShell command:

    New-FseExtendedOption -name name-Valuevalue