Syntaxe LoadState
La LoadState.exe commande est utilisée avec l’outil de migration de l’état utilisateur (USMT) pour restaurer un magasin précédemment capturé par la ScanState.exe commande sur un ordinateur de destination. Cet article décrit la syntaxe de LoadState.exe commande et les options disponibles avec celle-ci.
Avant de commencer
Avant d’exécuter la LoadState.exe commande, notez les éléments suivants :
Pour garantir la migration de tous les paramètres du système d’exploitation, Microsoft recommande d’exécuter
LoadState.exedes commandes en mode administrateur à partir d’un compte avec des informations d’identification d’administration.Pour plus d’informations sur la configuration logicielle requise pour l’exécution de la
LoadState.execommande, consultez Configuration requise de l’outil USMT.Déconnectez-vous après avoir exécuté la
LoadState.execommande . Certains paramètres, tels que les exemples, les polices, le papier peint et les paramètres d’écran de veille, ne prendront effet qu’à la prochaine connexion de l’utilisateur.Sauf indication contraire, chaque option ne peut être utilisée qu’une seule fois lors de l’exécution d’un outil à partir de la ligne de commande.
LoadState ne nécessite pas d’accès au contrôleur de domaine pour appliquer des profils de domaine. Cette fonctionnalité est disponible sans configuration supplémentaire. Il n’est pas nécessaire que l’ordinateur source dispose d’un accès au contrôleur de domaine lorsque le profil utilisateur a été collecté à l’aide de ScanState. Toutefois, les profils de domaine ne sont pas accessibles tant que l’ordinateur de destination n’est pas joint au domaine.
Le tableau Options de ligne de commande incompatibles répertorie les options qui peuvent être utilisées 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 lors de l’utilisation de la LoadState.exe commande. Les options peuvent être spécifiées dans n’importe quel ordre. Si l’option contient un paramètre, un séparateur de deux-points ou d’espace peut être spécifié.
La LoadState.exe syntaxe de la commande est la suivante :
LoadState.exe StorePath [/i :[Path\]FileName] [/v :VerbosityLevel] [/nocompress] [/decrypt /key :KeyString|/keyfile :[Path\]FileName] [/l :[Path\]FileName] [/l :[Path\]FileName] [/progress :[Path\]FileName] [/r :TimesToRetry] [/w :SecondsToWait] [/c] [/all] [/ui :[DomainName|ComputerName\]UserName] [/ue :[DomainName|ComputerName\]UserName] [/uel :NumberOfDays|AAAA/MM/DD|0] [/md :OldDomain :NewDomain] [/mu :OldDomain\OldUserName :[NewDomain\]NewUserName] [/lac :[Password]] [/lae] [/config :[Path\]FileName] [/ ?|help]
Par exemple, pour déchiffrer le magasin et migrer les fichiers et les paramètres vers un ordinateur, tapez la commande suivante :
LoadState.exe \\server\share\migration\mystore /i:MigApp.xml /i:MigDocs.xml /v:13 /decrypt /key:"mykey"
Options de stockage
USMT fournit les options suivantes qui peuvent être utilisées pour spécifier comment et où les données migrées sont stockées.
| option Command-Line | Description |
|---|---|
| StorePath | Indique le dossier dans lequel les fichiers et les données de paramètres sont stockés.
StorePath doit être spécifié lors de l’utilisation de la LoadState.exe commande . Vous ne pouvez pas spécifier plusieurs StorePath . |
|
/decrypt /key :KeyString or /decrypt /key :"Key String » or /decrypt /keyfile :[Path]FileName |
Déchiffre le magasin avec la clé spécifiée. Avec cette option, la clé de chiffrement doit être spécifiée de l’une des manières suivantes :
KeyString ne peut pas dépasser 256 caractères. Les /key options et /keyfile ne peuvent pas être utilisées sur la même ligne de commande.Les /decrypt options et /nocompress ne peuvent pas être utilisées sur la même ligne de commande.
Important Soyez prudent lorsque vous utilisez les /key options ou keyfile . Par exemple, toute personne ayant accès aux scripts qui exécutent la LoadState.exe commande avec ces options a également accès à la clé de chiffrement.Par exemple : LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /decrypt /key:mykey |
| /decrypt :"encryption strength » | L’option /decrypt accepte un paramètre de ligne de commande pour définir la force de chiffrement spécifiée pour le chiffrement du magasin de migration. Pour plus d’informations sur les algorithmes de chiffrement pris en charge, consultez Chiffrement du magasin de migration. |
| /hardlink | Permet de restaurer les données d’état utilisateur à partir d’un magasin de migration à liaison matérielle. Le /nocompress paramètre doit être spécifié avec l’option /hardlink . |
| /nocompress | Spécifie que le magasin n’est pas compressé. Cette option doit être utilisée uniquement dans les environnements de test. Microsoft recommande d’utiliser un magasin compressé pendant la migration réelle. Cette option ne peut pas être utilisée avec l’option /decrypt .Par exemple : LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /nocompress |
Options de règle de migration
USMT fournit les options suivantes pour spécifier les fichiers à migrer.
| option Command-Line | Description |
|---|---|
| /i :[Path]FileName |
(inclure) Spécifie un fichier .xml qui contient des règles qui définissent les données à migrer. Cette option peut être spécifiée plusieurs fois pour inclure tous les fichiers .xml ( MigApp.xml, , MigSys.xmlMigDocs.xml et tous les fichiers .xml personnalisés créés).
Le chemin peut être un chemin d’accès relatif ou complet. Si la variable Path n’est pas spécifiée, FileName doit se trouver dans le répertoire actif.Pour plus d’informations sur les fichiers à spécifier, consultez la section « Fichiers XML » de l’article Forum aux questions . |
| /config :[Path]FileName | Spécifie le Config.xml fichier que la LoadState.exe commande doit utiliser. Cette option ne peut pas être spécifiée plusieurs fois sur la ligne de commande.
Le chemin peut être un chemin d’accès relatif ou complet. Si la variable Path n’est pas spécifiée, le FileName doit se trouver dans le répertoire actif.Cet exemple migre les fichiers et les paramètres en fonction des règles des Config.xmlfichiers , MigDocs.xmlet MigApp.xml :LoadState.exe \server\share\migration\mystore /config:Config.xml /i:MigDocs.xml /i:MigApp.xml /v:5 /l:LoadState.log |
| /auto :"path to script files » | Cette option permet de spécifier l’emplacement des fichiers .xml par défaut. Si aucun chemin d’accès n’est spécifié, USMT utilise le répertoire où se trouvent les fichiers binaires USMT. L’option /auto a le même effet que l’utilisation des options suivantes : /i:MigDocs.xml/i:MigApp.xml /v:5. |
Options de surveillance
L’outil USMT fournit plusieurs options de ligne de commande qui peuvent être utilisées pour analyser les problèmes qui se produisent pendant la migration.
| option Command-Line | Description |
|---|---|
| /l :[Path]FileName | Spécifie l’emplacement et le nom du journal LoadState . Les fichiers journaux ne peuvent pas être stockés dans StorePath.
Le chemin peut être un chemin d’accès relatif ou complet. Si la variable Path n’est pas spécifiée, le journal est créé dans le répertoire actif. L’option /v peut être spécifiée pour ajuster le détail du journal.Si vous exécutez la LoadState.exe commande à partir d’une ressource réseau partagée, l’option l doit être spécifiée, sinon l’outil USMT échoue avec l’erreur :L’outil USMT n’a pas pu créer le ou les fichiers journaux Pour résoudre ce problème, veillez à spécifier l’option lors de l’exécution /lLoadState.exe à partir d’une ressource réseau partagée. |
/v :<VerbosityLevel> |
(Détail) Active la sortie détaillée dans le fichier journal LoadState . La valeur par défaut est 0. VerbosityLevel peut être défini sur l’un des niveaux suivants :
Par exemple : LoadState.exe \server\share\migration\mystore /v:5 /i:MigDocs.xml /i:MigApp.xml |
| /progress :[Path]FileName | Crée le journal de progression facultatif. Les fichiers journaux ne peuvent pas être stockés dans StorePath.
Le chemin peut être un chemin d’accès relatif ou complet. Si la variable Path n’est pas spécifiée, fileName est créé dans le répertoire actif. Par exemple : LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /progress:Progress.log /l:loadlog.log |
| /c | Lorsque cette option est spécifiée, la LoadState.exe commande continue à s’exécuter, même si des erreurs non irrécupérables se produisent. Tous les fichiers ou paramètres qui provoquent une erreur sont enregistrés dans le journal de progression. Par exemple, s’il existe un fichier volumineux qui ne tient pas sur l’ordinateur, la LoadState.exe commande enregistre une erreur et poursuit la migration. Sans l’option /c , la LoadState.exe commande se ferme à la première erreur. La < section ErrorControl> peut être utilisée dans le Config.xml fichier pour spécifier quel fichier ou registre les erreurs de lecture/écriture peuvent être ignorées en toute sécurité et qui peuvent entraîner l’échec de la migration. Ce contrôle d’erreurs permet à l’option /c de ligne de commande d’ignorer en toute sécurité toutes les erreurs d’entrée/sortie (E/S) dans l’environnement. En outre, l’option /genconfig génère désormais un exemple < de section ErrorControl> qui est activé en spécifiant les messages d’erreur et les comportements souhaités dans le Config.xml fichier. |
/r :<TimesToRetry> |
(Nouvelle tentative) Spécifie le nombre de nouvelles tentatives lorsqu’une erreur se produit lors de la migration de l’état utilisateur à partir d’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. Lorsque l’état de l’utilisateur est restauré, l’option /r ne récupère pas les données perdues en raison d’une défaillance matérielle du réseau, telle qu’un câble réseau défectueux ou déconnecté, ou en cas d’échec d’une connexion de réseau privé virtuel (VPN). L’option de nouvelle tentative est destinée aux réseaux volumineux et occupés pour lesquels la connectivité est satisfaisante, mais où la latence de communication pose problème. |
/w :<SecondsBeforeRetry> |
(Attendre) Spécifie le délai d’attente, en secondes, avant de réessayer une opération de fichier réseau. La valeur par défaut est 1 seconde. |
| /? ou /help | Affiche l’aide sur la ligne de commande. |
Options utilisateur
Par défaut, tous les utilisateurs sont migrés. La seule façon de spécifier les utilisateurs à inclure et à exclure consiste à utiliser les options suivantes. Les utilisateurs ne peuvent pas être exclus de la migration .xml fichiers ou à l’aide du Config.xml fichier . Pour plus d’informations, consultez Identifier les utilisateurs.
| option Command-Line | Description |
|---|---|
| /tout | Migre tous les utilisateurs sur l’ordinateur. USMT migre tous les comptes d’utilisateur sur l’ordinateur, sauf si un compte est spécifiquement exclu avec les /ue options ou /uel . Pour cette raison, cette option n’a pas besoin d’être spécifiée sur la ligne de commande. Toutefois, si vous utilisez l’option /all , les /uioptions ou /ue/uel ne peuvent pas également être utilisées. |
|
/ui :DomainName UserName or /ui :"DomainName User Name » or /ui :ComputerName LocalUserName |
(L’utilisateur inclut) Migre l’utilisateur spécifié. Par défaut, tous les utilisateurs sont inclus dans la migration. Par conséquent, cette option n’est utile que si elle est utilisée avec l’option /ue . Plusieurs /ui options peuvent être spécifiées, mais l’option /ui ne peut pas être utilisée avec l’option /all .
DomainName et UserName peuvent contenir le caractère générique astérisque (*). Lorsque le nom d’utilisateur qui contient des espaces est spécifié, il doit être entouré de guillemets (").Par exemple, pour inclure uniquement User2 à partir du domaine d’entreprise, entrez : /ue:* /ui:corporate\user2
Remarque Si un utilisateur est spécifié pour l’inclusion avec l’option /ui et qu’il doit également être exclu avec les /ue options ou /uel , l’utilisateur est inclus dans la migration.Pour obtenir d’autres exemples, consultez les descriptions des /ueloptions , /ueet /ui dans ce tableau. |
/uel :<NumberOfDays>or /uel : <YYYY/MM/DD>or /uel :0 |
(Exclure l’utilisateur en fonction de la dernière ouverture de session) Migre uniquement les utilisateurs qui se sont connectés à l’ordinateur source au cours de la période spécifiée, en fonction de la date de dernière modification du fichier Ntuser.dat sur l’ordinateur source. L’option /uel agit comme une règle d’include. Par exemple, l’option /uel:30 migre les utilisateurs qui se sont connectés ou dont le compte d’utilisateur a été modifié au cours des 30 derniers jours à compter de la date d’exécution de la ScanState.exe commande. Le nombre de jours peut être spécifié ou une date peut être spécifiée. Cette option ne peut pas être utilisée avec l’option /all . USMT récupère les dernières informations de connexion à partir de l’ordinateur local, de sorte que l’ordinateur n’a pas besoin d’être connecté au réseau lors de l’exécution de cette option. En outre, si un utilisateur de domaine se connecte à un autre ordinateur, USMT ne considère pas que la connexion instance.
Remarque L’option /uel n’est pas valide dans les migrations hors connexion.Exemples :
Par exemple : LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /uel:0 |
|
/ue :DomainName\UserName or /ue"DomainName\User Name » or /ue :ComputerName\LocalUserName |
(Exclusion de l’utilisateur) Exclut les utilisateurs spécifiés de la migration. Plusieurs /ue options peuvent être utilisées, mais l’option /ue ne peut pas être utilisée avec l’option /all .
DomainName et UserName peuvent contenir le caractère générique astérisque (*). Lorsqu’un nom d’utilisateur contenant des espaces est spécifié, il doit être entouré de guillemets (").Par exemple : LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /ue:contoso\user1Pour obtenir d’autres exemples, consultez les descriptions des /ueloptions , /ueet /ui dans ce tableau. |
|
/md :OldDomain :NewDomain or /md :LocalComputerName :NewDomain |
(Déplacer le domaine) Spécifie un nouveau domaine pour l’utilisateur. Utilisez cette option pour modifier le domaine des utilisateurs sur un ordinateur ou pour migrer un utilisateur local vers un compte de domaine. OldDomain peut contenir le caractère générique astérisque (). Cette option peut être spécifiée plusieurs fois. Si vous regroupez des utilisateurs dans plusieurs domaines dans un domaine unique, plusieurs /md options peuvent être spécifiées. Par exemple, pour consolider les utilisateurs des domaines Corporate et FarNorth dans le domaine Fabrikam, spécifiez les paramètres suivants : /md:corporate:fabrikam et /md:farnorth:fabrikam.S’il existe des conflits entre deux /md commandes, la première règle spécifiée est appliquée. Par exemple, si les /md:corporate:fabrikam commandes et /md:corporate:farnorth sont spécifiées, les utilisateurs d’entreprise sont mappés au domaine Fabrikam.
Remarque Si un domaine qui n’existait pas sur l’ordinateur source est spécifié, la LoadState.exe commande semble s’exécuter correctement, sans erreur ni avertissement. Toutefois, dans ce cas, les utilisateurs ne sont pas déplacés vers NewDomain , mais restent dans leur domaine d’origine. Par exemple, si contoso est mal orthographié et que /md :contso :fabrikam est spécifié, les utilisateurs restent dans contoso sur l’ordinateur de destination.Par exemple : LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore/progress:Progress.log /l:LoadState.log /md:contoso:fabrikam |
|
/mu :OldDomain OldUserName :[NewDomain]NewUserName or /mu :OldLocalUserName :NewDomain NewUserName |
(Déplacer l’utilisateur) Spécifie un nouveau nom d’utilisateur pour l’utilisateur spécifié. Si le magasin contient plusieurs utilisateurs, plusieurs /mu options peuvent être spécifiées. Les caractères génériques ne peuvent pas être utilisés avec cette option.Par exemple : LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore/progress:Progress.log /l:LoadState.log /mu:contoso\user1:fabrikam\user1 |
| /lac :[Password] |
(Créer un compte local) Si un compte d’utilisateur est :
/lae doit également être utilisée.Si l’option /lac n’est pas spécifiée, les comptes d’utilisateur locaux qui n’existent pas déjà sur l’ordinateur de destination ne sont pas migrés.Mot de passe est le mot de passe du compte nouvellement créé. Un mot de passe vide est utilisé par défaut.
Attention Utilisez la variable Password avec prudence. La variable Password est fournie en texte brut et toute personne ayant accès à l’ordinateur qui exécute la LoadState.exe commande peut obtenir le mot de passe.En outre, si l’ordinateur a plusieurs utilisateurs, tous les utilisateurs migrés ont le même mot de passe. Par exemple : LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystorePour obtenir des instructions, consultez Migrer des comptes d’utilisateur. |
/lae |
(Activation du compte local) Active le compte qui a été créé avec l’option /lac . L’option /lac doit être spécifiée avec cette option.Par exemple : LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore/progress:Progress.log /l:LoadState.log /lac:password /laePour obtenir des instructions, consultez Migrer des comptes d’utilisateur. |
Exemples pour les options /ui et /ue
Les exemples suivants s’appliquent aux options /ui et /ue . L’option /ue peut être remplacée par l’option /ui pour inclure, au lieu d’exclure, les utilisateurs spécifiés.
| Comportement | Commande |
|---|---|
| Excluez l’utilisateur nommé User One dans le domaine d’entreprise. | /ue:"corporate\user one" |
| Excluez l’utilisateur nommé User1 dans le domaine d’entreprise. | /ue:corporate\user1 |
| Excluez l’utilisateur local nommé User1. | /ue:%computername%\user1 |
| Excluez tous les utilisateurs du domaine. | /ue:Domain |
| Excluez tous les utilisateurs locaux. | /ue:%computername% |
| Excluez les utilisateurs dans tous les domaines nommés User1, User2, etc. | /ue:\user |
Utilisation des options ensemble
Les /ueloptions et /ui/ue peuvent être utilisées ensemble pour migrer uniquement les utilisateurs qui doivent être migrés.
L’option /ui est prioritaire sur les options /ue et /uel. Si un utilisateur est inclus à l’aide de l’option /ui et également exclu à l’aide des /ue options ou /uel , l’utilisateur est inclus dans la migration. Par exemple, si /ui:contoso\* /ue:contoso\user1 est spécifié, User1 est migré, car l’option /ui est prioritaire sur l’option /ue .
L’option /uel est prioritaire sur l’option /ue. Si un utilisateur s’est connecté au cours de la période spécifiée définie par l’option, le /uel profil de cet utilisateur est migré même s’il est exclu à l’aide de l’option /ue . Par exemple, si /ue:contoso\user1 /uel:14 est spécifié, User1 est migré s’il s’est connecté à l’ordinateur au cours des 14 derniers jours.
| Comportement | Commande |
|---|---|
| Incluez uniquement User2 du domaine Fabrikam et excluez tous les autres utilisateurs. | /ue:* /ui:fabrikam\user2 |
| Incluez uniquement l’utilisateur local nommé User1 et excluez tous les autres utilisateurs. | /ue:* /ui:user1 |
| Incluez uniquement les utilisateurs de domaine de Contoso, à l’exception de Contoso\User1. | Ce comportement ne peut pas être effectué à l’aide d’une seule commande. Au lieu de cela, pour migrer cet ensemble d’utilisateurs, spécifiez les options suivantes :
|
| Incluez uniquement les utilisateurs locaux (non-domaine). | /ue: /ui:%computername%* |
Options de ligne de commande incompatibles
Le tableau suivant indique les options de ligne de commande qui ne sont pas compatibles avec la LoadState.exe commande . Si l’entrée de table d’une combinaison particulière a un ✅, les options sont compatibles et peuvent être utilisées ensemble. Le ❌ symbole signifie que les options ne sont pas compatibles. Par exemple, l’option /nocompress ne peut pas être utilisée avec l’option /encrypt .
| option Command-Line | /keyfile | /nocompress | /genconfig | /tout |
|---|---|---|---|---|
| /Je | ✅ | ✅ | ✅ | ✅ |
| /v | ✅ | ✅ | ✅ | ✅ |
| /nocompress | ✅ | Non applicable | ❌ | ✅ |
| /clé | ❌ | ✅ | ❌ | ✅ |
| /décrypter | Obligatoire* | ❌ | ❌ | ✅ |
| /keyfile | Non applicable | ✅ | ❌ | ✅ |
| /l | ✅ | ✅ | ✅ | ✅ |
| /progrès | ✅ | ✅ | ❌ | ✅ |
| /r | ✅ | ✅ | ❌ | ✅ |
| /w | ✅ | ✅ | ❌ | ✅ |
| /c | ✅ | ✅ | ❌ | ✅ |
| /p | ✅ | ✅ | ❌ | Non applicable |
| /tout | ✅ | ✅ | ❌ | ✅ |
| /Ui | ✅ | ✅ | ❌ | ❌ |
| /ue | ✅ | ✅ | ❌ | ❌ |
| /Lse | ✅ | ✅ | ❌ | ❌ |
| /genconfig | ✅ | ✅ | Non applicable | ✅ |
| /config | ✅ | ✅ | ❌ | ✅ |
| StorePath | ✅ | ✅ | ✅ | ✅ |
| /Md | ✅ | ✅ | ✅ | ✅ |
| /mu | ✅ | ✅ | ✅ | ✅ |
| /Lae | ✅ | ✅ | ✅ | ✅ |
| /laque | ✅ | ✅ | ✅ | ✅ |
Remarque
L’option /key ou /keyfile doit être spécifiée avec l’option /decrypt .