Partager via

Syntaxe d’UsmtUtils

  • Article

Cette rubrique décrit la syntaxe des utilitaires disponibles dans Outil de migration utilisateur (USMT) 5.0 via l’interface de ligne de commande. Ces utilitaires :

  • améliorent votre capacité à déterminer les options de chiffrement pour votre migration ;

  • permettent de supprimer les magasins par liens physiques qui, autrement, ne peuvent pas être supprimés en raison d’un verrou de partage ;

  • vérifient si le fichier catalogue ou les autres fichiers contenus dans le magasin de migration compressé sont endommagés ;

  • extraient les fichiers du magasin de migration compressé lorsque vous migrez des fichiers et des paramètres vers l’ordinateur de destination.

Dans cette rubrique

Usmtutils.exe

Options de vérification

Options d’extraction

Usmtutils.exe

Le tableau suivant répertorie les options de ligne de commande d’USMTutils.exe. Les sections qui suivent présentent des options de ligne de commande supplémentaires pour les options /verify et /extract.

La syntaxe d’UsmtUtils.exe est la suivante :

usmtutils [/ec | /rd <répertoire_mag> | /verify <chemin_fichier> [options] | /extract <chemin_fichier><chemin_destination> [options]]

Option de ligne de commande Description :

/ec

Retourne la liste des algorithmes de chiffrement pris en charge (IDAlg) sur le système actuel. Vous pouvez utiliser cette option sur un ordinateur de destination pour déterminer quel algorithme utiliser avec la commande /encrypt avant d’exécuter l’outil ScanState sur l’ordinateur source.

/rd <répertoire_mag>

Supprime le chemin d’accès au répertoire spécifié par l’argument <répertoire_mag> sur l’ordinateur. Vous pouvez utiliser cette commande pour supprimer les magasins de migration par lien physique qui ne peuvent pas autrement être supprimés à partir d’une invite de commande en raison d’un verrou de partage. Si la magasin de migration occupe plusieurs volumes sur un lecteur donné, il est supprimé sur tous ces volumes.

Exemple :

usmtutils /rd D:\MyHardLinkStore

/y

Remplace l’invite d’acceptation des suppressions lorsqu’elle est utilisée avec l’option /rd. Lorsque vous utilisez l’option /y avec l’option /rd, vous n’êtes pas invité à accepter les suppressions avant que USMT ne supprime les répertoires.

/verify

Retourne des informations qui indiquent si le magasin de migration compressé est intact ou s’il contient des fichiers ou un catalogue endommagés.

Voir Options de vérification pour plus d’informations sur la syntaxe et les options à utiliser avec /verify.

/extract

Extrait les fichiers d’un magasin de migration compressé de l’outil USMT.

Voir Options d’extraction pour plus d’informations sur la syntaxe et les options à utiliser avec /extract.

Options de vérification

Utilisez l’option /verify lorsque vous voulez déterminer si un magasin de migration compressé est intact ou s’il contient des fichiers ou un catalogue endommagés. Pour plus d’informations sur l’utilisation de l’option /verify, voir Vérifier l’état d’un magasin de migration compressé.

La syntaxe de /verify est la suivante :

usmtutils /verify[:<type_rapport>] <chemin_fichier> [/l:<fichier_journal>] [/v:VerbosityLevel] [/decrypt [:<IDAlg>] {/key:<chaîne_clé> | /keyfile:<nom_fichier>}]

Option de ligne de commande Description :

<type_rapport>

Précise si le rapport à générer doit porter sur tous les fichiers, sur les fichiers endommagés uniquement ou sur l’état du catalogue.

  • Summary. Retourne 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 s’affiche par défaut.

  • all. Retourne une liste délimitée par des tabulations de tous les fichiers contenus dans le magasin de migration compressé, ainsi que l’état de chaque fichier. Chaque ligne contient le nom du fichier suivi d’un espacement de tabulation, ainsi que la mention « CORRUPTED » (endommagé) ou « OK », selon l’état du fichier. La dernière entrée indique l’état du catalogue (« CATALOG ») du magasin. Un fichier catalogue contient les métadonnées de tous les fichiers contenus dans un magasin de migration. L’outil LoadState a besoin d’un fichier catalogue valide pour ouvrir le magasin de migration. Retourne « OK » si le fichier catalogue est intact (LoadState peut alors ouvrir le magasin de migration) et « CORRUPTED » (endommagé) si le magasin de migration est endommagé.

  • failureonly. Retourne une liste délimitée par des tabulations des seuls fichiers endommagés contenus dans le magasin de migration compressé.

  • Catalog. Retourne uniquement l’état du fichier catalogue.

/l: <chemin_fichier_journal>

Spécifie l’emplacement et le nom du fichier journal.

/v: <VerbosityLevel>

(Verbosity)

Active la sortie en clair dans le fichier journal UsmtUtils. La valeur par défaut est 0.

Vous pouvez affecter l’un des niveaux suivants à la variable niveau_détail :

 

Niveau Explication

0

Seuls les erreurs et avertissements par défaut sont activés.

1

Active la sortie en clair.

4

Active la sortie d’erreur et d’état.

5

Active la sortie en clair et d’état.

8

Active la sortie d’erreur vers un débogueur.

9

Active la sortie en clair vers un débogueur.

