Export-FIMConfig
Extracts configuration resources from the mmsee mmsshort Service.
Syntax
Export-FIMConfig
[-Uri <String>]
[-Credential <PSCredential>]
[-AllLocales]
[-SchemaConfig]
[-PolicyConfig]
[-PortalConfig]
[-PamConfig]
[-Requests]
[-OnlyBaseResources]
[-CustomConfig <String[]>]
[-MessageSize <Int32>]
[<CommonParameters>]
Description
The Export-FIMConfig cmdlet extracts configuration resources from themmsshortService. 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 ofExportObjectinstances.
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, PortalUIConfiguration, 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 themmseeWindows PowerShellâ„¢ cmdlet set see about_FIM.
Examples
EXAMPLE 1
$pilot = Export-FIMConfig -uri http://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 http://pilot:5725/ResourceManagementService -policyConfig $pilot | ConvertFrom-FIMResource -file pilot.xml $pilot = ConvertTo-FIMResource -file pilot.xml $production = Export-FIMConfig -uri http://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 http://production:5725/ResourceManagementService
This is an end-to-end scenario for migrating configuration from a pilotmmsshortenvironment to a productionmmsshortenvironment.
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 theExportObjectinstances from the output and use them for other purposes. One such purpose is generating reports.
Parameters
-AllLocales
{{Fill AllLocales Description}}
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
{{Fill Credential Description}}
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CustomConfig
{{Fill CustomConfig Description}}
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MessageSize
{{Fill MessageSize Description}}
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OnlyBaseResources
{{Fill OnlyBaseResources Description}}
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PamConfig
{{Fill PamConfig Description}}
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PolicyConfig
{{Fill PolicyConfig Description}}
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PortalConfig
{{Fill PortalConfig Description}}
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Requests
{{Fill Requests Description}}
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SchemaConfig
{{Fill SchemaConfig Description}}
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Uri
{{Fill Uri Description}}
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Inputs
None
Outputs
ExportObject[]