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.
Notes
Lorsque vous modifiez des éléments XML dans le fichier Config.xml, il est préférable de modifier un élément et de définir la propriété migrate sur no, plutôt que de supprimer l’élément du fichier. Si vous supprimez l’élément au lieu de définir la propriété, le composant peut encore être migré par des règles d’autres fichiers 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.
Important
Le fichier MigApps.xml détecte et migre uniquement les fichiers PST associés à Microsoft® Office Outlook®. Pour plus d’informations sur la migration des fichiers PST non associés à Outlook, consultez la section Exemples de règles de migration pour les versions personnalisées des fichiers XML de ce document.
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.
Notes
Chaque extension de nom de fichier que vous incluez dans les règles au sein du fichier MigUser.xml augmente le temps nécessaire à l’outil ScanState pour rassembler les fichiers en vue de la migration. Si vous migrez plus de trois cent types de fichiers, le processus de migration peut être lent. Pour plus d’informations sur les autres moyens d’organiser la migration de vos données, consultez la section Utilisation de plusieurs fichiers XML de ce document.
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.
| Fichier de migration XML | Modifie les composants suivants : |
|---|---|
Fichier Config.xml |
Composants de système d’exploitation, tels que le papier peint et le thème d’arrière-plan du Bureau. Vous pouvez également surcharger le fichier Config.xml pour y inclure des paramètres d’application et de document en le créant avec d’autres fichiers XML par défaut. Pour plus d’informations, voir Personnaliser les fichiers XML de l’outil USMT et Fichier Config.xml. |
Fichier MigApps.xml |
Paramètres d’application. |
Fichiers MigUser.xml ou MigDocs.xml |
Paramètres de fichiers et de profils utilisateur. |
Fichiers XML personnalisés |
Paramètres d’application, paramètres de profil utilisateur ou fichiers utilisateur transcendant les règles contenues dans d’autres fichiers XML. |
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
Important
L’utilisation conjointe des fichiers MigUser.xml et MigDocs.xml dans la même commande est à éviter car elle peut provoquer une duplication de certains fichiers migrés. Ceci survient lorsque des instructions d’emplacement cible contradictoires sont fournies dans chaque fichier XML. Le fichier cible est stocké une seule fois au cours de la migration mais est appliqué par chaque fichier XML à un emplacement distinct sur l’ordinateur de destination.
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.
Notes
Si vous réinstallez l’USMT, les fichiers XML de migration par défaut sont remplacés et tous les changements personnalisés effectués directement dans ces fichiers sont perdus. Si possible, envisagez de créer des fichiers XML séparés pour vos règles de migration personnalisées et de les enregistrer à un emplacement sécurisé.
Pour créer les règles de migration XML d’un ordinateur source :
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.
Sélectionnez un compte disposant de privilèges d’administrateur, fournissez un mot de passe, puis cliquez sur OK.
À 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.
| Paramètre | Valeur | Valeur par défaut |
|---|---|---|
ScanProgramFiles |
L’argument ScanProgramFiles est valide seulement lorsque vous appelez la fonction GenerateDocPatterns dans un contexte système. Cet argument détermine la nécessité ou non d’analyser le répertoire Program Files à la recherche d’extensions de noms de fichiers enregistrées pour des applications connues. Par exemple, si elle a la valeur TRUE, la fonction détecte et migre les fichiers DOC dans le répertoire Microsoft Office parce que « .doc » est une extension de nom de fichier enregistrée dans une application Microsoft Office. La fonction GenerateDocPatterns génère le modèle d’inclusion suivant pour les fichiers dotés de l’extension .doc : Si un dossier enfant d’un dossier inclus abrite une application installée, ScanProgramFiles crée également une règle d’exclusion pour le dossier enfant. Tous les dossiers inclus dans le dossier d’application feront l’objet d’une analyse récursive pour y rechercher des extensions de noms de fichiers enregistrées. |
False |
IncludePatterns |
L‘argument IncludePatterns détermine si des modèles sont à exclure ou à inclure dans les données XML. Lorsque cet argument a la valeur TRUE, la fonction GenerateDocPatterns génère des modèles d’inclusion et la fonction doit être ajoutée sous l’élément <include>. Si vous redéfinissez le même argument sur FALSE, des modèles d’exclusion sont créés et la fonction doit être ajoutée sous l’élément <exclude>. |
True |
SystemDrive |
L’argument SystemDrive détermine si des modèles sont à créer pour tous les lecteurs fixes ou seulement pour le lecteur système. Le fait de redéfinir la valeur de cet argument sur TRUE a pour effet de restreindre tous les modèles au lecteur système. |
False |
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
Notes
Les règles contenues dans un composant affecté au contexte utilisateur sont exécutées pour chaque profil utilisateur sur l’ordinateur. Les fichiers analysés plusieurs fois par les fichiers MigDocs.xml sont uniquement copiés dans le magasin de migration une seule fois. Néanmoins, de très nombreuses règles dans le contexte utilisateur risquent de ralentir la migration. Utilisez le contexte système lorsque les circonstances l’exigent.
Exemples de règles de migration pour les versions personnalisées des fichiers XML
Notes
Pour plus d’informations sur les meilleures pratiques et la configuration requise en matière de fichiers XML personnalisés dans l’USMT, voir Personnaliser les fichiers XML de l’outil USMT et Conventions générales.
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 :
Règle 1 |
|
Règle 2 |
|
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.
Notes
Pour plus d’informations sur l’ordre de priorité des règles de migration XML, voir Conflits et priorité.
É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