Problemas mais comuns

As seções a seguir descrevem os problemas mais comuns que podem surgir quando você executa as ferramentas da USMT (Ferramenta de Migração de Estado do Usuário) 5.0. A USMT gera arquivos de log que descrevem detalhadamente os erros ocorridos durante o processo de migração. Esses logs podem ser usados para solucionar falhas na migração.

Neste tópico

Problemas com contas de usuário

Problemas com linhas de comando

Problemas com o arquivo XML

Problemas com migração

Problemas com migração offline

Problemas com migração de link físico

Diretrizes gerais para identificar problemas com migração

Ao encontrar um problema ou mensagem de erro durante a migração, você pode usar as seguintes diretrizes gerais para ajudá-lo a determinar a origem do problema:

  • Examine as atualizações de conteúdo no Guia do Usuário da USMT (Ferramenta de Migração de Estado do Usuário) 5.0 no TechNet.

  • Examine os logs de ScanState, LoadState e UsmtUtils para obter as mensagens de erro exatas da USMT e da API (interface de programação de aplicativo) do Windows®. Para saber mais sobre as mensagens de erro e os códigos de retorno da USMT , veja Códigos de retorno. Para saber mais sobre as mensagens de erro da API do Windows, digite net helpmsg na linha de comando.

    Na maioria dos casos, os logs de ScanState e LoadState indicam o motivo por que a USMT não está funcionando. Recomendamos que você use a opção /v*:5* ao testar sua migração. Esse nível de detalhamento pode ser ajustado em uma migração de produção, porém, a redução desse nível de detalhamento pode dificultar o diagnóstico das falhas encontradas durante as migrações de produção. Você poderá usar um nível de detalhamento superior a 5 se desejar que a saída dos arquivos de log seja direcionada para o depurador.

    Dica

    A execução das ferramentas ScanState e LoadState com a opção /v:5 cria um arquivo de log detalhado. Embora essa opção possa aumentar o tamanho do arquivo de log, os detalhes extras ajudam a determinar onde ocorreram os erros de migração.

  • Use a opção /verify da ferramenta UsmtUtils para determinar se algum arquivo de um repositório de migração compactado está corrompido. Para saber mais, veja Verificar a condição de um repositório de migração compactado.

  • Use a opção /extract da ferramenta UsmtUtils para extrair os arquivos de um repositório de migração compactado. Para saber mais, veja Extrair arquivos de um repositório de migração compactado da USMT.

  • Crie um log de andamento usando a opção /progress para monitorar sua migração.

  • No caso dos computadores de origem e destino, você deve obter informações sobre o sistema operacional e a versão dos aplicativos, como o Internet Explorer(R) e outros programas relevantes. Depois, verifique as etapas exatas que são necessárias para reproduzir o problema. Essas informações podem ajudá-lo a compreender melhor o que exatamente saiu errado e a reproduzir o problema no seu ambiente de teste.

  • Faça logoff depois de executar a LoadState. Algumas configurações (por exemplo, configurações de fonte, tela de fundo de área de trabalho e proteção de tela) só entrarão em vigor na próxima vez que o usuário final fizer logon.

  • Feche todos os aplicativos antes de executar as ferramentas ScanState ou LoadState. Se alguns aplicativos estiverem em execução durante o processo de ScanState ou LoadState, a USMT poderá não migrar alguns dados. Por exemplo, se o Microsoft Outlook® estiver aberto, a USMT poderá não migrar os arquivos .pst.

    Dica

    A USMT falhará se não puder migrar um arquivo ou uma configuração, a menos que você especifique a opção /c. Quando você especifica a opção /c, a USMT ignora os erros. Entretanto, ela registrará um erro sempre que encontrar um arquivo que está em uso e não foi migrado.

Problemas com contas de usuário

As seções a seguir descrevem os problemas mais comuns com contas de usuário. Expanda a seção para ver as soluções recomendadas.

Estou tendo problemas ao criar contas locais no computador de destino.

Resolução: para saber mais sobre a criação de contas e a migração de contas locais, veja Migrar contas de usuário.

Nenhuma das contas de usuário foi migrada para o computador de destino.

Causas/Resoluções: há duas causas possíveis para esse problema:

Ao executar a ferramenta ScanState no Windows Vista ou as ferramentas ScanState e LoadState no Windows 7 ou no Windows® 8, é preciso executá-las no modo Administrador usando uma conta com credenciais administrativas para garantir que todos os usuários especificados sejam migrados. Isso ocorre porque o UAC (Controle de Acesso de Usuário) está ativado no Windows Vista, Windows 7 e Windows 8. Para executar no modo Administrador:

  1. Clique em Iniciar.

  2. Clique em Todos os Programas.

  3. Clique em Acessórios.

  4. Clique com o botão direito do mouse no Prompt de Comando.

  5. Clique em Executar como administrador.

