Présentation des fichiers XML de migration

Le comportement d’une migration usMT (User State Migration Tool) de base peut être modifié à l’aide de fichiers XML. Ces fichiers fournissent des instructions sur l’emplacement et la façon dont les outils USMT doivent collecter et appliquer les fichiers et les paramètres. L’outil USMT comprend trois fichiers XML qui peuvent être utilisés pour personnaliser une migration de base : les MigDocs.xml fichiers et MigUser.xml , qui modifient la façon dont les fichiers sont découverts sur l’ordinateur source, et le fichier MigApps.xml, qui est requis pour migrer les paramètres d’application pris en charge. Des fichiers XML personnalisés et un Config.xml fichier peuvent être créés et modifiés pour personnaliser davantage la migration.

Cet article fournit une vue d’ensemble des fichiers XML de migration par défaut et personnalisés, et inclut des instructions pour la création et la modification d’une version personnalisée du MigDocs.xml fichier. Le MigDocs.xml fichier utilise la nouvelle GenerateDocPatterns fonction disponible dans USMT pour rechercher automatiquement les documents utilisateur sur un ordinateur source.

Vue d’ensemble du fichier Config.xml

Le Config.xml fichier est le fichier de configuration créé par l’option /genconfig de l’outil ScanState . Il peut être utilisé pour modifier les composants du système d’exploitation qu’USMT migre. Le Config.xml fichier peut être utilisé avec d’autres fichiers XML, comme dans l’exemple suivant :

ScanState.exe /i:migapps.xml /i:MigDocs.xml /genconfig:c:\myFolder\Config.xml

Lorsqu’il est utilisé de cette façon, le Config.xml fichier contrôle étroitement les aspects de la migration, notamment les profils utilisateur, les données et les paramètres, sans modifier ni créer d’autres fichiers XML. Pour plus d’informations sur le Config.xml fichier, consultez Personnaliser les fichiers XML USMT et Config.xml file.

Vue d’ensemble du fichier MigApp.xml

Le MigApp.xml fichier installé avec l’outil USMT inclut des instructions pour migrer les paramètres des applications répertoriées dans Qu’est-ce que l’outil USMT migre ?. Pour migrer les paramètres d’application, le MigApp.xml fichier doit être inclus lors de l’utilisation des outils ScanState et LoadState à l’aide de l’option /i . Les MigDocs.xml fichiers et MigUser.xml ne migrent pas les paramètres de l’application. Un fichier XML personnalisé peut être créé pour inclure des applications supplémentaires. Pour plus d’informations, consultez Personnaliser les fichiers XML USMT.

Vue d’ensemble du fichier MigDocs.xml

Le MigDocs.xml fichier utilise la nouvelle GenerateDocPatterns fonction d’assistance pour créer des instructions permettant à l’outil USMT de migrer des fichiers à partir de l’ordinateur source, en fonction de l’emplacement des fichiers. Le MigDocs.xml fichier peut être utilisé avec les outils ScanState et LoadState pour effectuer une migration plus ciblée que l’utilisation d’USMT sans instructions XML.

Le fichier par défaut MigDocs.xml migre les données suivantes :

• Tous les fichiers à la racine du lecteur, à l’exception %WINDIR%de , %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 de la racine du dossier Profiles, à l’exception des fichiers du profil système. Par exemple : c:\users\name[mail.pst].

• Tous les dossiers de la racine du dossier Profiles, à l’exception des dossiers de 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 par défaut MigDocs.xml ne migre pas les données suivantes :

• Fichiers marqués avec les attributs masqués et système .

• Fichiers et dossiers sur les lecteurs amovibles.

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

• Dossiers qui contiennent des applications installées.

L’option /genmigxml peut être utilisée avec l’outil ScanState pour examiner et modifier les fichiers migrés.

Vue d’ensemble du fichier MigUser.xml

