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

Artigo
02/21/2024

As seções a seguir discutem problemas comuns que você pode ver ao executar as ferramentas USMT 10.0. O USMT produz arquivos de log que descrevem detalhadamente os 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 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 exatas do USMT e as mensagens de erro da API (interface de programação do aplicativo Windows®). Para obter mais informações sobre códigos de retorno do USMT e mensagens de erro, confira Retornar códigos. 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).

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

Observação

Executar as ferramentas ScanState e LoadState com a opção /v:5 cria um arquivo de log detalhado. Embora essa opção torne o arquivo de log grande, o detalhe extra pode ajudá-lo a determinar onde ocorreram erros de migração.
Use a opção /Verify com a ferramenta UsmtUtils para determinar se os arquivos em um repositório de migração compactado estão corrompidos. Para obter mais informações, consulte Verificar a condição de um repositório de migração compactado.
Use a opção /Extract 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 do USMT compactado.
Crie um log de progresso usando a opção /Progress para monitorar sua migração.
Para os computadores de origem e de destino, obtenha informações do sistema operacional e versões de aplicativos como 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 economia de tela, só entrarão em vigor na próxima vez em que o usuário final fizer logon.
Feche todos os aplicativos antes de executar ferramentas ScanState ou LoadState . Se alguns aplicativos estiverem em execução durante o processo ScanState ou LoadState , o USMT poderá não migrar alguns dados. Por exemplo, se o Microsoft Outlook® estiver aberto, o USMT poderá não migrar arquivos PST.

Observação

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

Problemas da conta de usuário

As seções a seguir descrevem problemas comuns da conta de usuário. Expanda a seção para ver 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 Há duas possíveis causas 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 ser executado no modo Administrador:

Selecione Iniciar>todos os acessórios de> programas.
Clique com o botão direito do mouse em Prompt de Comando.
Selecione Executar como administrador.
Especifique o comando LoadState.exe ou ScanState.exe .

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

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

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

Causa: O comando que você especificou pode ter tido opções e /ue conflitantesui. Se um usuário for especificado com a opção /ui 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, o User1 será migrado porque a opção /ui terá precedência.

Resolução: Para obter mais informações sobre como usar as /ui opções e /ue em conjunto, confira os exemplos no artigo Sintaxe 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 última data modificada do arquivo NTUser.dat dos usuários. Há cenários em que essa última data modificada pode não corresponder à última data de entrada dos usuários.

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

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 em seu computador de teste e excluir perfis de usuário para testar a ferramenta LoadState no mesmo computador, você 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:

Abra o editor do registro digitando regedit.exe em um prompt de comando elevado.
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.
Exclua a chave para o perfil de usuário que você está tentando remover.

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 opção /EFS:copyraw de migrar arquivos criptografados e certificados EFS (Sistema de Arquivos Criptografados). 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 do Windows 2202 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 opção /mu 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 soluções recomendadas.

Recebi a seguinte mensagem de erro: "Erro de uso: você não pode 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 longo caminho de armazenamento ou 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:\Program Files\USMT40, cada caractere em C:\Arquivos de Programa\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 repositório mais o diretório atual.

Recebi a seguinte mensagem de erro: "O USMT não pôde criar os arquivos de log. Verifique se você tem acesso de gravação ao diretório de log.".

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

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

Problemas de arquivo XML

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

Usei a opção `/genconfig` para 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 documento do usuário que estão em ambos os arquivos .xml e são instalados no computador quando você executa a opção /genconfig . 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 opção /genconfig . 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 de .xml personalizado que criei, e não posso 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 seu 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 do USMT.

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

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

Resolução: Você deve pesquisar no log ScanState ou LoadState 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 soluções recomendadas.

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

Causa: Pode haver outra regra que esteja incluindo 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 migrou corretamente

Causa: Pode haver um erro na sintaxe XML.

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

Conflitos e precedência

Excluir arquivos e configurações

Redirecionar arquivos e configurações

Incluir arquivos e configurações

Exemplos 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

Há 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 economia de tela, não são aplicadas pelo LoadState até que o computador de destino tenha sido reiniciado.

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

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

Causa: O arquivoMigApp.xml migra apenas os arquivos PST vinculados aos perfis do Outlook.

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

O USMT não migra o layout Iniciar