Depois, especifique o comando LoadState ou ScanState. Se você não executar a USMT no modo Administrador, somente o perfil do usuário conectado será incluído na migração.

Qualquer conta de usuário existente no computador, mas não usada, não será migrada. Por exemplo, se você adicionar User1 ao computador, mas User1 nunca fizer logon, a USMT não migrará a conta User1.

As contas de usuário excluídas foram migradas para o computador de destino.

Causa: o comando especificado provavelmente continha opções /ui e /ue conflitantes. Se um usuário for especificado com a opção /ui e também for especificado para exclusão com a opção /ue ou /uel, ele será incluído na migração. Por exemplo, se você especificar /ui:domain1\* /ue:domain1\user1, o User1 será migrado, pois /ui tem precedência.

Resolução: para saber mais sobre como usar as opções /ui e /ue juntas, veja os exemplos no tópico Sintaxe de ScanState.

Estou usando a opção /uel, mas muitas contas ainda estão sendo incluídas na migração.

Causa: a opção /uel depende da última data de modificação do arquivo NTUser.dat dos usuários. Há cenários em que essa última data de modificação talvez não corresponda à data do último logon dos usuários.

Resolução: esta é uma limitação da opção /uel. Você talvez precise excluir esses usuários manualmente com a opção /ue.

A ferramenta LoadState reporta um erro como código de retorno 71 e falha ao restaurar um perfil de usuário durante um teste de migração.

Causa: durante um teste de migração, se você executar a ferramenta ScanState no computador de teste e excluir os perfis de usuário para testar a ferramenta LoadState no mesmo computador, poderá ter uma chave conflitante presente no Registro. O uso do comando net use para remover um perfil de usuário excluirá as pastas e os arquivos associados àquele perfil, mas não removerá a chave do Registro.

Resolução: para excluir um perfil de usuário, use o item Contas de Usuários no Painel de Controle. Para corrigir uma exclusão incompleta de um perfil de usuário:

  1. Abra o editor do Registro digitando regedit em um prompt de comandos com privilégios elevados.

  2. Navegue até HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\ProfileList.

    Cada perfil de usuário é armazenado em uma chave do Identificador do Sistema em ProfileList.

  3. Exclua a chave do perfil do usuário que você está tentando remover.

Os arquivos que não estavam criptografados antes da migração, agora estão criptografados com a conta usada para executar a ferramenta LoadState.

Causa: a ferramenta ScanState foi executada com a opção /efs:copyraw para migrar os arquivos criptografados e os certificados EFS (Encrypting File System). O atributo de criptografia foi definido em uma pasta migrada, mas foi removido antes da migração.

Resolução: antes de usar a ferramenta ScanState para uma migração que inclua arquivos criptografados e certificados EFS, você pode executar a ferramenta Cipher no prompt de comando para revisar e alterar as configurações de criptografia em arquivos e pastas. Remova o atributo de criptografia das pastas que contêm os arquivos não criptografados ou criptografe o conteúdo de todos os arquivos de uma pasta criptografada.

Para você remover a criptografia de arquivos que já foram migrados incorretamente, faça logon no computador com a conta usada para executar a ferramenta LoadState e remova a criptografia dos arquivos afetados.

A ferramenta LoadState reporta um erro como código de retorno 71 e um Erro 2202 do Windows no arquivo de log.

Causa: o nome do PC foi mudado durante a migração offline de um perfil de usuário local.

Resolução: você pode usar a opção /mu ao executar a ferramenta LoadState para especificar um novo nome para o usuário. Por exemplo,

loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore 
/progress:prog.log /l:load.log /mu:fareast\user1:farwest\user1

Problemas com linhas de comando

As seções a seguir descrevem os problemas mais comuns com linhas de comando. Expanda a seção para ver as soluções recomendadas.

Recebi a mensagem de erro "Usage Error: You cannot specify a file path with any of the command-line options that exceeds 256 characters."

Causa: você pode receber essa mensagem de erro em alguns casos, mesmo se não especificar um caminho de arquivo ou de repositório muito extenso. Isso acontece porque o comprimento do caminho é calculado com base no caminho absoluto. Por exemplo, se você executar o comando scanstate.exe /o store em C:\Arquivos de Programas\USMT40, cada caractere em "C:\Program Files\USMT40" será adicionado ao comprimento de "store" para obter o comprimento do caminho.

