Syntaxe de LoadState
Cette rubrique aborde la syntaxe et les options de la commande LoadState.
Dans cette rubrique
Avant de commencer
Syntaxe
Options de stockage
Options de règle de migration
Options de suivi
Options utilisateur
Options de ligne de commande incompatibles
Avant de commencer
Avant d’exécuter la commande LoadState, notez les points suivants :
Pour vous assurer que tous les paramètres de système d’exploitation sont migrés, nous vous recommandons d’exécuter des commandes LoadState en mode Administrateur à partir d’un compte muni d’informations d’identification d’administration.
Pour plus d’informations sur la configuration logicielle requise pour l’exécution de la commande LoadState, voir Configuration requise pour l’outil USMT.
Vous avez tout intérêt à fermer la session après avoir exécuté l’outil LoadState. Certains paramètres, tels que ceux relatifs aux polices, au papier peint et à l’écran de veille, ne prennent effet qu’à la prochaine ouverture de session de l’utilisateur.
Sauf indication contraire, vous pouvez utiliser chaque option une seule fois lorsque vous exécutez un outil dans la ligne de commande.
L’outil LoadState n’exige aucun accès à un contrôleur de domaine pour appliquer des profils de domaine. Cette fonctionnalité est disponible sans configuration supplémentaire. Si l’ordinateur source n’a pas eu besoin d’un accès au contrôleur de domaine au moment où le profil utilisateur a été récupéré à l’aide de ScanState, les profils de domaine restent toutefois inaccessibles tant que l’ordinateur de destination n’est pas joint au domaine.
Le tableau Options de ligne de commande incompatibles recense les options que vous pouvez utiliser ensemble et les options de ligne de commande incompatibles.
Syntaxe
Cette section explique la syntaxe et l’utilisation des options de ligne de commande disponibles lorsque vous avez recours à la commande LoadState. Les options peuvent être spécifiées dans n’importe quel ordre. Si l’option contient un paramètre, vous pouvez utiliser le caractère deux-points ou un espace en guise de séparateur.
La syntaxe de la commande LoadState est la suivante :
loadstate chemin_accès_magasin [/i:[chemin\]nom_fichier] [/v:niveau_détail] [/nocompress] [/decrypt /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] [/all] [/ui:[nom_domaine|nom_ordinateur\]nom_utilisateur] [/ue:[[nom_domaine|nom_ordinateur\]nom_utilisateur] [/uel:nombre_jours|AAAA/MM/JJ|0] [/md:ancien_domaine:nouveau_domaine] [/mu:ancien_domaine\ancien_nom_utilisateur:[nouveau_domaine\]nouveau_nom_utilisateur] [/lac:[mot_de_passe]] [/lae] [/config:[chemin\]nom_fichier] [/?|help]
Par exemple, pour déchiffrer le magasin et migrer les fichiers et les paramètres sur un ordinateur doté de Windows Vista ou de Windows 7, tapez ce qui suit dans la ligne de commande :
loadstate \\server\share\migration\mystore /i:migapp.xml /i:migdocs.xml /v:13 /decrypt /key:"mykey"
Options de stockage
L’USMT propose les options suivantes pour spécifier le mode et l’emplacement de stockage des données migrées.
Option de ligne de commande | Description |
---|---|
chemin_accès_magasin |
Indique le dossier dans lequel les données des fichiers et des paramètres sont stockées. Vous devez spécifier l’option chemin_accès_magasin lorsque vous utilisez la commande LoadState. Vous ne pouvez pas préciser plusieurs emplacements chemin_accès_magasin. |
/decrypt /key:chaîne_clé ou /decrypt /key:"chaîne_clé" ou /decrypt /keyfile:[chemin\]nom_fichier |
Déchiffre le magasin avec la clé spécifiée. Avec cette option, vous devez spécifier la chaîne de chiffrement de l’une des façons suivantes :
L’argument chaîne_clé ne peut pas contenir plus de 256 caractères. Les options /key et /keyfile ne peuvent pas être utilisées sur la même ligne de commande. Les options /decrypt 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 LoadState a aussi accès à la clé de chiffrement. >Exemple :
|
/decrypt : "niveau_chiffrement" |
L’option /decrypt 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. |
/hardlink |
Permet de restaurer des données d’état utilisateur à partir d’un magasin de migration par lien physique. Le paramètre /nocompress doit être spécifié avec l’option /hardlink. |
/nocompress |
Précise que le magasin n’est pas compressé. Vous ne devez utiliser cette option que dans des environnements de test. Nous vous recommandons d’utiliser un magasin compressé au moment même d’effectuer votre migration. Cette option ne peut pas être utilisée avec l’option /decrypt. Exemple :
|
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’état à migrer. Vous pouvez spécifier cette option plusieurs fois pour inclure tous vos fichiers XML (MigApp.xml, MigSys.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. |
|
/config:[chemin\]nom_fichier |
Spécifie le fichier Config.xml que doit utiliser la commande LoadState. 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. Cet exemple migre les fichiers et les paramètres en fonction des règles énoncées dans les fichiers Config.xml, MigDocs.xml et MigApp.xml :
|
|
/auto: "chemin d’accès aux fichiers de script" |
Cette option vous permet de préciser l’emplacement des fichiers XML par défaut, puis de lancer votre migration. Si aucun chemin d’accès n’est spécifié, l’USMT utilise le répertoire dans lequel résident les binaires propres à l’USMT. L’option /auto revient à utiliser les options suivantes : /i:MigDocs.xml/i:MigApp.xml /v:5. |
Options de suivi
L’USMT fournit plusieurs options de ligne de commande que vous pouvez utiliser pour analyser des problèmes survenus au cours de la migration.
Option de ligne de commande | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
/l:[chemin\]nom_fichier |
Spécifie l’emplacement et le nom du fichier journal LoadState. 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 spécifier l’option /v pour ajuster le volume de la sortie. Si vous exécutez la commande 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 l’option /l:load.log. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
/v: <niveau_détail> |
(Verbosity) Permet une sortie détaillée dans le fichier journal LoadState. 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.
Exemples pour les 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 ligne de commande incompatiblesLe tableau qui suit indique les options de ligne de commande qui ne sont pas compatibles avec la commande LoadState. 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 |