Présentation des fichiers XML de migration

Vous pouvez modifier le comportement d’une migration de base de l’Outil de migration utilisateur (USMT) 5.0 à l’aide de fichiers XML ; ces fichiers fournissent des instructions sur l’emplacement et la manière dont les outils de l’USMT doivent regrouper et appliquer des fichiers et des paramètres. L’USMT comprend trois fichiers XML permettant de personnaliser une migration de base : les fichiers MigDocs.xml et MigUser.xml qui modifient le mode de détection des fichiers sur l’ordinateur source, et le fichier MigApps.xml qui est indispensable à la migration des paramètres d’application pris en charge. Vous pouvez également créer et modifier des fichiers XML personnalisés, ainsi qu’un fichier Config.xml pour personnaliser davantage votre migration.

Cette rubrique offre un aperçu des fichiers XML de migration par défaut et personnalisés et inclut des consignes sur la manière de créer et de modifier une version personnalisée du fichier MigDocs.xml. Le fichier MigDocs.xml se sert de la nouvelle fonction GenerateDocPatterns de l’USMT pour rechercher automatiquement des documents utilisateur sur un ordinateur source.

Dans cette rubrique

Vue d’ensemble du fichier Config.xml

Vue d’ensemble du fichier MigApp.xml

Vue d’ensemble du fichier MigDocs.xml

Vue d’ensemble du fichier MigUser.xml

Utilisation de plusieurs fichiers XML

Règles XML de migration des fichiers utilisateur

Création et modification d’un fichier XML personnalisé

Fonction GenerateDocPatterns

Présentation du contexte système et du contexte utilisateur

Exemples de règles de migration pour les versions personnalisées des fichiers XML

Exemples d’utilisation des règles d’exclusion

Exemples d’utilisation des règles d’inclusion

Étapes suivantes

Vue d’ensemble du fichier Config.xml

Le fichier Config.xml est le fichier de configuration créé par l’option /genconfig de l’outil ScanState. Il peut servir à modifier les composants du système d’exploitation qui sont migrés par l’USMT. Le fichier Config.xml peut être utilisé conjointement avec d’autres fichiers XML, comme dans l’exemple suivant : scanstate /i:migapps.xml /i:migdocs.xml /genconfig:c:\myFolder\config.xml. S’il est utilisé dans ce cadre, le fichier Config.xml surveille étroitement tous les aspects de la migration, y compris les profils utilisateur, les données et les paramètres, sans modifier ou créer d’autres fichiers XML. Pour plus d’informations sur le fichier Config.xml, voir Personnaliser les fichiers XML de l’outil USMT et Fichier Config.xml.

Vue d’ensemble du fichier MigApp.xml

Le fichier MigApp.xml installé avec l’USMT comprend des instructions sur la migration des paramètres des applications répertoriées dans Quels sont les éléments migrés par l’outil USMT ?. Lorsque vous utilisez les outils ScanState et LoadState, vous devez inclure le fichier MigApp.xml en vous servant de l’option /i pour migrer les paramètres d’application. Les fichiers MigDocs.xml et MigUser.xml ne permettent pas de migrer des paramètres d’application. Vous pouvez créer un fichier XML personnalisé pour intégrer des applications supplémentaires. Pour plus d’informations, voir Personnaliser les fichiers XML de l’outil USMT.

Vue d’ensemble du fichier MigDocs.xml

Le fichier MigDocs.xml fait appel à la nouvelle fonction d’assistance GenerateDocPatterns pour élaborer des instructions permettant à l’USMT de migrer des fichiers à partir de l’ordinateur source, en fonction de l’emplacement des fichiers. Vous pouvez utiliser le fichier MigDocs.xml avec les outils ScanState et LoadState pour réaliser une migration plus ciblée que si vous utilisiez l’USMT sans instructions XML.

Le fichier MigDocs.xml par défaut migre les éléments suivants :

• Tous les fichiers à la racine du lecteur, à l’exception de %WINDIR%, %PROGRAMFILES%, %PROGRAMDATA% ou %USERS%.

• Tous les dossiers dans le répertoire racine de tous les lecteurs fixes. Par exemple : c:\data_mail\*[*]

