Códigos de retorno
Este tópico discute códigos de retorno e mensagens de erro da USMT (Ferramenta de Migração de Estado do Usuário) 5.0. Além disso, fornece uma lista de tabela dos códigos de retorno da USMT, com suas etapas de mitigação associadas. Este tópico também dá dicas para ajudá-lo a usar os arquivos de log para determinar o motivo pelo qual você recebeu um erro.
Entender os requisitos de execução da USMT pode ajudar a minimizar os erros nas migrações da USMT. Para saber mais, veja Requisitos da USMT.
Neste tópico
Códigos de retorno da USMT
Mensagens de erro da USMT
Solucionando problemas de mensagens de erro e códigos de retorno
Códigos de retorno da USMT
Se você encontrar um erro na migração da USMT, pode usar códigos de retorno e as informações mais específicas fornecidas nas mensagens de erro associadas da USMT para solucionar o problema e identificar as etapas de mitigação.
Códigos de retorno são agrupados nas seguintes categorias gerais que descrevem a sua área de relatório de erros:
Sucesso ou cancelamento de usuário
Linhas de comando inválidas
Instalação e inicialização
Erros não fatais
Erros fatais
Como prática recomendada, convém que você defina o mais alto nível de detalhamento como 5, /v*:5*, nas linhas de comando ScanState, LoadState e UsmtUtils, para que o relatório mais detalhado esteja disponível nos respectivos logs de USMT. Você pode usar um nível de detalhamento superior, se desejar que a saída dos arquivos de log seja direcionada para um depurador.
Mensagens de erro da USMT
Mensagens de erro fornecem informações mais detalhadas sobre o problema de migração do que o código de retorno associado. Por exemplo, as ferramentas ScanState, LoadState ou UsmtUtils podem retornar um código "11" (para "USMT_INVALID_PARAMETERS") e uma mensagem de erro relacionada que lê "/key e /keyfile especificados". A mensagem de erro é exibida no prompt de comando e é identificada nos arquivos de log de ScanState, LoadState ou UsmtUtils para ajudá-lo a determinar por que o código de retorno foi recebido.
Você pode obter mais informações sobre quaisquer códigos de erro de sistema listados na API (interface de programação de aplicativo) do Windows digitando net helpmsg na linha de comando e digitando o número do código de erro. Para saber mais informações sobre os códigos de erro do sistema, veja o site da Microsoft.
Solucionando problemas de mensagens de erro e códigos de retorno
A tabela a seguir lista cada código de retorno pelo valor numérico, junto com as mensagens de erro associadas e as ações de solução de problemas sugeridas.
| Valor do código de retorno | Código de retorno | Mensagem de erro | Solucionando problemas, mitigação, soluções alternativas | Categoria |
|---|---|---|---|---|
0 |
USMT_SUCCESS |
Execução bem-sucedida |
Não aplicável |
Sucesso ou cancelamento |
1 |
USMT_DISPLAY_HELP |
Ajuda da linha de comando solicitada |
Não aplicável |
Sucesso ou cancelamento |
2 |
USMT_STATUS_CANCELED |
A coleta foi interrompida por causa de um arquivo do EFS |
Não aplicável |
|
O usuário optou por cancelar (por exemplo, pressionando CTRL+C) |
Não aplicável |
Sucesso ou cancelamento |
||
3 |
USMT_WOULD_HAVE_FAILED |
Pelo menos um erro foi ignorado como resultado de /c |
Revise o log de ScanState, LoadState ou UsmtUtils para obter detalhes sobre erros da linha de comando. |
|
11 |
USMT_INVALID_PARAMETERS |
Conflitos entre /all e /ui, /ue ou /uel. |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. |
|
/auto espera um parâmetro opcional para a pasta de scripts |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. |
|||
/encrypt não pode ser utilizado com /nocompress |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. |
|||
/encrypt requer /key ou /keyfile |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. |
|||
/genconfig não pode ser usado com a maioria das outras opções |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. |
|||
/genmigxml não pode ser usado com a maioria das outras opções |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. |
|||
/hardlink requer /nocompress |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. |
|||
/key e /keyfile ambos especificados |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. |
|||
/key ou /keyfile usado sem habilitar a criptografia |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. |
|||
/lae é usado somente com /lac |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. |
|||
/listfiles não pode ser usado com /p |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. |
|||
/offline requer um caminho válido para um arquivo XML que descreve caminhos offline |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. |
|||
/offlinewindir requer um caminho válido para a pasta do Windows offline |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. |
|||
/offlinewinold requer um caminho válido para a pasta do Windows offline |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. |
|||
Já foi especificado um comando |
Verifique se a sintaxe da linha de comando está correta e se não há comandos duplicados. |
|||
Um argumento de opção está ausente |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. |
|||
Uma opção foi especificada mais de uma vez e é ambígua |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. |
|||
Por padrão, /auto seleciona todos os usuários e utiliza o mais alto nível de detalhamento do registro. Alternâncias como /all, /ui, /ue, /v não são permitidas. |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. |
|||
Argumentos de linha de comando são necessários. Especifique /? para obter opções. |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. |
|||
Opção de linha de comando inválida |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. |
|||
O parâmetro EFS especificado não é válido para /efs |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. |
|||
O argumento do arquivo é inválido para /genconfig |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. |
|||
O argumento do arquivo é inválido para /genmigxml |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. |
|||
Caminho de estimativa de espaço inválido. Verifique os parâmetros e/ou as permissões do sistema de arquivos |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. |
|||
Lista de argumentos de caminho de arquivo inválida para /listfiles |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. |
|||
O argumento de repetição deve ser um número inteiro |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. |
|||
O argumento do repositório de configurações especificado é inválido |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. Verifique se o caminho do repositório é acessível e se os níveis de permissão adequados estão definidos. |
|||
O algoritmo de criptografia especificado não tem suporte |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. |
|||
A opção /efs:hardlink requer /hardlink |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. |
|||
A opção /targetWindows7 só está disponível para Windows XP, Windows Vista® e Windows 7 |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. |
|||
O parâmetro de armazenamento é necessário mas não especificado |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. |
|||
O mapeamento de domínio de origem para destino é inválido para /md |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. |
|||
O mapeamento de conta de usuário de origem para destino é inválido para /mu |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. |
|||
Opção de linha de comando indefinida ou incompleta |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. |
Linhas de comando inválidas |
||
Use /nocompress ou forneça um caminho de arquivo XML com /p"pathtoafile" para obter uma estimativa de tamanho de repositório compactado |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. |
|||
Argumento de exclusão de usuário inválido |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. |
|||
O nível de detalhamento deve ser especificado como uma soma das opções de log desejadas: Verbose (0x01), Record Objects (0x04), Echo to debug port (0x08) |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. |
|||
Não há suporte para o recurso de cópia de sombra de volume com um repositório de link físico |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. |
|||
Argumento de atraso de espera deve ser um número inteiro |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. |
|||
12 |
USMT_ERROR_OPTION_PARAM_TOO_LARGE |
Argumentos de linha de comando não podem exceder 256 caracteres |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. |
Linhas de comando inválidas |
O caminho do repositório de configurações especificadas excede o tamanho máximo permitido de 256 caracteres |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. |
|||
13 |
USMT_INIT_LOGFILE_FAILED |
O argumento do caminho do log é inválido para /l |
Quando /l é especificado na linha de comando ScanState, a USMT valida o caminho. Verifique se a unidade e outras informações, como os caracteres do sistema de arquivos, estão corretas. |
Linhas de comando inválidas |
14 |
USMT_ERROR_USE_LAC |
Não é possível criar uma conta local porque /lac não foi especificado |
Ao criar contas locais, as opções de linha de comando /lac e /lae devem ser usadas. |
Linhas de comando inválidas |
26 |
USMT_INIT_ERROR |
Várias instalações do Windows encontradas |
Listfiles.txt não pôde ser criado. Verifique se o local especificado para a criação deste arquivo é válido. |
Instalação e inicialização |
Exceção desconhecida ou problema no software |
Verifique se há erros em todos os arquivos .xml carregados, erro comum ao usar /I para carregar o arquivo Config.xml. |
|||
Não é possível localizar um diretório válido do Windows para prosseguir com a operação solicitada offline; Verifique se o arquivo de entrada offline está presente e tem entradas válidas |
Verifique se o arquivo de entrada offline está presente e tem entradas válidas. A USMT não pôde encontrar um sistema operacional offline válido. Verifique o mapeamento do diretório offline. |
|||
27 |
USMT_INVALID_STORE_LOCATION |
Um caminho de repositório não pode ser usado porque existe um repositório; especifique /o para substituir |
Especifique /o para substituir um repositório de migração ou intermediário existente. |
Instalação e inicialização |
Um caminho de repositório está ausente ou tem dados incompletos |
Verifique se o caminho do repositório é acessível e se os níveis de permissão adequados estão definidos. |
|||
Erro durante a criação do repositório |
Verifique se o caminho do repositório é acessível e se os níveis de permissão adequados estão definidos. Especifique /o para substituir um repositório de migração ou intermediário existente. |
|||
Um dispositivo inadequado, como um disquete foi especificado para o repositório |
Verifique se o caminho do repositório é acessível e se os níveis de permissão adequados estão definidos. |
|||
Caminho do repositório inválido; verifique as permissões do parâmetro de repositório e/ou sistema de arquivos |
Caminho do repositório inválido; verifique as permissões do parâmetro de repositório e/ou sistema de arquivos |
|||
O conteúdo do layout e/ou arquivo não é reconhecido como um repositório válido |
Verifique se o caminho do repositório é acessível e se os níveis de permissão adequados estão definidos. Especifique /o para substituir um repositório de migração ou intermediário existente. |
|||
O caminho do repositório tem um repositório incompatível com a versão atual da USMT |
Verifique se o caminho do repositório é acessível e se os níveis de permissão adequados estão definidos. |
|||
O local de salvamento do repositório é somente leitura ou não dá suporte a uma opção de armazenamento solicitada |
Verifique se o caminho do repositório é acessível e se os níveis de permissão adequados estão definidos. |
|||
28 |
USMT_UNABLE_GET_SCRIPTFILES |
O arquivo de script é inválido para /i |
Verifique se há erros em todos os arquivos .xml de migração especificados. Este é um erro comum ao usar /i para carregar o arquivo Config.xml. |
Instalação e inicialização |
Não é possível localizar um arquivo de script especificado por /i |
Verifique a localização dos arquivos de script e se as opções de linha de comando estão corretas. |
|||
29 |
USMT_FAILED_MIGSTARTUP |
É necessário, no mínimo, 250 MB de espaço livre para arquivos temporários |
Verifique se o sistema satisfaz o requisito de espaço em disco temporário mínimo de 250 MB. Como solução alternativa, você pode definir a variável de ambiente USMT_WORKING_DIR=<path> para redirecionar o diretório de trabalho dos arquivos temporários. |
Instalação e inicialização |
Outro processo está impedindo a migração; somente uma ferramenta de migração pode ser executada de cada vez |
Verifique se há erros no arquivo de log de ScanState para o arquivo .xml de migração. |
|||
Falha ao iniciar o processamento principal, procure erros no log do sistema ou verifique a instalação |
Verifique se há erros no arquivo de log de ScanState para o arquivo .xml de migração. |
|||
Falha na migração devido a um erro de XML; examine o log para obter detalhes específicos |
Verifique se há erros no arquivo de log de ScanState para o arquivo .xml de migração. |
|||
Não é possível mapear automaticamente as letras de unidade para corresponder ao layout de letra de unidade online; Use /offline para fornecer uma tabela de mapeamento |
Verifique se há erros no arquivo de log de ScanState para o arquivo .xml de migração. |
|||
31 |
USMT_UNABLE_FINDMIGUNITS |
Erro durante a fase de descoberta; o log deve ter informações mais específicas |
Verifique se há erros no arquivo de log de ScanState para o arquivo .xml de migração. |
Instalação e inicialização |
32 |
USMT_FAILED_SETMIGRATIONTYPE |
Erro ao processar o sistema de migração |
Verifique se há erros no arquivo de log de ScanState para o arquivo .xml de migração ou use a Ajuda online digitando /? na linha de comando. |
Instalação e inicialização |
33 |
USMT_UNABLE_READKEY |
Erro ao acessar o arquivo especificado pelo parâmetro /keyfile |
Verifique se há erros no arquivo de log de ScanState para o arquivo .xml de migração ou use a Ajuda online digitando /? na linha de comando. |
Instalação e inicialização |
A chave de criptografia deve ter pelo menos um caractere |
Verifique se há erros no arquivo de log de ScanState para o arquivo .xml de migração ou use a Ajuda online digitando /? na linha de comando. |
|||
34 |
USMT_ERROR_INSUFFICIENT_RIGHTS |
A remoção de diretório requer privilégios elevados |
Faça logon como Administrador e execute com privilégios elevados. |
Instalação e inicialização |
Não há direitos para criar perfis de usuário; faça logon como Administrador, execute com privilégios elevados |
Faça logon como Administrador e execute com privilégios elevados. |
|||
Não há direitos para ler ou excluir perfis de usuário; faça logon como Administrador, execute com privilégios elevados |
Faça logon como Administrador e execute com privilégios elevados. |
|||
35 |
USMT_UNABLE_DELETE_STORE |
É necessário reiniciar para remover o repositório |
Reinicie para excluir todos os arquivos que não puderam ser excluídos quando o comando foi executado. |
Instalação e inicialização |
Não foi possível usar um caminho do repositório porque ele contém dados que não puderam ser substituídos |
Não foi possível excluir um repositório de migração. Se você estiver usando um repositório de migração de link físico, pode ter um arquivo bloqueado nele. Você deve excluir o repositório manualmente ou usar o comando usmtutils /rd para excluir o repositório. |
|||
Erro ao remover o repositório |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. |
|||
36 |
USMT_ERROR_UNSUPPORTED_PLATFORM |
Falha na verificação de conformidade; verifique os logs para obter detalhes |
Investigue se há um perfil temporário ativo no sistema. |
Instalação e inicialização |
O uso de /offline não tem suporte durante a aplicação |
O comando /offline não foi usado durante a execução no Windows PE (Ambiente de Pré-Instalação do Windows). |
|||
Use /offline para executar nesta plataforma |
O comando /offline não foi usado durante a execução no Windows PE. |
|||
37 |
USMT_ERROR_NO_INVALID_KEY |
O repositório contém dados criptografados, mas a chave de criptografia correta não foi fornecida |
Verifique se você incluiu a criptografia correta /key ou /keyfile. |
Instalação e inicialização |
38 |
USMT_ERROR_CORRUPTED_NOTENCRYPTED_STORE |
Erro durante o acesso ao repositório |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. Verifique se o caminho do repositório é acessível e se os níveis de permissão adequados estão definidos. |
Instalação e inicialização |
39 |
USMT_UNABLE_TO_READ_CONFIG_FILE |
Erro ao ler Config.xml |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros de linha de comando no arquivo Config.xml. |
Instalação e inicialização |
O argumento do arquivo é inválido para /config |
Verifique a linha de comando usada para carregar o arquivo Config.xml. Você pode usar a Ajuda online digitando /? na linha de comando. |
|||
40 |
USMT_ERROR_UNABLE_CREATE_PROGRESS_LOG |
Erro ao gravar no log de progresso |
Não foi possível criar o log de progresso. Verifique se o local é válido e se você tem acesso de gravação. |
Instalação e inicialização |
O argumento do log de progresso é inválido para /progress |
Não foi possível criar o log de progresso. Verifique se o local é válido e se você tem acesso de gravação. |
|||
41 |
USMT_PREFLIGHT_FILE_CREATION_FAILED |
Não é possível substituir o arquivo existente |
Não foi possível criar o log de progresso. Verifique se o local é válido e se você tem acesso de gravação. |
Instalação e inicialização |
Caminho de estimativa de espaço inválido. Verifique os parâmetros e/ou as permissões do sistema de arquivos |
Examine o log de ScanState ou LoadState para obter detalhes sobre erros da linha de comando. |
|||
42 |
USMT_ERROR_CORRUPTED_STORE |
O repositório contém um ou mais arquivos corrompidos |
Examine o log de UsmtUtils para obter detalhes sobre os arquivos corrompidos. Para saber como extrair os arquivos que não estão corrompidos, veja Extrair arquivos de um repositório de migração compactado da USMT. |
|
61 |
USMT_MIGRATION_STOPPED_NONFATAL |
Processamento interrompido devido a um erro de E/S |
A USMT saiu, mas pode continuar com a opção de linha de comando /c, com a seção opcional <ErrorControl> configurável ou usando a opção de linha de comando /vsc. |
Erros não fatais |
71 |
USMT_INIT_OPERATING_ENVIRONMENT_FAILED |
Erro de API do Win32 do Windows |
A transferência de dados foi iniciada e ocorreu um erro durante a criação do repositório de migração ou durante a fase de aplicação. Examine o log de ScanState ou LoadState para obter detalhes. |
Erros fatais |
Erro ao tentar inicializar os mecanismos de diagnóstico, como o log |
A transferência de dados foi iniciada e ocorreu um erro durante a criação do repositório de migração ou durante a fase de aplicação. Examine o log de ScanState ou LoadState para obter detalhes. |
|||
Falha ao gravar informações de diagnóstico |
A transferência de dados foi iniciada e ocorreu um erro durante a criação do repositório de migração ou durante a fase de aplicação. Examine o log de ScanState ou LoadState para obter detalhes. |
|||
Não é possível iniciar. Verifique se você está executando a USMT com privilégios elevados |
Saia da USMT e faça logon novamente com privilégios elevados. |
|||
72 |
USMT_UNABLE_DOMIGRATION |
Erro ao fechar o repositório |
A transferência de dados foi iniciada, e ocorreu um erro durante a criação do repositório de migração ou durante a fase de aplicação. Examine o log de ScanState ou LoadState para obter detalhes. |
Erros fatais |
Erro no processo de aplicação |
A transferência de dados foi iniciada, e ocorreu um erro durante a criação do repositório de migração ou durante a fase de aplicação. Examine o log de ScanState ou LoadState para obter detalhes. |
|||
Ocorreu um erro no processo de coleta |
A transferência de dados foi iniciada, e ocorreu um erro durante a criação do repositório de migração ou durante a fase de aplicação. Examine o log de ScanState ou LoadState para obter detalhes. |
|||
Espaço em disco insuficiente ao gravar o repositório |
A transferência de dados foi iniciada, e ocorreu um erro durante a criação do repositório de migração ou durante a fase de aplicação. Examine o log de ScanState ou LoadState para obter detalhes. |
|||
Espaço em disco temporário insuficiente no sistema local |
A transferência de dados foi iniciada, e ocorreu um erro durante a criação do repositório de migração ou durante a fase de aplicação. Examine o log de ScanState ou LoadState para obter detalhes. |
Consulte também
Outros Recursos
Ferramenta de Migração de Estado do Usuário (USMT)
Arquivos de log