Códigos de retorno da USMT (Ferramenta de Migração de Estado do Usuário)
Este artigo descreve códigos de retorno e mensagens de erro USMT 10.0. Também está incluída uma tabela que lista os códigos de retorno do USMT com suas etapas de mitigação associadas. Além disso, este artigo fornece dicas para ajudá-lo a usar os logfiles para determinar por que você recebeu um erro.
Entender os requisitos para executar o USMT pode ajudar a minimizar erros em suas migrações do USMT. Para obter mais informações, consulte Requisitos USMT.
Retornar códigos usados pelo USMT
Se você encontrar um erro na migração do USMT, poderá usar códigos retornados e as informações mais específicas fornecidas nas mensagens de erro USMT associadas para solucionar problemas do problema e identificar as etapas de mitigação.
Os códigos de retorno são agrupados nas seguintes categorias amplas que descrevem 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, recomendamos definir o nível de verbosidade como 5, v:5, nas linhas de comandoScanState.exe, LoadState.exee UsmtUtils.exe para que o relatório mais detalhado esteja disponível nos respectivos logs USMT. Você pode usar um nível de verbosidade mais alto se quiser que a saída de arquivos de log vá para um depurador.
Mensagens de erro USMT
As mensagens de erro fornecem informações mais detalhadas sobre o problema de migração do que o código de retorno associado. Por exemplo, a ferramenta ScanState, LoadState ou UsmtUtils pode retornar um código de 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 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 do sistema Windows listados digitando em uma janela net.exe helpmsg <error_number><de prompt de comando em que error_number> é o número de código de erro gerado pela mensagem de erro. Para obter mais informações sobre códigos de erro do sistema, consulte Códigos de Erro do Sistema (0-499).
Solução de problemas de códigos de retorno e mensagens de erro
As informações a seguir listam cada código retornado por valor numérico, juntamente com as mensagens de erro associadas e as ações de solução de problemas sugeridas.
0: USMT_SUCCESS
- Categoria: Sucesso ou cancelamento de usuário
| Mensagem de erro | Solução de problemas, mitigação, soluções alternativas |
|---|---|
| Execução bem-sucedida | NA |
1: USMT_DISPLAY_HELP
- Categoria: Sucesso ou cancelamento de usuário
| Mensagem de erro | Solução de problemas, mitigação, soluções alternativas |
|---|---|
| Ajuda de linha de comando solicitada | NA |
2: USMT_STATUS_CANCELED
- Categoria: Sucesso ou cancelamento de usuário
| Mensagem de erro | Solução de problemas, mitigação, soluções alternativas |
|---|---|
| Gather foi abortado por causa de um arquivo EFS | NA |
| O usuário optou por cancelar (como pressionar CTRL+C) | NA |
3: USMT_WOULD_HAVE_FAILED
- Categoria:
| Mensagem de erro | Solução de problemas, mitigação, soluções alternativas |
|---|---|
| Pelo menos um erro foi ignorado como resultado de /c. | Examine o log ScanState, LoadState ou UsmtUtils para obter detalhes sobre erros de linha de comando. |
11: USMT_INVALID_PARAMETERS
- Categoria: Linhas de comando inválidas
| Mensagem de erro | Solução de problemas, mitigação, soluções alternativas |
|---|---|
| /all entra em conflito com /ui, /ue ou /uel | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. |
| /auto espera um parâmetro opcional para a pasta script | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. |
| /encrypt não pode ser usado com /nocompress | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. |
| /encrypt requer /key ou /keyfile | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. |
| /genconfig não pode ser usado com a maioria das outras opções | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. |
| /genmigxml não pode ser usado com a maioria das outras opções | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. |
| /hardlink requer /nocompress | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. |
| /key e /keyfile especificados | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. |
| /key ou /keyfile usado sem habilitar a criptografia | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. |
| /lae é usado apenas com /lac | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. |
| /listfiles não podem ser usados com /p | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. |
| /offline requer um caminho válido para um arquivo XML que descreve caminhos offline | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. |
| /offlinewindir requer um caminho válido para a pasta de janelas offline | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. |
| /offlinewinold requer um caminho válido para a pasta de janelas offline | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. |
| Um comando já foi especificado | 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 do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. |
| Uma opção é especificada mais de uma vez e é ambígua | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. |
| Por padrão /auto seleciona todos os usuários e usa o nível de verbosidade de log mais alto. Comutadores como /all, /ui, /ue, /v não são permitidos. | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. |
| Argumentos de linha de comando são necessários. Especificar/? para opções. | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. |
| A opção de linha de comando não é válida | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. |
| O parâmetro EFS especificado não é válido para /efs | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. |
| O argumento do arquivo é inválido para /genconfig | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. |
| O argumento do arquivo é inválido para /genmigxml | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. |
| Caminho de estimativa de espaço inválido. Verifique os parâmetros e/ou permissões do sistema de arquivos | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. |
| O argumento caminho do arquivo de lista é inválido para /listfiles | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. |
| O argumento de repetição deve ser um inteiro | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. |
| O argumento de armazenamento de configurações especificado é inválido | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. Verifique se o caminho do repositório está acessível e se os níveis de permissão adequados estão definidos. |
| Não há suporte para o algoritmo de criptografia especificado | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. |
| O /efs:hardlink requer /hardlink | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. |
| A opção /targetWindows7 só está disponível para Windows XP, Windows Vista e Windows 7 | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. |
| O parâmetro de armazenamento é necessário, mas não especificado | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. |
| O mapeamento de domínio de origem para destino é inválido para /md | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. |
| O mapeamento da conta de usuário de origem a destino é inválido para /mu | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. |
| Opção de linha de comando indefinida ou incompleta | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. |
| Use /nocompress ou forneça um caminho de arquivo XML com /p"pathtoafile" para obter uma estimativa de tamanho do armazenamento compactado | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. |
| O argumento de exclusão de usuário é inválido | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. |
| O nível de verbosidade deve ser especificado como uma soma das opções de log desejadas: Verbose (0x01), Objetos de Registro (0x04), Echo para depurar porta (0x08) | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. |
| Não há suporte para o recurso de cópia de sombra de volume com um repositório de hardlink | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. |
| O argumento de atraso de espera deve ser um inteiro | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. |
12: USMT_ERROR_OPTION_PARAM_TOO_LARGE
- Categoria: Linhas de comando inválidas
| Mensagem de erro | Solução de problemas, mitigação, soluções alternativas |
|---|---|
| Os argumentos de linha de comando não podem exceder 256 caracteres | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. |
| O caminho de armazenamento de configurações especificadas excede o comprimento máximo permitido de 256 caracteres | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. |
13: USMT_INIT_LOGFILE_FAILED
- Categoria: Linhas de comando inválidas
| Mensagem de erro | Solução de problemas, mitigação, soluções alternativas |
|---|---|
| O argumento de caminho de log é inválido para /l | Quando /l é especificado na linha de comando ScanState, o USMT valida o caminho. Verifique se a unidade e outras informações, por exemplo, caracteres do sistema de arquivos, estão corretas. |
14: USMT_ERROR_USE_LAC
- Categoria: Linhas de comando inválidas
| Mensagem de erro | Solução de problemas, mitigação, soluções alternativas |
|---|---|
| Não foi possível criar uma conta local porque /lac não foi especificado | Ao criar contas locais, as opções /lac de linha de comando e /lae devem ser usadas. |
26: USMT_INIT_ERROR
- Categoria: Configuração e Inicialização
| Mensagem de erro | Solução de problemas, mitigação, soluções alternativas |
|---|---|
| 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. |
| Falha de software ou exceção desconhecida | Verifique todos os arquivos de .xml carregados em busca de erros, erro comum ao usar /i para carregar o arquivo Config.xml . |
| Não é possível encontrar um diretório válido do Windows para prosseguir com a operação offline solicitada; Verifique se o arquivo de entrada offline está presente e tem entradas válidas | Verifique se o arquivo de entrada offline está presente e se ele tem entradas válidas. O USMT não encontrou um sistema operacional offline válido. Verifique o mapeamento de diretório offline. |
27: USMT_INVALID_STORE_LOCATION
- Categoria: Configuração e Inicialização
| Mensagem de erro | Solução de problemas, mitigação, soluções alternativas |
|---|---|
| Um caminho de repositório não pode ser usado porque existe um repositório existente; especificar /o para substituir | Especifique /o para substituir um repositório de migração ou intermediário existente. |
| Um caminho de armazenamento está ausente ou tem dados incompletos | Verifique se o caminho do repositório está acessível e se os níveis de permissão adequados estão definidos. |
| Ocorreu um erro durante a criação do repositório | Verifique se o caminho do repositório está 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 está acessível e se os níveis de permissão adequados estão definidos. |
| Caminho do repositório inválido; marcar o parâmetro de armazenamento e/ou permissões do sistema de arquivos | Caminho do repositório inválido; marcar o parâmetro de armazenamento e/ou as permissões do sistema de arquivos. |
| O layout do arquivo e/ou o conteúdo do arquivo não são reconhecidos como um repositório válido | Verifique se o caminho do repositório está 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 mantém um repositório incompatível com a versão atual do USMT | Verifique se o caminho do repositório está acessível e se os níveis de permissão adequados estão definidos. |
| O local de salvamento da loja é somente leitura ou não dá suporte a uma opção de armazenamento solicitada | Verifique se o caminho do repositório está acessível e se os níveis de permissão adequados estão definidos. |
28: USMT_UNABLE_GET_SCRIPTFILES
- Categoria: Configuração e Inicialização
| Mensagem de erro | Solução de problemas, mitigação, soluções alternativas |
|---|---|
| O arquivo script é inválido para /i | Verifique todos os arquivos de .xml de migração especificados em busca de erros. Esse erro é comum ao usar /i para carregar o arquivo Config.xml . |
| Não é possível encontrar um arquivo de script especificado por /i | Verifique o local dos arquivos de script e verifique se as opções de linha de comando estão corretas. |
29: USMT_FAILED_MIGSTARTUP
- Categoria: Configuração e Inicialização
| Mensagem de erro | Solução de problemas, mitigação, soluções alternativas |
|---|---|
| Um mínimo de 250 MB de espaço livre é necessário para arquivos temporários | Verifique se o sistema atende ao requisito mínimo de espaço em disco temporário de 250 MB. Como solução alternativa, você pode definir a variável USMT_WORKING_DIR=<path> de ambiente para redirecionar o diretório de trabalho de arquivos temporários. |
| Outro processo é impedir a migração; apenas uma ferramenta de migração pode ser executada por vez | Verifique o arquivo de log ScanState para obter erros de arquivo .xml migração. |
| Falha ao iniciar main processamento, procure no log erros do sistema ou marcar a instalação | Verifique o arquivo de log ScanState para obter erros de arquivo .xml migração. |
| Falha na migração devido a um erro XML; procure no log para obter detalhes específicos | Verifique o arquivo de log ScanState para obter erros de arquivo .xml migração. |
| Não é possível mapear automaticamente as letras da unidade para corresponder ao layout da letra da unidade online; Usar /offline para fornecer uma tabela de mapeamento | Verifique o arquivo de log ScanState para obter erros de arquivo .xml migração. |
31: USMT_UNABLE_FINDMIGUNITS
- Categoria: Configuração e Inicialização
| Mensagem de erro | Solução de problemas, mitigação, soluções alternativas |
|---|---|
| Ocorreu um erro durante a fase de descoberta; o log deve ter informações mais específicas | Verifique o arquivo de log ScanState para obter erros de arquivo .xml migração. |
32: USMT_FAILED_SETMIGRATIONTYPE
- Categoria: Configuração e Inicialização
| Mensagem de erro | Solução de problemas, mitigação, soluções alternativas |
|---|---|
| Ocorreu um erro ao processar o sistema de migração | Verifique o arquivo de log ScanState para obter erros de arquivo .xml migração ou use ajuda online digitando /? na linha de comando. |
33: USMT_UNABLE_READKEY
- Categoria: Configuração e Inicialização
| Mensagem de erro | Solução de problemas, mitigação, soluções alternativas |
|---|---|
| Erro ao acessar o arquivo especificado pelo parâmetro /keyfile | Verifique o arquivo de log ScanState para obter erros de arquivo .xml migração ou use ajuda online digitando /? na linha de comando. |
| A chave de criptografia deve ter pelo menos um caractere | Verifique o arquivo de log ScanState para obter erros de arquivo .xml migração ou use ajuda online digitando /? na linha de comando. |
34: USMT_ERROR_INSUFFICIENT_RIGHTS
- Categoria: Configuração e Inicialização
| Mensagem de erro | Solução de problemas, mitigação, soluções alternativas |
|---|---|
| A remoção de diretório requer privilégios elevados | Entre como Administrador e execute com privilégios elevados. |
| Não há direitos para criar perfis de usuário; fazer logon como Administrador; executar com privilégios elevados | Entre como Administrador e execute com privilégios elevados. |
| Nenhum direito de ler ou excluir perfis de usuário; faça logon como Administrador, execute com privilégios elevados | Entre como Administrador e execute com privilégios elevados. |
35: USMT_UNABLE_DELETE_STORE
- Categoria: Configuração e Inicialização
| Mensagem de erro | Solução de problemas, mitigação, soluções alternativas |
|---|---|
| Uma reinicialização é necessária para remover o repositório | Reinicialize para excluir todos os arquivos que não puderam ser excluídos quando o comando foi executado. |
| Um caminho de armazenamento não pode ser usado porque contém dados que não puderam ser substituídos | Um repositório de migração não pôde ser excluído. Se você estiver usando um repositório de migração de hardlink, talvez tenha um arquivo bloqueado nele. Você deve excluir manualmente o repositório ou usar UsmtUtils.exe /rd o comando para excluir o repositório. |
| Houve um erro ao remover o repositório | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. |
36: USMT_ERROR_UNSUPPORTED_PLATFORM
- Categoria: Configuração e Inicialização
| Mensagem de erro | Solução de problemas, mitigação, soluções alternativas |
|---|---|
| Falha marcar de conformidade; marcar os logs para obter detalhes | Investigue se há um perfil temporário ativo no sistema. |
| Não há suporte para o uso de /offline durante a aplicação | O /offline comando não foi usado durante a execução no WinPE (Ambiente de Pré-instalação do Windows). |
| Usar /offline para executar a coleta nesta plataforma | O /offline comando não foi usado durante a execução no WinPE. |
37: USMT_ERROR_NO_INVALID_KEY
- Categoria: Configuração e Inicialização
| Mensagem de erro | Solução de problemas, mitigação, soluções alternativas |
|---|---|
| O repositório contém dados criptografados, mas a chave de criptografia correta não foi fornecida | Verifique se a chave de criptografia ou o arquivo de chave correto foi incluído com a opção /key ou /keyfile . |
38: USMT_ERROR_CORRUPTED_NOTENCRYPTED_STORE
- Categoria: Configuração e Inicialização
| Mensagem de erro | Solução de problemas, mitigação, soluções alternativas |
|---|---|
| Ocorreu um erro durante o acesso ao repositório | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. Verifique se o caminho do repositório está acessível e se os níveis de permissão adequados estão definidos. |
39: USMT_UNABLE_TO_READ_CONFIG_FILE
- Categoria: Configuração e Inicialização
| Mensagem de erro | Solução de problemas, mitigação, soluções alternativas |
|---|---|
| Leitura de erro Config.xml | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando no arquivo Config.xml . |
| O argumento do arquivo é inválido para /config | Verifique a linha de comando usada para carregar o arquivo Config.xml . Você pode usar ajuda online digitando /? na linha de comando. |
40: USMT_ERROR_UNABLE_CREATE_PROGRESS_LOG
- Categoria: Configuração e Inicialização
| Mensagem de erro | Solução de problemas, mitigação, soluções alternativas |
|---|---|
| Gravação de erro no log de progresso | O log progress não pôde ser criado. Verifique se o local é válido e se você tem acesso à gravação. |
| O argumento de log de progresso é inválido para /progress | O log progress não pôde ser criado. Verifique se o local é válido e se você tem acesso à gravação. |
41: USMT_PREFLIGHT_FILE_CREATION_FAILED
- Categoria: Configuração e Inicialização
| Mensagem de erro | Solução de problemas, mitigação, soluções alternativas |
|---|---|
| Não é possível substituir o arquivo existente | O log progress não pôde ser criado. Verifique se o local é válido e se você tem acesso à gravação. |
| Caminho de estimativa de espaço inválido. Verifique os parâmetros e/ou permissões do sistema de arquivos | Examine o log do ScanState ou o log do LoadState para obter detalhes sobre erros de linha de comando. |
42: USMT_ERROR_CORRUPTED_STORE
- Categoria:
| Mensagem de erro | O repositório contém um ou mais arquivos corrompidos |
|---|---|
| O repositório contém dados criptografados, mas a chave de criptografia correta não foi fornecida | Examine o log do UsmtUtils para obter detalhes sobre os arquivos corrompidos. Para obter informações sobre como extrair os arquivos que não estão corrompidos, consulte Extrair arquivos de um repositório de migração do USMT compactado. |
61: USMT_MIGRATION_STOPPED_NONFATAL
- Categoria: Erros não fatais
| Mensagem de erro | O repositório contém um ou mais arquivos corrompidos |
|---|---|
| O processamento foi interrompido devido a um erro de E/S | O USMT saiu, mas pode continuar com a opção /c de linha de comando, com a seção ErrorControl> configurável< opcional ou usando a opção /vsc de linha de comando. |
71: USMT_INIT_OPERATING_ENVIRONMENT_FAILED
- Categoria: Erros fatais
| Mensagem de erro | Solução de problemas, mitigação, soluções alternativas |
|---|---|
| Ocorreu um erro de API do Windows Win32 | A transferência de dados foi iniciada e houve um erro durante a criação do repositório de migração ou durante a fase de aplicação. Examine o log ScanState ou o log loadstate para obter detalhes. |
| Ocorreu um erro ao tentar inicializar os mecanismos de diagnóstico, como o log | A transferência de dados foi iniciada e houve um erro durante a criação do repositório de migração ou durante a fase de aplicação. Examine o log ScanState ou o log loadstate para obter detalhes. |
| Falha ao registrar informações de diagnóstico | A transferência de dados foi iniciada e houve um erro durante a criação do repositório de migração ou durante a fase de aplicação. Examine o log ScanState ou o log loadstate para obter detalhes. |
| Não é possível iniciar. Verifique se você está executando o USMT com privilégios elevados | Saia do USMT e entre novamente com privilégios elevados. |
72: USMT_UNABLE_DOMIGRATION
- Categoria: Erros fatais
| Mensagem de erro | Solução de problemas, mitigação, soluções alternativas |
|---|---|
| Ocorreu um erro ao fechar o repositório | A transferência de dados foi iniciada e houve um erro durante a criação do repositório de migração ou durante a fase de aplicação. Examine o log ScanState ou o log loadstate para obter detalhes. |
| Ocorreu um erro no processo de aplicação | A transferência de dados foi iniciada e houve um erro durante a criação do repositório de migração ou durante a fase de aplicação. Examine o log ScanState ou o log loadstate para obter detalhes. |
| Ocorreu um erro no processo de coleta | A transferência de dados foi iniciada e houve um erro durante a criação do repositório de migração ou durante a fase de aplicação. Examine o log ScanState ou o log loadstate para obter detalhes. |
| Espaço fora do disco durante a gravação do repositório | A transferência de dados foi iniciada e houve um erro durante a criação do repositório de migração ou durante a fase de aplicação. Examine o log ScanState ou o log loadstate para obter detalhes. |
| Espaço em disco temporário no sistema local | A transferência de dados foi iniciada e houve um erro durante a criação do repositório de migração ou durante a fase de aplicação. Examine o log ScanState ou o log loadstate para obter detalhes. |
Coleta de dados
Se você precisar de ajuda do suporte da Microsoft, recomendamos coletar as informações seguindo as etapas mencionadas em Coletar informações usando o TSS para problemas relacionados à implantação.
Artigos relacionados
Solução de problemas da USMT (Ferramenta de Migração de Estado do Usuário)