Le MigUser.xml fichier contient des instructions permettant à USMT de migrer des fichiers utilisateur en fonction des extensions de nom de fichier. Le MigUser.xml fichier peut être utilisé avec les outils ScanState et LoadState pour effectuer une migration plus ciblée que l’utilisation d’USMT sans instructions XML. Le MigUser.xml fichier rassemble tous les fichiers des dossiers de profil utilisateur standard et tous les fichiers sur l’ordinateur avec les extensions de nom de fichier spécifiées.

Le fichier par défaut MigUser.xml migre les données suivantes :

• Tous les fichiers des dossiers de profil utilisateur standard, qui sont décrits comme suit :

  • CSIDL_MYVIDEO

  • CSIDL_MYMUSIC

  • CSIDL_DESKTOP

  • CSIDL_STARTMENU

  • CSIDL_PERSONAL

  • CSIDL_MYPICTURES

  • CSIDL_FAVORITES

  • CSIDL_QUICK LANCEMENT

• Fichiers avec les extensions suivantes :

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

  Remarque

  L’astérisque (*) représente zéro ou plusieurs caractères.

  Remarque

  Les extensions OpenDocument (*.odt, *.odp, *.ods) que les applications Microsoft Office peuvent utiliser ne sont pas migrées par défaut.

Le fichier par défaut MigUser.xml ne migre pas les données suivantes :

• Fichiers étiquetés avec les attributs Hidden et System .

• Fichiers et dossiers sur les lecteurs amovibles.

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

• ACLS pour les fichiers dans des dossiers en dehors du profil utilisateur.

Le MigUser.xml fichier peut être copié, puis modifié pour inclure ou exclure les dossiers de profil utilisateur standard et les extensions de nom de fichier. Si toutes les extensions des fichiers qui doivent être migrés à partir de l’ordinateur source sont connues, utilisez le MigUser.xml fichier pour déplacer toutes les données pertinentes, quel que soit l’emplacement des fichiers. Toutefois, l’ajout de toutes les extensions de fichier qui doivent être migrées vers le MigUser.xml fichier peut entraîner une migration qui contient plus de fichiers que prévu. Par exemple, si tous les fichiers .jpg sont migrés, il peut également 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 avec ou générés par l’outil USMT est configuré pour un composant spécifique de la migration. Les fichiers XML personnalisés peuvent également être utilisés pour compléter ces fichiers par défaut par d’autres règles de migration.

Par exemple, tous les types de fichiers de migration XML peuvent être utilisés pour une migration unique, comme dans l’exemple suivant :

ScanState.exe <store> /config:c:\myFolder\Config.xml /i:migapps.xml /i:MigDocs.xml /i:CustomRules.xml

Règles XML pour la migration des fichiers utilisateur

Si le jeu de données est inconnu ou si de nombreux fichiers sont stockés en dehors des dossiers de profil utilisateur standard, le MigDocs.xml est un meilleur choix que le MigUser.xml fichier, car le MigDocs.xml fichier collecte une étendue plus large de données. Le MigDocs.xml fichier migre les dossiers de données en fonction de l’emplacement. Le MigUser.xml fichier migre uniquement les fichiers avec les extensions de nom de fichier spécifiées.

Pour plus de contrôle sur la migration, créez des fichiers XML personnalisés. Pour plus d’informations sur la création de fichiers XML personnalisés, consultez Création et modification d’un fichier XML personnalisé.

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

L’option /genmigxml de ligne de commande peut être utilisée pour déterminer les fichiers inclus dans la migration. L’option /genmigxml crée un fichier à un emplacement spécifié. Les règles XML du fichier peuvent ensuite être examinées et, si nécessaire, apporter des modifications.

Pour générer le fichier de règles de migration XML pour un ordinateur source :

1. Sélectionnez Démarrer>tous les accessoires de programmes>

2. Cliquez avec le bouton droit sur Invite de commandes, puis sélectionnez Exécuter en tant que.

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

