Compartilhar via

Problemas comuns da USMT (Ferramenta de Migração de Estado do Usuário)

  • Artigo

As seções a seguir discutem problemas comuns que você pode ver ao executar as ferramentas da USMT 10.0. A USMT produz arquivos de log que descrevem com mais detalhes quaisquer erros ocorridos durante o processo de migração. Esses logs podem ser usados para solucionar problemas de falhas de migração.

Diretrizes gerais para identificar problemas de migração

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

  • Examine os logs ScanState, LoadState e UsmtUtils para obter as mensagens de erro USMT exatas e as mensagens de erro da API (interface de programação de aplicativo) do Windows®. Para obter mais informações sobre códigos de retorno e mensagens de erro da USMT, consulte Códigos de retorno. 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).

    Na maioria dos casos, os logs ScanState e LoadState indicam por que uma migração da USMT está falhando. Recomendamos que você use a /v:5 opção ao testar sua migração. Esse nível de detalhamento pode ser ajustado em uma migração de produção; No entanto, reduzir o nível de detalhamento pode dificultar o diagnóstico de falhas encontradas durante as migrações de produção. Você pode usar um nível de detalhamento superior a 5 se quiser que a saída dos arquivos de log vá para um depurador.

    Observação

    A execução das ferramentas ScanState e LoadState com a /v:5 opção cria um arquivo de log detalhado. Embora essa opção torne o arquivo de log grande, os detalhes extras podem ajudá-lo a determinar onde ocorreram os erros de migração.

  • Use a /Verify opção com a ferramenta UsmtUtils para determinar se algum arquivo em um repositório de migração compactado está corrompido. Para obter mais informações, consulte Verificar a condição de um repositório de migração compactado.

  • Use a /Extract opção com a ferramenta UsmtUtils para extrair arquivos de um repositório de migração compactado. Para obter mais informações, consulte Extrair arquivos de um repositório de migração USMT compactado.

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

  • Para os computadores de origem e destino, obtenha informações do sistema operacional e versões de aplicativos como o Internet Explorer e quaisquer outros programas relevantes. Em seguida, verifique as etapas exatas necessárias para reproduzir o problema. Essas informações podem ajudá-lo a entender o que está errado e a reproduzir o problema em seu ambiente de teste.

  • Saia depois de executar a ferramenta LoadState . Algumas configurações, como fontes, planos de fundo da área de trabalho e configurações de proteção de tela, não entrarão em vigor até a 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 ScanState ou LoadState, a USMT poderá não migrar alguns dados. Por exemplo, se o Microsoft Outlook® estiver aberto, a USMT pode não migrar arquivos PST.

    Observação

    A USMT falhará se não puder migrar um arquivo ou configuração, a menos que você especifique a /c opção. Quando você especifica a opção, a /c USMT ignora os erros. No entanto, ele registra um erro quando encontra um arquivo que está em uso e que não foi migrado.

Problemas com a conta do usuário

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

Estou tendo problemas para criar contas locais no computador de destino

Resolução: para obter mais informações sobre como criar contas e migrar contas locais, consulte Migrar contas de usuário.

Nem todas as contas de usuário foram migradas para o computador de destino

Causas/Resoluções Existem duas causas possíveis para este problema:

Ao executar as ferramentas ScanState e LoadState no Windows 7, Windows 8 ou Windows 10, você deve executá-las no modo Administrador de uma conta com credenciais administrativas para garantir que todos os usuários especificados sejam migrados. Para executar no modo de administrador:

  1. Selecione Iniciar>todos os acessórios de programas>.

  2. Clique com o botão direito do mouse em Prompt de Comando.

  3. Selecione Executar como administrador.

  4. Especifique o comando LoadState.exe ou ScanState.exe .

Se você não executar a USMT no modo Administrador, somente o perfil de usuário conectado será incluído na migração.

Todas as contas de usuário no computador que não foram usadas não serão migradas. Por exemplo, se você adicionar o Usuário1 ao computador, mas o Usuário1 nunca fizer logon, a USMT não migrará a conta do Usuário1.

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

Causa: o comando que você especificou pode ter opções conflitantes e /ue conflitantesui. Se um usuário for especificado com a /ui opção e com as /ue opções ou /uel ao mesmo tempo, o usuário será incluído na migração. Por exemplo, se você especificar /ui:domain1\* /ue:domain1\user1, User1 será migrado porque a /ui opção tem precedência.

