Arquivos XML da USMT personalizados

  • Artigo

Neste tópico

Visão geral

Arquivos .xml de migração

Arquivos .xml personalizados

O arquivo Config.xml

Exemplos

Informações adicionais

Visão geral

Se você deseja que as ferramentas ScanState e LoadState usem qualquer um dos arquivos .xml de migração, especifique esses arquivos na linha de comando usando a opção /i. Como as ferramentas ScanState e LoadState precisam dos arquivos .xml para controlar a migração, especifique o mesmo conjunto de arquivos .xml para ambos os comandos ScanState e LoadState. Entretanto, você não precisa especificar o arquivo Config.xml com a opção /config, a menos que deseje excluir alguns dos arquivos e configurações que migrou para o repositório. Por exemplo, talvez você queira migrar a pasta Meus Documentos para o repositório, mas não para o computador de destino. Para isso, modifique o arquivo Config.xml e especifique o arquivo atualizado com o comando LoadState. O comando LoadState migrará somente os arquivos e as configurações que você deseja migrar.

Se você sair de um arquivo .xml a partir do comando LoadState, todos os dados do repositório que foram migrados com os arquivos .xml ausentes serão migrados. Entretanto, as regras de migração especificadas com o comando ScanState não serão aplicáveis. Por exemplo, se você deixar de incluir um arquivo .xml e ele contiver uma regra de reencaminhamento como: MigsysHelperFunction.RelativeMove("c:\data", "%CSIDL_PERSONAL%"), USMT não redirecionará os arquivos e eles serão migrados para c:\data.

Para modificar a migração, siga um ou mais dos seguintes procedimentos.

  • Modifique os arquivos .xml de migração. Se você deseja excluir uma parte de um componente — por exemplo, deseja migrar C:\, mas excluir todos os arquivos .mp3 — ou se quiser mover dados para um novo local no computador de destino, modifique os arquivos .xml. Para modificar esses arquivos, você deve estar familiarizado com a sintaxe e as regras de migração. Se você deseja que ScanState e LoadState usem esses arquivos, especifique-os na linha de comando quando cada comando é inserido.

  • Crie um arquivo .xml personalizado. Você também pode criar um arquivo .xml personalizado para migrar configurações para outro aplicativo ou para alterar o comportamento de migração para atender às suas necessidades. Para ScanState e LoadState usarem esse arquivo, especifique-os em ambas as linhas de comando.

  • Crie e modifique um arquivo Config.xml. Faça isso se desejar excluir um componente inteiro da migração. Por exemplo, você pode usar um arquivo Config.xml para excluir a pasta Meus Documentos inteira ou excluir as configurações de um aplicativo. Excluir componentes usando um arquivo Config.xml é mais fácil do que modificar os arquivos .xml de migração porque você não precisa estar familiarizado com a sintaxe e as regras de migração. Além disso, usar um arquivo Config.xml é a única maneira de excluir as configurações do sistema operacional da migração.

Para obter mais informações sobre como excluir dados, veja o tópico Excluir arquivos e configurações.

Arquivos .xml de migração

Esta seção descreve os arquivos .xml de migração incluídos com a USMT. Cada arquivo contém regras de migração que controlam quais componentes são migrados e onde são migrados no computador de destino.

Dica

Você pode usar o caractere curinga asterisco (*) em cada um desses arquivos. No entanto, você não pode usar um ponto de interrogação (?) como caractere curinga.

  • O arquivo MigApp.xml. Especifique este arquivo com os comandos ScanState e LoadState para migrar as configurações dos aplicativos.

  • O arquivo MigDocs.xml. Especifique esse arquivo com as ferramentas ScanState e LoadState para migrar todas as pastas e arquivos de usuário encontrados pela função auxiliar MigXmlHelper.GenerateDocPatterns. Essa função auxiliar encontra dados do usuário que residem na raiz de qualquer unidade e no diretório Users. No entanto, ele não encontra nem migra nenhum dado de aplicativo, arquivos de programas ou arquivos no diretório do Windows. Você pode modificar o arquivo MigDocs.xml.

  • O arquivo MigUser.xml. Especifique este arquivo com comandos ScanState e LoadState para migrar pastas de usuário, arquivos e tipos de arquivos. Você pode modificar o arquivo MigUser.xml. Este arquivo não contém regras que migram contas de usuário específicas. A única maneira de especificar quais contas de usuário serão migradas é na linha de comando usando as opções de usuário ScanState e LoadState.

    Dica

    Não use os arquivos MigUser.XML e MigDocs.xml juntos. Para saber mais, veja os tópicos Identificar Tipos de Arquivo, Arquivos e Pastas e Práticas recomendadas para USMT.

Arquivos .xml personalizados