4. À l’invite de commandes, entrez :

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

   où :

   • <USMTpath> : emplacement sur l’ordinateur source des fichiers et outils USMT enregistrés.
   • < >filepath.xml : chemin d’accès complet à un fichier dans lequel le rapport peut être enregistré.

   Par exemple, entrez :

   cd /d c:\USMT
   ScanState.exe /genmigxml:"C:\Users\USMT Tester\Desktop\genMig.xml"
   

Fonction GenerateDocPatterns

Le MigDocs.xml fichier appelle la GenerateDocPatterns fonction , qui prend trois valeurs booléennes. Les paramètres peuvent être modifiés pour modifier la façon dont le MigDocs.xml fichier génère les règles XML pour la migration.

• ScanProgramFiles: cet argument est valide uniquement lorsque la GenerateDocPatterns fonction est appelée dans un contexte système. Cet argument détermine s’il faut ou non analyser le répertoire Program Files pour collecter les extensions de nom de fichier inscrites pour les applications connues.

  Valeur par défaut : False

  Par exemple, lorsqu’elle est définie sur TRUE, la fonction découvre et migre .doc fichiers sous le répertoire Microsoft Office, car .doc est une extension de nom de fichier inscrite dans une application Microsoft Office. La GenerateDocPatterns fonction génère ce modèle d’inclusion pour les .doc fichiers :

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

  Si un dossier enfant d’un dossier inclus contient une application installée, ScanProgramFiles crée également une règle d’exclusion pour le dossier enfant. Tous les dossiers sous le dossier d’application sont analysés de manière récursive à la recherche d’extensions de nom de fichier inscrites.

• IncludePatterns: cet argument détermine s’il faut générer des modèles d’exclusion ou d’inclusion dans le code XML. Lorsque cet argument est défini sur TRUE, la GenerateDocPatterns fonction génère des modèles include et la fonction doit être ajoutée sous l’élément <include> . La modification de cet argument sur FALSE génère des modèles d’exclusion et la fonction doit être ajoutée sous l’élément <exclude> .

  Valeur par défaut : True

• SystemDrive: cet argument détermine s’il faut générer des modèles pour tous les lecteurs fixes ou uniquement pour le lecteur système. La modification de cet argument sur TRUE limite tous les modèles au lecteur système.

  Valeur par défaut : False

Usage:

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

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

<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
     <objectSet>
        <script>MigXmlHelper.GenerateDocPatterns ("FALSE","TRUE","TRUE")</script>
     </objectSet>
</include>

Pour créer une règle include afin de collecter des fichiers pour les extensions inscrites à partir du répertoire %PROGRAMFILES% :

<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
     <objectSet>
        <script>MigXmlHelper.GenerateDocPatterns ("TRUE","TRUE","FALSE")</script>
     </objectSet>
</include>

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

<exclude filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
     <objectSet>
        <script>MigXmlHelper.GenerateDocPatterns ("FALSE","FALSE","FALSE")</script>
     </objectSet>
</exclude>

Comprendre le contexte système et utilisateur

Les fichiers XML de migration contiennent deux <éléments de composant> avec des paramètres de contexte différents :

• Le contexte système s’applique aux fichiers sur l’ordinateur qui ne sont pas stockés dans le répertoire Profils utilisateur.
• Le contexte utilisateur s’applique aux fichiers qui sont spécifiques à un utilisateur individuel.

Contexte système

Le contexte système inclut des règles pour les données en dehors du répertoire Profils utilisateur. Par exemple, lorsqu’elle est appelée dans un contexte système du MigDocs.xml fichier, la GenerateDocPatterns fonction crée des modèles pour tous les dossiers d’interpréteur de commandes courants, les fichiers 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 les données dans le répertoire Profils utilisateur. Lorsqu’elle est appelée dans un contexte utilisateur dans le MigDocs.xml fichier, la GenerateDocPatterns fonction crée des modèles pour tous les dossiers d’interpréteur de commandes utilisateur, les fichiers situés à la racine du profil et les dossiers situés à la racine du profil. 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 de fichiers XML

