Noções básicas sobre arquivos XML de migração
Você pode modificar o comportamento de uma migração básica da USMT (Ferramenta de Migração de Estado do Usuário) 5.0 usando arquivos XML; esses arquivos fornecem instruções sobre onde e como as ferramentas da USMT devem coletar e aplicar arquivos e configurações. A USMT inclui três arquivos XML que você pode usar para personalizar uma migração básica: os arquivos MigDocs.xml e MigUser.xml, que modificam como os arquivos são detectados no computador de origem, e o arquivo MigApps.xml, que é necessário para migrar as configurações do aplicativo compatível. Você também pode criar e editar arquivos XML personalizados e um arquivo config.xml para personalizar ainda mais a migração.
Este tópico fornece uma visão geral dos arquivos XML de migração padrão e personalizados e inclui diretrizes para a criação e edição de uma versão personalizada do arquivo MigDocs.xml. O arquivo MigDocs.xml usa a nova função GenerateDocPatterns, disponível na USMT para encontrar automaticamente documentos do usuário em um computador de origem.
Neste tópico
Visão geral do arquivo Config.xml
Visão geral do arquivo MigApp.xml
Visão geral do arquivo MigDocs.xml
Visão geral do arquivo MigUser.xml
Usando vários arquivos XML
Regras XML para migração de arquivos do usuário
Criando e editando um arquivo XML personalizado
Função GenerateDocPatterns
Noções básicas sobre o sistema e o contexto do usuário
Exemplos de regras de migração para versões personalizadas de arquivos XML
Exemplos de uso de regras de exclusão
Exemplos de uso de regras de inclusão
Próximas etapas
Visão geral do arquivo Config.xml
O arquivo Config.xml é o arquivo de configuração criado pela opção /genconfig da ferramenta ScanState; ele pode ser usado para modificar os componentes do sistema operacional que serão migrados pela USMT. O arquivo Config.xml pode ser usado em conjunto com outros arquivos XML, como neste exemplo: scanstate /i:migapps.xml /i:migdocs.xml /genconfig:c:\myFolder\config.xml. Quando usado dessa forma, o arquivo Config.xml controla rigidamente aspectos da migração, como perfis de usuário, dados e configurações, sem modificar ou criar outros arquivos XML. Para saber mais sobre o arquivo Config.xml, veja Arquivos XML da USMT personalizados e Arquivo Config.xml.
Dica
Ao modificar os elementos XML no arquivo Config.xml, você deve editar um elemento e definir a propriedade migrate como no, em vez de excluir o elemento do arquivo. Se você excluir o elemento em vez de definir a propriedade, o componente ainda poderá ser migrado por regras em outros arquivos XML.
Visão geral do arquivo MigApp.xml
O arquivo MigApp.xml instalado com a USMT inclui instruções para migrar as configurações dos aplicativos listados em O que a ferramenta de transferência do Windows migra? Você deve incluir o arquivo MigApp.xml ao usar as ferramentas ScanState e LoadState, usando a opção /i para migrar as configurações do aplicativo. Os arquivos MigDocs.xml e MigUser.xml não migram as configurações do aplicativo. Você pode criar um arquivo XML personalizado para incluir aplicativos adicionais. Para saber mais, veja Arquivos XML da USMT personalizados.
Importante
O arquivo MigApps.xml detecta e migra apenas arquivos .pst vinculados ao Microsoft® Office Outlook®. Veja a seção Exemplos de regras de migração para versões personalizadas de arquivos XML deste documento para saber mais sobre como migrar arquivos .pst não vinculados ao Outlook.
Visão geral do arquivo MigDocs.xml
O arquivo MigDocs.xml usa a nova função auxiliar GenerateDocPatterns para criar instruções para que a USMT migre arquivos do computador de origem, com base no local dos arquivos. Você pode usar o arquivo MigDocs.xml com as ferramentas ScanState e LoadState para fazer uma migração mais específica, em vez de usar a USMT sem instruções XML.
O arquivo MigDocs.xml padrão migra o seguinte:
Todos os arquivos na raiz da unidade, exceto %WINDIR%, %PROGRAMFILES%, %PROGRAMDATA% ou %USERS%.
Todas as pastas no diretório raiz de todas as unidades fixas. Por exemplo: c:\data_mail\*[*]
Todos os arquivos na raiz da pasta Perfis, com exceção dos arquivos no perfil do sistema. Por exemplo: c:\usuários\nome[mail.pst]
Todas as pastas na raiz da pasta Perfis, exceto as pastas de perfil do sistema. Por exemplo: c:\usuários\nome\nova pasta\*[*]
Pastas compartilhadas padrão:
CSIDL_COMMON_DESKTOPDIRECTORY
CSIDL_COMMON_FAVORITES
CSIDL_COMMON_DOCUMENTS
CSIDL_COMMON_MUSIC
CSIDL_COMMON_PICTURES
CSIDL_COMMON_VIDEO
FOLDERID_PublicDownloads
Pastas de perfil de usuário padrão de cada usuário:
CSIDL_MYDOCUMENTS
CSIDL_MYPICTURES
FOLDERID_OriginalImages
CSIDL_MYMUSIC
CSIDL_MYVIDEO
CSIDL_FAVORITES
CSIDL_DESKTOP
CSIDL_QUICKLAUNCH
FOLDERID_Contacts
FOLDERID_Libraries
FOLDERID_Downloads
FOLDERID_SavedGames
FOLDERID_RecordedTV
O arquivo MigDocs.xml padrão não migra o seguinte:
Arquivos marcados com ambos os atributos oculto e sistema.
Arquivos e pastas em unidades removíveis.
Dados das pastas %WINDIR%, %PROGRAMDATA% e %PROGRAMFILES%.
Pastas que contêm aplicativos instalados.
Você também pode usar a opção /genmigxml com a ferramenta ScanState para verificar e modificar quais arquivos serão migrados. Para saber mais, veja a seção Criando e editando um arquivo XML personalizado deste documento.
Visão geral do arquivo MigUser.xml
O arquivo MigUser.xml inclui instruções para que a USMT migre arquivos do usuário com base em extensões de nome de arquivo. Você pode usar o arquivo MigUser.xml com as ferramentas ScanState e LoadState para fazer uma migração mais específica, em vez de usar a USMT sem instruções XML. O arquivo MigUser.xml coleta todos os arquivos das pastas de perfil de usuário padrão e todos os arquivos no computador com as extensões de nome de arquivo especificadas.
O arquivo MigUser.xml padrão migra o seguinte:
Todos os arquivos das pastas de perfil do usuário padrão descritas como:
CSIDL_MYVIDEO
CSIDL_MYMUSIC
CSIDL_DESKTOP
CSIDL_STARTMENU
CSIDL_PERSONAL
CSIDL_MYPICTURES
CSIDL_FAVORITES
CSIDL_QUICK LAUNCH
Arquivos com estas extensões:
.qdf, .qsd, .qel, .qph, .doc*, .dot*, .rtf, .mcw, .wps, .scd, .wri, .wpd, .xl*, .csv, .iqy, .dqy, .oqy, .rqy, .wk*, .wq1, .slk, .dif, .ppt*, .pps*, .pot*, .sh3, .ch3, .pre, .ppa, .txt, .pst, .one*, .vl*, .vsd, .mpp, .or6, .accdb, .mdb, .pub
O arquivo MigUser.xml padrão não migra o seguinte:
Arquivos marcados com ambos os atributos oculto e sistema.
Arquivos e pastas em unidades removíveis.
Dados das pastas %WINDIR%, %PROGRAMFILES%, %PROGRAMDATA%.
ACLS para arquivos em pastas fora do perfil do usuário.
Você pode fazer uma cópia do arquivo MigUser.xml e modificá-la para incluir ou excluir pastas de perfil do usuário padrão e extensões de nome de arquivo. Se você sabe todas as extensões dos arquivos que deseja migrar do computador de origem, use o arquivo MigUser.xml para mover todos os dados relevantes, independentemente do local dos arquivos. No entanto, isso pode resultar em uma migração com mais arquivos do que o esperado. Por exemplo, se você migrar todos os arquivos .jpg, pode migrar arquivos de imagem, como miniaturas e logotipos de aplicativos herdados que estão instalados no computador de origem.
Dica
Cada extensão de nome de arquivo que você incluir nas regras no arquivo MigUser.xml aumenta o tempo necessário para a ferramenta ScanState coletar os arquivos para a migração. Se a sua migração inclui mais de trezentos tipos de arquivo, ela pode ficar lenta. Para saber mais sobre outras maneiras de organizar a migração de dados, veja a seção Usando vários arquivos XML deste documento.
Usando vários arquivos XML
Você pode usar vários arquivos XML com as ferramentas ScanState e LoadState. Cada um dos arquivos XML padrão incluído ou gerado pela USMT é configurado para um componente específico da migração. Você também pode usar arquivos XML personalizados para complementar esses arquivos padrão com regras de migração adicionais.
| Arquivo XML de migração | Modifica os seguintes componentes: |
|---|---|
Arquivo Config.xml |
Componentes do sistema operacional, como papel de parede da área de trabalho e tema de tela de fundo. Você também pode sobrecarregar o config.xml para incluir algumas configurações de aplicativos e documentos, gerando o arquivo config.xml com os outros arquivos XML padrão. Para saber mais, veja Arquivos XML da USMT personalizados e Arquivo Config.xml. |
Arquivo MigApps.xml |
Configurações de aplicativos. |
Arquivos MigUser.xml ou MigDocs.xml |
Arquivos do usuário e configurações de perfil. |
Arquivos XML personalizados |
Configurações de aplicativos, configurações de perfil do usuário ou arquivos do usuário, além das regras contidas nos outros arquivos XML. |
Por exemplo, você pode usar todos os tipos de arquivos XML de migração para uma única migração, como no exemplo abaixo:
Scanstate <store> /config:c:\myFolder\config.xml /i:migapps.xml /i:migdocs.xml /i:customrules.xml
Regras XML para migração de arquivos do usuário
Importante
Você não deve usar os arquivos MigUser.xml e MigDocs.xml juntos no mesmo comando. O uso dos dois arquivos XML pode resultar na duplicação de alguns arquivos migrados. Isso ocorre quando são passadas instruções de local de destino conflitantes em cada arquivo XML. O arquivo de destino é armazenado uma vez durante a migração, mas é aplicado por cada arquivo XML a um local diferente no computador de destino.
Se o seu conjunto de dados é desconhecido ou se muitos arquivos estão armazenados fora das pastas de perfil do usuário padrão, o MigDocs.xml é uma opção melhor que o arquivo MigUser.xml, porque o arquivo MigDocs.xml coleta um escopo mais amplo de dados. O arquivo MigDocs.xml migra pastas de dados com base no local. O arquivo MigUser.xml migra apenas os arquivos com as extensões de nome de arquivo especificadas.
Para ter mais controle sobre a migração, você pode criar arquivos XML personalizados. Veja a seção Criando e editando um arquivo XML personalizado deste documento.
Criando e editando um arquivo XML personalizado
Você pode usar a opção de linha de comando /genmigxml para determinar quais arquivos serão incluídos em sua migração. A opção /genmigxml cria um arquivo em um local especificado para você verificar as regras XML e fazer modificações, conforme necessário.
Dica
Se você reinstalar a USMT, os arquivos XML de migração padrão serão substituídos e todas as personalizações feitas diretamente nesses arquivos serão perdidas. Considere a criação de arquivos XML separados para as suas regras de migração personalizadas e salve-os em um local seguro.
Para gerar o arquivo de regras de migração XML para um computador de origem:
Clique em Iniciar, Todos os Programas, Acessórios, clique com o botão direito do mouse em Prompt de Comando e clique em Executar como.
Selecione uma conta com privilégios de administrador, digite uma senha e clique em OK.
No prompt de comando, digite:
cd /d <caminhodaferramentadetransferênciadoWindows> scanstate.exe /genmigxml: <caminhodoarquivo.xml>Onde <USMTpath> é o local no computador de origem em que você salvou os arquivos e as ferramentas da USMT, e <filepath.xml> é o caminho completo de um arquivo em que você pode salvar o relatório. Por exemplo, digite:
cd /d c:\USMT scanstate.exe /genmigxml:"C:\Documents and Settings\USMT Tester\Desktop\genMig.xml"
Função GenerateDocPatterns
O arquivo MigDocs.xml chama a função GenerateDocPatterns, que tem três valores boolianos. Você pode mudar as configurações para modificar a maneira como o arquivo MigDocs.xml gera as regras XML para migração.
| Configuração | Valor | Valor padrão |
|---|---|---|
ScanProgramFiles |
O argumento ScanProgramFiles é válido somente quando a função GenerateDocPatterns é chamada em um contexto de sistema. Esse argumento determina se vai ser feita a verificação do diretório Arquivos de Programas para coletar extensões de nomes de arquivos registradas de aplicativos conhecidos. Por exemplo, quando definido como TRUE, a função detecta e migra arquivos .doc no diretório do Microsoft Office, porque .doc é uma extensão de nome de arquivo registrada para um aplicativo do Microsoft Office. A função GenerateDocPatterns gera esse padrão de inclusão para arquivos .doc: Se uma pasta filho de uma pasta incluída tem um aplicativo instalado, o ScanProgramFiles também cria uma regra de exclusão para a pasta filho. As extensões de nomes de arquivos registradas são verificadas recursivamente em todas as pastas dentro da pasta do aplicativo. |
False |
IncludePatterns |
O argumento IncludePatterns determina se deve gerar padrões de exclusão ou inclusão no XML. Quando esse argumento é definido como TRUE, a função GenerateDocPatterns gera padrões de inclusão e deve ser adicionada ao elemento <include>. A alteração desse argumento para FALSE gera padrões de exclusão e a função deve ser adicionada ao elemento <exclude>. |
True |
SystemDrive |
O argumento SystemDrive determina a geração de padrões para todas as unidades fixas ou apenas para a unidade do sistema. A alteração desse argumento para TRUE restringe todos os padrões à unidade do sistema. |
False |
Uso:
MigXmlHelper.GenerateDocPatterns ("<ScanProgramFiles>", "<IncludePatterns>", "<SystemDrive>")
Para criar padrões de inclusão de dados somente para a unidade do sistema:
<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
<objectSet>
<script>MigXmlHelper.GenerateDocPatterns ("FALSE","TRUE","TRUE")</script>
</objectSet>
</include>
Para criar uma regra de inclusão para coletar arquivos de extensões registradas do diretório %PROGRAMFILES%:
<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
<objectSet>
<script>MigXmlHelper.GenerateDocPatterns ("TRUE","TRUE","FALSE")</script>
</objectSet>
</include>
Para criar padrões de exclusão de dados:
<exclude filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
<objectSet>
<script>MigXmlHelper.GenerateDocPatterns ("FALSE","FALSE","FALSE")</script>
</objectSet>
</exclude>
Noções básicas sobre o sistema e o contexto do usuário
Os arquivos XML de migração contêm dois elementos <component> com configurações diferentes de contexto. O contexto do sistema aplica-se aos arquivos no computador que não estão armazenados no diretório Perfis de Usuário, enquanto o contexto de usuário aplica-se aos arquivos que são específicos de um usuário individual.
Contexto do sistema
O contexto do sistema inclui regras para dados fora do diretório Perfis de Usuário. Por exemplo, quando chamada em um contexto de sistema no arquivo MigDocs.xml, a função GenerateDocPatterns cria padrões para todas as pastas comuns do shell, arquivos no diretório raiz dos discos rígidos e pastas localizadas na raiz dos discos rígidos. Estas pastas estão incluídas:
CSIDL_COMMON_DESKTOPDIRECTORY
CSIDL_COMMON_FAVORITES
CSIDL_COMMON_DOCUMENTS
CSIDL_COMMON_MUSIC
CSIDL_COMMON_PICTURES
CSIDL_COMMON_VIDEO
FOLDERID_PublicDownloads
Contexto do usuário
O contexto do usuário inclui regras para dados no diretório Perfis de Usuário. Quando chamada em um contexto de usuário no arquivo MigDocs.xml, a função GenerateDocPatterns cria padrões para todas as pastas de shell do usuário, arquivos localizados na raiz do perfil e pastas localizadas na raiz do perfil. Estas pastas estão incluídas:
CSIDL_MYDOCUMENTS
CSIDL_MYPICTURES
FOLDERID_OriginalImages
CSIDL_MYMUSIC
CSIDL_MYVIDEO
CSIDL_FAVORITES
CSIDL_DESKTOP
CSIDL_QUICKLAUNCH
FOLDERID_Contacts
FOLDERID_Libraries
FOLDERID_Downloads
FOLDERID_SavedGames
FOLDERID_RecordedTV
Dica
As regras contidas em um componente ao qual é atribuído o contexto de usuário são executadas para cada perfil de usuário no computador. Os arquivos que são verificados várias vezes pelos arquivos MigDocs.xml são copiados para o repositório de migração apenas uma vez, mas um grande número de regras no contexto do usuário pode retardar a migração. Use o contexto do sistema quando for aplicável.
Exemplos de regras de migração para versões personalizadas de arquivos XML
Dica
Para conhecer as práticas recomendadas e os requisitos para arquivos XML personalizados na USMT, veja Arquivos XML da USMT personalizados e Convenções gerais.
Exemplos de uso de regras de exclusão
Nos exemplos abaixo, o computador de origem tem um arquivo .txt chamado "new text document" em um diretório chamado "new folder". O comportamento padrão do MigDocs.xml migra o arquivo new text document.txt e todos os arquivos contidos no diretório "new folder". As regras geradas pela função são:
Regra 1 |
|
Regra 2 |
|
Para excluir o arquivo new text document.txt e todos os arquivos .txt de "new folder", você pode fazer o seguinte:
Exemplo 1: excluir todos os arquivos .txt de uma pasta
Para excluir a Regra 1, o nome do arquivo deve ser exatamente igual. No entanto, para a Regra 2, você pode criar um padrão para excluir arquivos usando a extensão de nome de arquivo.
<exclude>
<objectSet>
<pattern type="File">D:\Newfolder\[new text document.txt]</pattern>
<pattern type="File">D:\New folder\*[*.txt]</pattern>
</objectSet>
</exclude>
Exemplo 2: usar o elemento UnconditionalExclude para dar à regra precedência sobre as regras de inclusão
Se você não sabe o nome ou o local do arquivo, mas sabe a extensão do nome do arquivo, pode usar a função GenerateDrivePatterns. Entretanto, a regra é menos específica que a regra de inclusão padrão gerada pelo arquivo MigDocs.xml e, dessa forma, ela não tem precedência. Você deve usar o elemento <UnconditionalExclude> para dar a essa regra precedência sobre a regra de inclusão padrão. Para saber mais sobre a ordem de precedência das regras de migração XML, veja Conflitos e precedência.
<unconditionalExclude>
<objectSet>
<script>MigXmlHelper.GenerateDrivePatterns ("*[*.txt]", "Fixed")</script>
</objectSet>
</unconditionalExclude>
Exemplo 3: usar o componente de contexto UserandSystem para executar regras em ambos os contextos
Para que o elemento <UnconditionalExclude> seja aplicado ao contexto do sistema e do usuário, você pode criar um terceiro componente usando o contexto UserandSystem. As regras nesse componente são executadas em ambos os contextos.
<component type="Documents" context="UserandSystem">
<displayName>MigDocExcludes</displayName>
<role role="Data">
<rules>
<unconditionalExclude>
<objectSet>
<script>MigXmlHelper.GenerateDrivePatterns ("*[*.txt]", "Fixed")</script>
</objectSet>
</unconditionalExclude>
</rules>
</role>
</component>
Para ver mais exemplos de regras de exclusão que você pode usar em arquivos XML de migração personalizados, veja Excluir arquivos e configurações.
Exemplos de uso de regras de inclusão
O diretório de dados do aplicativo é o local mais comum ao qual você precisa adicionar uma regra de inclusão. A função GenerateDocPatterns exclui esse local por padrão. Se a sua empresa usa um aplicativo que salva os dados importantes nesse local, você pode criar regras de inclusão para migrar os dados. Por exemplo, o local padrão dos arquivos .pst é: %CSIDL_LOCAL_APPDATA%\Microsoft\Outlook. O arquivo MigApp.xml contém regras de migração para mover somente esses arquivos .pst que estão vinculados ao Microsoft Outlook. Para incluir arquivos .pst que não estejam vinculados, você pode fazer o seguinte:
Exemplo 1: incluir uma extensão de nome de arquivo em uma pasta de usuário conhecida
Essa regra inclui os arquivos .pst que estão no local padrão, mas que não estão vinculados ao Microsoft Outlook. Use o contexto de usuário para executar essa regra para cada usuário no computador.
<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
<objectSet>
<pattern type="File">%CSIDL_LOCAL_APPDATA%\Microsoft\Outlook\*[*.pst]</pattern>
</objectSet>
</include>
Exemplo 2: incluir uma extensão de nome de arquivo em Arquivos de Programas
Para locais fora do perfil do usuário, como a pasta Arquivos de Programas, você pode adicionar a regra ao componente de contexto do sistema.
<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
<objectSet>
<pattern type="File">%CSIDL_PROGRAM_FILES%\*[*.pst]</pattern>
</objectSet>
</include>
Para ver mais exemplos de regras de inclusão que você pode usar em arquivos XML de migração personalizados, veja Incluir arquivos e configurações.
Dica
Para saber mais sobre a ordem de precedência das regras de migração XML, veja Conflitos e precedência.
Próximas etapas
Você pode incluir regras adicionais para a migração no arquivo MigDocs.xml ou em outros arquivos XML de migração. Por exemplo, você pode usar o elemento <locationModify> para mover os arquivos da pasta onde estavam reunidos para uma pasta diferente, quando eles forem aplicados ao computador de destino. Para saber mais, veja Referência XML da USMT.
Você pode usar um arquivo de esquema XML (MigXML.xsd) para validar a sintaxe dos arquivos XML personalizados. Para saber mais, veja Recursos da USMT.
Consulte também
Outros Recursos
Excluir arquivos e configurações
Incluir arquivos e configurações