Você pode criar arquivos .xml personalizados para personalizar a migração para suas necessidades exclusivas. Por exemplo, você pode desejar criar um arquivo personalizado para migrar um aplicativo de linha de negócios ou para modificar o comportamento padrão de migração. Se você quiser que ScanState e LoadState usem esse arquivo, especifique-o com ambos os comandos. Para saber mais, veja o tópico Arquivos XML da USMT personalizados.

O arquivo Config.xml

O arquivo Config.xml é um arquivo opcional que você cria usando a opção /genconfig com o comando ScanState. Você deve criar e modificar este arquivo se desejar excluir alguns componentes da migração. Além disso, você deve criar e modificar esse arquivo se quiser excluir qualquer umas das configurações de sistema operacional da migração. O formato do arquivo Config.xml é diferente dos outros arquivos .xml de migração, pois ele não contém regras de migração. Ele contém apenas uma lista de componentes do sistema operacional, aplicativos e os documentos do usuário que podem ser migrados. Para obter um exemplo, veja o tópico Arquivo Config.xml. Por esse motivo, excluir componentes usando esse arquivo é mais fácil do que modificar os arquivos .xml de migração porque você não precisa estar familiarizado com a sintaxe e as regras de migração. No entanto, você não pode usar caracteres curinga em um arquivo Config.xml.

Se você quiser incluir todos os componentes padrão, não precisará criar o arquivo Config.xml. Como alternativa, se você estiver satisfeito com o comportamento padrão de migração definido nos arquivos MigApp.xml, MigDocs.xml e MigUser.xml e quiser excluir somente alguns componentes, pode criar e modificar um arquivo Config.xml e deixar os outros arquivos .xml em seu estado original.

Quando você executa o comando ScanState com a opção /genconfig , ScanState lê os outros arquivos .xml que você especifica usando a opção /i para criar uma lista personalizada de componentes que pode ser migrada do computador. Esse arquivo irá conter somente componentes do sistema operacional, aplicativos e as seções de documentos do usuário que estiverem em ambos os arquivos .xml e os que são instalados no computador quando você executa o comando ScanState com a opção /genconfig. Portanto, você deve criar esse arquivo em um computador de origem que contenha todos os componentes, aplicativos e configurações que estarão presentes nos computadores de destino. Isso garantirá que esse arquivo contém todos os componentes que podem ser migrados. Os componentes são organizados em seções: <Applications>, <WindowsComponents> e <Documents>. Para optar por não migrar um componente, altere sua entrada para migrate="no".

Depois de criar esse arquivo, você precisará especificá-lo apenas com o comando ScanState usando a opção /Config para ele afetar a migração. No entanto, se desejar excluir dados adicionais que você migrou para o repositório, modifique o arquivo Config.xml e especifique o arquivo atualizado com o comando LoadState . Por exemplo, se você coletou a pasta Meus Documentos no repositório, mas decidir que não deseja migrar a pasta Meus Documentos para um computador de destino, pode modificar o arquivo Config.xml para indicar migrate="no" antes de executar o comando LoadState e o arquivo não será migrado. Para obter mais informações sobre a precedência estabelecida ao excluir dados, veja o tópico Excluir arquivos e configurações.

Além disso, observe a seguinte funcionalidade com o arquivo Config.xml:

  • Se um componente pai for removido da migração no arquivo Config.xml especificando migrate="no", todos os seus componentes filhos serão automaticamente removidos da migração, mesmo que o componente filho esteja definido como migrate="yes".

  • Se você, por engano, tem duas linhas de código para o mesmo componente onde uma linha especifica migrate="no" e a outra linha especifica migrate="yes", o componente será migrado.

  • Na USMT, há diversas políticas de migração que podem ser configuradas no arquivo Config.xml. Por exemplo, você pode configurar as opções adicionais <ErrorControl>, <ProfileControl> e <HardLinkStoreControl>. Para saber mais, veja o tópico Arquivo Config.xml.

Dica

Para excluir um componente do arquivo Config.xml, defina o valor migrate como "no". A exclusão de uma marca XML do componente do arquivo Config.xml não exclui o componente da migração.

Exemplos

  • O comando a seguir cria um arquivo Config.xml no diretório atual, mas não cria um repositório:

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

  • O comando a seguir cria um repositório criptografado usando o arquivo Config.xml e os arquivos .xml de migração padrão:

    scanstate \\server\share\migration\mystore /i:migapp.xml /i:migdocs.xml /o /config:config.xml /v:5 /encrypt /key:"mykey"

  • O comando a seguir descriptografa o repositório e migra os arquivos e as configurações:

    loadstate \\server\share\migration\mystore /i:migapp.xml /i:migdocs.xml /v:5 /decrypt /key:"mykey"

Informações adicionais

Consulte também

Outros Recursos

Sintaxe de linha de comando da USMT (ferramenta de transferência do Windows)
Recursos da USMT