Personalizar arquivos XML da USMT

Visão geral

Para usar qualquer um dos arquivos de.xml de migração com as ferramentas ScanState e LoadState , especifique esses arquivos na linha de comando usando a /i opção. 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 and LoadState.exe . No entanto, o Config.xml arquivo com a /config opção 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 realizar esse cenário, modifique o Config.xml arquivo e especifique o arquivo atualizado com o LoadState.exe comando. Em seguida, o LoadState.exe 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 que foram migrados com os arquivos de.xml ausentes serão migrados. No entanto, as regras de migração que foram especificadas com o ScanState.exe comando não se aplicam. Por exemplo, se um arquivo .xml for deixado de fora e contiver uma regra de redirecionamento, como:

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

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

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

  • Modifique os arquivos .xml 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, é essencial estar familiarizado com as regras e a sintaxe de migração. 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 ScanState e LoadState usarem 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 de 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 não é necessário ter familiaridade com as regras e a sintaxe de migração. Além disso, o uso de um Config.xml arquivo é a única maneira de excluir as configurações do sistema operacional da migração.

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

Migração .xml arquivos

Esta seção descreve a migração .xml arquivos incluídos na USMT. Cada arquivo contém regras de migração que controlam quais componentes são migrados e para onde eles 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 caractere curinga.

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

  • O arquivo MigDocs.xml. Especifique esse arquivo com as ferramentas ScanState e LoadState para migrar todas as pastas de usuário e arquivos encontrados pela função auxiliar MigXmlHelper.GenerateDocPatterns . Essa função auxiliar localiza 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 dados de aplicativo, arquivos de programa ou arquivos no diretório do Windows. O MigDocs.xml arquivo pode ser modificado.

  • O arquivo MigUser.xml. Especifique esse 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. Esse 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 é na linha de comando usando as opções de Usuário ScanState e as opções de Usuário LoadState.

Observação

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

Arquivos .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 os dois comandos. Para obter mais informações, consulte o artigo de exemplos de XML personalizado .

O arquivo Config.xml

O Config.xml arquivo é um arquivo opcional criado usando a /genconfig opção 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 de arquivo é diferente dos arquivos de.xml de migração porque não contém nenhuma regra de migração. Ela contém apenas uma lista dos componentes do sistema operacional, aplicativos e documentos de usuário que podem ser migrados. Para ver um exemplo, consulte o artigo Config.xml Arquivo . Por esse motivo, excluir componentes usando o Config.xml arquivo é mais fácil do que modificar os arquivos .xml migração. Com o Config.xml, a familiaridade com as regras de migração e a sintaxe não é. No entanto, caracteres curinga não podem ser usados em um Config.xml arquivo.

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

Quando o ScanState.exe comando é executado com a /genconfig opção, ScanState.exe lê os outros arquivos .xml especificados usando a /i opção para criar uma lista personalizada de componentes que podem ser migrados do computador. Esse arquivo contém apenas componentes do sistema operacional, aplicativos e seções do 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 /genconfig opção. Portanto, esse arquivo deve ser criado em um computador de origem que contenha 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 é criado, ele só precisa ser especificado com o ScanState.exe comando usando a /Config opção para afetar 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 será 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 seus componentes filho serão removidos automaticamente da migração, mesmo se o componente filho estiver definido como migrate="yes".

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

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

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 arquivo e os Config.xml arquivos .xml migração padrão:

    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 armazenamento e migra os arquivos e configurações:

    LoadState.exe \\server\share\migration\mystore /i:MigApp.xml /i:MigDocs.xml /v:5 /decrypt /key:"mykey"

Informações adicionais

  • Last updated on