Exclure des fichiers et des paramètres

Article
12/05/2013

Lorsque vous spécifiez les fichiers XML de migration MigApp.xml, Migdocs et MigUser.xml, l’Outil de migration utilisateur (USMT) 5.0 migre les paramètres et les composants répertoriés, tels qu’ils sont décrits dans Quels sont les éléments migrés par l’outil USMT ?. Vous pouvez créer un fichier XML personnalisé pour préciser davantage les éléments à inclure ou à exclure au cours de la migration. Vous pouvez également créer un fichier Config.xml pour exclure un composant tout entier d’une migration. En revanche, il ne vous sera pas possible d’exclure des utilisateurs au moyen des fichiers XML de migration ou du fichier Config.xml. Le seul moyen de spécifier les utilisateurs à inclure et à exclure est d’utiliser les options utilisateur dans la ligne de commande de l’outil ScanState. Pour plus d’informations, voir Syntaxe de ScanState.

Dans cette rubrique :

Créer un fichier XML personnalisé. Vous pouvez utiliser les éléments suivants pour préciser les éléments à exclure :
- <include> et <exclude> : vous pouvez utiliser les éléments <include> et <exclude> pour exclure des objets avec des conditions. Il est possible, par exemple, de migrer tous les fichiers situés dans le lecteur C:\, à l’exception des fichiers MP3. Gardez surtout à l’esprit que les caractéristiques décrites dans la rubrique Conflits et priorité s’appliquent à ces éléments.
- <unconditionalExclude> : vous pouvez vous servir de l’élément <unconditionalExclude> pour exclure globalement des données. Cet élément a priorité sur toutes les autres règles include et exclude dans les fichiers XML. Par conséquent, il exclut les objets, quelles que soient les autres règles <include> énoncées dans les fichiers XML. Par exemple, vous pouvez exclure tous les fichiers MP3 stockés sur l’ordinateur ou bien exclure tous les fichiers situés dans C:\UserData.
Créer un fichier Config.xml : vous pouvez créer et modifier un fichier Config.xml pour exclure un composant tout entier de la migration. Par exemple, vous pouvez utiliser ce fichier pour exclure les paramètres de l’une des applications par défaut. Qui plus est, la création et la modification d’un fichier Config.xml constituent le seul moyen d’exclure les paramètres du système d’exploitation migrés sur des ordinateurs exécutant Windows. 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.

Créer un fichier XML personnalisé

Nous vous recommandons de créer un fichier XML personnalisé plutôt que de modifier les fichiers XML de migration par défaut. Lorsque vous travaillez avec un fichier XML personnalisé, vous pouvez conserver vos modifications séparément des fichiers XML par défaut, ce qui en facilite le suivi.

<include> et <exclude>

Les fichiers XML de migration MigApp.xml, MigDocs et MigUser.xml contiennent l’élément <component> qui correspond généralement à un composant autonome ou une application, telle que Microsoft® Office Outlook® et Microsoft Word. Pour exclure les fichiers et les paramètres du Registre associés à ces composants, utilisez les éléments <include> et <exclude>. Ils vous permettent, par exemple, de migrer tous les fichiers et les paramètres de modèle X, exception faite des fichiers et des paramètres de modèle Y, où Y est plus précis que X. Pour connaître la syntaxe des éléments, voir Informations de référence XML de l’outil USMT.

Notes

Si vous spécifiez une règle <exclude>, spécifiez toujours une règle <include> correspondante. Sinon, si vous ne précisez aucune règle <include>, les fichiers ou paramètres spécifiques ne seront pas inclus. Ils seront en permanence exclus de la migration. C’est pourquoi une règle <exclude> non accompagnée n’est d’aucune utilité.

Exemple 1 : comment migrer tous les fichiers situés dans C:\, à l’exception des fichiers MP3
Exemple 2 : comment migrer tous les fichiers situés dans C:\Data, à l’exception des fichiers situés dans C:\Data\tmp
Exemple 3 : comment exclure les fichiers situés dans un dossier mais inclure tous les sous-dossiers
Exemple 4 : comment exclure un fichier d’un dossier spécifique
Exemple 5 : comment exclure un fichier d’un emplacement quelconque

Exemple 1 : comment migrer tous les fichiers situés dans C:\, à l’exception des fichiers MP3

Le fichier XML suivant migre tous les fichiers situés dans le lecteur C:\, à l’exception des fichiers MP3.