Resolução: para obter mais informações sobre como usar as /ui opções e /ue juntas, consulte os exemplos no artigo Sintaxe do ScanState.

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

Causa: A /uel opção depende da data da última modificação do arquivo NTUser.dat dos usuários. Há cenários em que essa data da última modificação pode não corresponder à data da última entrada dos usuários.

Resolução: essa é uma limitação da /uel opção. Talvez seja necessário excluir esses usuários manualmente com a /ue opção.

A ferramenta LoadState relata 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 perfis de usuário para testar a ferramenta LoadState no mesmo computador, poderá ter uma chave conflitante presente no Registro. Usar o comando net use para remover um perfil de usuário excluirá pastas e arquivos associados a esse perfil, mas não removerá a chave do Registro.

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

  1. Abra o editor de registro digitando regedit.exe em um prompt de comando 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 de identificador do sistema em ProfileList.

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

Os arquivos que não foram criptografados antes da migração agora são criptografados com a conta usada para executar a ferramenta LoadState

Causa: a ferramenta ScanState foi executada usando a /EFS:copyraw opção de migrar arquivos criptografados e certificados EFS (Sistema de Arquivos com Criptografia). O atributo de criptografia foi definido em uma pasta que foi migrada, mas o atributo foi removido do conteúdo do arquivo dessa pasta antes da migração.

Resolução: antes de usar a ferramenta ScanState para uma migração que inclui 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. Você deve remover o atributo de criptografia de pastas que contêm arquivos não criptografados ou criptografar o conteúdo de todos os arquivos dentro de uma pasta criptografada.

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

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

Causa: o nome do computador foi alterado durante uma migração offline de um perfil de usuário local.

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

LoadState.exe  /i:MigApp.xml /i:MigDocs.xml \\server\share\migration\mystore 
/progress:Progress.log /l:LoadState.log /mu:fareast\user1:farwest\user1

Problemas de linha de comando

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

Recebi a seguinte mensagem de erro: "Erro de uso: não é possível especificar um caminho de arquivo com nenhuma das opções de linha de comando que exceda 256 caracteres".

Causa: você pode receber essa mensagem de erro em alguns casos, mesmo que não especifique um repositório longo ou um caminho de arquivo, pois o comprimento do caminho é calculado com base no caminho absoluto. Por exemplo, se você executar o **ScanState**.exe /o store comando de C:\Arquivos de Programas\USMT40, cada caractere em C:\Arquivos de Programas\USMT40 será adicionado ao comprimento de "store" para obter o comprimento do caminho.

Resolução: verifique se o comprimento total do caminho não excede 256 caracteres. O comprimento total do caminho inclui o caminho do armazenamento mais o diretório atual.

Recebi a seguinte mensagem de erro: "A USMT não pôde criar o(s) arquivo(s) de log. Certifique-se de ter acesso de gravação ao diretório de log."

Causa: se você estiver executando as ferramentas ScanState ou LoadState de um recurso de rede compartilhado, receberá essa mensagem de erro se não especificar /l.

Resolução: para corrigir esse problema nesse cenário, especifique a /l:ScanState.log opção ou /l:LoadState.log .

Problemas de arquivo XML

As seções a seguir descrevem problemas comuns de arquivos XML. Expanda a seção para ver as soluções recomendadas.

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

Causa: Config.xml conterá apenas componentes do sistema operacional, aplicativos e as seções de documentos do usuário que estão em ambos os arquivos .xml e são instalados no computador quando você executa a /genconfig opção. Caso contrário, esses aplicativos e componentes não aparecerão no arquivo Config.xml .

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

ScanState.exe /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 arquivo de esquema XML MigXML.xsd em sua ferramenta de criação XML. MigXML.xsd está incluído no USMT. Para obter exemplos, consulte o Centro de Desenvolvimento do Visual Studio. Em seguida, carregue o arquivo .xml na ferramenta de criação para ver se há um erro de sintaxe. Para obter mais informações sobre como usar os elementos XML, consulte Referência XML da USMT.

Estou usando uma função auxiliar MigXML, mas a migração não está funcionando da maneira que eu esperava. Como faço para solucionar esse problema?

