Compartilhar via

Personalizar arquivos XML USMT

Visão geral

Para usar qualquer um dos arquivos de migração.xml com as ferramentas ScanState e LoadState , 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 os ScanState.exe comandos e LoadState.exe . No entanto, o Config.xml arquivo com a opção /config não precisa ser especificado, a menos que alguns dos arquivos e configurações migrados do repositório precisem ser excluídos. Por exemplo, para migrar a pasta Documentos para o repositório , mas não para o computador de destino. Para obter esse cenário, modifique o Config.xml arquivo e especifique o arquivo atualizado com o LoadState.exe comando. Em LoadState.exe seguida, o comando migra apenas os arquivos e configurações desejados.

Se um arquivo .xml for deixado de fora do LoadState.exe comando, todos os dados no repositório migrados com os arquivos de.xml ausentes serão migrados. No entanto, as regras de migração especificadas com o ScanState.exe comando não se aplicam. Por exemplo, se um arquivo .xml for deixado de fora e ele contiver uma regra de redirecionamento como:

MigsysHelperFunction.RelativeMove("c:\data", "%CSIDL_PERSONAL%")

O USMT não redireciona os arquivos e eles são migrados para C:\data.

Para modificar a migração, faça um ou mais dos seguintes procedimentos.

  • Modifique os arquivos de .xml de migração. Para excluir uma parte de um componente, modifique os arquivos .xml . Por exemplo, para migrar C:\ mas excluir todos os arquivos .mp3 ou mover dados para um novo local no computador de destino. Para modificar esses arquivos, a familiaridade com as regras de migração e a sintaxe é obrigatória. Para Que ScanState e LoadState usem esses arquivos, especifique-os na linha de comando quando cada comando for inserido.

  • Crie um arquivo de .xml personalizado. Um arquivo de.xml personalizado também pode ser criado para migrar configurações para outro aplicativo ou para alterar o comportamento de migração para atender às necessidades da organização. Para Que ScanState e LoadState usem esse arquivo, especifique-os em ambas as linhas de comando.

  • Crie e modifique um arquivo Config.xml. Crie e modifique um Config.xml arquivo para excluir um componente inteiro da migração. Por exemplo, um Config.xml arquivo pode ser usado para excluir toda a pasta Documentos ou excluir as configurações de um aplicativo. Excluir componentes usando um Config.xml arquivo é mais fácil do que modificar a migração .xml arquivos porque a familiaridade com as regras de migração e a sintaxe não é necessária. Além disso, usar um Config.xml arquivo é a única maneira de excluir a migração das configurações do sistema operacional.

Para obter mais informações sobre como excluir dados, consulte o artigo Excluir Arquivos e Configurações .

Arquivos de .xml de migração

Esta seção descreve a migração .xml arquivos incluídos com USMT. Cada arquivo contém regras de migração que controlam quais componentes são migrados e para onde são migrados no computador de destino.

Observação

O caractere curinga asterisco (*) pode ser usado em cada um desses arquivos. No entanto, um ponto de interrogação (?) não pode ser usado como um caractere curinga.

  • O arquivo MigApp.xml. Especifique esse arquivo com os ScanState.exe comandos e LoadState.exe para migrar as configurações do aplicativo.

  • O arquivo MigDocs.xml. Especifique este 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 Usuários. No entanto, ele não encontra e migra nenhum dado de aplicativo, arquivos de programa ou arquivos no diretório do Windows. O MigDocs.xml arquivo pode ser modificado.

  • O arquivo MigUser.xml. Especifique este arquivo com os ScanState.exe comandos e LoadState.exe para migrar pastas de usuário, arquivos e tipos de arquivo. O MigUser.xml arquivo pode ser modificado. 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 migrar está na linha de comando usando as opções usuário ScanState e as opções usuário loadstate.

Observação

Não use os MigUser.xml arquivos e MigDocs.xml juntos. Para obter mais informações, consulte os artigos Identificar tipos de arquivo, arquivos e pastas e práticas recomendadasdo USMT .

Arquivos de .xml personalizados

Arquivos de.xml personalizados podem ser criados para personalizar a migração para as necessidades exclusivas da organização. Por exemplo, um arquivo de.xml personalizado pode ser criado para migrar um aplicativo de linha de negócios ou para modificar o comportamento de migração padrão. Para ScanState.exe e LoadState.exe para usar esse arquivo, especifique-o com ambos os comandos. Para obter mais informações, consulte o artigo Exemplos XML Personalizados .

