Export-FIMConfig

Export-FIMConfig

Extracts configuration resources from the Microsoft® Forefront Identity Manager (FIM) 2010 FIM Service.

When you use the Export-FIMConfig cmdlet, you must specify at least one of the following configuration identifying parameters or the cmdlet fails: policyConfig, portalConfig, schemaConfig, or customConfig.

Syntax

Export-FIMConfig [-uri <string>] [-credential <Credential>] [-messagesize <string>] [-PolicyConfig] [-SchemaConfig] [-PortalConfig] [-CustomConfig <System.String[]>] [<CommonParameters>]

Detailed Description

The Export-FIMConfig cmdlet extracts configuration resources from the FIM Service. You can use the Export-FIMConfig cmdlet to follow references recursively that are contained in its resources to extract a full representation of the service's configuration. If a reference points to a resource that is not marked as a configuration resource, the cmdlet downloads the entire representation but it does not follow the non-configuration resource’s references. The cmdlet returns a collection of ExportObject instances.

The following are the pre-defined groupings of configuration for export.

Policy Configuration is defined as the following resource types:

• ManagementPolicyRule

• Set

• WorkflowDefinition

• EmailTemplate

• FilterScope

• ActivityInformationConfiguration

• Function

• SynchronizationRule

• SynchronizationFilter

Schema Configuration is defined as the following resource types:

• AttributeTypeDescription

• BindingDescription

• ObjectTypeDescription

• ConstantSpecifier

• SchemaSupportedLocales

Portal Configuration is defined as the following resource types:

• Homepage Configuration

• PortalUI

• Configuration

• NavigationBarConfiguration

• SearchScopeConfiguration

• Configuration

• ObjectVisualizationConfiguration

Custom Configuration is defined by the provided XPath filter. For example /ContosoContact or /Person[DisplayName=’Administrator’].

For more information about the Microsoft® Forefront Identity Manager (FIM) 2010 Windows PowerShell™ cmdlet set see Forefront Identity Manager Configuration with Windows PowerShell.

Parameters

--Uri <string>

Specifies the Uniform Resource Identifier (URI) of the FIM Service. The following example shows how to set this parameter to a specific FIM Service.

-uri “https://localhost:5725/ResourceManagementService”

Attributes

--Credential <Credential>

Specifies the Windows PowerShell credential to use. The following example shows how to set this parameter.

$credential = Get-Credential

-credential $credential

Attributes

--MessageSize <string>

Specifies the maximum SOAP message size in bytes. The following example shows how to set the maximum SOAP message size to 200 bytes.

-messagesize 200

Attributes

--PolicyConfig <SwitchParameter>

If present, include resources that define policy in FIM.

The following example shows how to use this parameter.

-policyConfig

Attributes

--SchemaConfig <SwitchParameter>

If present, include resources that define the schema in FIM.

The following example shows how to use this parameter.

-schemaConfig

Attributes

--PortalConfig <SwitchParameter>

If present, include the resources that define portal behavior in FIM.

The following example shows how to use this parameter.

-portalConfig

Attributes

--CustomConfig <System.String[]>

Specifies a list of System.String objects that refer to resource types to include as configuration. The following example shows how to use this parameter.

-customConfig ("/ConstosoCustomResource", "/Group")

Attributes

--CommonParameters

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters.

-CommonParameter

This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, and OutVariable. For more information, see about_CommonParameters.

Input and Return Types

The input type is the type of the objects that you can pipe to the cmdlet. The return type is the type of the objects that the cmdlet emits.

Notes

The cmdlet returns null if no ExportObject instances are present.

Examples

EXAMPLE 1

 
          $pilot = Export-FIMConfig -uri https://localhost:5725/ResourceManagementService -policyConfig -portalConfig 
        

This example retrieves basic policy and portal configuration resources.

EXAMPLE 2

 
          $pilot = Export-FIMConfig -policyConfig -customConfig ("/ConstosoCustomResource", "/Group") 
        

This example retrieves custom resource type and groups in addition to policy configuration.

EXAMPLE 3

 
          $pilot = Export-FIMConfig -uri https://pilot:5725/ResourceManagementService -policyConfig 
          $pilot | ConvertFrom-FIMResource -file pilot.xml 
 
 
          $pilot = ConvertTo-FIMResource -file pilot.xml 
          $production = Export-FIMConfig -uri https://production:5725/ResourceManagementService -policyConfig 
          $matches = Join-FIMConfig -source $pilot -target $production -defaultJoin "DisplayName" 
          $imports = $matches | Compare-FIMConfig 
          $imports | ConvertFrom-FIMResource -file imports.xml 
          $UndoneImports = $imports | Import-FIMConfig -uri https://production:5725/ResourceManagementService 
        

This is an end-to-end scenario for migrating configuration from a pilot FIM environment to a production FIM environment.

EXAMPLE 4

 
          $pilot = Export-FIMConfig –customConfig “/Request[Target=/Person[DisplayName=’Administrator’]]” 
          $pilot | ConvertFrom-FIMResource -file report.xml 
        

This example shows how to extract additional, non-configuration information that may be useful in other scenarios. Scripters can take the ExportObject instances from the output and use them for other purposes. One such purpose is generating reports.

See Also

Reference

Join-FIMConfig
Compare-FIMConfig
Import-FIMConfig
ConvertFrom-FIMResource
ConvertTo-FIMResource