Inclure des fichiers et des paramètres

Article
12/05/2013

Lorsque vous spécifiez les fichiers .xml de migration, Outil de migration utilisateur (USMT) 5.0 lance la migration des paramètres et des composants définis dans la rubrique Quels sont les éléments migrés par l’outil USMT ? Pour inclure des paramètres et fichiers supplémentaires, nous vous recommandons de créer un fichier .xml personnalisé, puis d’inclure ce fichier lors de l’utilisation des deux commandes ScanState et LoadState. En créant un fichier .xml personnalisé, vous pouvez laisser vos modifications à l’écart des fichiers .xml par défaut, ce qui facilite le suivi des modifications.

Dans cette rubrique :

Migrer une clé de Registre unique
Migrer un dossier spécifique
Migrer un dossier à partir d’un lecteur spécifique
Migrer un dossier à partir d’un emplacement
Migrer un type de fichier vers un dossier spécifique
Migrer un fichier spécifique

Migrer une clé de Registre unique

Le fichier .xml suivant migre une clé de Registre unique.

<migration urlid="https://www.microsoft.com/migration/1.0/migxmlext/test">
     <component type="Application" context="System">
          <displayName>Component to migrate only registry value string</displayName> 
          <role role="Settings">
          <rules>
               <include>
                    <objectSet>
                         <pattern type="Registry">HKLM\Software\Microsoft\Windows\CurrentVersion\Internet Settings\Cache [Persistent]</pattern> 
                    </objectSet>
               </include>
          </rules>
          </role>
     </component>
</migration>

Migrer un dossier spécifique

Les exemples suivants montrent comment migrer un dossier à partir d’un lecteur spécifique, puis à partir d’un emplacement quelconque sur l’ordinateur.

Migrer un dossier à partir d’un lecteur spécifique

Inclusion de sous-dossiers. Le fichier .xml suivant migre tous les fichiers et sous-dossiers de C:\EngineeringDrafts vers l’ordinateur de destination.

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

Exclusion de sous-dossiers. Le fichier .xml suivant migre tous les fichiers contenus dans C:\EngineeringDrafts, mais aucun de ses sous-dossiers.

<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>
    </rules>
  </role>
</component>
</migration>

Migrer un dossier à partir d’un emplacement

Le fichier .xml suivant migre tous les fichiers et sous-dossiers du dossier EngineeringDrafts à partir de n’importe quel lecteur de l’ordinateur. S’il existe plusieurs dossiers avec le même nom, tous les fichiers associés à ce nom sont migrés.

<migration urlid="https://www.microsoft.com/migration/1.0/migxmlext/test">
<component type="Documents" context="System">
  <displayName>Component to migrate all Engineering Drafts Documents folder on any drive on the computer </displayName>
  <role role="Data">
    <rules>
         <include>
            <objectSet>
         <script>MigXmlHelper.GenerateDrivePatterns ("\EngineeringDrafts\* [*] ", "Fixed")</script>            
         <script>MigXmlHelper.GenerateDrivePatterns ("*\EngineeringDrafts\* [*] ", "Fixed")</script>            
       </objectSet>
          </include>
    </rules>
  </role>
</component>
</migration>

Le fichier .xml suivant migre tous les fichiers et sous-dossiers du dossier EngineeringDrafts à partir de n’importe quel emplacement sur le lecteur C:\. S’il existe plusieurs dossiers avec le même nom, ils sont tous migrés.

<migration urlid="https://www.microsoft.com/migration/1.0/migxmlext/test">
<component type="Documents" context="System">
  <displayName>Component to migrate all Engineering Drafts Documents EngineeringDrafts folder from where ever it exists on the C: drive </displayName>
  <role role="Data">
    <rules>
         <include>
            <objectSet>                 
<pattern type="File"> C:\*\EngineeringDrafts\* [*]</pattern>
<pattern type="File"> C:\EngineeringDrafts\* [*]</pattern>
       </objectSet>
          </include>
    </rules>
  </role>
</component>
</migration>

Migrer un type de fichier vers un dossier spécifique

Le fichier .xml suivant migre les fichiers .mp3 situés dans les lecteurs spécifiés de l’ordinateur source dans le dossier C:\Music de l’ordinateur de destination.

<migration urlid="https://www.microsoft.com/migration/1.0/migxmlext/test">
<component type="Documents" context="System">
  <displayName>All .mp3 files to My Documents</displayName>
  <role role="Data">
    <rules>
      <include>
        <objectSet>
          <script>MigXmlHelper.GenerateDrivePatterns ("* [*.mp3]", "Fixed")</script>
        </objectSet>
      </include>
      <!-- Migrates all the .mp3 files in the store to the C:\Music folder during LoadState -->
      <locationModify script="MigXmlHelper.Move('C:\Music')">
        <objectSet>
          <script>MigXmlHelper.GenerateDrivePatterns ("* [*.mp3]", "Fixed")</script>
        </objectSet>
      </locationModify>
    </rules>
  </role>
</component>
</migration>

Migrer un fichier spécifique

Les exemples suivants montrent comment migrer un fichier à partir d’un dossier spécifique et à partir d’un emplacement quelconque.

Pour migrer un fichier à partir d’un dossier. Le fichier .xml suivant migre uniquement le fichier Sample.doc de C:\EngineeringDrafts sur l’ordinateur source vers l’ordinateur de destination.

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

Pour migrer un fichier à partir d’un emplacement quelconque. Pour migrer le fichier Sample.doc à partir d’un emplacement quelconque sur le lecteur C:\, utilisez l’élément <pattern>, comme l’illustre l’exemple suivant. S’il existe plusieurs fichiers de même nom sur le lecteur C:\, tous les fichiers portant ce nom sont migrés.
```
<pattern type="File"> C:\* [Sample.doc] </pattern>
```
Pour migrer le fichier Sample.doc à partir d’un lecteur de l’ordinateur, utilisez <script> à l’image de l’exemple suivant. S’il existe plusieurs fichiers de même nom, tous les fichiers portant ce nom sont migrés.
```
<script>MigXmlHelper.GenerateDrivePatterns("* [sample.doc]", "Fixed")</script>
```

Voir aussi

Autres ressources

Personnaliser les fichiers XML de l’outil USMT
Exemples de fichiers XML personnalisés
Conflits et priorité
Informations de référence XML de l’outil USMT