Syntaxe de ScanState

La commande ScanState est utilisée avec l’Outil de migration utilisateur (USMT) 5.0 pour analyser l’ordinateur source, collecter les fichiers et les paramètres, et créer un magasin.

Dans cette rubrique

Avant de commencer

Syntaxe

Options de stockage

Options de règle de migration

Options de suivi

Options utilisateur

Options de fichier chiffré

Options de ligne de commande incompatibles

Avant de commencer

Avant d’exécuter la commande ScanState, notez les points suivants :

  • Pour vous assurer que tous les paramètres de système d’exploitation sont migrés, dans la plupart des cas, vous devez exécuter des commandes ScanState en mode Administrateur à partir d’un compte muni d’informations d’identification d’administration.

  • Si vous chiffrez le magasin de migration, vous devez entrer une clé de chiffrement ou un chemin d’accès vers un fichier contenant cette même clé. Pensez surtout à noter la clé ou l’emplacement du fichier de cette dernière car les informations ne sont conservées nulle part dans le magasin de migration. Vous aurez besoin de ces informations au moment d’exécuter la commande LoadState pour déchiffrer le magasin de migration ou si vous devez exécuter l’utilitaire de récupération. Toute clé ou fichier de clé incorrect ou manquant entraîne un message d’erreur.

  • Pour plus d’informations sur la configuration logicielle requise pour l’exécution de la commande ScanState, voir Configuration requise pour l’outil USMT.

    Important

    Windows XP et Windows Vista® sont uniquement pris en charge en tant que systèmes d’exploitation sur l’ordinateur source.

  • Sauf indication contraire, vous pouvez utiliser chaque option une seule fois lorsque vous exécutez un outil dans la ligne de commande.

  • Vous pouvez rassembler des comptes de domaine sans que l’ordinateur source ait accès aux contrôleurs de domaine. Cette fonctionnalité est disponible sans configuration supplémentaire.

  • Le tableau Options de ligne de commande incompatibles recense les options que vous pouvez utiliser ensemble et les options de ligne de commande incompatibles.

  • L’emplacement de répertoire où vous enregistrez le magasin de migration sera exclu de l’analyse. Par exemple, si vous enregistrez le magasin de migration à la racine du lecteur D, le lecteur D et tous ses sous-répertoires seront exclus de l’analyse.

Syntaxe

Cette section explique la syntaxe et l’utilisation des options de ligne de commande ScanState. Les options peuvent être spécifiées dans n’importe quel ordre. Si l’option contient un paramètre, vous pouvez utiliser soit deux points, soit un séparateur d’espace.

La syntaxe de la commande ScanState est la suivante :

