Partager via

Personnaliser les fichiers XML de l’outil USMT

  • Article

Dans cette rubrique

Vue d’ensemble

Fichiers .xml de migration

Fichiers .xml personnalisés

Fichier Config.xml

Exemples

Informations supplémentaires

Vue d’ensemble

Si vous souhaitez que les outils ScanState et LoadState utilisent les fichiers .xml de migration, spécifiez ces fichiers sur la ligne de commande à l’aide de l’option /i. Les outils ScanState et LoadState ayant besoin des fichiers .xml pour contrôler la migration, spécifiez le même jeu de fichiers .xml pour les commandes ScanState et LoadState. Cependant, il n’est pas nécessaire de spécifier le fichier Config.xml avec l’option /config, sauf si vous voulez exclure certains fichiers et paramètres que vous avez migrés vers le magasin. Par exemple, vous pourriez vouloir migrer le dossier Mes documents vers le magasin, mais pas vers l’ordinateur de destination. Pour ce faire, modifiez le fichier Config.xml et spécifiez le fichier mis à jour avec la commande LoadState. La commande LoadState ne migre alors que les fichiers et paramètres de votre choix.

Si vous omettez un fichier .xml dans la commande LoadState, toutes les données du magasin qui ont été migrées avec le fichier .xml manquant sont migrées. Cependant, les règles de migration qui ont été spécifiées avec la commande ScanState ne s’appliquent pas. Par exemple, si vous omettez un fichier .xml comportant une règle de redirection, comme MigsysHelperFunction.RelativeMove("c:\data", "%CSIDL_PERSONAL%"), USMT ne redirige pas les fichiers, qui sont migrés vers C:\data.

Pour modifier la migration, effectuez l’une ou plusieurs opérations suivantes :

  • Modifiez les fichiers .xml de migration. Vous devez modifier les fichiers .xml si vous souhaitez exclure une partie d’un composant (par exemple, migrer C: en excluant tous les fichiers .mp3) ou déplacer les données vers un nouvel emplacement sur l’ordinateur de destination. Pour modifier ces fichiers, vous devez connaître la syntaxe et les règles de migration. Pour que ScanState et LoadState utilisent ces fichiers, spécifiez-les sur la ligne de commande en même temps que la commande.

  • Créez un fichier .xml personnalisé. Vous pouvez également créer un fichier .xml personnalisé pour migrer les paramètres d’une autre application ou pour modifier le comportement de migration en fonction de vos besoins. Pour que ScanState et LoadState utilisent ce fichier, vous devez le spécifier sur les deux lignes de commande.

  • Créez et modifiez un fichier Config.xml. Exécutez cette opération si vous souhaitez exclure de la migration tout un composant (par exemple, exclure tout le dossier Mes documents, ou exclure les paramètres d’une application). Il est plus facile d’exclure des composants en utilisant un fichier Config.xml qu’en modifiant les fichiers .xml de migration, car vous n’avez pas besoin de connaître la syntaxe et les règles de migration. De plus, l’utilisation de ce 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, voir Exclure des fichiers et des paramètres.

Fichiers .xml de migration

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

Notes

Vous pouvez utiliser le caractère générique * (astérisque) dans tous ces fichiers. Par contre, vous ne pouvez pas utiliser le point d’interrogation (?) comme caractère générique.

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

  • MigDocs.xml. Spécifiez ce fichier avec les commandes ScanState et LoadState pour migrer tous les dossiers et fichiers utilisateur trouvés par la fonction d’assistance MigXmlHelper.GenerateDocPatterns. Cette fonction d’assistance trouve les données utilisateur résidant à la racine de tout lecteur et dans le répertoire Utilisateurs. En revanche, il ne permet pas de trouver et migrer les données d’application, les fichiers programme, ni aucun fichier du répertoire Windows. Vous pouvez modifier le fichier MigDocs.xml.

  • MigUser.xml. Spécifiez ce fichier avec les commandes ScanState et LoadState pour migrer des dossiers, fichiers et types de fichiers utilisateur. Vous pouvez modifier le fichier MigUser.xml. Ce fichier ne contient aucune règle migrant des comptes d’utilisateurs spécifiques. Le seul endroit où spécifier les comptes d’utilisateurs à migrer est sur la ligne de commande, à l’aide des options utilisateur de ScanState et LoadState.

    Notes

    N’utilisez pas en même temps les fichiers MigUser.xml et MigDocs.xml. Pour plus d’informations, reportez-vous aux rubriques Identifier les types de fichiers, les fichiers et les dossiers et Meilleures pratiques concernant USMT.

Fichiers .xml personnalisés

Vous pouvez créer des fichiers .xml personnalisés pour adapter la migration en fonction de vos besoins. Imaginons par exemple que vous souhaitez créer un fichier personnalisé pour migrer une application métier ou pour modifier le comportement de migration par défaut. Si vous souhaitez que ScanState et LoadState utilisent ce fichier, spécifiez-le avec les deux commandes. Pour plus d’informations, voir Personnaliser les fichiers XML de l’outil USMT.

