Compartilhar via

Entender arquivos XML de migração

O comportamento de uma migração básica da USMT (Ferramenta de Migração de Estado do Usuário) pode ser modificado usando arquivos XML. Esses arquivos fornecem instruções sobre onde e como as ferramentas USMT devem reunir e aplicar arquivos e configurações. O USMT inclui três arquivos XML que podem ser usados para personalizar uma migração básica: os MigDocs.xml arquivos e MigUser.xml , que modificam como os arquivos são descobertos no computador de origem, e o arquivo MigApps.xml, que é necessário para migrar as configurações de aplicativo com suporte. Arquivos XML personalizados e um Config.xml arquivo podem ser criados e editados para personalizar ainda mais a migração.

Este artigo fornece uma visão geral dos arquivos XML de migração padrão e personalizados e inclui diretrizes para criar e editar uma versão personalizada do MigDocs.xml arquivo. O MigDocs.xml arquivo usa a nova GenerateDocPatterns função disponível no USMT para localizar automaticamente documentos do usuário em um computador de origem.

Visão geral do arquivo Config.xml

O Config.xml arquivo é o arquivo de configuração criado pela opção /genconfig da ferramenta ScanState . Ele pode ser usado para modificar quais componentes do sistema operacional USMT migra. O Config.xml arquivo pode ser usado com outros arquivos XML, como no exemplo a seguir:

ScanState.exe /i:migapps.xml /i:MigDocs.xml /genconfig:c:\myFolder\Config.xml

Quando usado dessa forma, o Config.xml arquivo controla fortemente aspectos da migração, incluindo perfis de usuário, dados e configurações, sem modificar ou criar outros arquivos XML. Para obter mais informações sobre o Config.xml arquivo, consulte Personalizar arquivos XML do USMT e Config.xml Arquivo.

Observação

Ao modificar os elementos XML no Config.xml arquivo, defina a propriedade de migração em um elemento como não em vez de excluir o elemento do arquivo. Se o elemento for excluído em vez de definir a propriedade, as regras em outros arquivos XML ainda poderão migrar o componente.

Visão geral do arquivo MigApp.xml

O MigApp.xml arquivo instalado com USMT inclui instruções para migrar as configurações para os aplicativos listados em O que o USMT migra?. Para migrar as configurações do aplicativo, o MigApp.xml arquivo deve ser incluído ao usar as ferramentas ScanState e LoadState usando a opção /i . Os MigDocs.xml arquivos e MigUser.xml não migram as configurações do aplicativo. Um arquivo XML personalizado pode ser criado para incluir aplicativos adicionais. Para obter mais informações, consulte Personalizar arquivos XML USMT.

Importante

O MigApps.xml arquivo detecta e migra apenas arquivos .pst vinculados ao Microsoft Office Outlook. Para obter mais informações sobre como migrar arquivos .pst que não estão vinculados ao Outlook, confira Regras de migração de exemplo para versões personalizadas de arquivos XML.

Visão geral do arquivo MigDocs.xml

O MigDocs.xml arquivo usa a nova GenerateDocPatterns função auxiliar para criar instruções para o USMT migrar arquivos do computador de origem, com base no local dos arquivos. O MigDocs.xml arquivo pode ser usado com as ferramentas ScanState e LoadState para executar uma migração mais direcionada do que usar USMT sem instruções XML.

O arquivo padrão MigDocs.xml migra os seguintes dados:

  • 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 da raiz da pasta Perfis, exceto arquivos no perfil do sistema. Por exemplo: c:\users\name[mail.pst].

  • Todas as pastas da raiz da pasta Perfis, exceto as pastas de perfil do sistema. Por exemplo: c:\users\name\new folder\*[*].

  • 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 para 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 padrão MigDocs.xml não migra os seguintes dados:

  • Arquivos marcados com os atributos ocultos e do sistema .

  • Arquivos e pastas em unidades removíveis.

  • Dados das pastas %WINDIR%, %PROGRAMDATA% e %PROGRAMFILES%.

  • Pastas que contêm aplicativos instalados.

A /genmigxml opção pode ser usada com a ferramenta ScanState para examinar e modificar quais arquivos são migrados.

Visão geral do arquivo MigUser.xml

