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.
Remarque
Lorsque vous modifiez les éléments XML dans le Config.xml fichier, définissez la propriété migrate sur un élément sur non au lieu de supprimer l’élément du fichier. Si l’élément est supprimé au lieu de définir la propriété , les règles d’autres fichiers XML peuvent toujours migrer le composant.
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.
Important
Le MigApps.xml fichier détecte et migre uniquement les fichiers .pst liés à Microsoft Office Outlook. Pour plus d’informations sur la migration de fichiers .pst qui ne sont pas liés à Outlook, voir Exemples de règles de migration pour les versions personnalisées de fichiers XML.
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.
Remarque
Chaque extension de nom de fichier incluse dans les règles du MigUser.xml fichier augmente le temps nécessaire à l’outil ScanState pour collecter les fichiers pour la migration. Si plus de 300 types de fichiers sont migrés, l’expérience de migration peut être lente. Pour plus d’informations sur les autres façons d’organiser la migration des données, consultez la section Utilisation de plusieurs fichiers XML de cet article.
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.
| Fichier de migration XML | Modifie les composants suivants : |
|---|---|
| fichierConfig.xml | Composants du système d’exploitation tels que le papier peint du bureau et le thème d’arrière-plan. Peut Config.xml également être étendu pour inclure certains paramètres d’application et de document en générant le Config.xml fichier avec les autres fichiers XML par défaut. Pour plus d’informations, consultez Personnaliser les fichiers XML USMT et Config.xml fichier. |
| fichierMigApps.xml | Paramètres des applications. |
| fichiersMigUser.xml ou MigDocs.xml | Fichiers utilisateur et paramètres de profil. |
| Fichiers XML personnalisés | Paramètres d’application, paramètres de profil utilisateur ou fichiers utilisateur, au-delà des règles contenues dans les autres fichiers XML. |
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
Important
Les MigUser.xml fichiers et MigDocs.xml ne doivent pas être utilisés ensemble dans la même commande. L’utilisation des deux fichiers XML peut entraîner une duplication de certains fichiers migrés. La duplication de certains fichiers migrés peut se produire lorsque des instructions d’emplacement cible en conflit sont fournies dans chaque fichier XML. Le fichier cible est stocké une seule fois pendant la migration, mais chaque fichier XML applique le fichier à un emplacement différent sur l’ordinateur de destination.
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.
Remarque
Si l’outil USMT est réinstallé, les fichiers XML de migration par défaut sont remplacés et toutes les personnalisations apportées à ces fichiers sont perdues. Envisagez de créer des fichiers XML distincts pour les règles de migration personnalisées et de les enregistrer dans un emplacement sécurisé.
Pour générer le fichier de règles de migration XML pour un ordinateur source :
Sélectionnez Démarrer>tous les accessoires de programmes>
Cliquez avec le bouton droit sur Invite de commandes, puis sélectionnez Exécuter en tant que.
Sélectionnez un compte disposant de privilèges d’administrateur, fournissez un mot de passe, puis sélectionnez OK.
À 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 laGenerateDocPatternsfonction 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
GenerateDocPatternsfonction génère ce modèle d’inclusion pour les.docfichiers :<pattern type="File">C:\Program Files\Microsoft Office[.doc]</pattern>Si un dossier enfant d’un dossier inclus contient une application installée,
ScanProgramFilescré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, laGenerateDocPatternsfonction 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
Utilisation:
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
Remarque
Les règles contenues dans un composant auquel le contexte utilisateur est affecté s’exécutent pour chaque profil utilisateur sur l’ordinateur. Les fichiers analysés plusieurs fois par les MigDocs.xml fichiers ne sont copiés qu’une seule fois dans le magasin de migration. Toutefois, un grand nombre de règles dans le contexte utilisateur peuvent ralentir la migration. Utilisez le contexte système lorsqu’il est applicable.
Exemples de règles de migration pour les versions personnalisées de fichiers XML
Astuce
Pour connaître les meilleures pratiques et les conditions requises pour les fichiers XML personnalisés dans l’outil USMT, consultez Personnaliser les fichiers XML USMT et les conventions générales.
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 :
| Règle | Syntaxe |
|---|---|
| Règle 1 | <pattern type="File">d:\new folder[new text document.txt]</pattern> |
| Règle 2 | <pattern type="File">d:\new folder[]</pattern> |
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 le organization 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.
Astuce
Pour plus d’informations sur l’ordre de priorité des règles de migration XML, consultez Conflits et priorité.
É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
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour