Start Migration - wim-beck/IS4U-FIM-Powershell GitHub Wiki

Synopsis

Starts the migration of a MIM-Setup by either comparing certain configurations between a source MIM-Setup and a target MIM-Setup or importing the delta in a target MIM-Setup.

Syntax

Start-Migration [-All] [-CompareSchema] [-ComparePolicy] [-ComparePortal] [-ImportDelta] [[-PathForDelta] <String>] [[-PathToConfigFiles] <String>] [<CommonParameters>]

Description

The source MIM-Setup xml files are acquired by calling Export-MIMConfig in the source environment. Start-Migration will serialize the target MIM setup resources to clixml and deserialize them so they can be compared with the resources from the source xml files. The differences that are found are writen to a Lithnet-format xml file called ConfigurationDelta.xml. When Start-Migration is called with -ImportDelta, the FimDelta.exe program is called and the user can choose which resources get imported from the configuration delta. The final (or total) configuration then gets imported in the target MIM-Setup.

IMPORTANT

This module has been designed to only use Start-Migration and Export-MIMSetup functions. When other function are called there is no guarantee the desired effect will be accomplished.

Parameters

All

If Start-Migration is called with the flag parameter '-All', all resources that are found in the Source and Target MIM-Setup will be compared. This will automatically create a complete ConfigurationDelta.xml where all the new and different resources are stored for every MIM-object type.

Property Value
Type SwitchParameter
Required false
Position named
Default value False
Accept pipeline input false

CompareSchema

This parameter has the same effect as ComparePolicy and ComparePortal: The variable All will be set to false, this will cause to only compare the configurations where the flags are called, in this case the Schema configuration.

Property Value
Type SwitchParameter
Required false
Position named
Default value False
Accept pipeline input false

ComparePolicy

Property Value
Type SwitchParameter
Required false
Position named
Default value False
Accept pipeline input false

ComparePortal

Property Value
Type SwitchParameter
Required false
Position named
Default value False
Accept pipeline input false

ImportDelta

To ensure the differences get imported in the target MIM-Setup, call 'Start-Migration -ImportDelta'. This will use the created ConfigurationDelta.xml (from the chosen configurations) with Start-FimDelta (FimDelta.exe). If the user wishes to not import all resources and saves the selected resources, a ConfigurationDelta2.xml file will be created. The ConfigurationDelta.xml or ConfigurationDelta2.xml then gets imported in the target MIM-Setup.

Property Value
Type SwitchParameter
Required false
Position named
Default value False
Accept pipeline input false

PathForDelta

Optional parameter to declare a path where the ConfigurationDelta(2).xml will be saved. If this parameter is not declared a folder browser prompt will appear where the user can choose this path.

Property Value
Type String
Required false
Position 1
Default value
Accept pipeline input false

PathToConfigFiles

Optional parameter to declare a path where the resources in xml files are located. If this parameter is not declared a folder browser prompt will appear where the user can choose this path.

Property Value
Type String
Required false
Position 2
Default value
Accept pipeline input false

Examples

Start-Migration -All -PathForDelta "C:\" -PathToConfigFiles "C:\Program Files\MIMExportFiles" Start-Migration -ComparePolicy

Start-Migration -ImportDelta

⚠️ **GitHub.com Fallback** ⚠️