Causa: Normalmente, esse problema é causado por sintaxe incorreta usada em uma função auxiliar. Você recebe um código de retorno de sucesso, mas os arquivos que você deseja migrar não foram coletados ou aplicados, ou não foram coletados ou aplicados da maneira esperada.

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

Problemas de migração

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

Os arquivos que especifiquei para excluir ainda estão sendo migrados

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

Resolução: para obter mais informações, consulte Conflitos e precedência e a seção Log de diagnóstico em Arquivos de log.

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

Causa: pode haver um erro na sintaxe XML.

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

Conflitos e precedência

Excluir arquivos e configurações

Redirecionar arquivos e configurações

Incluir arquivos e configurações

Exemplos de XML personalizados

Após a conclusão do LoadState, o novo plano de fundo da área de trabalho não aparece no computador de destino

Existem três causas típicas para esse problema.

Causa: algumas configurações, como fontes, planos de fundo da área de trabalho e configurações de proteção de tela, não são aplicadas pelo LoadState até que o computador de destino seja reiniciado.

Resolução: para corrigir esse problema, saia e faça logon novamente para ver o plano de fundo da área de trabalho migrado.

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

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

Resolução: para migrar arquivos PST que não estão vinculados a perfis do Outlook, você deve criar uma regra de migração separada para capturar esses arquivos.

A USMT não migra o layout inicial

Descrição: você está usando a USMT para migrar perfis de uma instalação do Windows 10 para outra instalação do Windows 10 em hardware diferente. Após a migração, o usuário entra no novo dispositivo e não tem o layout do menu Iniciar configurado anteriormente.

Causa: uma alteração de código no Menu Iniciar com Windows 10 versão 1607 e posterior é incompatível com essa função USMT.

Resolução: a seguinte solução alternativa está disponível:

  1. Com o usuário conectado, faça backup do layout Iniciar usando o seguinte comando do Windows PowerShell. Você pode especificar um caminho diferente, se desejar:

    Export-StartLayout -Path "C:\Layout\user1.xml"

  2. Migre o perfil do usuário com a USMT.

  3. Antes de o usuário entrar no novo dispositivo, importe o layout Iniciar usando o seguinte comando do Windows PowerShell:

    Import-StartLayout -LayoutPath "C:\Layout\user1.xml" -MountPath %systemdrive%

Essa solução alternativa altera o layout inicial do usuário padrão. A solução alternativa não é dimensionada para migrações em massa ou dispositivos multiusuário, mas pode desbloquear alguns cenários. Se outros usuários entrarem no dispositivo, você deverá excluí layoutmodification.xml do perfil de usuário padrão. Caso contrário, todos os usuários que entrarem nesse dispositivo usarão o layout Iniciar importado.

Problemas de migração offline

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

Algumas das configurações do meu sistema não são migradas em uma migração offline

Causa: algumas configurações do sistema, como planos de fundo da área de trabalho e impressoras de rede, não têm suporte em uma migração offline. Para obter mais informações, consulte O que a USMT migra?

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

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

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

Resolução: você pode reinicializar o computador para se livrar do perfil temporário ou pode 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 migração de perfis de usuário não funcionam da mesma forma offline e online

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

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

ScanState.exe /ui:S1-5-21-124525095-708259637-1543119021*

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

Você também pode usar padrões para SIDs que identificam usuários ou grupos genéricos. Por exemplo, você pode usar a /ue:*-500 opção para excluir as contas de administrador local. Para obter mais informações sobre SIDs do Windows, consulte Identificadores de segurança.

Meu script para limpar 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 termina de ser executada.

Resolução: reinicialize o computador ou descarregue o hive do Registro no prompt de comando depois que a ferramenta ScanState terminar de ser executada. Por exemplo, em um prompt de comando, insira:

reg.exe unload hklm\$dest$software

As seções a seguir descrevem problemas comuns de migração de link rígido. 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 /efs:hardlink opção de linha de comando só é aplicável a arquivos migrados na mesma partição.

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

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

Resolução: use a ferramenta UsmtUtils para excluir a loja ou alterar o nome da loja. Por exemplo, em um prompt de comando, insira:

UsmtUtils.exe /rd <storedir>

Você também deve reiniciar a máquina.

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.

Solução de problemas da USMT (Ferramenta de Migração de Estado do Usuário)

Perguntas frequentes

Códigos de retorno

Sintaxe UsmtUtils