12

Active la sortie d’erreur et d’état vers un débogueur.

13

Active la sortie en clair, d’état et du débogueur.

/decrypt: <IDAlg> /key:<ChaîneClé>

ou

/decrypt: <IDAlg> /key:<"chaîne de clé">

ou

/decrypt: <IDAlg> /keyfile:<NomFichier>

Indique 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 option /key ou /keyfile comme suit :

  • <IDAlg> spécifie l’algorithme de chiffrement qui a été utilisé pour créer le magasin de migration sur la ligne de commande ScanState. Si aucun algorithme n’est spécifié, ScanState et UsmtUtils utilisent l’algorithme 3DES par défaut.

    Les valeurs valides pour <IDAlg> sont : AES_128, AES_192, AES_256, 3DES ou 3DES_112.

  • /key: <chaîne_clé> spécifie la clé de chiffrement. S’il y a un espace dans <ChaîneClé>, vous devez mettre l’argument entre guillemets.

  • /keyfile: <nom_fichier> 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, voir Chiffrement de magasin de migration.

Quelques exemples de commandes /verify :

  • usmtutils /verify D:\MyMigrationStore\store.mig

  • usmtutils /verify:catalog D:\MyMigrationStore\store.mig

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

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

Options d’extraction

Utilisez l’option /extract pour récupérer les fichiers d’un magasin de migration compressé de l’outil USMT si LoadState n’est pas en mesure de le restaurer normalement. Pour plus d’informations sur l’utilisation de l’option /extract, voir Extraire des fichiers d’un magasin de migration compressé de l’outil USMT.

La syntaxe de /extract est la suivante :

/extract <chemin_fichier><chemin_destination> [/i:<modèle_inclusion>] [/e: <modèle_exclusion>] [/l: <fichier_journal>] [/v: VerbosityLevel>] [/decrypt[:<IDAlg>] {key: <chaîne_clé> | /keyfile: <nom_fichier>}] [/o]

Option de ligne de commande Description :

<chemin_fichier>

Chemin d’accès au magasin de migration de l’outil USMT.

Exemple :

D:\MyMigrationStore\USMT\store.mig

<chemin_destination>

Chemin d’accès au dossier dans lequel l’outil place les fichiers individuels.

/i:<modèle_inclusion>

Spécifie un modèle pour les fichiers à inclure dans l’extraction. Vous pouvez spécifier plusieurs modèles. Séparez les modèles par une virgule ou un point-virgule. Vous pouvez utiliser les options /i: <ModèleInclusion> et /e: <ModèleExclusion> dans la même commande. Lorsque les modèles d’inclusion et d’exclusion sont utilisés sur la ligne de commande, les modèles d’inclusion sont prioritaires par rapport aux modèles d’exclusion.

/e:<modèle_exclusion>

Spécifie un modèle pour les fichiers à omettre lors de l’extraction. Vous pouvez spécifier plusieurs modèles. Séparez les modèles par une virgule ou un point-virgule. Vous pouvez utiliser les options /i: <ModèleInclusion> et /e: <ModèleExclusion> dans la même commande. Lorsque les modèles d’inclusion et d’exclusion sont utilisés sur la ligne de commande, les modèles d’inclusion sont prioritaires par rapport aux modèles d’exclusion.

/l:<chemin_fichier_journal>

Spécifie l’emplacement et le nom du fichier journal.

/v: <VerbosityLevel>

(Verbosity)

Active la sortie en clair dans le fichier journal UsmtUtils. La valeur par défaut est 0.

Vous pouvez affecter l’un des niveaux suivants à la variable niveau_détail :

 

Niveau Explication

0

Seuls les erreurs et avertissements par défaut sont activés.

1

Active la sortie en clair.

4

Active la sortie d’erreur et d’état.

5

Active la sortie en clair et d’état.

8

Active la sortie d’erreur vers un débogueur.

9

Active la sortie en clair vers un débogueur.

12

Active la sortie d’erreur et d’état vers un débogueur.

13

Active la sortie en clair, d’état et du débogueur.

/decrypt: <IDAlg> /key:<ChaîneClé>

ou

/decrypt: <IDAlg> /key:<"chaîne de clé">

ou

/decrypt: <IDAlg> /keyfile:<NomFichier>

Indique 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, vous devez également spécifier une option /key ou /keyfile comme suit :

  • <IDAlg> spécifie l’algorithme de chiffrement qui a été utilisé pour créer le magasin de migration sur la ligne de commande ScanState. Si aucun algorithme n’est spécifié, ScanState et UsmtUtils utilisent l’algorithme 3DES par défaut.

    Les valeurs valides pour <IDAlg> sont : AES_128, AES_192, AES_256, 3DES ou 3DES_112.

  • /key: <chaîne_clé> spécifie la clé de chiffrement. S’il y a un espace dans <ChaîneClé>, vous devez mettre l’argument entre guillemets.

  • /keyfile: <nom_fichier> spécifie un fichier texte (.txt) qui contient la clé de chiffrement.

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

/o

Remplace les fichiers de sortie existants.

Quelques exemples de commandes /extract :

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

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

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

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

Voir aussi

Autres ressources

Syntaxe de la ligne de commande de l’Outil de migration utilisateur (USMT)
Codes de retour