Syntaxe ScanState

La ScanState.exe commande est utilisée avec l’outil de migration de l’état utilisateur (USMT) pour analyser l’ordinateur source, collecter les fichiers et les paramètres, et créer un magasin. Cet article décrit la syntaxe de ScanState.exe commande et les options disponibles avec celle-ci.

Avant de commencer

Avant d’exécuter la ScanState.exe commande, notez les éléments :

  • Pour vous assurer que tous les paramètres du système d’exploitation migrent, exécutez les ScanState.exe commandes en mode administrateur à partir d’un compte avec des informations d’identification d’administration.

  • Si le magasin de migration est chiffré, une clé de chiffrement ou un chemin d’accès à un fichier contenant la clé de chiffrement est nécessaire. Veillez à noter la clé ou l’emplacement du fichier de clé, car ces informations ne sont conservées nulle part dans le magasin de migration. Ces informations sont nécessaires lorsque la LoadState.exe commande est exécutée pour déchiffrer le magasin de migration ou si l’utilitaire de récupération doit être utilisé. Une clé ou un fichier de clé incorrect ou manquant génère un message d’erreur.

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

  • Sauf indication contraire, utilisez chaque option une seule fois lors de l’exécution d’un outil sur la ligne de commande.

  • Les comptes de domaine peuvent être collectés sans que l’ordinateur source n’ait accès au contrôleur de domaine. Cette fonctionnalité est disponible sans configuration supplémentaire.

  • 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.

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

Syntaxe

Cette section explique la syntaxe et l’utilisation des options de ligne de commande disponibles lors de l’utilisation de la ScanState.exe commande. Les options peuvent être spécifiées dans n’importe quel ordre. Si l’option contient un paramètre, un signe deux-points ou un séparateur d’espace peut être utilisé.

La ScanState.exe syntaxe de la commande est la suivante :