O MigUser.xml arquivo inclui instruções para a USMT migrar arquivos de usuário com base em extensões de nome de arquivo. O MigUser.xml arquivo pode ser usado com as ferramentas ScanState e LoadState para executar uma migração mais direcionada do que usar USMT sem instruções XML. O MigUser.xml arquivo reúne 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 padrão MigUser.xml migra os seguintes dados:

  • Todos os arquivos das pastas de perfil de usuário padrão, que são descritos como:

    • CSIDL_MYVIDEO

    • CSIDL_MYMUSIC

    • CSIDL_DESKTOP

    • CSIDL_STARTMENU

    • CSIDL_PERSONAL

    • CSIDL_MYPICTURES

    • CSIDL_FAVORITES

    • CSIDL_QUICK LAUNCH

  • Arquivos com as seguintes extensões:

    .accdb, .ch3, .csv, .dif, .doc*, .dot*, .dqy, .iqy, .mcw, .mdb*, .mpp, .one*, .oqy, .or6, .pot*, .ppa, .pps*, .ppt*, .pre, .pst, .pub, .qdf, .qel, .qph, .qsd, .rqy, .rtf, .scd, .sh3, .slk, .txt, .vl*, .vsd, .wk*, .wpd, .wps, .wq1, .wri, .xl*, .xla, .xlb, .xls*

    Observação

    O asterisco (*) significa zero ou mais caracteres.

    Observação

    As extensões OpenDocument (*.odt, *.odp, *.ods) que os aplicativos do Microsoft Office podem usar não são migradas por padrão.

O arquivo padrão MigUser.xml não migra os seguintes dados:

  • Arquivos marcados com os atributos Oculto e Sistema .

  • Arquivos e pastas em unidades removíveis.

  • Dados das %WINDIR%pastas , %PROGRAMFILES%, %PROGRAMDATA% .

  • ACLS para arquivos em pastas fora do perfil de usuário.

O MigUser.xml arquivo pode ser copiado e, em seguida, a cópia modificada para incluir ou excluir pastas padrão de perfil de usuário e extensões de nome de arquivo. Se todas as extensões para os arquivos que precisam ser migrados do computador de origem forem conhecidas, use o MigUser.xml arquivo para mover todos os dados relevantes, independentemente do local dos arquivos. No entanto, adicionar todas as extensões de arquivo que precisam ser migradas para o MigUser.xml arquivo pode resultar em uma migração que contém mais arquivos do que o pretendido. Por exemplo, se todos os arquivos .jpg forem migrados, ele também poderá migrar arquivos de imagem, como miniaturas e logotipos de aplicativos herdados instalados no computador de origem.

Observação

Cada extensão de nome de arquivo incluída nas regras dentro do MigUser.xml arquivo aumenta o tempo necessário para a ferramenta ScanState reunir os arquivos para a migração. Se mais de 300 tipos de arquivo estiverem sendo migrados, a experiência de migração poderá ser lenta. Para obter mais informações sobre outras maneiras de organizar a migração dos dados, consulte a seção Usando vários arquivos XML deste artigo.

Usando vários arquivos XML

Vários arquivos XML podem ser usados com as ferramentas ScanState e LoadState . Cada um dos arquivos XML padrão incluídos com ou gerados pelo USMT está configurado para um componente específico da migração. Arquivos XML personalizados também podem ser usados para complementar esses arquivos padrão com mais regras de migração.

Arquivo de migração XML Modifica os seguintes componentes:
Config.xml arquivo Componentes do sistema operacional, como papel de parede da área de trabalho e tema em segundo plano.
O Config.xml também pode ser estendido para incluir algumas configurações de aplicativo e documento, gerando o Config.xml arquivo com os outros arquivos XML padrão. Para obter mais informações, consulte Personalizar arquivos XML do USMT e Config.xml Arquivo.
MigApps.xml arquivo Configurações de aplicativos.
arquivosMigUser.xml ou MigDocs.xml Arquivos de usuário e configurações de perfil.
Arquivos XML personalizados Configurações de aplicativo, configurações de perfil de usuário ou arquivos de usuário, além das regras contidas nos outros arquivos XML.

Por exemplo, todos os tipos de arquivo de migração XML podem ser usados para uma única migração, como no exemplo a seguir:

ScanState.exe <store> /config:c:\myFolder\Config.xml /i:migapps.xml /i:MigDocs.xml /i:CustomRules.xml

Regras XML para migrar arquivos de usuário

Importante

Os MigUser.xml arquivos e MigDocs.xml não devem ser usados juntos no mesmo comando. O uso de ambos os arquivos XML pode resultar na duplicação de alguns arquivos migrados. A duplicação de alguns arquivos migrados pode ocorrer quando instruções conflitantes de local de destino são dadas em cada arquivo XML. O arquivo de destino é armazenado uma vez durante a migração, mas cada arquivo XML aplica o arquivo a um local diferente no computador de destino.

Se o conjunto de dados for desconhecido ou se muitos arquivos forem armazenados fora das pastas padrão de perfil de usuário, a MigDocs.xml será uma escolha melhor do que o MigUser.xml arquivo, pois o MigDocs.xml arquivo coleta um escopo mais amplo de dados. O MigDocs.xml arquivo migra pastas de dados com base no local. O MigUser.xml arquivo migra apenas os arquivos com as extensões de nome de arquivo especificadas.