<migration urlid="https://www.microsoft.com/migration/1.0/migxmlext/mp3files">
    <!-- This component migrates all files except those with .mp3 extension-->
    <component type="Documents" context="UserAndSystem">
        <displayName _locID="miguser.sharedvideo">MP3 Files</displayName>
        <role role="Data">
            <rules>
                <include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
                    <objectSet>
                        <pattern type="File">C:\* [*]</pattern>
                    </objectSet>
                </include>
                <exclude>
                    <objectSet>
                        <pattern type="File">C:\* [*.mp3]</pattern>
                    </objectSet>
                </exclude>
            </rules>
        </role>
    </component>
</migration>

Exemple 2 : comment migrer tous les fichiers situés dans C:\Data, à l’exception des fichiers situés dans C:\Data\tmp

Le fichier XML suivant migre l’ensemble des fichiers et des sous-dossiers dans C:\Data, à l’exception des fichiers et sous-dossiers situés dans C:\Data\tmp.

<migration urlid="https://www.microsoft.com/migration/1.0/migxmlext/test">
    <component type="Documents" context="System">
        <displayName _locID="miguser.sharedvideo">Test component</displayName>
        <role role="Data">
            <rules>
         <include>
            <objectSet>
                 <pattern type="File">C:\Data\* [*]</pattern>
            </objectSet>
          </include>
         <exclude>
             <objectSet>
                   <pattern type="File"> C:\Data\temp\* [*]</pattern>
             </objectSet>
         </exclude>  
            </rules>
        </role>
    </component>
</migration>

Exemple 3 : comment exclure les fichiers situés dans un dossier mais inclure tous les sous-dossiers

Le fichier XML suivant migre tous les sous-dossiers dans C:\EngineeringDrafts mais exclut tous les fichiers dans C:\EngineeringDrafts.

<migration urlid="https://www.microsoft.com/migration/1.0/migxmlext/test">
<component type="Documents" context="System">
  <displayName>Component to migrate all Engineering Drafts Documents without subfolders</displayName>
  <role role="Data">
    <rules>
         <include>
            <objectSet>
                 <pattern type="File"> C:\EngineeringDrafts\* [*]</pattern>
            </objectSet>
          </include>
      <exclude>
        <objectSet>
          <pattern type="File"> C:\EngineeringDrafts\ [*]</pattern>
        </objectSet>
      </exclude>
    </rules>
  </role>
</component>
</migration>

Exemple 4 : comment exclure un fichier d’un dossier spécifique

Le fichier XML suivant migre l’ensemble des fichiers et des sous-dossiers dans C:\EngineeringDrafts, à l’exception du fichier Sample.doc dans C:\EngineeringDrafts.

<migration urlid="https://www.microsoft.com/migration/1.0/migxmlext/test">
<component type="Documents" context="System">
  <displayName>Component to migrate all Engineering Drafts Documents except Sample.doc</displayName>
  <role role="Data">
    <rules>
         <include>
            <objectSet>
                 <pattern type="File"> C:\EngineeringDrafts\* [*]</pattern>
            </objectSet>
          </include>
      <exclude>
        <objectSet>
          <pattern type="File"> C:\EngineeringDrafts\ [Sample.doc]</pattern>
        </objectSet>
      </exclude>
    </rules>
  </role>
</component>
</migration>

Exemple 5 : comment exclure un fichier d’un emplacement quelconque

Pour exclure un fichier Sample.doc d’un emplacement quelconque dans le lecteur C:, utilisez l’élément <pattern>. Si plusieurs fichiers portant le même nom existent dans le lecteur C:, tous ces fichiers sont exclus.

<pattern type="File"> C:\* [Sample.doc] </pattern>

Pour exclure un fichier Sample.doc d’un lecteur quelconque sur l’ordinateur, utilisez l’élément <script>. Si plusieurs fichiers portent le même nom, tous ces fichiers sont exclus.

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

<unconditionalExclude>

Pour exclure un type de fichier de la migration, indépendamment des règles <include> ou <exclude>, vous pouvez utiliser l’élément <unconditionalExclude>. Cet élément exclut les objets globalement dans tous les composants. Par exemple, vous pouvez vous servir de cet élément pour exclure tous les fichiers .mp3 de l’ordinateur. Ou, si vous sauvegardez C:\UserData à l’aide d’une autre méthode, vous pouvez exclure l’intégralité du dossier de la migration. Vous devez toutefois procéder avec précaution lors de l’utilisation de cet élément, car si une application a besoin d’un fichier que vous excluez, elle risque de ne pas fonctionner correctement sur l’ordinateur de destination. Pour connaître la syntaxe de cet élément, voir Informations de référence XML de l’outil USMT.

Exemple 1 : comment exclure tous les fichiers .mp3
Exemple 2 : comment exclure tous les fichiers situés sur un lecteur spécifique
Exemple 3 : comment exclure des clés de Registre
Exemple 4 : comment exclure C:\Windows et C:\Program Files