ScanState.exe [StorePath] [/apps] [/ppkg :FileName] [/i :[Path\]FileName] [/o] [/v :VerbosityLevel] [/nocompress] [/localonly] [/encrypt /key :KeyString|/keyfile :[Path\]FileName] [/l :[Path\]FileName] [/progress :[Path\]FileName] [/r :TimesToRetry] [/w :SecondsBeforeRetry] [/c] [/p] [/all] [/ui :[DomainName|ComputerName\]UserName] [/ue :[DomainName|ComputerName\]UserName] [/uel :NumberOfDays|AAAA/MM/DD|0] [/efs :abort|skip|decryptcopy|copyraw] [/genconfig :[Path\]FileName[/config :[Path\]FileName] [/ ?|help]

Par exemple, pour créer un Config.xml fichier dans le répertoire actif, utilisez :

ScanState.exe /i:MigApp.xml /i:MigDocs.xml /genconfig:Config.xml /v:13

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

ScanState.exe \\server\share\migration\mystore /i:MigApp.xml /i:MigDocs.xml /o /config:Config.xml /v:13 /encrypt /key:"mykey"

Options de stockage

option Command-Line Description
StorePath Indique un dossier dans lequel les fichiers et les paramètres sont enregistrés. StorePath ne peut pas être C:\. L’option StorePath doit être spécifiée dans la ScanState.exe commande, sauf lors de l’utilisation de l’option /genconfig . Vous ne pouvez pas spécifier plusieurs emplacements StorePath .
/Apps Analyse l’image à la recherche d’applications et les inclut ainsi que leurs paramètres de Registre associés.
/ppkg [<FileName>] Exporte vers un emplacement de fichier spécifique.
/O Requis pour remplacer toutes les données existantes dans le magasin ou Config.xml le fichier de migration. Si elle n’est pas spécifiée, la ScanState.exe commande échoue si le magasin de migration contient déjà des données. Cette option ne peut pas être utilisée plusieurs fois sur une ligne de commande.
/Vsc Cette option permet au service de cliché instantané de volume 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 qui sont généralement rencontrées par la <section ErrorControl> .

Cette option est utilisée uniquement avec le fichier exécutable ScanState et ne peut pas être combinée avec l’option /hardlink .
/hardlink Active la création d’un magasin de migration de liaison matérielle à l’emplacement spécifié. L’option /nocompress doit être spécifiée avec l’option /hardlink .
/encrypt [{/key :<KeyString> | /keyfile :<file>]} Chiffre le magasin avec la clé spécifiée. Le chiffrement est désactivé par défaut. Avec cette option, la clé de chiffrement doit être spécifiée de l’une des manières suivantes :
  • /key: KeyString spécifie la clé de chiffrement. S’il existe un espace dans KeyString, KeyString doit être entouré de guillemets (").
  • /keyfile: FilePathAndName spécifie un fichier texte (.txt) qui contient la clé de chiffrement.

KeyString est recommandé d’avoir au moins huit caractères, mais il 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 /encrypt 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 ScanState.exe commande avec ces options a également accès à la clé de chiffrement.

L’exemple suivant montre la ScanState.exe commande et l’option /key :
ScanState.exe /i:MigDocs.xml /i:MigApp.xml \server\share\migration\mystore /encrypt /key:mykey
/encrypt :<EncryptionStrength> L’option /encrypt accepte un paramètre de ligne de commande pour définir la puissance de chiffrement à utiliser 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.
/nocompress Désactive la compression des données et enregistre les fichiers dans un dossier masqué nommé « File » sur StorePath\USMT. La compression est activée par défaut. La combinaison de l’option /nocompress avec l’option /hardlink génère un magasin de migration de liaison matérielle. Le magasin non compressé peut être utilisé pour afficher l’outil USMT stocké, résoudre un problème ou exécuter un utilitaire antivirus sur les fichiers. Cette option doit être utilisée uniquement dans les environnements de test. Microsoft recommande d’utiliser un magasin compressé pendant les migrations de production, sauf si l’option /nocompress est combinée avec l’option /hardlink .

Les /nocompress options et /encrypt ne peuvent pas être utilisées ensemble dans une seule instruction sur la ligne de commande. Toutefois, si un magasin non compressé est migré, la LoadState.exe commande migre chaque fichier directement du magasin vers l’emplacement approprié sur l’ordinateur de destination sans emplacement temporaire.

Par exemple :
ScanState.exe /i:MigDocs.xml /i:MigApp.xml \server\share\migration\mystore /nocompress

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

La ScanState.exe commande peut être exécutée dans l’environnement de préinstallation Windows (WinPE). En outre, USMT prend en charge les migrations à partir d’installations précédentes de Windows contenues dans les répertoires Windows.old . Le répertoire hors connexion peut être un répertoire Windows lorsque la ScanState.exe commande est exécutée dans WinPE ou un répertoire Windows.old lorsque la ScanState.exe commande est exécutée dans Windows.

L’exécution de la ScanState.exe commande sur une image Windows hors connexion présente plusieurs avantages, notamment :

  • Amélioration des performances.

    Étant donné que WinPE est un système d’exploitation léger, il y a moins de services en cours d’exécution. Dans cet environnement, la ScanState.exe commande a plus d’accès aux ressources matérielles locales, ce qui permet à ScanState d’effectuer des opérations de migration plus rapidement.

  • Processus de déploiement de bout en bout simplifié.

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

  • Amélioration de la réussite de la migration.

    Le taux de réussite de la migration est augmenté pour les raisons suivantes :

    • Les fichiers ne sont pas verrouillés pour modification en mode hors connexion.
    • WinPE fournit un accès administrateur aux fichiers dans le système de fichiers Windows hors connexion, ce qui élimine la nécessité d’un accès de niveau administrateur au système en ligne.
  • Possibilité de récupérer un à partir d’un ordinateur qui ne démarre pas.

    Il peut être possible de récupérer et de migrer des données à partir d’un ordinateur qui ne démarre pas.

Options de migration hors connexion

option Command-Line Définition
/offline :"path to an Offline.xml file » Cette option est utilisée pour définir un chemin d’accès à un fichier .xml hors connexion qui peut spécifier d’autres options de migration hors connexion. Par exemple, un répertoire Windows hors connexion ou toute redirection de domaine ou de dossier requise dans la migration.
/offlinewindir :"path to a Windows directory » Cette option spécifie le répertoire Windows hors connexion à partir duquel la ScanState.exe commande collecte l’état de l’utilisateur. Le répertoire hors connexion peut être Windows.old lorsque la ScanState.exe commande est exécutée dans Windows ou un répertoire Windows lorsque la ScanState.exe commande est exécutée dans WinPE.
/offlinewinold :"Windows.old directory » Cette option de ligne de commande active le mode de migration hors connexion et démarre la migration à partir de l’emplacement spécifié. Cette option est uniquement destinée à être utilisée dans les scénarios de migration Windows.old , où la migration se produit à partir d’un répertoire Windows.old .

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 l’utilisateur, l’application ou l’état système à migrer. Cette option peut être spécifiée plusieurs fois pour inclure tous les fichiers .xml (MigApp.xml, MigDocs.xmlet 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 .
/genconfig :[Path]FileName (Générer Config.xml)

Génère le fichier facultatif Config.xml , mais ne crée pas de magasin de migration. Pour vous assurer que ce fichier contient tout ce qui doit être migré, créez ce fichier sur un ordinateur source qui contient tous les éléments suivants :
  • Composants
  • applications
  • settings
présents sur les ordinateurs de destination. En outre, les autres fichiers .xml de migration doivent être spécifiés, à l’aide de l’option /i , lorsque cette option est spécifiée.

Une fois ce fichier créé, il peut être utilisé avec la commande à l’aide ScanState.exe de l’option /config .

Les seules options qui peuvent être spécifiées avec cette option sont les /ioptions , /vet /l . Vous ne pouvez pas spécifier StorePath, car l’option /genconfig ne crée pas de magasin. 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.

Exemples :
  • L’exemple suivant crée un Config.xml fichier dans le répertoire actif :
    ScanState.exe /i:MigApp.xml /i:MigDocs.xml /genconfig:Config.xml /v:13
/config :[Path]FileName Spécifie le Config.xml fichier que la ScanState.exe commande doit utiliser pour créer le magasin. Cette option ne peut pas être utilisé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, FileName doit se trouver dans le répertoire actif.

L’exemple suivant crée un magasin à l’aide des Config.xml fichiers , MigDocs.xmlet MigApp.xml :
ScanState.exe \server\share\migration\mystore /config:Config.xml /i:MigDocs.xml /i:MigApp.xml /v:13 /l:ScanState.log

L’exemple suivant migre les fichiers et les paramètres vers l’ordinateur de destination à l’aide des Config.xmlfichiers , MigDocs.xmlet MigApp.xml :
LoadState.exe \server\share\migration\mystore /config:Config.xml /i:MigDocs.xml /i:MigApp.xml /v:13 /l:LoadState.log
/auto :path vers les fichiers de script 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 fait référence au 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.
/genmigxml :path to a file Cette option spécifie que la ScanState.exe commande doit utiliser le 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 ScanState.exe commande s’exécute.
/localonly Migre uniquement les fichiers stockés sur l’ordinateur local, quelles que soient les règles dans les fichiers.xml spécifiés sur la ligne de commande. Cette option doit être utilisée pour exclure les données des lecteurs amovibles sur l’ordinateur source et lorsqu’il existe des lecteurs réseau mappés sur l’ordinateur source. Les lecteurs usb (UFD) et certains disques durs externes sont des exemples de lecteurs amovibles. Si l’option /localonly n’est pas spécifiée, la commande copie les ScanState.exe fichiers de ces lecteurs amovibles ou réseau dans le magasin.

/localonly exclut tout ce qui n’est pas considéré comme un lecteur fixe par le système d’exploitation. Dans certains cas, les disques durs externes volumineux sont considérés comme des disques fixes. Ces lecteurs peuvent être explicitement exclus de la migration à l’aide d’un fichier .xml personnalisé. Pour plus d’informations sur l’exclusion de tous les fichiers sur un lecteur spécifique, consultez Exclure des fichiers et des paramètres.

L’option /localonly de ligne de commande inclut ou exclut les données de la migration, comme indiqué dans les emplacements de stockage suivants :
  • Lecteurs amovibles tels qu’un lecteur flash USB - Exclus
  • Lecteurs réseau - Exclus
  • Lecteurs fixes - Inclus

Options de surveillance

L’outil USMT fournit plusieurs options qui peuvent être utilisées pour analyser les problèmes qui se produisent pendant la migration.

Remarque

Le journal ScanState est créé par défaut, mais le nom et l’emplacement du journal peuvent être spécifiés avec l’option /l .

option Command-Line Description
/listfiles :<FileName> L’option /listfiles de ligne de commande peut être utilisée avec la ScanState.exe commande pour générer un fichier texte qui répertorie tous les fichiers inclus dans la migration.
/l :[Path]FileName Spécifie l’emplacement et le nom du journal ScanState .

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 utilisée pour ajuster la quantité de sortie.

Si la ScanState.exe commande est exécutée à partir d’une ressource réseau partagée, l’option /l doit être spécifiée, sinon l’outil USMT échoue avec l’erreur suivante :

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 /lScanState.exe à partir d’une ressource réseau partagée.
/v :<VerbosityLevel> (Détail)

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

VerbosityLevel peut être défini sur l’un des niveaux suivants :
  • 0 - Seuls les erreurs et avertissements par défaut sont activés.
  • 1 - Active la sortie détaillée.
  • 4 - Active l’erreur et status sortie.
  • 5 - Active la sortie détaillée et status.
  • 8 - Active la sortie d’erreur sur un débogueur.
  • 9 - Active la sortie détaillée sur un débogueur.
  • 12 - Active l’erreur et status sortie à un débogueur.
  • 13 - Active la sortie détaillée, status et débogueur.

Par exemple :
ScanState.exe \server\share\migration\mystore /v:13 /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 :
ScanState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /progress:Progress.log /l:scanlog.log
/C Lorsque cette option est spécifiée, la ScanState.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 dans le magasin, la ScanState.exe commande enregistre une erreur et poursuit la migration. En outre, si un fichier est ouvert ou utilisé par une application, USMT peut ne pas être en mesure de migrer le fichier et enregistre une erreur. Sans l’option /c , la ScanState.exe commande se ferme à la première erreur.

La < section ErrorControl> du Config.xml fichier peut être utilisée 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. Cet avantage dans le Config.xml fichier 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 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.

Lorsque l’état utilisateur est stocké, l’option /r ne peut pas récupérer 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.
/p :<pathToFile> Lorsque la ScanState.exe commande s’exécute, elle crée un fichier .xml dans le chemin d’accès spécifié. 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 :
ScanState.exe C:\MigrationLocation [additional parameters]
/p:"C:\MigrationStoreSize.xml"

Pour plus d’informations, consultez Estimer la taille du magasin de migration.

Pour conserver les fonctionnalités des applications ou scripts existants qui nécessitent le comportement précédent d’USMT, l’option /p peut être utilisée, sans spécifier « pathtoafile », dans USMT. Si seule l’option /p est spécifiée, les estimations de l’espace de stockage sont créées de la même manière qu’avec les versions USMT 3.x.
/? 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 de l’utilisation du Config.xml fichier. Pour plus d’informations, consultez Identifier les utilisateurs et Migrer des comptes d’utilisateur.

option Command-Line Description
/Tous Migre tous les utilisateurs sur l’ordinateur.

L’outil 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 l’option /all est spécifiée, les /uioptions ou /uel/ue ne peuvent pas également être spécifiées.
/ui :<DomainName>\<UserName>
or
/ui :<ComputerName>\<LocalUserName>
(L’utilisateur inclut)

Migre les utilisateurs spécifiés. 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 les /ue options ou /uel . 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 (*). Lorsqu’un nom d’utilisateur contenant des espaces est spécifié, il doit être entouré de guillemets (").
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.

Par exemple :
  • Pour inclure uniquement User2 à partir du domaine Fabrikam, entrez :

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

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

    /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 d’autres exemples, consultez les descriptions des /ue options et dans /ui ce tableau.
/uel :<NumberOfDays>
or
/uel :<AAAA/MM/JJ>
or
/uel :0
(Exclure l’utilisateur en fonction de la dernière ouverture de session)

Migre 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 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 ou la date peut être spécifié. 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.
  • /uel:0 migre tous les utilisateurs actuellement connectés.
  • /uel:90 migre les utilisateurs qui se sont connectés ou dont les comptes ont été modifiés au cours des 90 derniers jours.
  • /uel:1 migre les utilisateurs dont le compte a été modifié au cours des dernières 24 heures.
  • /uel:2020/2/15 migre les utilisateurs qui se sont connectés ou qui ont été modifiés le 15 février 2020 ou après.

Exemple :
ScanState.exe /i:MigApp.xml /i:MigDocs.xml \\server\share\migration\mystore /uel:0
/ue :<DomainName>\<UserName>
- ou -

/ue :<ComputerName>\<LocalUserName>
(Exclusion de l’utilisateur)

Exclut les utilisateurs spécifiés de la migration. Plusieurs /ue options peuvent être spécifiées. Cette option 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 (").

Exemple :
ScanState.exe /i:MigDocs.xml /i:MigApp.xml \\server\share\migration\mystore /ue:contoso\user1

Comment utiliser /ui et /ue

Les exemples suivants s’appliquent /ui aux options et /ue . L’option /ue peut être remplacée par l’option /ui permettant d’inclure, plutôt que d’exclure, les utilisateurs spécifiés.

Comportement Commande
Excluez l’utilisateur nommé User One dans le domaine Fabrikam. /ue:"fabrikam\user one"
Excluez l’utilisateur nommé User1 dans le domaine Fabrikam. /ue:fabrikam\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 /ue options et ./uel 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. 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:fixed\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 commandes suivantes :
  • Dans la ligne de ScanState.exe commande, entrez :
    /ue:*\* /ui:contoso\*
  • Dans la ligne de LoadState.exe commande, entrez :
    /ue:contoso\user1
Incluez uniquement les utilisateurs locaux (non-domaine). /ue:*\* /ui:%computername%\*

Options de fichier chiffré

Les options suivantes peuvent être utilisées pour migrer des fichiers chiffrés. Dans tous les cas, par défaut, l’outil USMT échoue si un fichier chiffré est trouvé, sauf si l’option /efs est spécifiée. Pour migrer des fichiers chiffrés, le comportement par défaut doit être modifié.

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

Remarque

Les certificats EFS sont migrés automatiquement pendant la migration. Par conséquent, l’option /efs:copyraw doit être spécifiée avec la ScanState.exe commande pour migrer les fichiers chiffrés.

Attention

Soyez prudent lors de la migration de fichiers chiffrés. Si un fichier chiffré est migré sans migrer également le certificat, les utilisateurs finaux ne pourront pas accéder au fichier après la migration.

option Command-Line Explication
/efs :hardlink Crée un lien dur vers le fichier EFS au lieu de le copier. Utilisez uniquement avec les /hardlink/nocompress options et .
/efs :abort Provoque l’échec de la ScanState.exe commande avec un code d’erreur, si un fichier EFS (Encrypting File System) est trouvé sur l’ordinateur source. Activé par défaut.
/efs :skip Force la ScanState.exe commande à ignorer les fichiers EFS.
/efs :decryptcopy Fait que la ScanState.exe commande déchiffre le fichier, si possible, avant de l’enregistrer dans le magasin de migration, et échoue si le fichier ne peut pas être déchiffré. Si la ScanState.exe commande réussit, le fichier n’est pas chiffré dans le magasin de migration et, une fois la LoadState.exe commande exécutée, le fichier est copié sur l’ordinateur de destination.
/efs :copyraw Force la ScanState.exe commande à copier les fichiers au format chiffré. Les fichiers sont inaccessibles sur l’ordinateur de destination jusqu’à ce que les certificats EFS soient migrés. Les certificats EFS sont automatiquement migrés ; Toutefois, par défaut, l’outil USMT échoue si un fichier chiffré est trouvé, sauf si l’option /efs est spécifiée. Par conséquent, l’option /efs:copyraw doit être spécifiée avec la ScanState.exe commande pour migrer le fichier chiffré. Lorsque la LoadState.exe commande est exécutée, le fichier chiffré et le certificat EFS sont automatiquement migrés.

Exemple :
ScanState.exe /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 à l’intérieur d’un dossier chiffré est supprimé, le fichier est chiffré pendant la migration à l’aide des informations d’identification du compte utilisé pour exécuter l’outil LoadState . Pour plus d’informations, consultez Migrer des fichiers et des certificats EFS.

Options de ligne de commande incompatibles

Le tableau suivant indique les options de ligne de commande qui ne sont pas compatibles avec la ScanState.exe commande . Si l’entrée de table pour 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 /Tous
/Je
/O
/C
/nocompress Non applicable
/localonly
/Clé
/Crypter Obligatoire*
/Keyfile Non applicable
/L
/listfiles
/Progrès
/R
/W
/C
/P Non applicable
/Tous
/Ui
/ue
/Lse
/efs :<option>
/genconfig Non applicable
/Config
<StorePath>

Remarque

L’option /key ou /keyfile doit être spécifiée avec l’option /encrypt .