Syntaxe d’UsmtUtils

Cet article décrit la syntaxe des utilitaires disponibles dans User State Migration Tool (USMT) via l’interface de ligne de commande. Ces utilitaires :

  • Améliorez la capacité à déterminer les options de chiffrement pour la migration.

  • Aidez à supprimer les magasins de liens en dur qui ne peuvent pas être supprimés en raison d’un verrou de partage.

  • Vérifiez si le fichier catalogue ou l’un des autres fichiers du magasin de migration compressé sont endommagés.

  • Extrayez les fichiers du magasin de migration compressé créé lorsque les fichiers et les paramètres sont migrés vers l’ordinateur de destination.

UsmtUtils.exe

Le tableau suivant répertorie les options de ligne de commande pour UsmtUtils.exe. Les sections suivantes fournissent d’autres options de ligne de commande pour les /verify options et ./extract

La syntaxe de UsmtUtils.exe est la suivante :

UsmtUtils.exe [/ec | /rd <storeDir> | /verify <filepath> [options] | /extract <filepath><destinationPath> [options]]

Option de ligne de commande Description
/Ce Retourne une liste d’algorithmes de chiffrement (AlgID) pris en charge sur le système actuel. Cette option peut être utilisée sur un ordinateur de destination pour déterminer l’algorithme à utiliser avec la /encrypt commande avant d’exécuter l’outil ScanState sur l’ordinateur source.
/rd<storeDir> Supprime le chemin d’accès au répertoire spécifié par l’argument <storeDir> sur l’ordinateur. Cette commande peut être utilisée pour supprimer des magasins de migration à liaison matérielle qui ne peuvent pas être supprimés à l’invite de commandes en raison d’un verrou de partage. Si le magasin de migration s’étend sur plusieurs volumes sur un lecteur donné, le magasin de migration est supprimé de tous ces volumes.

Exemple :
UsmtUtils.exe /rd D:\MyHardLinkStore
/y Remplace l’invite pour accepter les suppressions lorsqu’elle est utilisée avec l’option /rd . Lorsque l’option /y est utilisée avec l’option /rd , aucune invite ne s’affiche pour accepter les suppressions avant que l’outil USMT ne supprime les répertoires.
/vérifier Retourne des informations indiquant si le magasin de migration compressé est intact ou s’il contient des fichiers endommagés ou un catalogue endommagé.

Consultez Vérifier les options de syntaxe et les options à utiliser avec /verify.
/extraire Récupère les fichiers d’un magasin de migration USMT compressé.

Consultez Options d’extraction pour connaître la syntaxe et les options à utiliser avec /extract.

Vérifier les options

Utilisez l’option /verify pour déterminer si un magasin de migration compressé est intact ou s’il contient des fichiers endommagés ou un catalogue endommagé. Pour plus d’informations sur l’utilisation de l’option /verify , consultez Vérifier la condition d’un magasin de migration compressé.

La syntaxe de /verify est la suivante :

UsmtUtils.exe /verify[ :<reportType>] <filePath> [/l :<logfile>] [/v :VerbosityLevel] [/decrypt [ :<AlgID>] {/key :<keystring> | /keyfile :<filename>}]

Option de ligne de commande Description
<reportType> Spécifie s’il faut signaler tous les fichiers, les fichiers endommagés uniquement ou l’état du catalogue.
  • Résumé. Retourne à la fois le nombre de fichiers intacts et le nombre de fichiers endommagés dans le magasin de migration. Si aucun algorithme n’est spécifié, le rapport de synthèse est affiché par défaut.
  • tous. Retourne une liste délimitée par des tabulations de tous les fichiers dans le magasin de migration compressé et l’état de chaque fichier. Chaque ligne contient le nom du fichier suivi d’un espacement de tabulation, et corrompu ouOK en fonction de l’état du fichier. La dernière entrée signale l’état d’endommagement du CATALOGUE du magasin. Un fichier catalogue contient des métadonnées pour tous les fichiers d’un magasin de migration. L’outil LoadState nécessite un fichier catalogue valide pour ouvrir le magasin de migration. Retourne « OK » si le fichier catalogue est intact et que LoadState peut ouvrir le magasin de migration et « CORRUPTED » si le magasin de migration est endommagé.
  • écheconly. Retourne une liste délimitée par des tabulations contenant uniquement les fichiers endommagés dans le magasin de migration compressé.
  • Catalogue. Retourne uniquement l’état du fichier catalogue.
/l :
<logfilePath>		 Spécifie l’emplacement et le nom du fichier journal.
/v :<VerbosityLevel> (Détail)

Active la sortie détaillée dans le fichier journal UsmtUtils . 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 la sortie d’erreur et d’état.
  • 5 - Active la sortie détaillée et d’état.
  • 8 - Active la sortie d’erreur sur un débogueur.
  • 9 - Active la sortie détaillée sur un débogueur.
  • 12 - Active la sortie d’erreur et d’état sur un débogueur.
  • 13 - Active la sortie détaillée, l’état et le débogueur.