• Tous les fichiers à la racine du dossier Profils, à l’exception des fichiers dans le profil système. Par exemple : c:\users\name[mail.pst]

• Tous les dossiers à la racine du dossier Profils, à l’exception des dossiers du profil système. Par exemple : c:\users\name\new folder\*[*]

• Dossiers partagés standard :

  • CSIDL_COMMON_DESKTOPDIRECTORY

  • CSIDL_COMMON_FAVORITES

  • CSIDL_COMMON_DOCUMENTS

  • CSIDL_COMMON_MUSIC

  • CSIDL_COMMON_PICTURES

  • CSIDL_COMMON_VIDEO

  • FOLDERID_PublicDownloads

• Dossiers de profil utilisateur standard pour chaque utilisateur :

  • CSIDL_MYDOCUMENTS

  • CSIDL_MYPICTURES

  • FOLDERID_OriginalImages

  • CSIDL_MYMUSIC

  • CSIDL_MYVIDEO

  • CSIDL_FAVORITES

  • CSIDL_DESKTOP

  • CSIDL_QUICKLAUNCH

  • FOLDERID_Contacts

  • FOLDERID_Libraries

  • FOLDERID_Downloads

  • FOLDERID_SavedGames

  • FOLDERID_RecordedTV

Le fichier MigDocs.xml par défaut ne migre pas les éléments suivants :

• Fichiers balisés à la fois avec les attributs hidden et system.

• Fichiers et dossiers sur des lecteurs amovibles.

• Données des dossiers %WINDIR%, %PROGRAMDATA% et %PROGRAMFILES%.

• Dossiers contenant des applications installées.

Vous pouvez également utiliser l’option /genmigxml avec l’outil ScanState pour examiner et modifier les fichiers à migrer. Pour plus d’informations, consultez la section Création et modification d’un fichier XML personnalisé de ce document.

Vue d’ensemble du fichier MigUser.xml

Le fichier MigUser.xml renferme des instructions qui permettent à l’USMT de migrer des fichiers utilisateur en se basant sur les extensions dans les noms des fichiers. Vous pouvez utiliser le fichier MigUser.xml avec les outils ScanState et LoadState pour réaliser une migration plus ciblée que si vous utilisiez l’USMT sans instructions XML. Le fichier MigUser.xml collecte tous les fichiers des dossiers de profil utilisateur standard, ainsi que tous les fichiers stockés sur l’ordinateur et dont les noms portent les extensions spécifiées.

Le fichier MigUser.xml par défaut migre les éléments suivants :

• Tous les fichiers des dossiers de profil utilisateur standard qui se présentent de la manière suivante :

  • CSIDL_MYVIDEO

  • CSIDL_MYMUSIC

  • CSIDL_DESKTOP

  • CSIDL_STARTMENU

  • CSIDL_PERSONAL

  • CSIDL_MYPICTURES

  • CSIDL_FAVORITES

  • CSIDL_QUICK LAUNCH

• Fichiers portant les extensions suivantes :

  .qdf, .qsd, .qel, .qph, .doc*, .dot*, .rtf, .mcw, .wps, .scd, .wri, .wpd, .xl*, .csv, .iqy, .dqy, .oqy, .rqy, .wk*, .wq1, .slk, .dif, .ppt*, .pps*, .pot*, .sh3, .ch3, .pre, .ppa, .txt, .pst, .one*, .vl*, .vsd, .mpp, .or6, .accdb, .mdb, .pub

Le fichier MigUser.xml par défaut ne migre pas les éléments suivants :

• Fichiers balisés à la fois avec les attributs hidden et system.

• Fichiers et dossiers sur des lecteurs amovibles.

• Données des dossiers %WINDIR%, %PROGRAMFILES% et %PROGRAMDATA%.

• Listes de contrôle d’accès (ACL) des fichiers des dossiers situés en dehors du profil utilisateur.