Descrição: Você está usando o USMT para migrar perfis de uma instalação de Windows 10 para outra instalação de 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 que havia 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 solução alternativa a seguir está disponível:

Com o usuário conectado, faça backup do layout Iniciar usando o seguinte comando Windows PowerShell. Você pode especificar um caminho diferente, se desejar:
```
Export-StartLayout -Path "C:\Layout\user1.xml"
```
Migre o perfil do usuário com USMT.
Antes que o usuário entre no novo dispositivo, importe o layout Iniciar usando o seguinte comando Windows PowerShell:
```
Import-StartLayout -LayoutPath "C:\Layout\user1.xml" -MountPath %systemdrive%
```

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

Problemas de migração offline

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

Algumas das configurações do meu sistema não migram 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, confira O que o 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. Este perfil é mapeado para c:\users\temp. O log ScanState mostra uma exceção MigStartupOfflineCaught que inclui o erro SID duplicado do perfil do usuário.

Resolução: Você pode reiniciar 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.

Incluir e excluir regras para migrar perfis de usuário não funcionam da mesma forma offline que funcionam online

Causa: Quando offline, o servidor DNS não pode ser consultado para resolve o nome de usuário e o mapeamento 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 cartão selvagem (*) 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 opção /ue:*-500 para excluir as contas de administrador local. Para obter mais informações sobre SIDs do Windows, consulte Identificadores de segurança.

Meu script para apagar o disco falha depois de executar a ferramenta ScanState em um sistema de 64 bits

Causa: O hive do registro HKLM não é descarregado depois que a ferramenta ScanState terminar 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 executar. Por exemplo, em um prompt de comando, insira:

reg.exe unload hklm\$dest$software

Hard-Link problemas de migração

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

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

A ferramenta ScanState não pode excluir um repositório de migração de link rígido anterior

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

Resolução: Use a ferramenta UsmtUtils para excluir o repositório ou alterar o nome do repositório. Por exemplo, em um prompt de comando, insira:

UsmtUtils.exe /rd <storedir>

Você também deve reiniciar o computador.

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

Retornar códigos

Sintaxe usmtUtils

Compartilhar via

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

Diretrizes gerais para identificar problemas de migração

Problemas da conta de usuário

Estou tendo problemas para criar contas locais no computador de destino

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

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

Estou usando a opção /uel, mas muitas contas ainda estão sendo incluídas na migraçã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

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

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

Problemas de linha de comando

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

Recebi a seguinte mensagem de erro: "O USMT não pôde criar os arquivos de log. Verifique se você tem acesso de gravação ao diretório de log.".

Problemas de arquivo XML

Usei a opção `/genconfig` para 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?

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

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

Problemas de migração

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

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

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

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

O USMT não migra o layout Iniciar

Problemas de migração offline

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

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

Incluir e excluir regras para migrar perfis de usuário não funcionam da mesma forma offline que funcionam online

Meu script para apagar o disco falha depois de executar a ferramenta ScanState em um sistema de 64 bits

Hard-Link problemas de migração

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

A ferramenta ScanState não pode excluir um repositório de migração de link rígido anterior

Coleta de dados

Comentários

Comentários

Recursos adicionais

Compartilhar via

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

Diretrizes gerais para identificar problemas de migração

Problemas da conta de usuário

Estou tendo problemas para criar contas locais no computador de destino

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

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

Estou usando a opção /uel, mas muitas contas ainda estão sendo incluídas na migraçã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

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

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

Problemas de linha de comando

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

Recebi a seguinte mensagem de erro: "O USMT não pôde criar os arquivos de log. Verifique se você tem acesso de gravação ao diretório de log.".

Problemas de arquivo XML

Usei a opção /genconfig para 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?

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

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

Problemas de migração

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

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

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

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

O USMT não migra o layout Iniciar

Problemas de migração offline

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

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

Incluir e excluir regras para migrar perfis de usuário não funcionam da mesma forma offline que funcionam online

Meu script para apagar o disco falha depois de executar a ferramenta ScanState em um sistema de 64 bits

Hard-Link problemas de migração

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

A ferramenta ScanState não pode excluir um repositório de migração de link rígido anterior

Coleta de dados

Artigos relacionados

Comentários

Comentários

Recursos adicionais

Usei a opção `/genconfig` para 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?