Partilhar via

Compreender os ficheiros XML de migração

O comportamento de uma migração básica da User State Migration Tool (USMT) pode ser modificado com ficheiros XML. Estes ficheiros fornecem instruções sobre onde e como as ferramentas USMT devem recolher e aplicar ficheiros e definições. O USMT inclui três ficheiros XML que podem ser utilizados para personalizar uma migração básica: os MigDocs.xml ficheiros e MigUser.xml , que modificam a forma como os ficheiros são detetados no computador de origem, e o ficheiro MigApps.xml, que é necessário para migrar as definições da aplicação suportadas. Os ficheiros XML personalizados e um Config.xml ficheiro podem ser criados e editados para personalizar ainda mais a migração.

Este artigo fornece uma descrição geral dos ficheiros XML de migração predefinidos e personalizados e inclui diretrizes para criar e editar uma versão personalizada do MigDocs.xml ficheiro. O MigDocs.xml ficheiro utiliza a nova GenerateDocPatterns função disponível no USMT para localizar automaticamente documentos de utilizador num computador de origem.

Descrição geral do ficheiro de Config.xml

O Config.xml ficheiro é o ficheiro de configuração criado pela opção /genconfig da ferramenta ScanState . Pode ser utilizado para modificar os componentes do sistema operativo que o USMT migra. O Config.xml ficheiro pode ser utilizado com outros ficheiros XML, como no exemplo seguinte:

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

Quando utilizado desta forma, o Config.xml ficheiro controla rigorosamente os aspetos da migração, incluindo perfis de utilizador, dados e definições, sem modificar ou criar outros ficheiros XML. Para obter mais informações sobre o Config.xml ficheiro, veja Personalizar Ficheiros XML USMT e FicheiroConfig.xml.

Observação

Ao modificar os elementos XML no Config.xml ficheiro, defina a propriedade migrate num elemento como não em vez de eliminar o elemento do ficheiro. Se o elemento for eliminado em vez de definir a propriedade, as regras noutros ficheiros XML ainda podem migrar o componente.

Descrição geral do ficheiro de MigApp.xml

O MigApp.xml ficheiro instalado com o USMT inclui instruções para migrar as definições das aplicações listadas em O que é que o USMT Migra?. Para migrar as definições da aplicação, o MigApp.xml ficheiro tem de ser incluído ao utilizar as ferramentas ScanState e LoadState com a opção /i . Os MigDocs.xml ficheiros e MigUser.xml não migram as definições da aplicação. Pode ser criado um ficheiro XML personalizado para incluir aplicações adicionais. Para obter mais informações, veja Personalizar Ficheiros XML USMT.

Importante

O MigApps.xml ficheiro deteta e migra apenas ficheiros .pst associados ao Microsoft Office Outlook. Para obter mais informações sobre a migração de ficheiros .pst que não estão ligados ao Outlook, veja Sample migration rules for customized versions of XML files (Regras de migração de exemplo para versões personalizadas de ficheiros XML).

Descrição geral do ficheiro de MigDocs.xml

O MigDocs.xml ficheiro utiliza a nova GenerateDocPatterns função auxiliar para criar instruções para o USMT migrar ficheiros do computador de origem, com base na localização dos ficheiros. O MigDocs.xml ficheiro pode ser utilizado com as ferramentas ScanState e LoadState para efetuar uma migração mais direcionada do que utilizar o USMT sem instruções XML.

O ficheiro predefinido MigDocs.xml migra os seguintes dados:

  • Todos os ficheiros na raiz da unidade, exceto %WINDIR%, %PROGRAMFILES%, %PROGRAMDATA%ou %USERS%.

  • Todas as pastas no diretório de raiz de todas as unidades fixas. Por exemplo: c:\data_mail\*[*].

  • Todos os ficheiros da raiz da pasta Perfis, exceto os ficheiros 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 partilhadas padrão:

    • CSIDL_COMMON_DESKTOPDIRECTORY

    • CSIDL_COMMON_FAVORITES

    • CSIDL_COMMON_DOCUMENTS

    • CSIDL_COMMON_MUSIC

    • CSIDL_COMMON_PICTURES

    • CSIDL_COMMON_VIDEO

    • FOLDERID_PublicDownloads

  • Pastas padrão de perfis de utilizador para cada utilizador:

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

  • Ficheiros marcados com os atributos ocultos e do sistema .

  • Ficheiros e pastas em unidades amovíveis.

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

  • Pastas que contêm aplicações instaladas.