Fichier Config.xml

Il s’agit d’un fichier facultatif, que vous pouvez créer à l’aide de l’option /genconfig sur la ligne de commande ScanState. Vous devez créer et modifier ce fichier pour pouvoir exclure certains composants de la migration. Vous devez également créer et modifier ce fichier pour pouvoir exclure des paramètres du système d’exploitation de la migration. Le format de ce fichier est différent de celui des fichiers .xml de migration car il ne contient aucune règle de migration (seulement la liste des composants du système d’exploitation, des applications et des documents utilisateur pouvant faire l’objet d’une migration). Pour un exemple, reportez-vous à la rubrique Fichier Config.xml. Pour cette raison, il est plus facile d’exclure des composants en utilisant ce fichier qu’en modifiant les fichiers .xml de migration, car vous n’avez pas besoin de connaître la syntaxe et les règles de migration. Vous ne pouvez pas utiliser de caractères génériques dans ce fichier.

Vous n’avez pas besoin de créer de fichier Config.xml pour inclure tous les composants par défaut. Sinon, si vous êtes satisfait du comportement de migration par défaut défini dans les fichiers MigSys.xml, MigApp.xml et MigUser.xml et que vous souhaitez seulement exclure certains composants, vous pouvez créer et modifier un fichier Config.xml et laisser les autres fichiers .xml tels quels.

Lorsque vous exécutez la commande ScanState avec l’option /genconfig, ScanState lit les autres fichiers .xml (spécifiés à l’aide de l’option /i) afin de créer une liste personnalisée des composants de l’ordinateur pouvant faire l’objet d’une migration. Ce fichier contient uniquement les composants du système d’exploitation, les applications et les sections des documents utilisateur qui sont à la fois dans les fichiers .xml et installés sur l’ordinateur lorsque vous exécutez la commande ScanState avec l’option /genconfig. Vous devez donc créer ce fichier sur un ordinateur source sur lequel se trouvent tous les composants, applications et paramètres qui seront présents sur les ordinateurs de destination. Vous avez ainsi la garantie que ce fichier contient tous les composants pouvant faire l’objet d’une migration. Les composants sont classés en différentes sections : <Applications>, <WindowsComponents> et <Documents>. Pour ne pas migrer un composant, définissez simplement l’entrée correspondante sur migrate="no".

Une fois ce fichier créé, vous devez le spécifier sur la ligne de commande ScanState à l’aide de l’option /Config pour qu’elle ait une incidence sur la migration. Néanmoins, si vous souhaitez exclure d’autres données ayant fait l’objet d’une migration vers le magasin, modifiez le fichier Config.xml et spécifiez le fichier mis à jour avec la commande LoadState. Par exemple, si vous avez récupéré le dossier Mes documents dans le magasin mais que vous décidez de ne pas le migrer vers un ordinateur de destination, vous pouvez modifier le fichier Config.xml (en indiquant migrate="no") avant d’exécuter la commande LoadState pour que ce dossier ne soit pas migré. Pour plus d’informations sur les priorités qui s’appliquent dans le cadre de l’exclusion de données, reportez-vous à la rubrique Exclure des fichiers et des paramètres.

En outre, notez les points suivants concernant le fichier Config.xml :

  • Si un composant parent est supprimé de la migration dans le fichier Config.xml via le paramètre migrate="no", tous ses composants enfants sont automatiquement supprimés de la migration (même si le composant enfant est défini sur migrate="yes").

  • Si vous disposez par erreur de deux lignes de code pour le même composant, l’une indiquant migrate="no" et l’autre migrate="yes", le composant est migré.

  • Dans USMT, plusieurs stratégies de migration peuvent être configurées dans le fichier Config.xml. Par exemple, vous pouvez configurer des options <ErrorControl>, <ProfileControl> et <HardLinkStoreControl> supplémentaires. Pour plus d’informations, reportez-vous à la rubrique Fichier Config.xml.

Notes

Pour exclure un composant du fichier Config.xml, affectez « no » à la valeur migrate. La suppression de la balise XML du composant dans le fichier Config.xml n’entraîne pas l’exclusion du composant de votre migration.

Exemples

  • La commande suivante crée un fichier Config.xml dans le répertoire en cours (sans créer de magasin) :

    scanstate /i:migapp.xml /i:migdocs.xml /genconfig:config.xml /v:5

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

    scanstate \\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 \\server\share\migration\mystore /i:migapp.xml /i:migdocs.xml /v:5 /decrypt /key:"mykey"

Informations supplémentaires

Voir aussi

Autres ressources

Syntaxe de la ligne de commande de l’Outil de migration utilisateur (USMT)
Ressources de l’outil USMT