Excluir arquivos e configurações

Artigo
12/05/2013

Quando você especifica os arquivos .xml de migração, MigApp.xml, Migdocs e MigUser.xml, a USMT (Ferramenta de Migração de Estado do Usuário) 5.0 migra as configurações e os componentes listados, conforme discutido em O que a ferramenta de transferência do Windows migra? Você pode criar um arquivo .xml personalizado para especificar melhor o que deve ser incluído ou excluído na migração. Além disso, é possível criar um arquivo Config.xml para excluir um componente inteiro de uma migração. No entanto, não é possível excluir usuários usando os arquivos .xml de migração ou o arquivo Config.xml. A única maneira de especificar os usuários a serem incluídos e excluídos é por meio das opções de usuário, na linha de comando da ferramenta ScanState. Para saber mais, veja Sintaxe de ScanState.

Neste tópico:

Criar um arquivo .xml personalizado. Você pode usar os seguintes elementos para especificar o que deve ser excluído:
- <include> e <exclude>: você pode usar os elementos <include> e <exclude> para excluir objetos com condições. Por exemplo, você pode migrar todos os arquivos localizados na unidade C:\, exceto os arquivos .mp3. É importante lembrar que as regras de Conflitos e precedência se aplicam a esses elementos.
- <unconditionalExclude>: você pode usar o elemento <unconditionalExclude> para excluir dados globalmente. Esse elemento tem precedência sobre todas as outras regras de inclusão e exclusão nos arquivos .xml. Portanto, ele exclui objetos independentemente das outras regras de <include> definidas nos arquivos .xml. Por exemplo, você pode excluir todos os arquivos .mp3 do computador ou pode excluir todos os arquivos de C:\UserData.
Criar um arquivo Config.xml: você pode criar e modificar um arquivo Config.xml para excluir um componente inteiro da migração. Por exemplo, é possível usar esse arquivo para excluir as configurações de um dos aplicativos padrão. Além disso, criar e modificar um arquivo Config.xml é a única maneira de excluir as configurações do sistema operacional que são migradas para computadores que executam o Windows. A exclusão de componentes usando esse arquivo é mais fácil do que modificar os arquivos .xml de migração porque não é necessário estar familiarizado com as regras e a sintaxe de migração.

Criar um arquivo .xml personalizado

Recomendamos que você crie um arquivo .xml personalizado em vez de modificar os arquivos .xml de migração padrão. Ao usar um arquivo .xml personalizado, você pode manter suas alterações separadas dos arquivos .xml padrão, o que facilita o controle das modificações.

<include> e <exclude>

Os arquivos .xml de migração, MigApp.xml, MigDocs e MigUser.xml, contêm o elemento <component>, que geralmente representa um componente autossuficiente ou um aplicativo, como o Microsoft® Office Outlook® e o Word. Para excluir arquivos e configurações do Registro associados a esses componentes, use os elementos <include> e <exclude>. Por exemplo, você pode usar esses elementos para migrar todos os arquivos e as configurações com o padrão X, exceto aqueles com o padrão Y, sendo que Y é mais específico do que X. Para saber a sintaxe desses elementos, veja o tópico sobre a Referência XML da USMT.

Dica

Se especificar uma regra <exclude>, sempre especifique uma regra <include> correspondente. Por outro lado, se você não especificar uma regra <include>, as configurações ou os arquivos específicos não serão incluídos. Eles já estarão excluídos da migração, de modo que uma regra <exclude> desacompanhada é desnecessária.

Exemplo 1: Como migrar todos os arquivos de C:\ exceto os arquivos .mp3
Exemplo 2: Como migrar todos os arquivos localizados em C:\Data, exceto os situados em C:\Data\tmp
Exemplo 3: Como excluir os arquivos de uma pasta, mas incluir todas as subpastas
Exemplo 4: Como excluir um arquivo de uma pasta específica
Exemplo 5: Como excluir um arquivo de qualquer local

Exemplo 1: Como migrar todos os arquivos de C:\ exceto os arquivos .mp3

O arquivo .xml a seguir migra todos os arquivos localizados na unidade C:, exceto os arquivos .mp3.

<migration urlid="https://www.microsoft.com/migration/1.0/migxmlext/mp3files">
    <!-- This component migrates all files except those with .mp3 extension-->
    <component type="Documents" context="UserAndSystem">
        <displayName _locID="miguser.sharedvideo">MP3 Files</displayName>
        <role role="Data">
            <rules>
                <include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
                    <objectSet>
                        <pattern type="File">C:\* [*]</pattern>
                    </objectSet>
                </include>
                <exclude>
                    <objectSet>
                        <pattern type="File">C:\* [*.mp3]</pattern>
                    </objectSet>
                </exclude>
            </rules>
        </role>
    </component>