A /genmigxml opção pode ser utilizada com a ferramenta ScanState para rever e modificar os ficheiros que são migrados.

Descrição geral do ficheiro de MigUser.xml

O MigUser.xml ficheiro inclui instruções para o USMT migrar ficheiros de utilizador com base em extensões de nome de ficheiro. O MigUser.xml ficheiro pode ser utilizado com as ferramentas ScanState e LoadState para efetuar uma migração mais direcionada do que utilizar o USMT sem instruções XML. O MigUser.xml ficheiro recolhe todos os ficheiros das pastas de perfil de utilizador padrão e quaisquer ficheiros no computador com as extensões de nome de ficheiro especificadas.

O ficheiro predefinido MigUser.xml migra os seguintes dados:

  • Todos os ficheiros das pastas padrão do perfil de utilizador, que são descritos como:

    • CSIDL_MYVIDEO

    • CSIDL_MYMUSIC

    • CSIDL_DESKTOP

    • CSIDL_STARTMENU

    • CSIDL_PERSONAL

    • CSIDL_MYPICTURES

    • CSIDL_FAVORITES

    • CSIDL_QUICK LAUNCH

  • Ficheiros 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 carateres.

    Observação

    As extensões OpenDocument (*.odt, *.odp, *.ods) que as aplicações do Microsoft Office podem utilizar não são migradas por predefinição.

O ficheiro predefinido MigUser.xml não migra os seguintes dados:

  • Ficheiros marcados com os atributos Oculto e Sistema .

  • Ficheiros e pastas em unidades amovíveis.

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

  • ACLS para ficheiros em pastas fora do perfil de utilizador.

O MigUser.xml ficheiro pode ser copiado e, em seguida, a cópia modificada para incluir ou excluir pastas padrão de perfil de utilizador e extensões de nome de ficheiro. Se todas as extensões dos ficheiros que precisam de ser migrados do computador de origem forem conhecidas, utilize o MigUser.xml ficheiro para mover todos os dados relevantes, independentemente da localização dos ficheiros. No entanto, adicionar todas as extensões de ficheiro que precisam de ser migradas para o MigUser.xml ficheiro pode resultar numa migração que contém mais ficheiros do que o pretendido. Por exemplo, se todos os .jpg ficheiros forem migrados, também pode migrar ficheiros de imagem, como miniaturas e logótipos de aplicações legadas que estão instaladas no computador de origem.

Observação

Cada extensão de nome de ficheiro incluída nas regras no MigUser.xml ficheiro aumenta a quantidade de tempo necessária para a ferramenta ScanState recolher os ficheiros para a migração. Se estiverem a ser migrados mais de 300 tipos de ficheiro, a experiência de migração pode ser lenta. Para obter mais informações sobre outras formas de organizar a migração dos dados, veja a secção Utilizar vários ficheiros XML deste artigo.

Utilizar vários ficheiros XML

Podem ser utilizados vários ficheiros XML com as ferramentas ScanState e LoadState . Cada um dos ficheiros XML predefinidos incluídos ou gerados pelo USMT está configurado para um componente específico da migração. Os ficheiros XML personalizados também podem ser utilizados para complementar estes ficheiros predefinidos com mais regras de migração.

Ficheiro de migração XML Modifica os seguintes componentes:
Config.xml ficheiro Componentes do sistema operativo, como padrão de fundo do ambiente de trabalho e tema de fundo.
O Config.xml também pode ser expandido para incluir algumas definições de aplicação e documento ao gerar o Config.xml ficheiro com os outros ficheiros XML predefinidos. Para obter mais informações, veja Personalizar Ficheiros XML USMT e FicheiroConfig.xml.
MigApps.xml ficheiro Definições de aplicações.
ficheirosMigUser.xml ou MigDocs.xml Ficheiros de utilizador e definições de perfil.
Ficheiros XML personalizados Definições da aplicação, definições de perfil de utilizador ou ficheiros de utilizador, para além das regras contidas nos outros ficheiros XML.

Por exemplo, todos os tipos de ficheiros de migração XML podem ser utilizados para uma única migração, como no exemplo seguinte:

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

Regras XML para migrar ficheiros de utilizador

Importante

Os MigUser.xml ficheiros e MigDocs.xml não devem ser utilizados em conjunto no mesmo comando. A utilização de ambos os ficheiros XML pode resultar na duplicação de alguns ficheiros migrados. A duplicação de alguns ficheiros migrados pode ocorrer quando são dadas instruções de localização de destino em conflito em cada ficheiro XML. O ficheiro de destino é armazenado uma vez durante a migração, mas cada ficheiro XML aplica o ficheiro a uma localização diferente no computador de destino.