Vous pouvez créer une copie du fichier MigUser.xml et le modifier pour inclure et exclure des dossiers de profil utilisateur standard et des extensions de noms de fichiers. Si vous connaissez toutes les extensions des fichiers que vous souhaitez migrer à partir de l’ordinateur source, servez-vous du fichier MigUser.xml pour déplacer l’ensemble des données pertinentes, quel que soit l’emplacement des fichiers. Notez cependant que cette opération peut aboutir à une migration susceptible de contenir plus de fichiers que prévu. Par exemple, si vous choisissez de migrer tous les fichiers JPG, vous pouvez migrer des fichiers image, tels que des miniatures et des logos, à partir d’applications héritées installées sur l’ordinateur source.

Utilisation de plusieurs fichiers XML

Plusieurs fichiers XML peuvent être utilisés avec les outils ScanState et LoadState. Chacun des fichiers XML par défaut inclus dans l’USMT ou créés par ce dernier est configuré pour un composant spécifique de la migration. Vous pouvez également utiliser des fichiers XML personnalisés en supplément de ces fichiers par défaut en mettant en place des règles de migration supplémentaires.

Par exemple, vous pouvez utiliser tous les types de fichiers XML de migration pour une seule et unique migration, comme dans l’exemple qui suit :

Scanstate <store> /config:c:\myFolder\config.xml /i:migapps.xml /i:migdocs.xml /i:customrules.xml

Règles XML de migration des fichiers utilisateur

Si votre jeu de données est inconnu ou si un grand nombre de fichiers sont stockés hors des dossiers de profil utilisateur standard, le fichier MigDocs.xml s’avère un meilleur choix que le fichier MigUser.xml car il permet de rassembler un plus large éventail de données. Le fichier MigDocs.xml migre les dossiers de données en fonction de l’emplacement. Le fichier MigUser.xml migre seulement les fichiers dont les noms portent les extensions spécifiées.

Pour contrôler davantage le processus de migration, vous pouvez créer des fichiers XML personnalisés. Consultez la section Création et modification d’un fichier XML personnalisé de ce document.

Création et modification d’un fichier XML personnalisé

Vous pouvez utiliser l’option de ligne de commande /genmigxml pour identifier les fichiers à intégrer dans votre migration. L’option /genmigxml crée un fichier à un emplacement précisé par vos soins pour vous permettre de passer les règles XML en revue et d’y apporter des modifications selon vos besoins.

Pour créer les règles de migration XML d’un ordinateur source :

1. Cliquez sur Démarrer, sur Tous les programmes, puis sur Accessoires. Cliquez avec le bouton droit sur Invite de commandes, puis cliquez sur Exécuter en tant que.

2. Sélectionnez un compte disposant de privilèges d’administrateur, fournissez un mot de passe, puis cliquez sur OK.

3. À partir de l’invite de commandes, tapez :

   cd /d <USMTpath>
   
   scanstate.exe /genmigxml: <filepath.xml>
   

   Où <USMTpath> représente l’emplacement sur votre ordinateur source où vous avez enregistré les outils et fichiers d’USMT tandis que <filepath.xml> est le chemin d’accès complet à un fichier où vous pouvez enregistrer le rapport. Par exemple, tapez :

   cd /d c:\USMT
   
   scanstate.exe /genmigxml:"C:\Documents and Settings\USMT Tester\Desktop\genMig.xml"
   

Fonction GenerateDocPatterns

Le fichier MigDocs.xml appelle la fonction GenerateDocPatterns qui accepte trois valeurs booléennes. Vous pouvez modifier les paramètres pour changer la manière dont le fichier MigDocs.xml crée les règles XML en vue de la migration.

<pattern type="File">C:\Program Files\Microsoft Office\*[*.doc]</pattern>

Utilisation :

MigXmlHelper.GenerateDocPatterns ("<ScanProgramFiles>", "<IncludePatterns>", "<SystemDrive>")

Pour créer des modèles de données d’inclusion pour le lecteur système uniquement :

<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>

     <objectSet>

        <script>MigXmlHelper.GenerateDocPatterns ("FALSE","TRUE","TRUE")</script>

     </objectSet>

</include>

Pour créer une règle d’inclusion afin de collecter des fichiers avec des extensions enregistrées à partir du répertoire %PROGRAMFILES% :