O arquivo Config.xml

O Config.xml arquivo é um arquivo opcional que é criado usando a opção /genconfig com o ScanState.exe comando. Esse arquivo deve ser criado e modificado para excluir determinados componentes da migração. Além disso, esse arquivo deve ser criado e modificado para excluir qualquer uma das configurações do sistema operacional de ser migrada. O Config.xml formato do arquivo é diferente da migração .xml arquivos porque ele não contém regras de migração. Ele contém apenas uma lista dos componentes do sistema operacional, aplicativos e os documentos de usuário que podem ser migrados. Para obter um exemplo, consulte o artigo ArquivoConfig.xml . Por esse motivo, excluir componentes usando o Config.xml arquivo é mais fácil do que modificar a migração .xml arquivos. Com a Config.xml, familiaridade com as regras de migração e sintaxe não é. No entanto, caracteres curinga não podem ser usados em um Config.xml arquivo.

Para incluir todos os componentes padrão, um Config.xml arquivo não precisa ser criado. Como alternativa, se o comportamento de migração padrão definido no , e os MigApp.xmlarquivos forem satisfatórios e apenas alguns componentes precisarem ser excluídos, um Config.xml arquivo poderá ser MigUser.xml criado. MigDocs.xml Os outros arquivos.xml podem ser deixados em seu estado original.

Quando o ScanState.exe comando é executado com a opção /genconfig , ScanState.exe lê os outros arquivos .xml especificados usando a opção /i para criar uma lista personalizada de componentes que podem ser migrados do computador. Este arquivo contém apenas componentes do sistema operacional, aplicativos e as seções de documento do usuário que estão em ambos os arquivos .xml e que são instalados no computador quando o ScanState.exe comando é executado com a opção /genconfig . Portanto, esse arquivo deve ser criado em um computador de origem que contém todos os componentes, aplicativos e configurações presentes nos computadores de destino. A criação do arquivo no computador de origem garante que esse arquivo contenha todos os componentes que podem ser migrados. Os componentes são organizados em seções: <Aplicativos>, <WindowsComponents> e <Documentos>. Para optar por não migrar um componente, altere sua entrada para migrate="no".

Depois que esse arquivo for criado, ele só precisa ser especificado com o ScanState.exe comando usando a opção /Config para que ele afete a migração. No entanto, se dados adicionais que foram migrados para o repositório precisarem ser excluídos, modifique o Config.xml arquivo e especifique o arquivo atualizado com o LoadState.exe comando. Por exemplo, se a pasta Documentos for coletada no repositório, mas a pasta Documentos não precisar ser migrada para um computador de destino, o Config.xml arquivo poderá ser modificado para indicar migrate="no" antes que o LoadState.exe comando seja executado e o arquivo não seja migrado. Para obter mais informações sobre a precedência que ocorre ao excluir dados, consulte o artigo Excluir arquivos e configurações .

Além disso, observe a seguinte funcionalidade com o Config.xml arquivo:

  • Se um componente pai for removido da migração no Config.xml arquivo especificando migrate="no", todos os componentes filho serão removidos automaticamente da migração, mesmo que o componente filho seja definido como migrate="yes".

  • Se houver erroneamente duas linhas de código para o mesmo componente em que uma linha especifica migrate="no" e a outra linha especificar migrate="yes", o componente será migrado.

  • No USMT, há várias políticas de migração que podem ser configuradas no Config.xml arquivo. Por exemplo, opções adicionais <ErrorControl>, <ProfileControl> e <HardLinkStoreControl> podem ser configuradas. Para obter mais informações, consulte o artigo ArquivoConfig.xml .

Observação

Para excluir um componente do Config.xml arquivo, defina o valor de migração como "não". Excluir a marca XML do componente do Config.xml arquivo não exclui o componente da migração.

Exemplos

  • O comando a seguir cria um Config.xml arquivo no diretório atual, mas não cria um repositório:

    ScanState.exe /i:MigApp.xml /i:MigDocs.xml /genconfig:Config.xml /v:5

  • O comando a seguir cria um repositório criptografado usando o Config.xml arquivo e a migração padrão .xml arquivos:

    ScanState.exe \\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.exe \\server\share\migration\mystore /i:MigApp.xml /i:MigDocs.xml /v:5 /decrypt /key:"mykey"

Informações adicionais