Se o conjunto de dados for desconhecido ou se muitos ficheiros estiverem armazenados fora das pastas de perfil de utilizador padrão, o MigDocs.xml é uma escolha melhor do que o MigUser.xml ficheiro, porque o MigDocs.xml ficheiro recolhe um âmbito de dados mais amplo. O MigDocs.xml ficheiro migra pastas de dados com base na localização. O MigUser.xml ficheiro migra apenas os ficheiros com as extensões de nome de ficheiro especificadas.

Para obter mais controlo sobre a migração, crie ficheiros XML personalizados. Para obter mais informações sobre como criar ficheiros XML personalizados, veja Criar e editar um ficheiro XML personalizado.

Criar e editar um ficheiro XML personalizado

A /genmigxml opção da linha de comandos pode ser utilizada para determinar que ficheiros estão incluídos na migração. A /genmigxml opção cria um ficheiro numa localização especificada. As regras XML no ficheiro podem ser revistas e, se necessário, as modificações efetuadas.

Observação

Se a USMT for reinstalada, os ficheiros XML de migração predefinidos serão substituídos e quaisquer personalizações feitas a estes ficheiros serão perdidas. Considere criar ficheiros XML separados para as regras de migração personalizadas e guardá-los numa localização segura.

Para gerar o ficheiro 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 rato em Linha de Comandos e, em seguida, selecione Executar como.

  3. Selecione uma conta com privilégios de administrador, forneça uma palavra-passe e, em seguida, selecione OK.

  4. Na linha de comandos, introduza:

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

    onde:

    • <USMTpath> – localização no computador de origem dos ficheiros e ferramentas USMT guardados.
    • < >filepath.xml - caminho completo para um ficheiro onde o relatório pode ser guardado.

    Por exemplo, introduza:

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

A função GenerateDocPatterns

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

  • ScanProgramFiles: este argumento só é válido quando a GenerateDocPatterns função é chamada num contexto de sistema. Este argumento determina se deve ou não analisar o diretório Ficheiros de Programa para recolher extensões de nome de ficheiro registadas para aplicações conhecidas.

    Valor predefinido: Falso

    Por exemplo, quando definida como VERDADEIRO, a função deteta e migra ficheiros.doc no diretório do Microsoft Office, porque .doc é uma extensão de nome de ficheiro registada numa aplicação do Microsoft Office. A GenerateDocPatterns função gera este padrão de inclusão para .doc ficheiros:

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

    Se uma pasta subordinada de uma pasta incluída contiver uma aplicação instalada, ScanProgramFiles também cria uma regra de exclusão para a pasta subordinada. Todas as pastas na pasta da aplicação são analisadas de forma recursiva relativamente a extensões de nome de ficheiro registadas.

  • IncludePatterns: este argumento determina se pretende gerar padrões de exclusão ou inclusão no XML. Quando este argumento está definido como VERDADEIRO, a GenerateDocPatterns função gera padrões de inclusão e a função tem de ser adicionada sob o <include> elemento . Alterar este argumento para FALSO gera padrões de exclusão e a função tem de ser adicionada sob o <exclude> elemento .

    Valor predefinido: Verdadeiro

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

    Valor predefinido: Falso

Utilização:

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 recolher ficheiros para extensões registadas a partir 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>

Compreender o sistema e o contexto do utilizador

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

  • O contexto do sistema aplica-se a ficheiros no computador que não estão armazenados no diretório Perfis de Utilizador.
  • O contexto de utilizador aplica-se a ficheiros específicos de um utilizador individual.

Contexto do sistema

O contexto do sistema inclui regras para dados fora do diretório Perfis de Utilizador. Por exemplo, quando chamada num contexto de sistema no MigDocs.xml ficheiro, a GenerateDocPatterns função cria padrões para todas as pastas de shell comuns, ficheiros no diretório de raiz de discos rígidos e pastas localizadas na raiz dos discos rígidos. Estão incluídas as seguintes pastas:

  • CSIDL_COMMON_DESKTOPDIRECTORY

  • CSIDL_COMMON_FAVORITES

  • CSIDL_COMMON_DOCUMENTS

  • CSIDL_COMMON_MUSIC

  • CSIDL_COMMON_PICTURES

  • CSIDL_COMMON_VIDEO

  • FOLDERID_PublicDownloads

Contexto do utilizador