</migration>

Exemplo 2: Como migrar todos os arquivos localizados em C:\Data, exceto os situados em C:\Data\tmp

O arquivo .xml a seguir migra todos os arquivos e subpastas de C:\Data, exceto os arquivos e subpastas de C:\Data\tmp.

<migration urlid="https://www.microsoft.com/migration/1.0/migxmlext/test">
    <component type="Documents" context="System">
        <displayName _locID="miguser.sharedvideo">Test component</displayName>
        <role role="Data">
            <rules>
         <include>
            <objectSet>
                 <pattern type="File">C:\Data\* [*]</pattern>
            </objectSet>
          </include>
         <exclude>
             <objectSet>
                   <pattern type="File"> C:\Data\temp\* [*]</pattern>
             </objectSet>
         </exclude>  
            </rules>
        </role>
    </component>
</migration>

Exemplo 3: Como excluir os arquivos de uma pasta, mas incluir todas as subpastas

O arquivo .xml a seguir migra todas as subpastas de C:\EngineeringDrafts, mas exclui todos os arquivos localizados nessa pasta.

<migration urlid="https://www.microsoft.com/migration/1.0/migxmlext/test">
<component type="Documents" context="System">
  <displayName>Component to migrate all Engineering Drafts Documents without subfolders</displayName>
  <role role="Data">
    <rules>
         <include>
            <objectSet>
                 <pattern type="File"> C:\EngineeringDrafts\* [*]</pattern>
            </objectSet>
          </include>
      <exclude>
        <objectSet>
          <pattern type="File"> C:\EngineeringDrafts\ [*]</pattern>
        </objectSet>
      </exclude>
    </rules>
  </role>
</component>
</migration>

Exemplo 4: Como excluir um arquivo de uma pasta específica

O arquivo .xml a seguir migra todos os arquivos e subpastas de C:\EngineeringDrafts, exceto o arquivo Sample.doc.

<migration urlid="https://www.microsoft.com/migration/1.0/migxmlext/test">
<component type="Documents" context="System">
  <displayName>Component to migrate all Engineering Drafts Documents except Sample.doc</displayName>
  <role role="Data">
    <rules>
         <include>
            <objectSet>
                 <pattern type="File"> C:\EngineeringDrafts\* [*]</pattern>
            </objectSet>
          </include>
      <exclude>
        <objectSet>
          <pattern type="File"> C:\EngineeringDrafts\ [Sample.doc]</pattern>
        </objectSet>
      </exclude>
    </rules>
  </role>
</component>
</migration>

Exemplo 5: Como excluir um arquivo de qualquer local

Para excluir um arquivo Sample.doc de qualquer local na unidade C:, use o elemento <pattern>. Caso existam vários arquivos com o mesmo nome na unidade C:, todos eles serão excluídos.

<pattern type="File"> C:\* [Sample.doc] </pattern>

Para excluir um arquivo Sample.doc de qualquer unidade do computador, use o elemento <script>. Caso existam vários arquivos com o mesmo nome, todos eles serão excluídos.

<script>MigXmlHelper.GenerateDrivePatterns("* [sample.doc]", "Fixed")</script>

<unconditionalExclude>

Caso queira excluir um tipo de arquivo da migração, sejam quais forem as outras regras de <include> ou <exclude>, você pode usar o elemento <unconditionalExclude>. Esse elemento exclui objetos globalmente de todos os componentes. Utilize-o, por exemplo, para excluir todos os arquivos .mp3 do computador. Ou, se estiver fazendo backup em C:\UserData usando outro método, você poderá excluir a pasta inteira da migração. Entretanto, use esse elemento com cuidado porque, se um aplicativo precisar de um arquivo que tenha sido excluído, o aplicativo poderá não funcionar corretamente no computador de destino. Para ver a sintaxe desse elemento, veja o tópico sobre a Referência XML da USMT.

Exemplo 1: Como excluir todos os arquivos .mp3
Exemplo 2: Como excluir todos os arquivos de uma unidade específica
Exemplo 3: Como excluir chaves do Registro
Exemplo 4: Como excluir as pastas C:\Windows e C:\Program Files (Arquivos de Programas)

Exemplo 1: Como excluir todos os arquivos .mp3

O arquivo .xml a seguir exclui todos os arquivos .mp3 da migração:

