Condividi tramite

Codici restituiti

  • Articolo

Questo argomento descrive i codici restituiti e i messaggi di errore di Utilità di migrazione stato utente (USMT) 5.0. È inoltre disponibile una tabella che elenca i codici restituiti di USMT, con le azioni di prevenzione associate. L'argomento include inoltre suggerimenti per l'uso dei file di log per stabilire le cause degli errori.

La conoscenza dei requisiti per l'esecuzione di USMT può essere utile per ridurre al minimo gli errori per le migrazioni eseguite con USMT. Per altre informazioni, vedi Requisiti per Utilità di migrazione stato utente (USMT).

In questo argomento

Codici restituiti di USMT

Messaggi di errore di USMT

Risolvere i problemi relativi ai codici restituiti e ai messaggi di errore

Codici restituiti di USMT

Se si verifica un errore durante la migrazione USMT, puoi usare i codici restituiti e le informazioni più specifiche fornite nei messaggi di errore di USMT associati per risolvere il problema e identificare eventuali azioni di prevenzione.

I codici restituiti sono raggruppati nelle categorie generali seguenti che descrivono l'area di segnalazione errori corrispondente:

  • Operazione riuscita o annullata dall'utente

  • Righe di comando non valide

  • Installazione e inizializzazione

  • Errori non irreversibili

  • Errori irreversibili

Come buona norma, consigliamo di impostare il livello di dettaglio 5, /v*:5*, nelle righe di comando ScanState, LoadState e UsmtUtils in modo che nei registri di USMT corrispondenti sia disponibile la informazioni più dettagliate. Puoi usare un livello di dettaglio superiore se vuoi passare a un debugger l'output dei file di log.

Messaggi di errore di USMT

I messaggi di errori forniscono informazioni più dettagliate sul problema di migrazione rispetto ai codici restituiti associati. Lo strumento ScanState, LoadState o UsmtUtils, ad esempio, potrebbe restituire il codice "11" (per "USMT_INVALID_PARAMETERS") e il messaggio di errore correlato "/key and /keyfile both specified". Il messaggio di errore viene visualizzato al prompt dei comandi ed identificato nei file di log di ScanState, LoadState o UsmtUtils per determinare il motivo per il quale è stato ricevuto il codice restituito.

Puoi ottenere ulteriori informazioni sui codici di errore di sistema dell'API (Application Programming Interface) di Windows digitando net helpmsg nella riga di comando, quindi specificando il numero del codice di errore. Per altre informazioni sui codici di errore di sistema, vedi questo sito Web Microsoft.

Risolvere i problemi relativi ai codici restituiti e ai messaggi di errore

La tabella seguente elenca ogni codice restituito per valore numerico, insieme ai messaggi di errore associati e alle azioni di risoluzione dei problemi consigliate.

Valore codice restituito Codice restituito Messaggio di errore Risoluzione dei problemi, azioni di prevenzione, soluzioni alternative Categoria

0

USMT_SUCCESS

Successful run

Non applicabile

Operazione riuscita o annullata

1

USMT_DISPLAY_HELP

Command line help requested

Non applicabile

Operazione riuscita o annullata

2

USMT_STATUS_CANCELED

Gather was aborted because of an EFS file

Non applicabile

User chose to cancel (such as pressing CTRL+C)

Non applicabile

Operazione riuscita o annullata

3

USMT_WOULD_HAVE_FAILED

At least one error was skipped as a result of /c

Esamina il registro di ScanState, LoadState o UsmtUtils per informazioni dettagliate sugli errori della riga di comando.

11

USMT_INVALID_PARAMETERS

/all conflicts with /ui, /ue or /uel

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando.

/auto expects an optional parameter for the script folder

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando.

/encrypt can't be used with /nocompress

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando.

/encrypt requires /key or /keyfile

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando.

/genconfig can't be used with most other options

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando.

/genmigxml can't be used with most other options

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando.

/hardlink requires /nocompress

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando.

/key and /keyfile both specified

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando.

/key or /keyfile used without enabling encryption

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando.

/lae is only used with /lac

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando.

/listfiles cannot be used with /p

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando.

/offline requires a valid path to an XML file describing offline paths

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando.

/offlinewindir requires a valid path to offline windows folder

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando.

/offlinewinold requires a valid path to offline windows folder

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando.

A command was already specified