/decrypt<AlgID>/ :<KeyString>
or
/decrypt<AlgID>/ :<"Key String »>
or
/decrypt :<AlgID>/keyfile :<FileName>		 Spécifie que l’option /encrypt a été utilisée pour créer le magasin de migration avec l’outil ScanState . Pour déchiffrer le magasin de migration, spécifiez une /key option ou /keyfile comme suit :
  • <AlgID> spécifie l’algorithme de chiffrement utilisé pour créer le magasin de migration sur la ligne de ScanState.exe commande. Si aucun algorithme n’est spécifié, ScanState et UsmtUtils utilisent l’algorithme 3DES comme algorithme par défaut.
    <Les valeurs valides d’AlgID> incluent : AES_128, AES_192AES_256, 3DES, ou 3DES_112.
  • /key: <KeyString> spécifie la clé de chiffrement. S’il existe un espace dans <KeyString>, l’argument doit être entouré de guillemets.
  • /keyfile: <FileName> spécifie l’emplacement et le nom d’un fichier texte (.txt) qui contient la clé de chiffrement.

Pour plus d’informations sur les algorithmes de chiffrement pris en charge, consultez Chiffrement du magasin de migration.

Voici quelques exemples de /verify commandes :

  • UsmtUtils.exe /verify D:\MyMigrationStore\store.mig

  • UsmtUtils.exe /verify:catalog D:\MyMigrationStore\store.mig

  • UsmtUtils.exe /verify:all D:\MyMigrationStore\store.mig /decrypt /l:D:\UsmtUtilsLog.txt

  • UsmtUtils.exe /verify:failureonly D:\MyMigrationStore\store.mig /decrypt:AES_192 /keyfile:D:\encryptionKey.txt

Options d’extraction

Utilisez l’option /extract pour récupérer des fichiers à partir d’un magasin de migration USMT compressé s’il n’est pas restauré normalement avec LoadState. Pour plus d’informations sur l’utilisation de l’option /extract , consultez Extraire des fichiers d’un magasin de migration USMT compressé.

La syntaxe de /extract est la suivante :

/extract <filePath><destinationPath> [/i :<includePattern>] [/e : <excludePattern>] [/l : <logfile>] [/v : VerbosityLevel>] [/decrypt[ :<AlgID>] {key : <keystring> | /keyfile : <filename>}] [/o]

Option de ligne de commande Description
<filePath> Chemin d’accès au magasin de migration USMT.

Exemple :
D:\MyMigrationStore\USMT\store.mig
<destinationPath> Chemin d’accès au dossier dans lequel l’outil place les fichiers individuels.
/i :<includePattern> Spécifie un modèle pour les fichiers à inclure dans l’extraction. Plusieurs modèles peuvent être spécifiés. Séparez les modèles par une virgule ou un point-virgule. Les /ioptions includePattern<> et /e: <excludePattern> peuvent être utilisées dans la même commande. Lorsque les modèles include et exclude sont utilisés sur la ligne de commande, les modèles include sont prioritaires sur les modèles d’exclusion.
/e :<excludePattern> Spécifie un modèle pour les fichiers à omettre de l’extraction. Plusieurs modèles peuvent être spécifiés. Séparez les modèles par une virgule ou un point-virgule. Les /ioptions includePattern<> et /e: <excludePattern> peuvent être utilisées dans la même commande. Lorsque les modèles include et exclude sont utilisés sur la ligne de commande, les modèles include sont prioritaires sur les modèles d’exclusion.
/l :<logfilePath> Spécifie l’emplacement et le nom du fichier journal.
/v :<VerbosityLevel> (Détail)

Active la sortie détaillée dans le fichier journal UsmtUtils . 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 la sortie d’erreur et d’état.
  • 5 - Active la sortie détaillée et d’état.
  • 8 - Active la sortie d’erreur sur un débogueur.
  • 9 - Active la sortie détaillée sur un débogueur.
  • 12 - Active la sortie d’erreur et d’état sur un débogueur.
  • 13 - Active la sortie détaillée, l’état et le débogueur.
/decrypt*<AlgID>/key :<KeyString>
or
/décrypter<AlgID>/ :<"Key String »>
or
/décrypter:<AlgID>/keyfile :<FileName>*		 Spécifie que l’option /encrypt a été utilisée pour créer le magasin de migration avec l’outil ScanState . Pour déchiffrer le magasin de migration, l’option /key ou /keyfile doit également être spécifiée comme suit :
  • <AlgID> spécifie l’algorithme de chiffrement utilisé pour créer le magasin de migration sur la ligne de ScanState.exe commande. Si aucun algorithme n’est spécifié, ScanState et UsmtUtils utilisent l’algorithme 3DES comme algorithme par défaut.
    <Les valeurs valides d’AlgID> incluent : AES_128, AES_192AES_256, 3DES, ou 3DES_112.
  • /key: <KeyString> spécifie la clé de chiffrement. S’il existe un espace dans <KeyString>, l’argument doit être entouré de guillemets.
  • /keyfile:<FileName> spécifie un fichier texte (.txt) qui contient la clé de chiffrement

Pour plus d’informations sur les algorithmes de chiffrement pris en charge, consultez Chiffrement du magasin de migration.
/o Remplace les fichiers de sortie existants.

Voici quelques exemples de /extract commandes :

  • UsmtUtils.exe /extract D:\MyMigrationStore\USMT\store.mig C:\ExtractedStore

  • UsmtUtils.exe /extract D:\MyMigrationStore\USMT\store.mig /i:"*.txt, *.pdf" C:\ExtractedStore /decrypt /keyfile:D:\encryptionKey.txt

  • UsmtUtils.exe /extract D:\MyMigrationStore\USMT\store.mig /e:*.exe C:\ExtractedStore /decrypt:AES_128 /key:password /l:C:\usmtlog.txt

  • UsmtUtils.exe /extract D:\MyMigrationStore\USMT\store.mig /i:myProject.* /e:*.exe C:\ExtractedStore /o