<migration urlid="https://www.microsoft.com/migration/1.0/migxmlext/excludefiles">
  <component context="System" type="Documents">
        <displayName>Test</displayName>
        <role role="Data">
            <rules>
             <unconditionalExclude>
                        <objectSet>
    <script>MigXmlHelper.GenerateDrivePatterns ("* [*.mp3]", "Fixed")</script>
                        </objectSet> 
             </unconditionalExclude>
            </rules>
        </role>
    </component>
</migration>

Exemplo 2: Como excluir todos os arquivos de uma unidade específica

O arquivo .xml a seguir exclui apenas os arquivos localizados na unidade C:.

<migration urlid="https://www.microsoft.com/migration/1.0/migxmlext/allfiles">
    <component type="Documents" context="System">
        <displayName>Test</displayName>
        <role role="Data">
            <rules>
  <unconditionalExclude>
                    <objectSet>
      <pattern type="File">c:\*[*]</pattern>
                    </objectSet>
  </unconditionalExclude>
            </rules>
        </role>
    </component>
</migration>

Exemplo 3: Como excluir chaves do Registro

O arquivo .xml a seguir exclui incondicionalmente a chave HKey_Current_User do Registro e todas as suas subchaves.

<?xml version="1.0" encoding="UTF-8"?>
<migration urlid="https://www.microsoft.com/migration/1.0/migxmlext/miguser">
   <component type="Documents" context="User">
      <displayName>Test</displayName>
      <role role="Data">
         <rules>
            <include>
               <objectSet>
                  <pattern type="Registry">HKCU\testReg[*]</pattern>
               </objectSet>
            </include>
            <unconditionalExclude>
               <objectSet>
                  <pattern type="Registry">HKCU\*[*]</pattern>
               </objectSet>
            </unconditionalExclude>
         </rules>
      </role>
   </component>
</migration>

Exemplo 4: Como excluir as pastas C:\Windows e C:\Program Files (Arquivos de Programas)

O arquivo .xml a seguir exclui incondicionalmente as pastas do sistema C:\Windows e C:\Program Files (Arquivos de Programas). Observe que todos os arquivos *.docx, *.xls e *.ppt não serão migrados porque o elemento <unconditionalExclude> tem precedência sobre o elemento <include>.

<?xml version="1.0" encoding="UTF-8"?>
<migration urlid="https://www.microsoft.com/migration/1.0/migxmlext/miguser">
   <component type="Documents" context="System">
      <displayName>Test</displayName>
      <role role="Data">
         <rules>
            <include>
               <objectSet>
    <script>MigXmlHelper.GenerateDrivePatterns ("* [*.doc]", "Fixed")</script>
    <script>MigXmlHelper.GenerateDrivePatterns ("* [*.xls]", "Fixed")</script>
    <script>MigXmlHelper.GenerateDrivePatterns ("* [*.ppt]", "Fixed")</script>
               </objectSet>
            </include>
            <unconditionalExclude>
               <objectSet>
                  <pattern type="File">C:\Program Files\* [*]</pattern>
<pattern type="File">C:\Windows\* [*]</pattern>
               </objectSet>
            </unconditionalExclude>
         </rules>
      </role>
   </component>
</migration>

Criar um arquivo Config.xml

Você pode criar e modificar um arquivo Config.xml se quiser excluir componentes da migração. A exclusão de componentes usando esse arquivo é mais fácil do que modificar os arquivos .xml de migração porque não é necessário estar familiarizado com as regras e a sintaxe de migração. O Config.xml é um arquivo opcional que pode ser criado por meio da opção de linha de comando /genconfig com a ferramenta ScanState. Por exemplo, é possível usar o arquivo Config.xml para excluir as configurações de um dos aplicativos padrão. Além disso, criar e modificar esse arquivo é a única maneira de excluir as configurações do sistema operacional que são migradas para computadores que executam o Windows.

Para excluir as configurações de um aplicativo padrão: especifique migrate="no" para o aplicativo na seção <Applications> do arquivo Config.xml.
Para excluir uma configuração do sistema operacional: especifique migrate="no" para a configuração na seção <WindowsComponents>.
Para excluir Meus Documentos: especifique migrate="no" para Meus Documentos na seção <Documents>. Observe que todas as regras de <include> nos arquivos .xml ainda serão aplicáveis. Por exemplo, se você tiver uma regra que inclua todos os arquivos .docx de Meus Documentos, somente os arquivos .docx serão migrados; o restante, não.

Veja Arquivo Config.xml para saber mais.