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 :
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 :
|
/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 :
|
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 :
|
||||||||
/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 :
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 :
|
||||||||
/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 :
|
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 :
Options utilisateurPar 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.
Utilisation des options /ui et /ueLes 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.
Utilisation conjointe des optionsVous 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 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
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.
Options de ligne de commande incompatiblesLe 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.
Notes Vous devez spécifier au choix l’option /key ou /keyfile avec l’option /encrypt. Voir aussiAutres ressources |