Resolução: verifique se o comprimento do caminho (caminho do repositório mais o diretório atual) não excede 256 caracteres.

Recebi este erro: "USMT was unable to create the log file(s). Ensure that you have write access to the log directory."

Causa: se estiver executando as ferramentas ScanState ou LoadState com um recurso de rede compartilhado, esse erro será exibido caso você não especifique /l.

Resolução: para solucionar esse problema nesse cenário, especifique a opção /l:scan.log ou /l:load.log.

Problemas com o arquivo XML

As seções a seguir descrevem os problemas mais comuns com o arquivo XML. Expanda a seção para ver as soluções recomendadas.

Usei a opção /genconfig para criar um arquivo Config.xml, mas vejo apenas alguns aplicativos e componentes que estão no MigApp.xml. Por que o Config.xml não contém os mesmos aplicativos?

Causa: o Config.xml terá apenas os componentes de sistema operacional, os aplicativos e as seções de documento do usuário que estiverem em ambos os arquivos .xml e instalados no computador quando a opção /genconfig for executada. Caso contrário, esses aplicativos e componentes não serão exibidos no arquivo Config.xml.

Resolução: instale todos os aplicativos desejados no computador antes de executar a opção /genconfig. Depois, execute ScanState com todos os arquivos .xml. Por exemplo, execute o seguinte:

scanstate /genconfig:config.xml /i:migdocs.xml /i:migapp.xml /v:5 /l:scanstate.log

Estou tendo problemas com um arquivo .xml personalizado que criei e não consigo verificar se a sintaxe está correta.

Resolução: você pode carregar o esquema XML (MigXML.xsd), que acompanha a USMT, na sua ferramenta de criação de XML. Para obter exemplos, veja o Visual Studio Development Center. Depois, carregue o arquivo XML nessa ferramenta de criação para verificar se há algum erro de sintaxe. Além disso, veja Referência XML da USMT para saber mais sobre o uso de elementos .xml.

Estou usando uma função auxiliar do MigXML, mas a migração não está funcionando da maneira esperada.  Como soluciono esse problema?

Causa: esse problema normalmente é causado pelo uso de sintaxe incorreta em uma função auxiliar. Você recebe um código de retorno Sucesso, mas os arquivos que a serem migrados não foram coletados ou aplicados, ou essas ações não ocorreram da forma esperada.

Resolução: pesquise o log de ScanState ou de LoadState para obter o nome do componente que contém a função auxiliar do MigXML ou o título da função auxiliar do MigXML e, assim, localizar o aviso relacionado no arquivo de log.

Problemas com migração

As seções a seguir descrevem os problemas mais comuns com migração. Expanda a seção para ver as soluções recomendadas.

Os arquivos especificados para exclusão ainda estão sendo migrados.

Causa: deve haver outra regra que está incluindo os arquivos. Se houver uma regra mais específica ou conflitante, os arquivos serão incluídos na migração.

Resolução: para saber mais, veja Conflitos e precedência e a seção Log de diagnóstico em Arquivos de log.

Defini regras para mover uma pasta para um local específico no computador de destino, mas ela não foi migrada corretamente.

Causa: deve haver um erro na sintaxe do XML.

Resolução: você pode usar o esquema XML da USMT (MigXML.xsd) para gravar e validar arquivos .xml de migração. Veja também os exemplos de XML nos seguintes tópicos:

Conflitos e precedência

Excluir arquivos e configurações

Reencaminhar arquivos e configurações

Incluir arquivos e configurações

Exemplos de XML personalizados

Depois que a LoadState é concluída, a nova tela de fundo de área de trabalho não aparece no computador de destino.

Existem três causas comuns para esse problema.

Causa 1: algumas configurações, como fontes, telas de fundo da área de trabalho e proteção de tela, não são aplicadas pela LoadState enquanto o computador de destino não for reiniciado.

Resolução: para solucionar esse problema, faça logoff e depois faça logon novamente para ver a tela de fundo de área de trabalho migrada.

Causa 2: quando o computador de origem executa o Windows® XP, a tela de fundo de área de trabalho é armazenada na pasta Unidade:\WINDOWS\Web\Wallpaper (que é a pasta padrão onde a tela de fundo de área de trabalho é armazenada no Windows XP). Por isso, a tela de fundo de área de trabalho não é migrada. E o computador de destino exibe a tela de fundo padrão de área de trabalho do Windows® . Isso ocorre mesmo quando a tela de fundo de área de trabalho é uma imagem personalizada que foi adicionada à pasta \WINDOWS\Web\Wallpaper. Entretanto, se o usuário final definir como tela de fundo de área de trabalho uma imagem gravada em outro local (por exemplo, em Minhas Imagens), então ela será migrada.

