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, umConfig.xml
arquivo pode ser usado para excluir toda a pasta Documentos ou excluir as configurações de um aplicativo. Excluir componentes usando umConfig.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 umConfig.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 eLoadState.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 eLoadState.exe
para migrar pastas de usuário, arquivos e tipos de arquivo. OMigUser.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.xml
arquivos 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 especificandomigrate="no"
, todos os componentes filho serão removidos automaticamente da migração, mesmo que o componente filho seja definido comomigrate="yes"
.Se houver erroneamente duas linhas de código para o mesmo componente em que uma linha especifica
migrate="no"
e a outra linha especificarmigrate="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
- Para obter mais informações sobre como alterar os arquivos e as configurações que são migrados, consulte os artigos de instruções da USMT (Ferramenta de Migração de Estado do Usuário).
- Para obter mais informações sobre cada elemento .xml , consulte o artigo biblioteca de elementos XML .
- Para obter respostas para perguntas comuns, consulte ".xml arquivos" no artigo Perguntas frequentes .
Artigos relacionados
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de