Verifica che la sintassi della riga di comando sia corretta e che non siano presenti comandi duplicati.

An option argument is missing

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando.

An option is specified more than once and is ambiguous

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando.

By default /auto selects all users and uses the highest log verbosity level. Switches like /all, /ui, /ue, /v are not allowed.

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando.

Command line arguments are required. Specify /? for options.

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando.

Command line option is not valid

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando.

EFS parameter specified is not valid for /efs

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando.

File argument is invalid for /genconfig

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando.

File argument is invalid for /genmigxml

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando.

Invalid space estimate path. Check the parameters and/or file system permissions

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando.

List file path argument is invalid for /listfiles

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando.

Retry argument must be an integer

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando.

Settings store argument specified is invalid

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando. Verifica che il percorso dell'archivio sia accessibile e che siano impostati i livelli di autorizzazione appropriati.

Specified encryption algorithm is not supported

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando.

The /efs:hardlink requires /hardlink

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando.

The /targetWindows7 option is only available for Windows XP, Windows Vista®, and Windows 7

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando.

The store parameter is required but not specified

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando.

The source-to-target domain mapping is invalid for /md

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando.

The source-to-target domain mapping is invalid for /md

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando.

Undefined or incomplete command line option

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando.

Righe di comando non valide

Use /nocompress, or provide an XML file path with /p"pathtoafile" to get a compressed store size estimate

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando.

User exclusion argument is invalid

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando.

Verbosity level must be specified as a sum of the desired log options: Verbose (0x01), Record Objects (0x04), Echo to debug port (0x08)

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando.

Volume shadow copy feature is not supported with a hardlink store

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando.

Wait delay argument must be an integer

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando.

12

USMT_ERROR_OPTION_PARAM_TOO_LARGE

Command line arguments cannot exceed 256 characters

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando.

Righe di comando non valide

Specified settings store path exceeds the maximum allowed length of 256 characters

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando.

13

USMT_INIT_LOGFILE_FAILED

List file path argument is invalid for /listfiles

Se si specifica /l nella riga di comando di ScanState, USMT convalida il percorso. Verifica che l'unità e le altre informazioni, ad esempio i caratteri del file system, siano corrette.

Righe di comando non valide

14

USMT_ERROR_USE_LAC

Unable to create a local account because /lac was not specified

Per la creazione di account locali è necessario usare le opzioni della riga di comando /lac e /lae.

Righe di comando non valide

26

USMT_INIT_ERROR

Multiple Windows installations found

Non è stato possibile creare Listfiles.txt. Verifica che il percorso specificato per la creazione di questo file sia valido.

Installazione e inizializzazione

Software malfunction or unknown exception

Controlla se sono presenti errori in tutti i file XML caricati. Si tratta di un errore comune quando si usa l'opzione /I per caricare il file Config.xml.

Unable to find a valid Windows directory to proceed with requested offline operation; Check if offline input file is present and has valid entries

Verifica che il file di input offline sia presente e contenga voci valide. USMT non è riuscito a trovare un sistema operativo offline valido. Verifica il mapping di directory offline.

27

USMT_INVALID_STORE_LOCATION

A store path can't be used because an existing store exists; specify /o to overwrite

Specifica /o per sovrascrivere un archivio intermedio o delle migrazioni esistente.

Installazione e inizializzazione

A store path is missing or has incomplete data

Verifica che il percorso dell'archivio sia accessibile e che siano impostati i livelli di autorizzazione appropriati.

An error occurred during store creation

Verifica che il percorso dell'archivio sia accessibile e che siano impostati i livelli di autorizzazione appropriati. Specifica /o per sovrascrivere un archivio intermedio o delle migrazioni esistente.

An inappropriate device such as a floppy disk was specified for the store

Verifica che il percorso dell'archivio sia accessibile e che siano impostati i livelli di autorizzazione appropriati.

Il percorso dell'archivio non è valido. Controlla il parametro relativo all'archivio e/o le autorizzazioni del file system

Il percorso dell'archivio non è valido. Controlla il parametro relativo all'archivio e/o le autorizzazioni del file system

The file layout and/or file content is not recognized as a valid store

Verifica che il percorso dell'archivio sia accessibile e che siano impostati i livelli di autorizzazione appropriati. Specifica /o per sovrascrivere un archivio intermedio o delle migrazioni esistente.

The store path holds a store incompatible with the current USMT version

