Arquivos XML da USMT personalizados
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 comomigrate="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 especificamigrate="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
Para obter mais informações sobre como alterar os arquivos e as configurações que são migradas, veja Tópicos "Como fazer" da USMT (ferramenta de transferência do Windows).
Para obter mais informações sobre cada elemento .xml, veja o tópico Biblioteca de elementos XML.
Para obter respostas para perguntas comuns, veja "arquivos .xml" no tópico Perguntas frequentes.
Consulte também
Outros Recursos
Sintaxe de linha de comando da USMT (ferramenta de transferência do Windows)
Recursos da USMT