Para obter mais controle sobre a migração, crie arquivos XML personalizados. Para obter mais informações sobre como criar arquivos XML personalizados, consulte Criando e editando um arquivo XML personalizado.

Criando e editando um arquivo XML personalizado

A /genmigxml opção de linha de comando pode ser usada para determinar quais arquivos estão incluídos na migração. A /genmigxml opção cria um arquivo em um local especificado. As regras XML no arquivo podem então ser revisadas e, se necessário, modificações feitas.

Observação

Se USMT for reinstalado, os arquivos XML de migração padrão serão substituídos e todas as personalizações feitas para esses arquivos serão perdidas. Considere criar arquivos XML separados para as regras de migração personalizadas e salvá-los em um local seguro.

Para gerar o arquivo de regras de migração XML para um computador de origem:

  1. Selecione Iniciar>Todos os Acessórios de Programas>

  2. Clique com o botão direito do mouse em Prompt de Comando e selecione Executar como.

  3. Selecione uma conta com privilégios de administrador, forneça uma senha e selecione OK.

  4. No prompt de comando, insira:

    cd /d <USMTpath>
ScanState.exe /genmigxml: <filepath.xml>

    onde:

    • <USMTpath> – localização no computador de origem dos arquivos e ferramentas USMT salvos.
    • <>filepath.xml – caminho completo para um arquivo em que o relatório pode ser salvo.

    Por exemplo, insira:

    cd /d c:\USMT
ScanState.exe /genmigxml:"C:\Users\USMT Tester\Desktop\genMig.xml"

A função GenerateDocPatterns

O MigDocs.xml arquivo chama a GenerateDocPatterns função, que usa três valores boolianos. As configurações podem ser alteradas para modificar a forma como o MigDocs.xml arquivo gera as regras XML para migração.

  • ScanProgramFiles: esse argumento é válido somente quando a GenerateDocPatterns função é chamada em um contexto do sistema. Esse argumento determina se deve ou não examinar o diretório Arquivos de Programa para coletar extensões de nome de arquivo registradas para aplicativos conhecidos.

    Valor padrão: False

    Por exemplo, quando definida como TRUE, a função descobre e migra arquivos.doc no diretório do Microsoft Office, pois .doc é uma extensão de nome de arquivo registrada em um aplicativo do Microsoft Office. A GenerateDocPatterns função gera esse padrão de inclusão para .doc arquivos:

    <pattern type="File">C:\Program Files\Microsoft Office[.doc]</pattern>

    Se uma pasta filho de uma pasta incluída contiver um aplicativo instalado, ScanProgramFiles também criará uma regra de exclusão para a pasta filho. Todas as pastas na pasta de aplicativo são examinadas recursivamente para extensões de nome de arquivo registradas.

  • IncludePatterns: Este argumento determina se deve gerar padrões de exclusão ou de inclusão no XML. Quando esse argumento é definido como TRUE, a GenerateDocPatterns função gera padrões de inclusão e a função deve ser adicionada no <include> elemento. Alterar esse argumento para FALSE gera padrões de exclusão e a função deve ser adicionada no <exclude> elemento.

    Valor padrão: True

  • SystemDrive: este argumento determina se deve gerar padrões para todas as unidades fixas ou apenas para a unidade do sistema. Alterar esse argumento para TRUE restringe todos os padrões à unidade do sistema.

    Valor padrão: False

Uso:

MigXmlHelper.GenerateDocPatterns ("<ScanProgramFiles>", "<IncludePatterns>", "<SystemDrive>")

Para criar, inclua padrões de dados apenas 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 para 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 dados de exclusão:

<exclude filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
     <objectSet>
        <script>MigXmlHelper.GenerateDocPatterns ("FALSE","FALSE","FALSE")</script>
     </objectSet>
</exclude>

Entender o contexto do sistema e do usuário

Os arquivos XML de migração contêm dois <elementos de componente> com configurações de contexto diferentes:

  • O contexto do sistema se aplica a arquivos no computador que não são armazenados no diretório Perfis de Usuário.
  • O contexto do usuário se aplica a arquivos específicos a 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 MigDocs.xml sistema no arquivo, a GenerateDocPatterns função cria padrões para todas as pastas de shell comuns, arquivos no diretório raiz de discos rígidos e pastas localizadas na raiz dos discos rígidos. As pastas a seguir 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 MigDocs.xml usuário no arquivo, a GenerateDocPatterns função cria padrões para todas as pastas de shell de usuário, arquivos localizados na raiz do perfil e pastas localizadas na raiz do perfil. As pastas a seguir 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