Verifica che il percorso dell'archivio sia accessibile e che siano impostati i livelli di autorizzazione appropriati.

The store save location is read-only or does not support a requested storage option

Verifica che il percorso dell'archivio sia accessibile e che siano impostati i livelli di autorizzazione appropriati.

28

USMT_UNABLE_GET_SCRIPTFILES

Script file is invalid for /i

Controlla se sono presenti errori in tutti i file XML della migrazione. Si tratta di un errore comune quando si usa l'opzione /i per caricare il file Config.xml.

Installazione e inizializzazione

Unable to find a script file specified by /i

Verifica il percorso dei file di script e assicurati che le opzioni della riga di comando siano corrette.

29

USMT_FAILED_MIGSTARTUP

A minimum of 250 MB of free space is required for temporary files

Verifica che il sistema soddisfi il requisito di 250 MB di spazio minimo su disco temporaneo. Per risolvere il problema, puoi impostare la variabile di ambiente USMT_WORKING_DIR=<percorso> per reindirizzare la directory di lavoro dei file temporanei.

Installazione e inizializzazione

Another process is preventing migration; only one migration tool can run at a time

Controlla il file di log di ScanState per gli errori relativi al file XML di migrazione.

Failed to start main processing, look in log for system errors or check the installation

Controlla il file di log di ScanState per gli errori relativi al file XML di migrazione.

Migration failed because of an XML error; look in the log for specific details

Controlla il file di log di ScanState per gli errori relativi al file XML di migrazione.

Unable to automatically map the drive letters to match the online drive letter layout; Use /offline to provide a mapping table

Controlla il file di log di ScanState per gli errori relativi al file XML di migrazione.

31

USMT_UNABLE_FINDMIGUNITS

An error occurred during the discover phase; the log should have more specific information

Controlla il file di log di ScanState per gli errori relativi al file XML di migrazione.

Installazione e inizializzazione

32

USMT_FAILED_SETMIGRATIONTYPE

An error occurred processing the migration system

Controlla il file di log di ScanState per gli errori relativi al file XML di migrazione o usa la Guida online digitando /? nella riga di comando.

Installazione e inizializzazione

33

USMT_UNABLE_READKEY

Error accessing the file specified by the /keyfile parameter

Controlla il file di log di ScanState per gli errori relativi al file XML di migrazione o usa la Guida online digitando /? nella riga di comando.

Installazione e inizializzazione

The encryption key must have at least one character

Controlla il file di log di ScanState per gli errori relativi al file XML di migrazione o usa la Guida online digitando /? nella riga di comando.

34

USMT_ERROR_INSUFFICIENT_RIGHTS

Directory removal requires elevated privileges

Accedi come amministratore ed esegui l'operazione con privilegi elevati.

Installazione e inizializzazione

No rights to create user profiles; log in as Administrator; run with elevated privileges

Accedi come amministratore ed esegui l'operazione con privilegi elevati.

No rights to read or delete user profiles; log in as Administrator, run with elevated privileges

Accedi come amministratore ed esegui l'operazione con privilegi elevati.

35

USMT_UNABLE_DELETE_STORE

A reboot is required to remove the store

Esegui il riavvio per eliminare eventuali file che non è stato possibile eliminare durante l'esecuzione del comando.

Installazione e inizializzazione

A store path can't be used because it contains data that could not be overwritten

Non è riuscita l'eliminazione di un archivio delle migrazioni. Se usi un archivio delle migrazioni con collegamento reale, è possibile che nell'archivio ci sia un file bloccato. Devi eliminare manualmente l'archivio oppure usare il comando usmtutils /rd per eliminarlo.

There was an error removing the store

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando.

36

USMT_ERROR_UNSUPPORTED_PLATFORM

Compliance check failure; please check the logs for details

Verifica se nel sistema è presente un profilo temporaneo attivo.

Installazione e inizializzazione

Use of /offline is not supported during apply

Il comando /offline non è stato usato durante l'esecuzione in Ambiente preinstallazione Wndows (Windows PE).

Use /offline to run gather on this platform

Il comando /offline non è stato usato durante l'esecuzione in Windows PE.

37

USMT_ERROR_NO_INVALID_KEY

The store holds encrypted data but the correct encryption key was not provided

Verifica di aver incluso il valore di crittografia corretto /key o /keyfile.

Installazione e inizializzazione

38