Exemples d’utilisation de règles d’exclusion

Dans les exemples suivants, l’ordinateur source dispose d’un fichier .txt appelé new text document dans un répertoire appelé new folder. Le comportement par défaut MigDocs.xml migre le nouveau fichier texte document.txt et tous les fichiers contenus dans le new folder répertoire. Les règles générées par la fonction sont les suivantes :

Pour exclure le nouveau fichier texte document.txt et les fichiers .txt dans new folder, les modifications suivantes peuvent être apportées :

Exemple 1 : Exclure tous les fichiers .txt dans un dossier

Pour exclure la règle 1, il doit y avoir une correspondance exacte du nom de fichier. Toutefois, pour la règle 2, un modèle peut être créé pour exclure des fichiers à l’aide 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 donner la priorité à une règle sur les règles include

Si le nom ou l’emplacement du fichier n’est pas connu, mais que l’extension de nom de fichier est connue, la GenerateDrivePatterns fonction peut être utilisée. Toutefois, la règle étant moins spécifique que la règle include par défaut générée par le MigDocs.xml fichier, elle n’est pas prioritaire. L’élément <UnconditionalExclude> doit être utilisé pour donner à cette règle la priorité sur la règle include par défaut. Pour plus d’informations sur l’ordre de priorité des règles de migration XML, consultez Conflits et priorité.

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

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

Pour appliquer l’élément <UnconditionalExclude> au contexte système et utilisateur, un troisième composant peut être créé à l’aide du contexte UserandSystem . Les règles de ce composant s’exécutent 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 d’autres exemples de règles d’exclusion qui peuvent être utilisées dans des fichiers XML de migration personnalisés, consultez Exclure des fichiers et des paramètres.

Inclure des exemples d’utilisation de règles

Le répertoire de données de l’application est l’emplacement le plus courant pour lequel une règle include doit être ajoutée. La GenerateDocPatterns fonction exclut cet emplacement par défaut. Si l’organisation utilise une application qui enregistre des données importantes à cet emplacement, des règles include peuvent être créées pour migrer les données. Par exemple, l’emplacement par défaut des fichiers .pst est : %CSIDL_LOCAL_APPDATA%\Microsoft\Outlook. Le MigApp.xml fichier contient des règles de migration pour déplacer uniquement les fichiers .pst liés à Microsoft Outlook. Pour inclure des fichiers .pst qui ne sont pas liés, vous pouvez apporter la modification suivante :

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

Cette règle inclut les fichiers .pst qui se trouvent à l’emplacement par défaut, mais qui ne sont pas liés à Microsoft Outlook. Utilisez le contexte utilisateur pour exécuter cette règle pour chaque utilisateur sur 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 Program Files

Pour les emplacements en dehors du profil utilisateur, tels que le dossier Program Files, la règle peut être ajoutée au composant de contexte système.

<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
     <objectSet>
        <pattern type="File">%CSIDL_PROGRAM_FILES%\*[*.pst]</pattern>
     </objectSet>
</include>

Pour obtenir d’autres exemples de règles include qui peuvent être utilisées dans des fichiers XML de migration personnalisés, consultez Inclure des fichiers et des paramètres.

Étapes suivantes

Des règles supplémentaires pour la migration peuvent être incluses dans le MigDocs.xml fichier ou d’autres fichiers de migration XML. Par exemple, l’élément <locationModify> peut être utilisé pour déplacer des fichiers du dossier où ils ont été collectés vers un autre dossier, lorsqu’ils sont appliqués à l’ordinateur de destination.

Un fichier de schéma XML (MigXML.xsd) peut être utilisé pour valider la syntaxe des fichiers XML personnalisés. Pour plus d’informations, consultez Ressources USMT.

Articles connexes

• Excluez les fichiers et les paramètres.
• Inclure des fichiers et des paramètres.