Personnaliser les fichiers XML USMT

Vue d'ensemble

Pour utiliser l’un des fichiers de.xml de migration avec les outils ScanState et LoadState , spécifiez ces fichiers sur la ligne de commande à l’aide de l’option /i . Étant donné que les outils ScanState et LoadState ont besoin des fichiers.xml pour contrôler la migration, spécifiez le même ensemble de fichiers .xml pour les ScanState.exe commandes et LoadState.exe . Toutefois, le Config.xml fichier avec l’option /config n’a pas besoin d’être spécifié, sauf si certains des fichiers et paramètres migrés du magasin doivent être exclus. Par exemple, pour migrer le dossier Documents vers le magasin, mais pas vers l’ordinateur de destination. Pour ce scénario, modifiez le Config.xml fichier et spécifiez le fichier mis à jour avec la LoadState.exe commande . La LoadState.exe commande migre ensuite uniquement les fichiers et paramètres souhaités.

Si un fichier .xml est exclu de la LoadState.exe commande, toutes les données du magasin qui ont été migrées avec les fichiers .xml manquants sont migrées. Toutefois, les règles de migration spécifiées avec la ScanState.exe commande ne s’appliquent pas. Par exemple, si un fichier .xml est oublié et qu’il contient une règle de réacheminement telle que :

MigsysHelperFunction.RelativeMove("c:\data", "%CSIDL_PERSONAL%")

L’outil USMT ne redirige pas les fichiers et ils sont migrés vers C:\data.

Pour modifier la migration, effectuez une ou plusieurs des opérations suivantes.

  • Modifiez les fichiers de .xml de migration. Pour exclure une partie d’un composant, modifiez les fichiers .xml . Par exemple, pour migrer C :\ mais exclure tous les fichiers .mp3 , ou pour déplacer des données vers un nouvel emplacement sur l’ordinateur de destination. Pour modifier ces fichiers, vous devez connaître les règles de migration et la syntaxe. Pour que ScanState et LoadState utilisent ces fichiers, spécifiez-les sur la ligne de commande lorsque chaque commande est entrée.

  • Créez un fichier .xml personnalisé. Un fichier .xml personnalisé peut également être créé pour migrer les paramètres d’une autre application ou pour modifier le comportement de migration en fonction des besoins de l’organization. Pour que ScanState et LoadState utilisent ce fichier, spécifiez-les sur les deux lignes de commande.

  • Créez et modifiez un fichier Config.xml. Créez et modifiez un Config.xml fichier pour exclure un composant entier de la migration. Par exemple, un Config.xml fichier peut être utilisé pour exclure l’intégralité du dossier Documents ou pour exclure les paramètres d’une application. Il est plus facile d’exclure des composants à l’aide d’un Config.xml fichier que de modifier les fichiers .xml de migration, car il n’est pas nécessaire de connaître les règles et la syntaxe de migration. En outre, l’utilisation d’un Config.xml fichier est la seule façon d’exclure les paramètres du système d’exploitation de la migration.

Pour plus d’informations sur l’exclusion de données, consultez l’article Exclure des fichiers et des paramètres .

Fichiers .xml de migration

Cette section décrit la migration .xml fichiers inclus avec l’outil USMT. Chaque fichier contient des règles de migration qui contrôlent les composants migrés et l’emplacement vers lequel ils sont migrés sur l’ordinateur de destination.

Remarque

L’astérisque (*) caractère générique peut être utilisé dans chacun de ces fichiers. Toutefois, un point d’interrogation ( ?) ne peut pas être utilisé comme caractère générique.

  • Fichier MigApp.xml. Spécifiez ce fichier avec les ScanState.exe commandes et pour LoadState.exe migrer les paramètres de l’application.

  • Fichier MigDocs.xml. Spécifiez ce fichier avec les outils ScanState et LoadState pour migrer tous les dossiers et fichiers utilisateur trouvés par la fonction d’assistance MigXmlHelper.GenerateDocPatterns . Cette fonction d’assistance recherche les données utilisateur qui résident à la racine d’un lecteur et dans le répertoire Utilisateurs. Toutefois, il ne trouve pas et ne migre pas de données d’application, de fichiers de programme ou de fichiers dans le répertoire Windows. Le MigDocs.xml fichier peut être modifié.

  • Fichier MigUser.xml. Spécifiez ce fichier avec les ScanState.exe commandes et LoadState.exe pour migrer les dossiers utilisateur, les fichiers et les types de fichiers. Le MigUser.xml fichier peut être modifié. Ce fichier ne contient pas de règles qui migrent des comptes d’utilisateur spécifiques. La seule façon de spécifier les comptes d’utilisateur à migrer est sur la ligne de commande à l’aide des options ScanState User et LoadState User.

Remarque

N’utilisez pas les MigUser.xml fichiers et MigDocs.xml ensemble. Pour plus d’informations, consultez les articles Identifier les types de fichiers, les fichiers et les dossiers et les meilleures pratiques USMT .

Fichiers .xml personnalisés