Resolução: certifique-se de que as imagens da tela de fundo de área de trabalho que você deseja migrar não estão na pasta \WINDOWS\Web\Wallpaper do computador de origem.

Causa 3: quando a ScanState não é executada no Windows XP usando uma conta com credenciais administrativas, algumas configurações do sistema operacional não são migradas. Por exemplo, configurações de tela de fundo de área de trabalho, seleções de proteção de tela, opções de modem, configurações de media player e configurações e arquivos (.pbk) do catálogo telefônico de conexão do RAS (Serviço de Acesso Remoto) não serão migrados.

Resolução: execute as ferramentas ScanState e LoadState em uma conta com credenciais administrativas.

Incluí o MigApp.xml na migração, mas alguns arquivos .pst não estão migrando.

Causa: o arquivo MigApp.xml migra somente os arquivos PST vinculados aos perfis do Outlook.

Resolução: para migrar arquivos PST não vinculados aos perfis do Outlook, crie uma regra de migração separada para capturar esses arquivos.

Problemas com migração offline

As seções a seguir descrevem os problemas mais comuns com migração offline. Expanda a seção para ver as soluções recomendadas.

Algumas de minhas configurações do sistema não migram offline.

Causa: não há suporte para algumas configurações do sistema, como telas de fundo de área de trabalho e impressoras de rede, em uma migração offline. Para saber mais, veja O que a ferramenta de transferência do Windows migra?

Resolução: em uma migração offline, essas configurações do sistema devem ser restauradas manualmente.

A ferramenta ScanState falha com código de retorno 26.

Causa: uma causa comum de código de retorno 26 é um perfil temporário estar ativo no computador de origem. Esse perfil mapeia c:\users\temp. O log de ScanState mostra a exceção MigStartupOfflineCaught, que inclui a mensagem "Erro SID de duplicação de perfil de usuário".

Resolução: você pode reiniciar o computador para se livrar do perfil temporário ou definir MIG_FAIL_ON_PROFILE_ERROR=0 para ignorar o erro e excluir o perfil temporário.

As regras de inclusão e exclusão para migrar perfis de usuário não funcionam offline da mesma forma que online.

Causa: quando offline, o servidor DNS não pode ser consultado para solucionar o mapeamento de nome de usuário e SID.

Resolução: use um SID (Identificador de Segurança) para incluir um usuário ao executar a ferramenta ScanState. Por exemplo:

Scanstate /ui:S1-5-21-124525095-708259637-1543119021*

O caractere curinga (*) no final do SID também migrará a chave SID_Classes.

Também é possível usar padrões para os SIDs que identificam usuários ou grupos genéricos. Por exemplo, você pode usar a opção /ue:*-500 para excluir as contas locais de administrador. Para saber mais sobre os SIDs do Windows, visite este site da Microsoft.

Meu script para apagar o disco falha após a execução da ferramenta ScanState em um sistema de 64 bits.

Causa: o hive do Registro HKLM não é descarregado depois que a ferramenta ScanState conclui a execução.

Resolução: reinicie o computador ou descarregue o hive do registro no prompt de comando depois que a ferramenta ScanState concluir a execução. Por exemplo, em um prompt de comando, digite:

reg.exe unload hklm\$dest$software

As seções a seguir descrevem os problemas mais comuns com migração de link físico. Expanda a seção para ver as soluções recomendadas.

Os arquivos EFS não são restaurados para a nova partição.

Causa: os arquivos EFS não podem ser movidos para uma nova partição com um link físico. A opção de linha de comando /efs:hardlink é aplicável somente aos arquivos migrados na mesma partição.

Resolução: use a opção de linha de comando /efs:copyraw para copiar os arquivos EFS durante a migração em vez de criar links físicos ou copiar manualmente os arquivos EFS do repositório de links físicos.

Causa: o repositório de migração contém links físicos para arquivos bloqueados.

Resolução: use a ferramenta UsmtUtils para excluir o repositório ou mudar seu nome. Por exemplo, em um prompt de comando, digite:

USMTutils /rd <storedir>

Reinicie a máquina.

Consulte também

Outros Recursos

Ferramenta de Migração de Estado do Usuário (USMT)
Perguntas frequentes
Códigos de retorno
Sintaxe de UsmtUtils