Arquivo Config.xml

Artigo
01/09/2024
Aplica-se a:

✅ Windows 11, ✅ Windows 10

O Config.xml arquivo é um arquivo USMT (User State Migration Tool) opcional que pode ser criado usando a opção /genconfig com a ferramenta ScanState . Se todos os componentes padrão devem ser incluídos e nenhuma alteração precisar ser feita no comportamento padrão de criação de armazenamento ou migração de perfil, um Config.xml arquivo não precisará ser criado.

No entanto, se o comportamento de migração padrão definido nos MigApp.xmlarquivos e MigUser.xmlMigDocs.xml for satisfatório, mas determinados componentes precisarem ser excluídos, um Config.xml arquivo poderá ser criado e modificado, deixando os outros arquivos .xml inalterados. Por exemplo, um Config.xml arquivo deve ser criado para excluir qualquer uma das configurações do sistema operacional que são migradas. É necessário criar e modificar o Config.xml arquivo para alterar qualquer um dos comportamentos padrão de criação de armazenamento ou migração de perfil.

O Config.xml arquivo tem um formato diferente dos outros arquivos de migração.xml , pois não contém regras de migração. Ele contém apenas uma lista dos componentes do sistema operacional, aplicativos, documentos de usuário que podem ser migrados e política de perfil de usuário e política de controle de erro. Por esse motivo, excluir componentes usando o Config.xml arquivo é mais fácil do que modificar a migração .xml arquivos, pois a familiarização com as regras de migração e a sintaxe não é necessária. No entanto, caracteres curinga não podem ser usados neste arquivo.

Para obter mais informações sobre como usar o Config.xml arquivo com outros arquivos de migração, como os MigDocs.xml arquivos e MigApps.xml , consulte Noções básicas sobre migração de arquivos 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.

Políticas de migração

No USMT, há políticas de migração que podem ser configuradas no Config.xml arquivo. Por exemplo, <as opções ErrorControl>, <ProfileControl> e <HardLinkStoreControl> podem ser configuradas. Os seguintes elementos e parâmetros são usados somente no Config.xml arquivo.

<Políticas>

O <elemento Policies contém elementos> que descrevem as políticas que o USMT segue ao criar um repositório de migração. As crianças válidas do< elemento Policies> são <ErrorControl> e <HardLinkStoreControl>. O <elemento Policies> é filho da <Configuração>.

Sintaxe:

<Policies> </Policies>

<ErrorControl>

O <elemento ErrorControl> é um elemento opcional que pode ser configurado no Config.xml arquivo. As regras de ErrorControl> configuráveis< dão suporte apenas às variáveis de ambiente para o sistema operacional em execução e o usuário conectado no momento. Como solução alternativa, um caminho pode ser especificado usando o caractere curinga (*).

Número de ocorrências: uma vez para cada componente
Elementos pai: o <elemento Policies>
Elementos filho: o <elemento fileError> e <RegistryError>

Sintaxe:

<ErrorControl> </ErrorControl>

O exemplo a seguir especifica que todos os arquivos bloqueados, independentemente de sua localização (incluindo arquivos em C:\Usuários), devem ser ignorados. No entanto, a migração falhará se qualquer arquivo em C:\Usuários não puder ser acessado devido a qualquer outro motivo. No exemplo a seguir, o <elemento ErrorControl> ignora quaisquer problemas na migração de chaves de registro que correspondam ao padrão fornecido e os resolve para um erro negado pelo Access .

Além disso, a ordem na <seção ErrorControl> implica prioridade. Neste exemplo, a primeira <marca não> fatal tem precedência sobre a segunda <marca fatal> . Essa precedência é aplicada, independentemente de quantas marcas estão listadas.

<ErrorControl>
  <fileError>
    <nonFatal errorCode="33">* [*]</nonFatal>
    <fatal errorCode="any">C:\Users\* [*]</fatal>
  </fileError>
  <registryError>
    <nonFatal errorCode="5">HKCU\SOFTWARE\Microsoft\* [*]</nonFatal>
  </registryError>
</ErrorControl>

Importante

As regras de ErrorControl> configuráveis< dão suporte apenas às variáveis de ambiente para o sistema operacional em execução e o usuário conectado no momento. Como solução alternativa, um caminho usando o caractere curinga (*) pode ser especificado.

<Fatal>

O <elemento fatal> não é necessário.

Número de ocorrências: uma vez para cada componente
Elementos pai: <fileError> e <RegistryError>
Elementos filho: nenhum.

Sintaxe:

<fatal errorCode="any"> <specify pattern here> </fatal>

Parâmetro	Obrigatório	Valor
Errorcode	Não	"any" ou "especificar mensagem de erro do sistema aqui"

O <elemento fatal> pode ser usado para especificar que erros que correspondam a um padrão específico devem fazer com que o USMT interrompa a migração.

<fileError>

O <elemento fileError> não é necessário.

Número de ocorrências: uma vez para cada componente
Elementos pai: <ErrorControl>
Elementos filho: <não fabricados> e <fatais>

Sintaxe:

<fileError> </fileError>

O <elemento fileError> pode ser usado para representar o comportamento associado a erros de arquivo.

<Nonfatal>

O <elemento nãofatal> não é necessário.

Número de ocorrências: uma vez para cada componente
Elementos pai: os <elementos fileError> e <RegistryError> .
Elementos filho: nenhum.

Sintaxe:

<nonfatal errorCode="any"> <specify pattern here> </nonFatal>

