Códigos de retorno da USMT (Ferramenta de Migração de Estado do Usuário)
Este artigo descreve os códigos de retorno e as mensagens de erro da USMT 10.0. Também está incluída uma tabela listando os códigos de retorno da USMT com suas etapas de mitigação associadas. Além disso, este artigo fornece dicas para ajudá-lo a usar os arquivos de log para determinar por que você recebeu um erro.
Compreender os requisitos para executar a USMT pode ajudar a minimizar erros em suas migrações da USMT. Para obter mais informações, consulte Requisitos da USMT.
Códigos de retorno usados pela USMT
Se você encontrar um erro na migração da USMT, poderá usar códigos de retorno e as informações mais específicas fornecidas nas mensagens de erro da USMT associadas para solucionar o 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 do usuário
Linhas de comando inválidas
Configuração e inicialização
Erros não fatais
Erros fatais
Como prática recomendada, recomendamos que você defina o nível de detalhamento como 5, v:5, nas linhas de comando ScanState.exe, LoadState.exe e UsmtUtils.exe para que os relatórios mais detalhados estejam disponíveis nos respectivos logs da USMT. Você pode usar um nível de detalhamento mais alto se quiser que a saída dos arquivos de log vá para um depurador.
Mensagens de erro da 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 diz /key e /keyfile, ambos 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 de sistema Windows listados digitando em uma janela net.exe helpmsg <error_number> de prompt de comando onde <error_number> é o número do 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 de retorno 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 | ND |
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 | ND |
2: USMT_STATUS_CANCELED
- Categoria: Sucesso ou Cancelamento de Usuário
| Mensagem de erro | Solução de problemas, mitigação, soluções alternativas |
|---|---|
| O Gather foi abortado por causa de um arquivo EFS | ND |
| O usuário optou por cancelar (como pressionar CTRL+C) | ND |
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 |
|---|---|
| /todos os conflitos com /ui, /ue ou /uel | Examine o log ScanState ou o log LoadState para obter detalhes sobre erros de linha de comando. |
| /auto espera um parâmetro opcional para a pasta de script | Examine o log ScanState ou o log LoadState para obter detalhes sobre erros de linha de comando. |
| /encrypt não pode ser usado com /nocompress | Examine o log ScanState ou o log LoadState para obter detalhes sobre erros de linha de comando. |
| /encrypt requer /key ou /keyfile | Examine o log ScanState ou o log 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 ScanState ou o log 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 ScanState ou o log LoadState para obter detalhes sobre erros de linha de comando. |
| /hardlink requer /nocompress | Examine o log ScanState ou o log LoadState para obter detalhes sobre erros de linha de comando. |
| /key e /keyfile ambos especificados | Examine o log ScanState ou o log LoadState para obter detalhes sobre erros de linha de comando. |
| /key ou /keyfile usado sem habilitar a criptografia | Examine o log ScanState ou o log LoadState para obter detalhes sobre erros de linha de comando. |
| /lae é usado apenas com /lac | Examine o log ScanState ou o log LoadState para obter detalhes sobre erros de linha de comando. |
| /listfiles não pode ser usado com /p | Examine o log ScanState ou o log 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 ScanState ou o log LoadState para obter detalhes sobre erros de linha de comando. |
| /offlinewindir requer um caminho válido para a pasta offline do Windows | Examine o log ScanState ou o log LoadState para obter detalhes sobre erros de linha de comando. |
| /offlinewinold requer um caminho válido para a pasta offline do Windows | Examine o log ScanState ou o log 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 ScanState ou o log LoadState para obter detalhes sobre erros de linha de comando. |
| Uma opção é especificada mais de uma vez e é ambígua | Examine o log ScanState ou o log 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 detalhamento de log mais alto. Opções como /all, /ui, /ue, /v não são permitidas. | Examine o log ScanState ou o log 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 ScanState ou o log LoadState para obter detalhes sobre erros de linha de comando. |
| A opção de linha de comando não é válida | Examine o log ScanState ou o log LoadState para obter detalhes sobre erros de linha de comando. |
| O parâmetro EFS especificado não é válido para /efs | Examine o log ScanState ou o log LoadState para obter detalhes sobre erros de linha de comando. |
| O argumento do arquivo é inválido para /genconfig | Examine o log ScanState ou o log LoadState para obter detalhes sobre erros de linha de comando. |
| O argumento de arquivo é inválido para /genmigxml | Examine o log ScanState ou o log 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 ScanState ou o log LoadState para obter detalhes sobre erros de linha de comando. |
| O argumento de caminho do arquivo de lista é inválido para /listfiles | Examine o log ScanState ou o log LoadState para obter detalhes sobre erros de linha de comando. |
| O argumento de repetição deve ser um número inteiro | Examine o log ScanState ou o log LoadState para obter detalhes sobre erros de linha de comando. |
| O argumento de armazenamento de configurações especificado é inválido | Examine o log ScanState ou o log 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. |
| O algoritmo de criptografia especificado não é suportado | Examine o log ScanState ou o log LoadState para obter detalhes sobre erros de linha de comando. |
| O /efs:hardlink requer /hardlink | Examine o log ScanState ou o log 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 ScanState ou o log LoadState para obter detalhes sobre erros de linha de comando. |
| O parâmetro store é obrigatório, mas não especificado | Examine o log ScanState ou o log 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 ScanState ou o log LoadState para obter detalhes sobre erros de linha de comando. |
| O mapeamento de conta de usuário de origem para destino é inválido para /mu | Examine o log ScanState ou o log LoadState para obter detalhes sobre erros de linha de comando. |
| Opção de linha de comando indefinida ou incompleta | Examine o log ScanState ou o log 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 de repositório compactado | Examine o log ScanState ou o log LoadState para obter detalhes sobre erros de linha de comando. |
| O argumento de exclusão do usuário é inválido | Examine o log ScanState ou o log LoadState para obter detalhes sobre erros de linha de comando. |
| O nível de detalhamento deve ser especificado como uma soma das opções de log desejadas: Detalhado (0x01), Objetos de Registro (0x04), Eco para depurar a porta (0x08) | Examine o log ScanState ou o log LoadState para obter detalhes sobre erros de linha de comando. |
| O recurso de cópia de sombra de volume não é compatível com um repositório de links físicos | Examine o log ScanState ou o log LoadState para obter detalhes sobre erros de linha de comando. |
| O argumento de atraso de espera deve ser um número inteiro | Examine o log ScanState ou o log 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 da linha de comando não podem exceder 256 caracteres | Examine o log ScanState ou o log 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 ScanState ou o log 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 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, 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 é 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 desse arquivo é válido. |
| Mau funcionamento do software ou exceção desconhecida | 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 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. A USMT não conseguiu encontrar 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; especifique /o para substituir | Especifique /o para substituir um repositório intermediário ou de migração 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 da loja | 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 intermediário ou de migração existente. |
| Um dispositivo inadequado, como um disquete, foi especificado para o armazenamento | Verifique se o caminho do repositório está acessível e se os níveis de permissão adequados estão definidos. |
| Caminho de armazenamento inválido; Verifique o parâmetro de armazenamento e/ou as permissões do sistema de arquivos | Caminho de armazenamento inválido; Verifique 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 é reconhecido 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 intermediário ou de migração existente. |
| O caminho do repositório contém um repositório incompatível com a versão atual da 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 oferece 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 de script é inválido para /i | Verifique se há erros em todos os arquivos de .xml de migração especificados. Esse erro é comum ao usar /i para carregar o arquivo Config.xml . |
| Não é possível localizar 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 |
|---|---|
| É necessário um mínimo de 250 MB de espaço livre 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 dos arquivos temporários. |
| Outro processo é impedir a migração; Apenas uma ferramenta de migração pode ser executada por vez | Verifique se há erros de migração no arquivo de log do ScanState .xml arquivo. |
| Falha ao iniciar o processamento principal, procure no log por erros do sistema ou verifique a instalação | Verifique se há erros de migração no arquivo de log do ScanState .xml arquivo. |
| A migração falhou devido a um erro de XML; Procure no log para obter detalhes específicos | Verifique se há erros de migração no arquivo de log do ScanState .xml arquivo. |
| Não é possível mapear automaticamente as letras da unidade para corresponder ao layout da letra da unidade online; Use /offline para fornecer uma tabela de mapeamento | Verifique se há erros de migração no arquivo de log do ScanState .xml arquivo. |
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 se há erros de migração no arquivo de log do ScanState .xml arquivo. |
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 se há erros de migração no arquivo de log do ScanState .xml ou use a 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 se há erros de migração no arquivo de log do ScanState .xml ou use a Ajuda online digitando /? na linha de comando. |
| A chave de criptografia deve ter pelo menos um caractere | Verifique se há erros de migração no arquivo de log do ScanState .xml ou use a 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 do diretório requer privilégios elevados | Entre como administrador e execute com privilégios elevados. |
| Sem direitos para criar perfis de usuário; faça login como Administrador; Executar com privilégios elevados | Entre como administrador e execute com privilégios elevados. |
| Sem direitos de leitura ou exclusão de perfis de usuário; faça login 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 armazenamento | 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 | Não foi possível excluir um repositório de migração. Se você estiver usando um repositório de migração de hardlink, poderá ter um arquivo bloqueado nele. Você deve excluir manualmente o repositório ou usar UsmtUtils.exe /rd o comando para excluir o repositório. |
| Ocorreu um erro ao remover a loja | Examine o log ScanState ou o log 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 na verificação de conformidade; Por favor, verifique os logs para obter detalhes | Investigue se há um perfil temporário ativo no sistema. |
| O uso de /offline não é suportado durante a aplicação | O /offline comando não foi usado durante a execução no WinPE (Ambiente de Pré-Instalação do Windows). |
| Use /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-chave correto foi incluído na /key opção 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 à loja | Examine o log ScanState ou o log 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 |
|---|---|
| Erro ao ler 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 a 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 |
|---|---|
| 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. |
| 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
- 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 | Não foi possível criar o log de progresso. Verifique se o local é válido e se você tem acesso de 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 ScanState ou o log 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 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 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 | A USMT saiu, mas pode continuar com a /c opção de linha de comando, com a seção ErrorControl> configurável <opcional ou usando a /vsc opção 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 a USMT com privilégios elevados | Saia da 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 a loja | 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. |
| Sem espaço em disco durante a gravação do armazenamento | 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. |
| Sem 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)