Observação

As regras contidas em um componente atribuído ao contexto do usuário são executadas para cada perfil de usuário no computador. Os arquivos que são verificados várias vezes pelos MigDocs.xml arquivos só são copiados para o repositório de migração uma vez. No entanto, 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.

Regras de migração de exemplo para versões personalizadas de arquivos XML

Dica

Para obter melhores práticas e requisitos para arquivos XML personalizados no USMT, consulte Personalizar arquivos XML usmt e convenções gerais.

Excluir exemplos de uso de regras

Nos exemplos a seguir, o computador de origem tem um arquivo .txt chamado new text document em um diretório chamado new folder. O comportamento padrão MigDocs.xml migra o novo arquivo de texto document.txt e todos os arquivos contidos no new folder diretório. As regras geradas pela função são:

Regra Sintaxe
Regra 1 <pattern type="File">d:\new folder[new text document.txt]</pattern>
Regra 2 <pattern type="File">d:\new folder[]</pattern>

Para excluir o novo arquivo de texto document.txt e qualquer .txt arquivos no new folder, as seguintes modificações podem ser feitas:

Exemplo 1: excluir todos os arquivos .txt em uma pasta

Para excluir a Regra 1, é necessário que haja uma correspondência exata do nome do arquivo. No entanto, para a Regra 2, um padrão pode ser criado para excluir arquivos usando a extensão nome do 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: use o elemento IncondicionalExclude para dar uma precedência de regra sobre regras de inclusão

Se o nome do arquivo ou o local do arquivo não for conhecido, mas a extensão de nome do arquivo for conhecida, a GenerateDrivePatterns função poderá ser usada. No entanto, a regra é menos específica do que a regra de inclusão padrão gerada pelo MigDocs.xml arquivo, portanto, não tem precedência. O <elemento IncondicionalExclude> deve ser usado para dar a essa regra precedência sobre a regra de inclusão padrão. Para obter mais informações sobre a ordem de precedência para regras de migração XML, consulte Conflitos e Precedência.

<unconditionalExclude>
     <objectSet>
        <script>MigXmlHelper.GenerateDrivePatterns ("*[*.txt]", "Fixed")</script>
     </objectSet>
</unconditionalExclude>

Exemplo 3: usar um componente de contexto UserandSystem para executar regras em ambos os contextos

Para aplicar o <elemento IncondicionalExclude> ao contexto do sistema e do usuário, um terceiro componente pode ser criado usando o contexto UserandSystem . As regras neste 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 obter mais exemplos de regras de exclusão que podem ser usadas em arquivos XML de migração personalizada, consulte Excluir Arquivos e Configurações.

Incluir exemplos de uso de regras

O diretório de dados do aplicativo é o local mais comum para o qual uma regra de inclusão precisaria ser adicionada. A GenerateDocPatterns função exclui esse local por padrão. Se a organização usar um aplicativo que salva dados importantes para esse local, as regras de inclusão poderão ser criadas para migrar os dados. Por exemplo, o local padrão para arquivos .pst é: %CSIDL_LOCAL_APPDATA%\Microsoft\Outlook. O MigApp.xml arquivo contém regras de migração para mover apenas os arquivos .pst vinculados ao Microsoft Outlook. Para incluir arquivos .pst que não estão vinculados, a seguinte modificação pode ser feita:

Exemplo 1: incluir uma extensão de nome de arquivo em uma pasta de usuário conhecida

Essa regra inclui arquivos .pst que estão localizados no local padrão, mas não estão vinculados ao Microsoft Outlook. Use o contexto do 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 Programa

Para locais fora do perfil de usuário, como a pasta Arquivos de Programa, a regra pode ser adicionada ao componente de contexto do sistema.

<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
     <objectSet>
        <pattern type="File">%CSIDL_PROGRAM_FILES%\*[*.pst]</pattern>
     </objectSet>
</include>

Para obter mais exemplos de regras de inclusão que podem ser usadas em arquivos XML de migração personalizada, consulte Incluir Arquivos e Configurações.

Dica

Para obter mais informações sobre a ordem de precedência para regras de migração XML, consulte Conflitos e Precedência.

Próximas etapas

Regras adicionais para a migração podem ser incluídas no MigDocs.xml arquivo ou em outros arquivos de migração XML. Por exemplo, o <locationModify> elemento pode ser usado para mover arquivos da pasta em que eles foram coletados para uma pasta diferente, quando eles são aplicados ao computador de destino.

Um arquivo XML (MigXML.xsd) pode ser usado para validar a sintaxe dos arquivos XML personalizados. Para obter mais informações, consulte USMT Resources.