O contexto de utilizador inclui regras para dados no diretório Perfis de Utilizador. Quando chamada num contexto de utilizador no ficheiro, a MigDocs.xmlGenerateDocPatterns função cria padrões para todas as pastas da shell do utilizador, ficheiros localizados na raiz do perfil e pastas localizadas na raiz do perfil. Estão incluídas as seguintes pastas:

  • 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

Regras contidas num componente a que é atribuído o contexto de utilizador é executado para cada perfil de utilizador no computador. Os ficheiros que são analisados várias vezes pelos MigDocs.xml ficheiros só são copiados para o arquivo de migração uma vez. No entanto, um grande número de regras no contexto do utilizador pode abrandar a migração. Utilize o contexto do sistema quando for aplicável.

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

Dica

Para obter as melhores práticas e requisitos para ficheiros XML personalizados no USMT, veja Personalizar Ficheiros XML USMT e Convenções Gerais.

Exemplos de utilização de regras de exclusão

Nos exemplos seguintes, o computador de origem tem um ficheiro de.txt chamado new text document num diretório chamado new folder. O comportamento predefinido MigDocs.xml migra o novo ficheiro de texto document.txt e todos os ficheiros 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 ficheiro de texto document.txt e quaisquer ficheiros.txt no new folder, podem ser efetuadas as seguintes modificações:

Exemplo 1: Excluir todos os .txt ficheiros numa pasta

Para excluir a Regra 1, tem de existir uma correspondência exata do nome do ficheiro. No entanto, para a Regra 2, pode ser criado um padrão para excluir ficheiros com a extensão de nome de ficheiro.

<exclude>
     <objectSet>
        <pattern type="File">D:\Newfolder\[new text document.txt]</pattern>
         <pattern type="File">D:\New folder\*[*.txt]</pattern>
     </objectSet>
</exclude>

Exemplo 2: Utilizar o elemento IncondicionalExclude para dar precedência sobre regras de inclusão

Se o nome do ficheiro ou a localização do ficheiro não forem conhecidos, mas a extensão de nome de ficheiro for conhecida, a GenerateDrivePatterns função pode ser utilizada. No entanto, a regra é menos específica do que a regra de inclusão predefinida gerada pelo MigDocs.xml ficheiro, pelo que não tem precedência. O <elemento IncondicionalExclude> tem de ser utilizado para dar precedência a esta regra sobre a regra de inclusão predefinida. Para obter mais informações 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: Utilizar um componente de contexto UserandSystem para executar regras em ambos os contextos

Para aplicar o <elemento IncondicionalExclude> ao contexto do sistema e do utilizador, pode ser criado um terceiro componente com 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 utilizadas em ficheiros XML de migração personalizada, veja Excluir Ficheiros e Definições.

Incluir exemplos de utilização de regras

O diretório de dados da aplicação é a localização mais comum para a qual uma regra de inclusão teria de ser adicionada. A GenerateDocPatterns função exclui esta localização por predefinição. Se a organização utilizar uma aplicação que guarda dados importantes nesta localização, podem ser criadas regras de inclusão para migrar os dados. Por exemplo, a localização predefinida para ficheiros .pst é: %CSIDL_LOCAL_APPDATA%\Microsoft\Outlook. O MigApp.xml ficheiro contém regras de migração para mover apenas os ficheiros .pst associados ao Microsoft Outlook. Para incluir ficheiros .pst que não estão ligados, pode ser efetuada a seguinte modificação:

Exemplo 1: Incluir uma extensão de nome de ficheiro numa pasta de utilizador conhecida

Esta regra inclui ficheiros .pst localizados na localização predefinida, mas que não estão ligados ao Microsoft Outlook. Utilize o contexto de utilizador para executar esta regra para cada utilizador 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 ficheiro em Ficheiros de Programa

Para localizações fora do perfil de utilizador, como a pasta Ficheiros 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 utilizadas em ficheiros XML de migração personalizada, veja Incluir Ficheiros e Definições.

Dica

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

Próximas etapas

Podem ser incluídas regras adicionais para a migração no MigDocs.xml ficheiro ou noutros ficheiros de migração XML. Por exemplo, o <locationModify> elemento pode ser utilizado para mover ficheiros da pasta onde foram recolhidos para uma pasta diferente, quando são aplicados ao computador de destino.

Um ficheiro de esquema XML (MigXML.xsd) pode ser utilizado para validar a sintaxe dos ficheiros XML personalizados. Para obter mais informações, veja RECURSOS USMT.