<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>

     <objectSet>

        <script>MigXmlHelper.GenerateDocPatterns ("TRUE","TRUE","FALSE")</script>

     </objectSet>

</include>

Pour créer des des modèles de données d’exclusion :

<exclude filter='MigXmlHelper.IgnoreIrrelevantLinks()'>

     <objectSet>

        <script>MigXmlHelper.GenerateDocPatterns ("FALSE","FALSE","FALSE")</script>

     </objectSet>

</exclude>

Présentation du contexte système et du contexte utilisateur

Les fichiers XML de migration contiennent deux éléments <component> avec des paramètres context différents. Le contexte système concerne les fichiers qui ne sont pas stockés dans le répertoire Profil des utilisateurs de l’ordinateur tandis que le contexte utilisateur s’applique aux fichiers propres à un utilisateur seul.

Contexte système

Le contexte système inclut des règles pour des données externes au répertoire Profils des utilisateurs. Par exemple, lorsque vous l’appelez depuis un contexte système dans le fichier MigDocs.xml, la fonction GenerateDocPatterns crée des modèles pour tous les dossiers shell courants, les fichiers stockés dans le répertoire racine des disques durs et les dossiers situés à la racine des disques durs. Les dossiers suivants sont inclus :

• CSIDL_COMMON_DESKTOPDIRECTORY

• CSIDL_COMMON_FAVORITES

• CSIDL_COMMON_DOCUMENTS

• CSIDL_COMMON_MUSIC

• CSIDL_COMMON_PICTURES

• CSIDL_COMMON_VIDEO

• FOLDERID_PublicDownloads

Contexte utilisateur

Le contexte utilisateur inclut des règles pour des données incluses dans le répertoire Profils des utilisateurs. Si vous l’appelez depuis un contexte utilisateur dans le fichier MigDocs.xml, la fonction GenerateDocPatterns crée des modèles pour tous les dossiers shell courants, les fichiers situés à la racine du profil et les dossiers à cette même racine. Les dossiers suivants sont inclus :

• CSIDL_MYDOCUMENTS

• CSIDL_MYPICTURES

• FOLDERID_OriginalImages

• CSIDL_MYMUSIC

• CSIDL_MYVIDEO

• CSIDL_FAVORITES

• CSIDL_DESKTOP

• CSIDL_QUICKLAUNCH

• FOLDERID_Contacts

• FOLDERID_Libraries

• FOLDERID_Downloads

• FOLDERID_SavedGames

• FOLDERID_RecordedTV

Exemples de règles de migration pour les versions personnalisées des fichiers XML

Exemples d’utilisation des règles d’exclusion

Dans les exemples ci-dessous, l’ordinateur source dispose d’un fichier TXT appelé « new text document » situé dans un répertoire « new folder ». Par défaut, MigDocs.xml migre le fichier « new text document.txt » et tous les fichiers figurant dans le répertoire « new folder ». Les règles générées par la fonction sont les suivantes :

<pattern type="File">d:\new folder\[new text document.txt]</pattern>

<pattern type="File">d:\new folder\*[*]</pattern>

Pour exclure le fichier « new text document.txt », ainsi que tous les fichiers TXT du répertoire « new folder », vous pouvez effectuer les opérations suivantes :

Exemple 1 : Exclure tous les fichiers TXT dans un dossier

Pour la règle 1 d’exclusion, le nom du fichier doit bénéficier d’une correspondance exacte. En revanche, pour la règle 2, vous pouvez créer un modèle qui exclut les fichiers au moyen de l’extension de nom de fichier.

<exclude>

     <objectSet>

        <pattern type="File">D:\Newfolder\[new text document.txt]</pattern>

         <pattern type="File">D:\New folder\*[*.txt]</pattern>

     </objectSet>

</exclude>

Exemple 2 : Utiliser l’élément UnconditionalExclude pour rendre une règle prioritaire sur les règles d’inclusion

Si vous ne connaissez pas le nom du fichier ou l’emplacement de ce dernier mais connaissez par contre l’extension du nom du fichier, vous pouvez faire appel à la fonction GenerateDrivePatterns. Cependant, la règle sera moins spécifique que la règle d’inclusion par défaut créée par le fichier MigDocs.xml. Elle ne sera donc pas prioritaire. Vous devez utiliser l’élément <UnconditionalExclude> pour rendre cette règle prioritaire par rapport à la la règle d’inclusion par défaut. Pour plus d’informations sur l’ordre de priorité des règles de migration XML, voir Conflits et priorité.

<unconditionalExclude>

     <objectSet>

        <script>MigXmlHelper.GenerateDrivePatterns ("*[*.txt]", "Fixed")</script>

     </objectSet>

</unconditionalExclude>

Exemple 3 : Utiliser un composant contextuel UserandSystem pour exécuter des règles dans les deux contextes

Pour appliquer éventuellement l’élément <UnconditionalExclude> aux contextes système et utilisateur à la fois, vous pouvez créer un troisième composant à l’aide du contexte UserandSystem. Les règles inscrites dans ce composant seront exécutées dans les deux contextes.

<component type="Documents" context="UserandSystem">

   <displayName>MigDocExcludes</displayName>

   <role role="Data">

     <rules>

       <unconditionalExclude>

         <objectSet>

                <script>MigXmlHelper.GenerateDrivePatterns ("*[*.txt]", "Fixed")</script>

         </objectSet>

       </unconditionalExclude>

     </rules>

   </role>

</component>

Pour obtenir plus d’exemples de règles d’exclusion à exploiter dans les fichiers XML de migration personnalisés, voir Exclure des fichiers et des paramètres.

Exemples d’utilisation des règles d’inclusion

Le répertoire des données d’application est l’emplacement le plus courant auquel vous auriez besoin d’ajouter une règle d’inclusion. Par défaut, la fonction GenerateDocPatterns exclut cet emplacement. Si votre société travaille avec une application qui enregistre un volume conséquent de données à cet emplacement, vous pouvez concevoir des règles d’inclusion pour migrer les données. Par exemple, l’emplacement par défaut des fichiers PST est : %CSIDL_LOCAL_APPDATA%\Microsoft\Outlook. Le fichier Migapp.xml comprend des règles de migration destinées à transférer uniquement les fichiers PST associés à Microsoft Outlook. Pour inclure des fichiers PST non associés, vous pouvez effectuer les opérations suivantes :

Exemple 1 : Inclure une extension de nom de fichier dans un dossier utilisateur connu

Cette règle inclut les fichiers PST qui se trouvent dans l’emplacement par défaut mais ne sont pas associés à Microsoft Outlook. Servez-vous du contexte utilisateur pour exécuter cette règle pour chaque utilisateur de l’ordinateur.

<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>

     <objectSet>

        <pattern type="File">%CSIDL_LOCAL_APPDATA%\Microsoft\Outlook\*[*.pst]</pattern>

     </objectSet>

</include>

Exemple 2 : Inclure une extension de nom de fichier dans le dossier Program Files

Pour les emplacements en dehors du profil utilisateur, notamment le dossier Program Files, vous pouvez ajouter la règle au composant du contexte système.

<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>

     <objectSet>

        <pattern type="File">%CSIDL_PROGRAM_FILES%\*[*.pst]</pattern>

     </objectSet>

</include>

Pour obtenir plus d’exemples de règles d’inclusion à exploiter dans les fichiers XML de migration personnalisés, voir Inclure des fichiers et des paramètres.

Étapes suivantes

Vous pouvez inclure des règles supplémentaires pour la migration dans le fichier MigDocs.xml ou dans d’autres fichiers XML de migration. Par exemple, l’élément <locationModify> peut être employé pour déplacer des fichiers du dossier où ils ont été rassemblés vers un autre dossier lorsque vous les appliquez à l’ordinateur de destination. Pour plus d’informations, voir Informations de référence XML de l’outil USMT.

Vous pouvez utiliser un fichier de schéma XML (MigXML.xsd) pour valider la syntaxe de vos fichiers XML personnalisés. Pour plus d’informations, voir Ressources de l’outil USMT.

Voir aussi

Autres ressources

Exclure des fichiers et des paramètres
Inclure des fichiers et des paramètres