Des fichiers .xml personnalisés peuvent être créés pour personnaliser la migration en fonction des besoins uniques de l’organization. Par exemple, un fichier .xml personnalisé peut être créé pour migrer une application métier ou modifier le comportement de migration par défaut. Pour ScanState.exe et LoadState.exe pour utiliser ce fichier, spécifiez-le avec les deux commandes. Pour plus d’informations, consultez l’article Exemples XML personnalisés .

Fichier Config.xml

Le Config.xml fichier est un fichier facultatif qui est créé à l’aide de l’option /genconfig avec la ScanState.exe commande . Ce fichier doit être créé et modifié pour exclure certains composants de la migration. De plus, ce fichier doit être créé et modifié pour exclure la migration des paramètres du système d’exploitation. Le Config.xml format de fichier est différent de celui des fichiers .xml de migration, car il ne contient aucune règle de migration. Il contient uniquement une liste des composants du système d’exploitation, des applications et des documents utilisateur qui peuvent être migrés. Pour obtenir un exemple, consultez l’article fichierConfig.xml . Pour cette raison, l’exclusion de composants à l’aide du Config.xml fichier est plus facile que la modification de la migration .xml fichiers. Avec , Config.xmlla connaissance des règles de migration et de la syntaxe n’est pas. Toutefois, les caractères génériques ne peuvent pas être utilisés dans un Config.xml fichier.

Pour inclure tous les composants par défaut, il n’est pas nécessaire de créer un Config.xml fichier. Sinon, si le comportement de migration par défaut défini dans les MigApp.xmlfichiers , MigDocs.xmlet MigUser.xml est satisfaisant et que seuls certains composants doivent être exclus, un Config.xml fichier peut être créé. Les autres fichiers.xml peuvent être conservés dans leur état d’origine.

Lorsque la ScanState.exe commande est exécutée avec l’option /genconfig , ScanState.exe lit les autres fichiers.xml spécifiés à l’aide de l’option /i pour créer une liste personnalisée de composants pouvant être migrés à partir de l’ordinateur. Ce fichier contient uniquement les composants du système d’exploitation, les applications et les sections de document utilisateur qui se trouvent dans les deux fichiers .xml et qui sont installés sur l’ordinateur lorsque la ScanState.exe commande est exécutée avec l’option /genconfig . Par conséquent, ce fichier doit être créé sur un ordinateur source qui contient tous les composants, applications et paramètres présents sur les ordinateurs de destination. La création du fichier sur l’ordinateur source garantit que ce fichier contient tous les composants pouvant être migrés. Les composants sont organisés en sections : <Applications>, <WindowsComponents> et <Documents>. Pour choisir de ne pas migrer un composant, remplacez son entrée par migrate="no".

Une fois ce fichier créé, il doit uniquement être spécifié avec la commande à l’aide ScanState.exe de l’option /Config pour qu’il affecte la migration. Toutefois, si des données supplémentaires migrées vers le magasin doivent être exclues, modifiez le Config.xml fichier et spécifiez le fichier mis à jour avec la LoadState.exe commande . Par exemple, si le dossier Documents est collecté dans le magasin, mais que le dossier Documents n’a pas besoin d’être migré vers un ordinateur de destination, le Config.xml fichier peut être modifié pour indiquer migrate="no" avant l’exécution de la LoadState.exe commande et que le fichier n’est pas migré. Pour plus d’informations sur la priorité qui se produit lors de l’exclusion de données, consultez l’article Exclure des fichiers et des paramètres .

En outre, notez les fonctionnalités suivantes avec le Config.xml fichier :

  • Si un composant parent est supprimé de la migration dans le Config.xml fichier en spécifiant migrate="no", tous ses composants enfants sont automatiquement supprimés de la migration, même si le composant enfant a la valeur migrate="yes".

  • S’il existe par erreur deux lignes de code pour le même composant où une ligne spécifie migrate="no" et l’autre ligne spécifie migrate="yes", le composant est migré.

  • Dans USMT, plusieurs stratégies de migration peuvent être configurées dans le Config.xml fichier. Par exemple, des options ErrorControl>, ProfileControl et HardLinkStoreControl supplémentaires< peuvent être configurées.<><> Pour plus d’informations, consultez l’article FichierConfig.xml .

Remarque

Pour exclure un composant du Config.xml fichier, définissez la valeur de migration sur « non ». La suppression de la balise XML du composant du Config.xml fichier n’exclut pas le composant de la migration.

Exemples

  • La commande suivante crée un Config.xml fichier dans le répertoire actif, mais elle ne crée pas de magasin :

    ScanState.exe /i:MigApp.xml /i:MigDocs.xml /genconfig:Config.xml /v:5

  • La commande suivante crée un magasin chiffré à l’aide du Config.xml fichier et des fichiers de migration par défaut.xml :

    ScanState.exe \\server\share\migration\mystore /i:MigApp.xml /i:MigDocs.xml /o /config:Config.xml /v:5 /encrypt /key:"mykey"

  • La commande suivante déchiffre le magasin et migre les fichiers et les paramètres :

    LoadState.exe \\server\share\migration\mystore /i:MigApp.xml /i:MigDocs.xml /v:5 /decrypt /key:"mykey"

Informations complémentaires