Exemple 1 : comment exclure tous les fichiers .mp3

Le fichier XML suivant exclut tous les fichiers .mp3 de la migration :

<migration urlid="https://www.microsoft.com/migration/1.0/migxmlext/excludefiles">
  <component context="System" type="Documents">
        <displayName>Test</displayName>
        <role role="Data">
            <rules>
             <unconditionalExclude>
                        <objectSet>
    <script>MigXmlHelper.GenerateDrivePatterns ("* [*.mp3]", "Fixed")</script>
                        </objectSet> 
             </unconditionalExclude>
            </rules>
        </role>
    </component>
</migration>

Exemple 2 : comment exclure tous les fichiers situés sur un lecteur spécifique

Le fichier XML suivant exclut uniquement les fichiers situés dans le lecteur C:.

<migration urlid="https://www.microsoft.com/migration/1.0/migxmlext/allfiles">
    <component type="Documents" context="System">
        <displayName>Test</displayName>
        <role role="Data">
            <rules>
  <unconditionalExclude>
                    <objectSet>
      <pattern type="File">c:\*[*]</pattern>
                    </objectSet>
  </unconditionalExclude>
            </rules>
        </role>
    </component>
</migration>

Exemple 3 : comment exclure des clés de Registre

Le fichier XML suivant exclut sans conditions la clé de Registre HKey_Current_User et l’ensemble de ses sous-clés.

<?xml version="1.0" encoding="UTF-8"?>
<migration urlid="https://www.microsoft.com/migration/1.0/migxmlext/miguser">
   <component type="Documents" context="User">
      <displayName>Test</displayName>
      <role role="Data">
         <rules>
            <include>
               <objectSet>
                  <pattern type="Registry">HKCU\testReg[*]</pattern>
               </objectSet>
            </include>
            <unconditionalExclude>
               <objectSet>
                  <pattern type="Registry">HKCU\*[*]</pattern>
               </objectSet>
            </unconditionalExclude>
         </rules>
      </role>
   </component>
</migration>

Exemple 4 : comment exclure C:\Windows et C:\Program Files

Le fichier XML suivant exclut sans conditions les dossiers système C:\Windows et C:\Program Files. Notez que tous les fichiers *.docx, *.xls et *.ppt ne seront pas migrés puisque l’élément <unconditionalExclude> est prioritaire sur l’élément <include>.

<?xml version="1.0" encoding="UTF-8"?>
<migration urlid="https://www.microsoft.com/migration/1.0/migxmlext/miguser">
   <component type="Documents" context="System">
      <displayName>Test</displayName>
      <role role="Data">
         <rules>
            <include>
               <objectSet>
    <script>MigXmlHelper.GenerateDrivePatterns ("* [*.doc]", "Fixed")</script>
    <script>MigXmlHelper.GenerateDrivePatterns ("* [*.xls]", "Fixed")</script>
    <script>MigXmlHelper.GenerateDrivePatterns ("* [*.ppt]", "Fixed")</script>
               </objectSet>
            </include>
            <unconditionalExclude>
               <objectSet>
                  <pattern type="File">C:\Program Files\* [*]</pattern>
<pattern type="File">C:\Windows\* [*]</pattern>
               </objectSet>
            </unconditionalExclude>
         </rules>
      </role>
   </component>
</migration>

Créer un fichier Config.xml

Vous pouvez créer et modifier un fichier Config.xml pour exclure des composants de la migration. 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. Config.xml est un fichier facultatif que vous pouvez créer à l’aide de l’option de ligne de commande /genconfig de l’outil ScanState. Vous pouvez notamment vous servir du fichier Config.xml pour exclure les paramètres de l’une des applications par défaut. Qui plus est, la création et la modification de ce fichier constituent le seul moyen d’exclure les paramètres du système d’exploitation migrés sur des ordinateurs exécutant Windows.

Pour exclure les paramètres d’une application par défaut : précisez migrate="no" pour l’application en question sous la section <Applications> du fichier Config.xml.
Pour exclure un paramètre de système d’exploitation : précisez migrate="no" pour le paramètre sous la section <WindowsComponents>.
Pour exclure Mes documents : précisez migrate="no" pour Mes documents sous la section <Documents>. Notez que toutes les règles <include> au sein des fichiers XML s’appliquent toujours. Par exemple, si vous disposez d’une règle qui héberge tous les fichiers .docx dans le dossier Mes documents, seuls ces fichiers .docx sont alors migrés ; le reste des fichiers ne l’est pas.

Pour plus d’informations, voir Fichier Config.xml.