scanstate [chemin_accès_magasin] [/i:[chemin\]nom_fichier] [/o] [/v:niveau_détail] [/nocompress] [/localonly] [/encrypt /key:chaîne_clé|/keyfile:[chemin\]nom_fichier] [/l:[chemin\]nom_fichier] [/progress:[chemin\]nom_fichier] [/r:nombre_nouvelles_tentatives] [/w:secondes_avant_nouvelle tentative] [/c] [/p] [/all] [/ui:[nom_domaine|nom_ordinateur\]nom_utilisateur] [/ue:[nom_domaine|nom_ordinateur\]nom_utilisateur] [/uel:nombre_jours|AAAA/MM/JJ|0] [/efs:abort|skip|decryptcopy|copyraw] [/genconfig:[chemin\]nom_fichier[/config:[chemin\]nom_fichier] [/?|help]

Exemple :

  • Pour créer un fichier Config.xml dans le répertoire actuel, utilisez :

    scanstate /i:migapp.xml /i:migdocs.xml /genconfig:config.xml /v:13

  • Pour créer un magasin chiffré à l’aide du fichier Config.xml et des fichiers XML de migration par défaut, utilisez :

    scanstate \\server\share\migration\mystore /i:migapp.xml /i:migdocs.xml /o /config:config.xml /v:13 /encrypt /key:"mykey"

Options de stockage

Option de ligne de commande Description

chemin_accès_magasin

Indique un dossier dans lequel les fichiers et les paramètres sont enregistrés. Notez que chemin_accès_magasin ne peut pas être c:\. Vous devez spécifier l’option chemin_accès_magasin dans la commande ScanState, sauf quand vous utilisez l’option /genconfig. Vous ne pouvez pas préciser plusieurs emplacements chemin_accès_magasin.

/o

Option nécessaire pour remplacer des données existantes dans le magasin de migration ou le fichier Config.xml. Si cette option n’est pas précisée, la commande ScanState échoue si le magasin de migration contient déjà des données. Vous ne pouvez pas utiliser cette option plus d’une fois dans une ligne de commande.

/vsc

Cette option permet au service VSS (Volume Shadow-Copy) de migrer des fichiers verrouillés ou en cours d’utilisation. Cette option de ligne de commande élimine la plupart des erreurs de verrouillage de fichier généralement rencontrées dans la section <ErrorControl>.

Elle peut être utilisée uniquement avec le fichier exécutable ScanState et mais pas conjointement avec l’option /hardlink.

/hardlink

Permet de créer un magasin de migration par lien physique à l’emplacement précisé. L’option /nocompress doit être spécifiée avec l’option /hardlink.

/encrypt [{/key:<chaîne_clé> | /keyfile:<fichier>]}

Chiffre le magasin avec la clé spécifiée. Le chiffrement est désactivé par défaut. Avec cette option, vous devez spécifier la chaîne de chiffrement de l’une des façons suivantes :

  • /key: chaîne_clé spécifie la clé de chiffrement. S’il y a un espace dans chaîne_clé, vous devez mettre chaîne_clé entre guillemets.

  • /keyfile: chemin_accès_et_nom_fichier spécifie un fichier texte (.txt) contenant la clé de chiffrement.

Pour l’argument chaîne_clé, nous recommandons l’utilisation d’au moins huit caractères sans que cette valeur ne dépasse 256 caractères. Les options /key et /keyfile ne peuvent pas être utilisées sur la même ligne de commande. Les options /encrypt et /nocompress ne peuvent pas être utilisées sur la même ligne de commande.

> [!IMPORTANT] > Utilisez cette option avec précaution car quiconque ayant accès au script de ligne de commande ScanState a aussi accès à la clé de chiffrement. >

L’exemple qui suit présente la commande ScanState et l’option /key :

scanstate /i:migdocs.xml /i:migapp.xml \\server\share\migration\mystore /encrypt /key:mykey

/encrypt:<niveau_chiffrement>

L’option /encrypt accepte un paramètre de ligne de commande qui définit le niveau de chiffrement spécifié pour le chiffrement du magasin de migration. Pour plus d’informations sur les algorithmes de chiffrement pris en charge, voir Chiffrement de magasin de migration.

/nocompress

Désactive la compression des données et enregistre les fichiers dans un dossier masqué appelé « File » dans chemin_accès_magasin\USMT. La compression est activée par défaut. L’utilisation conjointe des options /nocompress et /hardlink entraîne la création d’un magasin de migration par lien physique. Vous pouvez utiliser le magasin non compressé pour connaître les éléments stockés par l‘USMT, résoudre un problème ou exécuter un utilitaire antivirus pour analyser les fichiers. Vous ne devez utiliser cette option que dans des environnements de test car il est recommandé d’utiliser un magasin compressé au moment même d’effectuer votre migration, sauf si vous utilisez ensemble les options /nocompress et /hardlink.

Vous ne pouvez pas utiliser conjointement les options /nocompress et /encrypt en une seule instruction sur la ligne de commande. Toutefois, si vous choisissez de migrer un magasin non compressé, la commande LoadState migre chaque fichier directement depuis le magasin vers l’emplacement adéquat sur l’ordinateur de destination sans recourir à un emplacement temporaire.

Exemple :

scanstate /i:migdocs.xml /i:migapp.xml \\server\share\migration\mystore /nocompress

Exécuter la commande ScanState sur un système Windows hors connexion

Vous pouvez exécuter la commande ScanState dans l’Environnement de préinstallation Windows (Windows PE). De plus, l’USMT prend en charge les migrations à partir d’installations précédentes de Windows contenues dans des répertoires Windows.old. Le répertoire hors connexion peut être un répertoire Windows lorsque vous exécutez la commande ScanState dans Windows PE ou bien un répertoire Windows.old lorsque vous exécutez la commande ScanState dans Windows.

L’exécution de la commande ScanState sur une image système Windows hors connexion offre plusieurs avantages :

  • Des performances accrues.

    L’Environnement de préinstallation Windows (Windows PE) étant un système d’exploitation léger, le nombre de services exécutés est plus réduit. Dans cet environnement, la commande ScanState a davantage accès aux ressources matérielles locales, ce qui permet à ScanState d’exécuter plus rapidement les opérations de migration.

  • Un processus de déploiement de bout en bout simplifié.

    La migration de données depuis Windows.old simplifie le processus de déploiement de bout en bout en permettant au processus de migration d’intervenir après l’installation du nouveau système d’exploitation.

  • Un taux de réussite accru pour les migrations.

    Le taux de succès de migration est augmenté puisque aucun fichier n’est protégé en écriture en mode hors connexion et du fait que l’environnement Windows PE procure un accès administrateur aux fichiers dans le système de fichiers Windows hors connexion, ce qui élimine la nécessité de disposer d’un accès de niveau administrateur au système en ligne.

  • Aptitude à récupérer un ordinateur non démarrable.

    Il peut être possible de récupérer et de migrer des données depuis un ordinateur non démarrable.

Options de migration hors connexion

Option de ligne de commande Définition

/offline: "chemin_fichier_XML_hors_connexion"

Cette option permet de définir un chemin d’accès vers un fichier XML hors connexion qui peut spécifier d’autres options de migration (par exemple, un répertoire Windows hors connexion ou une redirection de domaine ou de dossier requise pour votre migration).

/offlinewindir: "chemin_répertoire_Windows"

Cette option spécifie le répertoire Windows hors connexion à partir duquel la commande ScanState recueille l’état utilisateur. Le répertoire hors connexion peut être un répertoire Windows.old lorsque vous exécutez la commande ScanState dans Windows ou bien un répertoire Windows lorsque vous exécutez la commande ScanState dans l’Environnement de préinstallation Windows (Windows PE).

/offlinewinold: "répertoire_Windows.old"

Cette option de ligne de commande active le mode de migration hors connexion et démarre la migration à partir de l’emplacement spécifié. Elle est uniquement destinée à être utilisée dans les scénarios de migration Windows.old où la migration s’effectue à partir d’un répertoire Windows.old.

Options de règle de migration

L’USMT fournit les options suivantes pour spécifier les fichiers à migrer.

Option de ligne de commande Description

/i:[chemin\]nom_fichier

(include)

Spécifie un fichier XML contenant les règles qui définissent l’utilisateur, l’application ou l’état système à migrer. Vous pouvez spécifier cette option plusieurs fois pour inclure tous vos fichiers XML (MigApp.xml, MigDocs.xml et tous les fichiers XML personnalisés que vous créez). chemin peut être un chemin d’accès relatif ou complet. Si vous ne spécifiez pas la variable chemin, nom_fichier doit alors se trouver dans le répertoire actuel. Pour plus d’informations sur les fichiers à spécifier, voir la section « Fichiers XML » de la rubrique Forum Aux Questions.

/genconfig:[chemin\]nom_fichier

(Générer Config.xml)

Génère le fichier Config.xml facultatif, mais ne crée pas de magasin de migration. Pour vous assurer que ce fichier contient chacun des composants, applications et paramètres qu’il est possible de migrer, vous devez le créer sur un ordinateur source qui contient tous les composants, applications et paramètres qui seront présents sur les ordinateurs de destination. De plus, vous devez spécifier les autres fichiers XML de migration, à l’aide de l’option /i, lorsque vous spécifiez cette option.

Après avoir créé ce fichier, vous devez l’utiliser avec la commande ScanState au moyen de l’option /config.

Les seules options que vous pouvez spécifier avec cette option sont /i, /v et /l. Vous ne pouvez pas spécifier chemin_accès_magasin puisque l’option /genconfig ne crée pas de magasin. chemin peut être un chemin d’accès relatif ou complet. Si vous ne spécifiez pas la variable chemin, nom_fichier est créé dans le répertoire actuel.

Exemples :

  • L’exemple suivant crée un fichier Config.xml dans le répertoire actuel :

    scanstate /i:migapp.xml /i:migdocs.xml /genconfig:config.xml /v:13

/config:[chemin\]nom_fichier

Spécifie le fichier Config.xml que doit utiliser la commande ScanState pour créer le magasin. Vous ne pouvez pas utiliser cette option plus d’une fois dans la ligne de commande. chemin peut être un chemin d’accès relatif ou complet. Si vous ne spécifiez pas la variable chemin, nom_fichier doit alors se trouver dans le répertoire actuel.

L’exemple suivant crée un magasin à l’aide des fichiers Config.xml, MigDocs.xml et MigApp.xml :

scanstate \\server\share\migration\mystore /config:config.xml /i:migdocs.xml /i:migapp.xml /v:13 /l:scan.log

L’exemple suivant migre les fichiers et paramètres vers l’ordinateur de destination à l’aide des fichiers Config.xml, MigDocs.xml et MigApp.xml :

loadstate \\server\share\migration\mystore /config:config.xml /i:migdocs.xml /i:migapp.xml /v:13 /l:load.log

/auto: chemin_accès_fichiers_script

Cette option vous permet de préciser l’emplacement des fichiers XML par défaut, puis de lancer la migration. Si aucun chemin d’accès n’est spécifié, l’USMT désigne le répertoire dans lequel résident les fichiers binaires propres à l’USMT. L’option /auto équivaut aux options suivantes : /i:MigDocs.xml/i:MigApp.xml /v:5.

/genmigxml: chemin_accès_fichier

Cette option spécifie que la commande ScanState doit utiliser l’outil de recherche de documents pour créer et exporter un fichier XML qui définit comment migrer tous les fichiers sur l’ordinateur sur lequel la commande ScanState est exécutée.

/localonly

Migre uniquement les fichiers stockés sur l’ordinateur local, quelles que soient les règles contenues dans les fichiers XML que vous spécifiez dans la ligne de commande. Vous devez utiliser cette option lorsque vous souhaitez exclure les données des lecteurs amovibles sur l’ordinateur source (tels que des disques mémoire flash USB, des disques durs externes, etc.) et lorsque des lecteurs réseau sont mappés sur l’ordinateur source. Si l’option /localonly n’est pas spécifiée, la commande ScanState copie les fichiers de ces lecteurs amovibles ou réseau dans le magasin.

Tout ce qui n’est pas considéré comme un lecteur fixe par le système d’exploitation est exclu par /localonly. Dans certains cas, des disques durs externes volumineux peuvent être considérés comme des lecteurs fixes. Ces lecteurs peuvent être explicitement exclus de la migration au moyen d’un fichier XML personnalisé. Pour plus d’informations sur la manière d’exclure tous les fichiers sur un lecteur en particulier, voir Exclure des fichiers et des paramètres.

L’option de ligne de commande /localonly inclut ou exclut les données dans la migration conformément aux informations contenues dans le tableau suivant :

 

Type de lecteur Comportement avec /localonly

Lecteurs amovibles (par exemple, un disque mémoire flash USB)

Exclus

Lecteurs réseau

Exclus

Lecteurs fixes

Inclus

Options de suivi

L’USMT fournit plusieurs options que vous pouvez utiliser pour analyser des problèmes survenus au cours de la migration.

Notes

Le journal ScanState est créé par défaut, mais vous pouvez spécifier le nom et l’emplacement du journal avec l’option /l.

Option de ligne de commande Description

/listfiles:<nom_fichier>

Vous pouvez utiliser l’option de ligne de commande /listfiles avec la commande ScanState pour générer un fichier texte qui répertorie tous les fichiers inclus dans la migration.

/l:[chemin\]nom_fichier

Spécifie l’emplacement et le nom du journal ScanState.

Vous ne pouvez pas stocker les fichiers journaux dans chemin_accès_magasin. chemin peut être un chemin d’accès relatif ou complet. Si vous ne spécifiez pas la variable chemin, le journal est créé dans le répertoire actuel. Vous pouvez utiliser l’option /v pour ajuster le volume de la sortie.

Si vous exécutez la commande ScanState ou LoadState à partir d’une ressource réseau partagée, vous devez spécifier cette option sans quoi l’USMT échoue avec l’erreur suivante : « L’Outil de migration utilisateur (USMT) n’a pas pu créer le ou les fichiers journaux ». Pour résoudre ce problème, utilisez la commande /l:scan.log.

/v: <niveau_détail>

(Verbosity)

Permet une sortie détaillée dans le fichier journal ScanState. La valeur par défaut est 0.

Vous pouvez affecter l’un des niveaux suivants à la variable niveau_détail :

 

Niveau Explication

0

Seuls les erreurs et avertissements par défaut sont activés.

1

Active la sortie détaillée.

4

Active la sortie d’erreur et d’état.

5

Active la sortie détaillée et d’état.

8

Active la sortie d’erreur vers un débogueur.

9

Active la sortie détaillée vers un débogueur.

12

Active la sortie d’erreur et d’état vers un débogueur.

13

Active la sortie détaillée, d’état et du débogueur.

          </div>
          <p>Exemple :</p>
          <p>
            <code>scanstate \\server\share\migration\mystore /v:13 /i:migdocs.xml /i:migapp.xml</code>
          </p>
          <p>
            
          </p>
        </td>
      </tr>
      <tr>
        <td colspan="1">
          <p>
            <strong>/progress</strong>:[<em>chemin\</em>]<em>nom_fichier</em></p>
        </td>
        <td colspan="1">
          <p>Crée le journal de progression facultatif. Vous ne pouvez pas stocker les fichiers journaux dans <em>chemin_accès_magasin</em>. <em>chemin</em> peut être un chemin d’accès relatif ou complet. Si vous ne spécifiez pas la variable <em>chemin</em>, <em>nom_fichier</em> est créé dans le répertoire actuel.</p>
          <p>Exemple :</p>
          <p>
            <code>scanstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /progress:prog.log /l:scanlog.log</code>
          </p>
        </td>
      </tr>
      <tr>
        <td colspan="1">
          <p>
            <strong>/c</strong>
          </p>
        </td>
        <td colspan="2">
          <p> Lorsque vous spécifiez cette option, l’exécution de la commande <strong>ScanState</strong> se poursuit même si des erreurs récupérables surviennent. Tout fichier ou paramètre qui provoque une erreur est consigné dans le journal de progression. Par exemple, si un fichier de taille importante ne tient pas dans le magasin, la commande <strong>ScanState</strong> consigne une erreur et poursuit la migration. De plus, si un fichier est ouvert ou est en cours d’utilisation dans une application, l’USMT risque de ne pas pouvoir migrer le fichier et enregistre une erreur. Sans l’option <strong>/c</strong>, la commande <strong>ScanState</strong> se ferme dès la première erreur.</p>
          <p>Vous pouvez utiliser la nouvelle section <strong>&lt;ErrorControl&gt;</strong> du fichier Config.xml pour spécifier les erreurs de lecture/écriture de fichier ou du Registre qui peuvent être ignorées sans risque et celles susceptibles de faire échouer la migration. Ceci permet à l’option de ligne de commande <strong>/c</strong> d’ignorer en toute sécurité toutes les erreurs d’entrée/sortie (E/S) dans votre environnement. De plus, l’option <strong>/genconfig</strong> génère à présent un exemple de section <strong>&lt;ErrorControl&gt;</strong> mis en place en spécifiant les messages d’erreur et les comportements souhaités au sein du fichier Config.xml.</p>
        </td>
      </tr>
      <tr>
        <td colspan="1">
          <p>
            <strong>/r:</strong>
            <em>&lt;nombre_nouvelles_tentatives&gt;</em>
          </p>
        </td>
        <td colspan="2">
          <p>
            <strong>(Retry)</strong>
          </p>
          <p>Spécifie le nombre de nouvelles tentatives à effectuer en cas d’erreur lors de l’enregistrement de l’état utilisateur sur un serveur. La valeur par défaut est trois fois. Cette option est utile dans les environnements où la connectivité réseau n’est pas fiable.</p>
          <p>Lors de la restauration de l’état utilisateur, l’option <strong>/r</strong> ne récupère pas les données perdues suite à une défaillance de l’équipement réseau (par exemple, un câble réseau défectueux ou déconnecté) ou à l’échec d’une connexion VPN (réseau privé virtuel). L’option de nouvelle tentative est destinée aux grands réseaux encombrés où la connectivité est satisfaisante, mais où la latence de communication pose problème.</p>
        </td>
      </tr>
      <tr>
        <td colspan="1">
          <p>
            <strong>/w:</strong>
            <em>&lt;secondes_avant_nouvelle tentative&gt;</em>
          </p>
        </td>
        <td colspan="2">
          <p>
            <strong>(Wait)</strong>
          </p>
          <p>Spécifie le délai d’attente (en secondes) avant que l’opération de fichier réseau ne soit retentée. La valeur par défaut est 1 seconde.</p>
        </td>
      </tr>
      <tr>
        <td>
          <p>
            <strong>/p:</strong>
            <em>&lt;chemin_accès_fichier&gt;</em>
          </p>
        </td>
        <td>
          <p>Lorsque la commande <strong>ScanState</strong> s’exécute, elle crée un fichier XML à l’emplacement précisé. Ce fichier XML inclut des estimations d’espace améliorées pour le magasin de migration. L’exemple suivant montre comment créer ce fichier XML :</p>
          <p>
            <code>Scanstate.exe C:\MigrationLocation [additional parameters]</code>
          </p>
          <p>
            <code>/p:"C:\MigrationStoreSize.xml"</code>
          </p>
          <p>Pour plus d’informations, voir <a runat="server" href="hh825132(v=win.10).md">Estimer la taille des magasins de migration</a>.</p>
          <p>Pour conserver la fonctionnalité des scripts ou applications existants qui nécessitent le comportement précédent de l’USMT, vous pouvez vous servir de l’option <strong>/p</strong>, sans spécifier « <em>chemin_accès_fichier</em> » dans l’USMT. Si vous spécifiez uniquement l’option <strong>/p</strong>, les estimations d’espace de stockage sont créées de la même manière que dans les versions USMT3.x.</p>
        </td>
      </tr>
      <tr>
        <td colspan="1">
          <p>
            <strong>/?</strong> ou <strong>/help</strong></p>
        </td>
        <td colspan="2">
          <p>Affiche l’aide sur la ligne de commande.</p>
        </td>
      </tr>
    </table>

Options utilisateur

Par défaut, tous les utilisateurs sont migrés. Le seul moyen de spécifier les utilisateurs à inclure et à exclure consiste à utiliser les options suivantes. Vous ne pouvez pas exclure des utilisateurs dans les fichiers XML de migration ou à l’aide du fichier Config.xml. Pour plus d’informations, voir Identifier les utilisateurs et Migrer des comptes d’utilisateurs.

Option de ligne de commande Description

/all

Migre tous les utilisateurs sur l’ordinateur.

L’USMT migre tous les comptes d’utilisateurs de l’ordinateur, sauf si vous excluez spécifiquement un compte au moyen de l’option /ue ou /uel. C’est pourquoi il n’est pas nécessaire de spécifier cette option sur la ligne de commande. En revanche, si vous choisissez d’utiliser l’option /all, vous ne pouvez pas utiliser également les options /ui, /ue ou /uel.

/ui: <nom_domaine>\<nom_utilisateur>

ou

/ui: <nom_ordinateur>\<nom_utilisateur_local>

(User include)

Migre les utilisateurs spécifiés. Par défaut, tous les utilisateurs sont inclus dans la migration. Autrement dit, cette option n’est utile que lorsque vous utilisez l’option /ue ou /uel. Vous pouvez spécifier plusieurs options /ui, mais vous ne pouvez pas utiliser l’option /ui avec l’option /all. nom_domaine et nom_utilisateur peuvent contenir le caractère générique « * » (astérisque). Lorsque vous spécifiez un nom d’utilisateur qui contient des espaces, vous devez le placer entre guillemets.

noteRemarque
Si vous précisez qu’un utilisateur est inclus au moyen de l’option /ui et qu’il est également exclu à l’aide de l’option /ue ou /uel, l’utilisateur est inclus dans la migration.

Exemple :

  • Pour inclure uniquement l’utilisateur User2 du domaine Fabrikam, tapez :

    /ue:*\* /ui:fabrikam\user2

  • Pour migrer tous les utilisateurs du domaine Fabrikam et uniquement les comptes d’utilisateurs d’autres domaines qui ont été actifs ou modifiés au cours des 30 derniers jours, tapez :

    /uel:30 /ui:fabrikam\*

    Dans cet exemple, un compte d’utilisateur du domaine Contoso qui a été modifié pour la dernière fois il y a deux mois n’est pas migré.

Pour obtenir plus d’exemples, voir les descriptions des options /ue et /ui dans ce tableau.

/uel: <nombre_jours>

ou

/uel: <AAAA/MM/JJ>

ou

/uel:0

(User exclude based on last logon)

Migre uniquement les utilisateurs qui ont ouvert une session sur l’ordinateur source au cours de la période spécifiée en se basant sur la date de dernière modification inscrite dans le fichier Ntuser.dat sur l’ordinateur source. L’option /uel intervient en qualité de règle d’inclusion. Par exemple, l’option /uel:30 migre les utilisateurs qui ont ouvert une session, ou dont le compte a été modifié, au cours des 30 derniers jours à compter de la date d’exécution de la commande ScanState.

Vous pouvez spécifier un nombre de jours ou bien une date. Vous ne pouvez pas utiliser cette option avec l’option /all. L’USMT récupère les dernières informations d’ouverture de session depuis l’ordinateur local ; il n’est donc pas nécessaire que celui-ci soit connecté au réseau lorsque vous exécutez cette option. De plus, si un utilisateur du domaine a ouvert une session sur un autre ordinateur, cette instance d’ouverture de session n’est pas prise en compte par l’USMT.

noteRemarque
L’option /uel n’est pas valide pour les migrations hors connexion.

  • /uel:0 migre tous les utilisateurs actuellement connectés.

  • /uel:90 migre les utilisateurs qui ont ouvert une session ou dont le compte a été modifié au cours des 90 derniers jours.

  • /uel:1 migre les utilisateurs dont les comptes ont été modifiés au cours des dernières 24 heures.

  • /uel:2002/1/15 migre les utilisateurs qui ont ouvert une session ou dont les comptes ont été modifiés le 15 janvier 2002 ou au-delà.

Exemple :

scanstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /uel:0

/ue: <nom_domaine>\<nom_utilisateur>

– ou –

/ue: <nom_ordinateur>\<nom_utilisateur_local>

(User exclude)

Exclut les utilisateurs spécifiés de la migration. Vous pouvez spécifier plusieurs options /ue. Vous ne pouvez pas utiliser cette option avec l’option /all. <nom_domaine> et <nom_utilisateur> peuvent contenir le caractère générique « * » (astérisque). Lorsque vous spécifiez un nom d’utilisateur qui contient des espaces, vous devez le mettre entre guillemets.

Exemple :

scanstate /i:migdocs.xml /i:migapp.xml \\server\share\migration\mystore /ue:contoso\user1

Utilisation des options /ui et /ue

Les exemples qui suivent s’appliquent aux options /ui et /ue. Vous pouvez remplacer l’option /ue par l’option /ui pour inclure, et non exclure, les utilisateurs spécifiés.

Comportement Commande

Exclure l’utilisateur appelé « User One » dans le domaine Fabrikam.

/ue:"fabrikam\user one"

Exclure l’utilisateur appelé « User1 » dans le domaine Fabrikam.

/ue:fabrikam\user1

Exclure l’utilisateur local nommé User1.

/ue:%computername%\user1

Exclure tous les utilisateurs de domaine.

/ue:Domain\*

Exclure tous les utilisateurs locaux.

/ue:%computername%\*

Exclure les utilisateurs dans tous les domaines nommés User1, User2, etc.

/ue:*\user*

Utilisation conjointe des options

Vous pouvez utiliser les options /uel, /ue et /ui ensemble pour migrer uniquement les utilisateurs que vous cherchez à migrer.

L’option /ui a priorité sur les options /ue et /uel. Si vous précisez qu’un utilisateur est inclus avec l’option /ui et qu’il est également exclu soit avec l’option /ue ou avec l’option /uel, l’utilisateur est inclus dans la migration. Par exemple, si vous spécifiez /ui:contoso\* /ue:contoso\user1, alors l’utilisateur User1 est migré puisque l’option /ui est prioritaire sur l’option /ue.

L’option /uel a priorité sur l’option /ue. Si un utilisateur a ouvert une session pendant la période définie par le biais de l’option /uel, le profil de cet utilisateur est migré même s’il a été exclu à l’aide de l’option /ue. Par exemple, si vous spécifiez /ue:fixed\user1 /uel:14, l’utilisateur User1 est migré s’il a ouvert une session sur l’ordinateur au cours des 14 derniers jours.

Comportement Commande

Inclure uniquement User2 du domaine Fabrikam et exclure tous les autres utilisateurs.

/ue:*\* /ui:fabrikam\user2

Inclure uniquement l’utilisateur local nommé User1 et exclure tous les autres utilisateurs.

/ue:*\* /ui:user1

Inclure uniquement les utilisateurs du domaine Contoso, à l’exception de Contoso\User1.

Ce comportement ne peut pas être obtenu à l’aide d’une seule commande. Au lieu de cela, pour migrer cet ensemble d’utilisateurs, vous devez spécifier ce qui suit :

  • Sur la ligne de commande ScanState, tapez : /ue:*\* /ui:contoso\*

  • Sur la ligne de commande LoadState, tapez : /ue:contoso\user1

Inclure uniquement les utilisateurs locaux (n’appartenant pas à un domaine).

/ue:*\* /ui:%computername%\*

Options de fichier chiffré

Vous pouvez utiliser les options suivantes pour migrer des fichiers chiffrés. Dans tous les cas, par défaut, l’USMT échoue si un fichier chiffré est détecté (sauf si vous spécifiez une option /efs). Pour migrer des fichiers chiffrés, vous devez modifier le comportement par défaut.

Pour plus d’informations, voir Migrer des fichiers et des certificats EFS.

Notes

Les certificats EFS sont migrés automatiquement au moment de la migration vers Windows Vista, Windows 7 ou Windows 8. Vous devez par conséquent spécifier l’option /efs:copyraw avec la commande ScanState pour migrer les fichiers chiffrés.

Avertissement

Procédez avec précaution lorsque vous migrez des fichiers chiffrés. Si vous migrez un fichier chiffré sans migrer également le certificat, les utilisateurs finaux ne pourront pas accéder au fichier après la migration.

Option de ligne de commande Explication

/efs:hardlink

Crée un lien physique vers le fichier EFS plutôt que de le copier. À utiliser uniquement avec les options /hardlink et /nocompress.

/efs:abort

Entraîne un échec de la commande ScanState avec un code d’erreur si un fichier EFS (Encrypting File System) est détecté sur l’ordinateur source. Option activée par défaut.

/efs:skip

Incite la commande ScanState à ignorer les fichiers EFS.

/efs:decryptcopy

Incite la commande ScanState à déchiffrer le fichier (si cela est possible) avant de l’enregistrer dans le magasin de migration et la fait échouer s’il est impossible de déchiffrer le fichier. Si la commande ScanState réussit, le fichier est déchiffré dans le magasin de migration et il est copié sur l’ordinateur de destination une fois que vous avez exécuté la commande LoadState.

/efs:copyraw

Incite la commande ScanState à copier les fichiers au format chiffré. Les fichiers sont inaccessibles sur l’ordinateur de destination tant que les fichiers EFS n’ont pas été migrés. Les certificats EFS sont automatiquement migrés. En revanche, par défaut, l’USMT échoue si un fichier chiffré est détecté (sauf si vous spécifiez une option /efs). Vous devez par conséquent spécifier l’option /efs:copyraw avec la commande ScanState pour migrer le fichier chiffré. Ensuite, lors de l’exécution de la commande LoadState, le fichier chiffré et le certificat EFS sont automatiquement migrés.

Exemple :

ScanState /i:migdocs.xml /i:migapp.xml \\server\share\migration\mystore /efs:copyraw

> [!IMPORTANT] > Tous les fichiers doivent être chiffrés si le dossier parent est chiffré. Si l’attribut de chiffrement d’un fichier au sein d’un dossier chiffré a été supprimé, le fichier est chiffré au cours de la migration à l’aide des informations d’identification du compte employé pour exécuter l’outil LoadState. Pour plus d’informations, voir Migrer des fichiers et des certificats EFS. >

Options de ligne de commande incompatibles

Le tableau qui suit indique les options de ligne de commande qui ne sont pas compatibles avec la commande ScanState. Si l’entrée de tableau d’une combinaison spécifique est vide, cela signifie que les options sont compatibles et peuvent être utilisées conjointement. Le symbole X signifie que les options sont incompatibles. Par exemple, vous ne pouvez pas utiliser l’option /nocompress avec l’option /encrypt.

Option de ligne de commande /keyfile /nocompress /genconfig /all

/i

/o

/v

/nocompress

X

Non applicable

/localonly

X

/key

X

X

/encrypt

Obligatoire*

X

X

/keyfile

Non applicable

X

/l

/progress

X

/r

X

/w

X

/c

X

/p

X

Non applicable

/all

X

/ui

X

X

/ue

X

X

/uel

X

X

/efs:<option>

X

/genconfig

Non applicable

/config

X

<chemin_accès_magasin>

X

Notes

Vous devez spécifier au choix l’option /key ou /keyfile avec l’option /encrypt.

Voir aussi

Autres ressources

Bibliothèque d’éléments XML