USMT_ERROR_CORRUPTED_NOTENCRYPTED_STORE

An error occurred during store access

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando. Verifica che il percorso dell'archivio sia accessibile e che siano impostati i livelli di autorizzazione appropriati.

Installazione e inizializzazione

39

USMT_UNABLE_TO_READ_CONFIG_FILE

Error reading Config.xml

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando nel file Config.xml.

Installazione e inizializzazione

File argument is invalid for /genconfig

Controlla la riga di comando usata per caricare il file Config.xml. Puoi usare la Guida online digitando /? nella riga di comando.

40

USMT_ERROR_UNABLE_CREATE_PROGRESS_LOG

Error writing to the progress log

Non è possibile creare il registro di stato. Verifica che il percorso sia valido e di avere accesso in scrittura.

Installazione e inizializzazione

Progress log argument is invalid for /progress

Non è possibile creare il registro di stato. Verifica che il percorso sia valido e di avere accesso in scrittura.

41

USMT_PREFLIGHT_FILE_CREATION_FAILED

Can't overwrite existing file

Non è possibile creare il registro di stato. Verifica che il percorso sia valido e di avere accesso in scrittura.

Installazione e inizializzazione

Invalid space estimate path. Check the parameters and/or file system permissions

Esamina il registro di ScanState o LoadState per informazioni dettagliate sugli errori della riga di comando.

42

USMT_ERROR_CORRUPTED_STORE

The store contains one or more corrupted files

Esamina il registro di UsmtUtils per informazioni dettagliate sui file danneggiati. Per altre informazioni su come estrarre i file non danneggiati, vedi Estrarre i file da un archivio delle migrazioni USMT compresso.

61

USMT_MIGRATION_STOPPED_NONFATAL

Processing stopped due to an I/O error

USMT ha interrotto l'elaborazione ma può continuare con l'opzione della riga di comando /c, con la sezione facoltativa configurabile <ErrorControl> o l'opzione della riga di comando /vsc.

Errori non irreversibili

71

USMT_INIT_OPERATING_ENVIRONMENT_FAILED

A Windows Win32 API error occurred

Il trasferimento dei dati è stato avviato e si è verificato un errore durante la creazione dell'archivio delle migrazioni o durante la fase di applicazione. Esamina il registro di ScanState o LoadState per informazioni dettagliate.

Errori irreversibili

An error occurred when attempting to initialize the diagnostic mechanisms such as the log

Il trasferimento dei dati è stato avviato e si è verificato un errore durante la creazione dell'archivio delle migrazioni o durante la fase di applicazione. Esamina il registro di ScanState o LoadState per informazioni dettagliate.

Failed to record diagnostic information

Il trasferimento dei dati è stato avviato e si è verificato un errore durante la creazione dell'archivio delle migrazioni o durante la fase di applicazione. Esamina il registro di ScanState o LoadState per informazioni dettagliate.

Unable to start. Make sure you are running USMT with elevated privileges

Esci da USMT ed esegui di nuovo l'accesso con privilegi elevati.

72

USMT_UNABLE_DOMIGRATION

An error occurred closing the store

Il trasferimento dei dati è stato avviato e si è verificato un errore durante la creazione dell'archivio di migrazione o durante la fase di applicazione. Esamina il registro di ScanState o LoadState per informazioni dettagliate.

Errori irreversibili

An error occurred in the apply process

Il trasferimento dei dati è stato avviato e si è verificato un errore durante la creazione dell'archivio di migrazione o durante la fase di applicazione. Esamina il registro di ScanState o LoadState per informazioni dettagliate.

An error occurred in the gather process

Il trasferimento dei dati è stato avviato e si è verificato un errore durante la creazione dell'archivio di migrazione o durante la fase di applicazione. Esamina il registro di ScanState o LoadState per informazioni dettagliate.

Out of disk space while writing the store

Il trasferimento dei dati è stato avviato e si è verificato un errore durante la creazione dell'archivio di migrazione o durante la fase di applicazione. Esamina il registro di ScanState o LoadState per informazioni dettagliate.

Out of temporary disk space on the local system

Il trasferimento dei dati è stato avviato e si è verificato un errore durante la creazione dell'archivio di migrazione o durante la fase di applicazione. Esamina il registro di ScanState o LoadState per informazioni dettagliate.

Vedere anche

Altre risorse

Risolvere i problemi di Utilità di migrazione stato utente (USMT)
File di log