Parâmetro	Obrigatório	Valor
<Errorcode>	Não	"any" ou "especificar mensagem de erro do sistema". Se as mensagens de erro do sistema não forem especificadas, o comportamento padrão aplicará o parâmetro a todas as mensagens de erro do sistema.

O <elemento nãofatal> pode ser usado para especificar que erros que correspondam a um padrão específico não devem fazer com que o USMT interrompa a migração.

<RegistryError>

O <elemento RegistryError> não é necessário.

Número de ocorrências: uma vez para cada componente
Elementos pai: <ErrorControl>
Elementos filho: <não fatais> e <não fatais>

Sintaxe:

<registryError errorcode="any"> </registryError>

Parâmetro	Obrigatório	Valor
<Errorcode>	Não	"any" ou "especificar mensagem de erro do sistema aqui". Se as mensagens de erro do sistema não forem especificadas, o comportamento padrão aplicará o parâmetro a todas as mensagens de erro do sistema.

O <elemento RegistryError> pode ser usado para especificar que erros correspondentes a um padrão específico não devem fazer com que o USMT interrompa a migração.

<HardLinkStoreControl>

O <elemento HardLinkStoreControl> contém elementos que descrevem como lidar com arquivos durante a criação de um repositório de migração de link rígido. Seu único filho válido é <fileLocked>.

Sintaxe:

<HardLinkStoreControl> </HardLinkStoreControl>

Número de ocorrências: uma vez para cada componente
Elementos pai: <políticas>
Elementos filho: <fileLocked>

Sintaxe:

<HardLinkStoreControl> </HardLinkStoreControl>

O código de exemplo HardLinkStoreControl> a seguir< especifica que links rígidos só podem ser criados para arquivos bloqueados se o arquivo bloqueado residir em algum lugar em C:\Users\. Caso contrário, ocorre um erro de acesso ao arquivo quando um arquivo bloqueado é encontrado que não pode ser copiado, embora seja tecnicamente possível que o link seja criado.

Importante

A <seção ErrorControl> pode ser configurada para ignorar condicionalmente os erros de acesso ao arquivo, com base no local do arquivo.

<Policy>
   <HardLinkStoreControl>
      <fileLocked>
         <createHardLink>C:\Users\*</createHardLink>
         <errorHardLink>C:\*</errorHardLink>
      </fileLocked>
   </HardLinkStoreControl>
   <ErrorControl>
      […]
   </ErrorControl>
</Policy>

<fileLocked>

O <elemento fileLocked> contém elementos que descrevem como lidar com arquivos bloqueados para edição. As regras definidas pelo <elemento fileLocked> são processadas na ordem em que aparecem no arquivo XML.

Sintaxe:

<fileLocked> </fileLocked>

<createHardLink>

O <elemento createHardLink> define um padrão MigXML padrão que descreve caminhos de arquivo em que links rígidos devem ser criados, mesmo que o arquivo seja bloqueado para edição por outro aplicativo.

Sintaxe:

<createHardLink> <specify pattern here> </createHardLink>

<errorHardLink>

O <elemento errorHardLink> define um padrão MigXML padrão que descreve caminhos de arquivo em que links rígidos não devem ser criados se o arquivo estiver bloqueado para edição por outro aplicativo. O USMT tenta copiar arquivos nesses caminhos para o repositório de migração. No entanto, se isso não for possível, Error_Locked será lançada. Esse erro é um erro padrão da API (interface de programação do aplicativo Windows) que pode ser capturado pela <seção ErrorControl> para fazer com que a USMT ignore o arquivo ou anule a migração.

Sintaxe:

<errorHardLink> <specify pattern here> </errorHardLink>

<ProfileControl>

Esse elemento é usado para conter outros elementos que estabelecem regras para migrar perfis, usuários e políticas em torno da associação de grupo local durante a migração. <ProfileMigration> é filho da <Configuração>.

Sintaxe:

<ProfileControl> </ProfileControl>

<localGroups>

Esse elemento é usado para conter outros elementos que estabelecem regras de como migrar grupos locais. <localGroups> é filho do <ProfileControl>.

Sintaxe:

<localGroups> </localGroups>

<Mapeamentos>

Esse elemento é usado para conter outros elementos que estabelecem mapeamentos entre grupos.

Sintaxe:

<mappings> </mappings>

<changeGroup>

Esse elemento descreve os grupos de origem e de destino para uma alteração de associação de grupo local durante a migração. É filho de <grupos> locais. Os seguintes parâmetros são definidos:

Parâmetro	Obrigatório	Valor
De	Sim	Um grupo local válido no computador de origem que contém usuários selecionados para migração na linha de comando.
Para	Sim	Um grupo local para o qual os usuários devem ser movidos durante a migração.
Appliesto	Sim	nonmigratedUsers, migratedUsers, AllUsers. Esse valor define a quais usuários a operação do grupo de alterações deve ser aplicada.

Os filhos válidos e necessários do <changeGroup> são <incluem> e <excluem>. Embora ambos possam ser crianças ao mesmo tempo, apenas um é necessário.

Sintaxe:

<changeGroup From="Group1" To= "Group2"> </changeGroup>

<include>

Esse elemento especifica que seu filho necessário, <padrão>, deve ser incluído na migração.

Sintaxe:

<include> </include>

<exclude>

Esse elemento especifica que seu filho necessário, <padrão>, deve ser excluído da migração.

Sintaxe:

<exclude> </exclude>