Codes de retour
Cette rubrique décrit les codes de retour et les messages d’erreur de l’Outil de migration utilisateur (USMT) 5.0. Vous y trouverez également un tableau recensant les codes de retour d’USMT avec les étapes de prévention associées et des conseils sur l’utilisation des fichiers journaux pour déterminer la raison pour laquelle vous avez reçu un message d’erreur.
Mieux vous comprendrez la configuration requise pour l’exécution d’USMT moins vous rencontrerez d’erreurs lors de vos migrations USMT. Pour plus d’informations, voir Configuration requise pour l’outil USMT.
Dans cette rubrique
Codes de retour de l’Outil de migration utilisateur (USMT)
Messages d’erreur de l’Outil de migration utilisateur (USMT)
Résolution des problèmes liés aux codes de retour et aux messages d’erreur
Codes de retour de l’Outil de migration utilisateur (USMT)
Si vous rencontrez une erreur lors de votre migration USMT, vous pouvez vous servir des codes de retour et des informations plus précises fournies par les messages d’erreur USMT associés pour résoudre le problème et identifier les étapes de prévention.
Les codes de retour sont regroupés dans les catégories générales suivantes :
Réussite ou annulation par l’utilisateur
Lignes de commande non valides
Installation et initialisation
Erreurs récupérables
Erreurs irrécupérables
Nous vous recommandons de définir le niveau de détail sur 5, /v*:5*, sur les lignes de commande ScanState, LoadState et UsmtUtils de façon à disposer de rapports les plus détaillés possibles dans les journaux USMT respectifs. Vous pouvez utiliser un niveau de commentaires supérieur si vous voulez que la sortie des fichiers journaux soit envoyée à un débogueur.
Messages d’erreur de l’Outil de migration utilisateur (USMT)
Les messages d’erreur fournissent des informations plus détaillées sur le problème de migration que le code de retour associé. Par exemple, les outils ScanState, LoadState ou UsmtUtils peuvent renvoyer le code « 11 » (pour « USMT_INVALID_PARAMETERS ») et un message d’erreur connexe indiquant « /key and /keyfile both specified ». Le message d’erreur s’affiche à l’invite de commandes et est identifié dans les fichiers journaux ScanState, LoadState ou UsmtUtils pour vous aider à déterminer pourquoi ce code de retour a été reçu.
Vous pouvez obtenir des informations supplémentaires sur les codes d’erreur système énumérés de l’interface de programmation d’applications (API) Windows en tapant net helpmsg sur la ligne de commande, puis le numéro du code d’erreur. Pour plus d’informations sur les codes d’erreur système, voir ce site Web de Microsoft.
Résolution des problèmes liés aux codes de retour et aux messages d’erreur
Le tableau suivant répertorie chaque code d’erreur par valeur numérique, avec les messages d’erreur associés et des suggestions de résolution des problèmes.
| Valeur du code de retour | Code de retour | Message d’erreur | Résolution, prévention, solutions de contournement | Catégorie |
|---|---|---|---|---|
0 |
USMT_SUCCESS |
Successful run |
Non applicable |
Réussite ou annulation |
1 |
USMT_DISPLAY_HELP |
Command line help requested |
Non applicable |
Réussite ou annulation |
2 |
USMT_STATUS_CANCELED |
Gather was aborted because of an EFS file |
Non applicable |
|
User chose to cancel (such as pressing CTRL+C) |
Non applicable |
Réussite ou annulation |
||
3 |
USMT_WOULD_HAVE_FAILED |
At least one error was skipped as a result of /c |
Examinez le journal ScanState, LoadState ou UsmtUtils pour plus de détails sur les erreurs de ligne de commande. |
|
11 |
USMT_INVALID_PARAMETERS |
/all conflicts with /ui, /ue or /uel |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. |
|
/auto expects an optional parameter for the script folder |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. |
|||
/encrypt can’t be used with /nocompress |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. |
|||
/encrypt requires /key or /keyfile |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. |
|||
/genconfig can’t be used with most other options |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. |
|||
/genmigxml can’t be used with most other options |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. |
|||
/hardlink requires /nocompress |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. |
|||
/key and /keyfile both specified |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. |
|||
/key or /keyfile used without enabling encryption |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. |
|||
/lae is only used with /lac |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. |
|||
/listfiles cannot be used with /p |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. |
|||
/offline requires a valid path to an XML file describing offline paths |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. |
|||
/offlinewindir requires a valid path to offline windows folder |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. |
|||
/offlinewinold requires a valid path to offline windows folder |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. |
|||
A command was already specified |
Vérifiez que la syntaxe de la ligne de commande est correcte et qu’aucune commande n’est dupliquée. |
|||
An option argument is missing |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. |
|||
An option is specified more than once and is ambiguous |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. |
|||
By default /auto selects all users and uses the highest log verbosity level. Switches like /all, /ui, /ue, /v are not allowed. |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. |
|||
Command line arguments are required. Specify /? for options. |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. |
|||
Command line option is not valid |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. |
|||
EFS parameter specified is not valid for /efs |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. |
|||
File argument is invalid for /genconfig |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. |
|||
File argument is invalid for /genmigxml |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. |
|||
Chemin d’accès à l’estimation d’espace non valide. Vérifier les paramètres et/ou les autorisations du système de fichiers |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. |
|||
List file path argument is invalid for /listfiles |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. |
|||
Retry argument must be an integer |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. |
|||
Settings store argument specified is invalid |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. Assurez-vous que le chemin d’accès au magasin est accessible et que les niveaux d’autorisation appropriés sont définis. |
|||
Specified encryption algorithm is not supported |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. |
|||
The /efs:hardlink requires /hardlink |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. |
|||
The /targetWindows7 option is only available for Windows XP, Windows Vista®, and Windows 7 |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. |
|||
The store parameter is required but not specified |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. |
|||
The source-to-target domain mapping is invalid for /md |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. |
|||
The source-to-target user account mapping is invalid for /mu |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. |
|||
Undefined or incomplete command line option |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. |
Lignes de commande non valides |
||
Use /nocompress, or provide an XML file path with /p"pathtoafile" to get a compressed store size estimate |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. |
|||
User exclusion argument is invalid |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. |
|||
Verbosity level must be specified as a sum of the desired log options: Verbose (0x01), Record Objects (0x04), Echo to debug port (0x08) |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. |
|||
Volume shadow copy feature is not supported with a hardlink store |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. |
|||
Wait delay argument must be an integer |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. |
|||
12 |
USMT_ERROR_OPTION_PARAM_TOO_LARGE |
Command line arguments cannot exceed 256 characters |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. |
Lignes de commande non valides |
Specified settings store path exceeds the maximum allowed length of 256 characters |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. |
|||
13 |
USMT_INIT_LOGFILE_FAILED |
List file path argument is invalid for /listfiles |
Lorsque /l est spécifié dans la ligne de commande ScanState, USMT valide le chemin d’accès. Vérifiez que le lecteur et les autres informations, par exemple les caractères du système de fichiers, sont corrects. |
Lignes de commande non valides |
14 |
USMT_ERROR_USE_LAC |
Unable to create a local account because /lac was not specified |
Lors de la création de comptes locaux, les options de ligne de commande /lac et /lae doivent être utilisées. |
Lignes de commande non valides |
26 |
USMT_INIT_ERROR |
Multiple Windows installations found |
Listfiles.txt n’a pas pu être créé. Vérifiez que l’emplacement spécifié pour la création de ce fichier est valide. |
Installation et initialisation |
Software malfunction or unknown exception |
Vérifiez dans tous les fichiers .xml chargés s’il existe des erreurs. Il s’agit d’une erreur courante lorsque le fichier Config.xml est chargé à l’aide de /I. |
|||
Unable to find a valid Windows directory to proceed with requested offline operation; Check if offline input file is present and has valid entries |
Vérifiez que le fichier d’entrée hors connexion est présent et qu’il contient des entrées valides. USMT n’a pas pu trouver de système d’exploitation hors connexion valide. Vérifiez votre mappage de répertoire hors connexion. |
|||
27 |
USMT_INVALID_STORE_LOCATION |
A store path can’t be used because an existing store exists; specify /o to overwrite |
Spécifiez /o pour remplacer un magasin intermédiaire ou de migration existant. |
Installation et initialisation |
A store path is missing or has incomplete data |
Assurez-vous que le chemin d’accès au magasin est accessible et que les niveaux d’autorisation appropriés sont définis. |
|||
An error occurred during store creation |
Assurez-vous que le chemin d’accès au magasin est accessible et que les niveaux d’autorisation appropriés sont définis. Spécifiez /o pour remplacer un magasin intermédiaire ou de migration existant. |
|||
An inappropriate device such as a floppy disk was specified for the store |
Assurez-vous que le chemin d’accès au magasin est accessible et que les niveaux d’autorisation appropriés sont définis. |
|||
Invalid store path; check the store parameter and/or file system permissions |
Invalid store path; check the store parameter and/or file system permissions |
|||
The file layout and/or file content is not recognized as a valid store |
Assurez-vous que le chemin d’accès au magasin est accessible et que les niveaux d’autorisation appropriés sont définis. Spécifiez /o pour remplacer un magasin intermédiaire ou de migration existant. |
|||
The store path holds a store incompatible with the current USMT version |
Assurez-vous que le chemin d’accès au magasin est accessible et que les niveaux d’autorisation appropriés sont définis. |
|||
The store save location is read-only or does not support a requested storage option |
Assurez-vous que le chemin d’accès au magasin est accessible et que les niveaux d’autorisation appropriés sont définis. |
|||
28 |
USMT_UNABLE_GET_SCRIPTFILES |
Script file is invalid for /i |
Vérifiez dans tous les fichiers de migration .xml spécifiés s’il existe des erreurs. Il s’agit d’une erreur courante lorsque le fichier Config.xml est chargé à l’aide de /I. |
Installation et initialisation |
Unable to find a script file specified by /i |
Vérifiez l’emplacement de vos fichiers de script et assurez-vous que les options de ligne de commande sont correctes. |
|||
29 |
USMT_FAILED_MIGSTARTUP |
A minimum of 250 MB of free space is required for temporary files |
Vérifiez que le système dispose de l’espace disque temporaire minimal requis de 250 Mo. La solution de contournement consiste à définir la variable d’environnement USMT_WORKING_DIR=<path> pour rediriger les fichiers temporaires vers un répertoire de travail. |
Installation et initialisation |
Another process is preventing migration; only one migration tool can run at a time |
Vérifiez si le fichier journal ScanState contient des erreurs de fichier de migration .xml. |
|||
Failed to start main processing, look in log for system errors or check the installation |
Vérifiez si le fichier journal ScanState contient des erreurs de fichier de migration .xml. |
|||
Migration failed because of an XML error; look in the log for specific details |
Vérifiez si le fichier journal ScanState contient des erreurs de fichier de migration .xml. |
|||
Unable to automatically map the drive letters to match the online drive letter layout; Use /offline to provide a mapping table |
Vérifiez si le fichier journal ScanState contient des erreurs de fichier de migration .xml. |
|||
31 |
USMT_UNABLE_FINDMIGUNITS |
An error occurred during the discover phase; the log should have more specific information |
Vérifiez si le fichier journal ScanState contient des erreurs de fichier de migration .xml. |
Installation et initialisation |
32 |
USMT_FAILED_SETMIGRATIONTYPE |
An error occurred processing the migration system |
Vérifiez s’il existe des erreurs de fichier de migration .xml dans le journal ScanState, ou utilisez l’aide en ligne en tapant /? sur la ligne de commande. |
Installation et initialisation |
33 |
USMT_UNABLE_READKEY |
Error accessing the file specified by the /keyfile parameter |
Vérifiez s’il existe des erreurs de fichier de migration .xml dans le journal ScanState, ou utilisez l’aide en ligne en tapant /? sur la ligne de commande. |
Installation et initialisation |
The encryption key must have at least one character |
Vérifiez s’il existe des erreurs de fichier de migration .xml dans le journal ScanState, ou utilisez l’aide en ligne en tapant /? sur la ligne de commande. |
|||
34 |
USMT_ERROR_INSUFFICIENT_RIGHTS |
Directory removal requires elevated privileges |
Ouvrez une session en tant qu’administrateur et utilisez des privilèges élevés lors de l’exécution. |
Installation et initialisation |
No rights to create user profiles; log in as Administrator; run with elevated privileges |
Ouvrez une session en tant qu’administrateur et utilisez des privilèges élevés lors de l’exécution. |
|||
No rights to create user profiles; log in as Administrator; run with elevated privileges |
Ouvrez une session en tant qu’administrateur et utilisez des privilèges élevés lors de l’exécution. |
|||
35 |
USMT_UNABLE_DELETE_STORE |
A reboot is required to remove the store |
Redémarrez afin de supprimer les fichiers qui ne l’avaient pas été lors de l’exécution de la commande. |
Installation et initialisation |
A store path can’t be used because it contains data that could not be overwritten |
Un magasin de migration n’a pas pu être supprimé. Si vous utilisez un magasin de migration de liaison permanente, il se peut qu’il contienne un fichier verrouillé. Vous devez supprimer manuellement le magasin ou utiliser la commande usmtutils /rd pour supprimer le magasin. |
|||
There was an error removing the store |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. |
|||
36 |
USMT_ERROR_UNSUPPORTED_PLATFORM |
Compliance check failure; please check the logs for details |
Déterminez s’il existe un profil temporaire actif sur le système. |
Installation et initialisation |
Use of /offline is not supported during apply |
La commande /offline n’a pas été utilisée lors de l’exécution dans l’Environnement de préinstallation Windows (Windows PE). |
|||
Use /offline to run gather on this platform |
La commande /offline n’a pas été utilisée lors de l’exécution dans Windows PE. |
|||
37 |
USMT_ERROR_NO_INVALID_KEY |
The store holds encrypted data but the correct encryption key was not provided |
Vérifiez que vous avez inclus la clé de chiffrement /key ou /keyfile correcte. |
Installation et initialisation |
38 |
USMT_ERROR_CORRUPTED_NOTENCRYPTED_STORE |
An error occurred during store access |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. Assurez-vous que le chemin d’accès au magasin est accessible et que les niveaux d’autorisation appropriés sont définis. |
Installation et initialisation |
39 |
USMT_UNABLE_TO_READ_CONFIG_FILE |
Error reading Config.xml |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. |
Installation et initialisation |
File argument is invalid for /genmigxml |
Vérifiez la ligne de commande que vous avez utilisée pour charger le fichier Config.xml. Vous pouvez utiliser l’aide en ligne en tapant /? sur la ligne de commande. |
|||
40 |
USMT_ERROR_UNABLE_CREATE_PROGRESS_LOG |
Error writing to the progress log |
Le journal de progression n’a pas pu être créé. Vérifiez que l’emplacement est valide et que vous disposez d’un accès en écriture. |
Installation et initialisation |
Progress log argument is invalid for /progress |
Le journal de progression n’a pas pu être créé. Vérifiez que l’emplacement est valide et que vous disposez d’un accès en écriture. |
|||
41 |
USMT_PREFLIGHT_FILE_CREATION_FAILED |
Can’t overwrite existing file |
Le journal de progression n’a pas pu être créé. Vérifiez que l’emplacement est valide et que vous disposez d’un accès en écriture. |
Installation et initialisation |
Chemin d’accès à l’estimation d’espace non valide. Vérifier les paramètres et/ou les autorisations du système de fichiers |
Examinez le journal ScanState ou LoadState pour plus de détails sur les erreurs de ligne de commande. |
|||
42 |
USMT_ERROR_CORRUPTED_STORE |
The store contains one or more corrupted files |
Examinez le journal UsmtUtils pour plus de détails sur les fichiers corrompus. Pour plus d’informations sur l’extraction des fichiers non corrompus, voir Extraire des fichiers d’un magasin de migration compressé de l’outil USMT. |
|
61 |
USMT_MIGRATION_STOPPED_NONFATAL |
Processing stopped due to an I/O error |
USMT s’est interrompu mais peut continuer avec l’option de ligne de commande /c, la section configurable facultative <ErrorControl> ou l’option de ligne de commande /vsc. |
Erreurs récupérables |
71 |
USMT_INIT_OPERATING_ENVIRONMENT_FAILED |
A Windows Win32 API error occurred |
Le transfert de données a commencé et une erreur s’est produite pendant la création du magasin de migration ou la phase d’application. Examinez le journal ScanState ou LoadState pour obtenir des détails. |
Erreurs irrécupérables |
An error occurred when attempting to initialize the diagnostic mechanisms such as the log |
Le transfert de données a commencé et une erreur s’est produite pendant la création du magasin de migration ou la phase d’application. Examinez le journal ScanState ou LoadState pour obtenir des détails. |
|||
Failed to record diagnostic information |
Le transfert de données a commencé et une erreur s’est produite pendant la création du magasin de migration ou la phase d’application. Examinez le journal ScanState ou LoadState pour obtenir des détails. |
|||
Unable to start. Vérifiez que vous exécutez USMT avec des privilèges élevés |
Quittez USMT et reconnectez-vous avec des privilèges élevés. |
|||
72 |
USMT_UNABLE_DOMIGRATION |
An error occurred closing the store |
Le transfert de données a commencé, et une erreur s’est produite pendant la création du magasin de migration ou la phase d’application. Examinez le journal ScanState ou LoadState pour obtenir des détails. |
Erreurs irrécupérables |
An error occurred in the apply process |
Le transfert de données a commencé, et une erreur s’est produite pendant la création du magasin de migration ou la phase d’application. Examinez le journal ScanState ou LoadState pour obtenir des détails. |
|||
An error occurred in the gather process |
Le transfert de données a commencé, et une erreur s’est produite pendant la création du magasin de migration ou la phase d’application. Examinez le journal ScanState ou LoadState pour obtenir des détails. |
|||
Out of disk space while writing the store |
Le transfert de données a commencé, et une erreur s’est produite pendant la création du magasin de migration ou la phase d’application. Examinez le journal ScanState ou LoadState pour obtenir des détails. |
|||
Out of temporary disk space on the local system |
Le transfert de données a commencé, et une erreur s’est produite pendant la création du magasin de migration ou la phase d’application. Examinez le journal ScanState ou LoadState pour obtenir des détails. |
Voir aussi
Autres ressources
Résolution des problèmes liés à l’Outil de migration utilisateur (USMT)
Fichiers journaux