Referência XML de ResetConfig

Essa referência descreve todos os elementos XML usados para criar o arquivo ResetConfig.xml, usado para configurar recursos de redefinição de botão do Ambiente de Recuperação do Windows.

ResetConfig XML

Aqui está uma ResetConfig.xml vazia que você pode usar como ponto de partida:

<?xml version="1.0" encoding="utf-8"?>
<Reset>
 <Run Phase="BasicReset_BeforeImageApply">
   <Path></Path>
   <Duration></Duration>
 </Run>
 <Run Phase="BasicReset_AfterImageApply">
   <Path></Path>
   <Param></Param>
   <Duration></Duration>
 </Run>
 <Run Phase="FactoryReset_AfterDiskFormat">
   <Path></Path>
   <Duration></Duration>
 </Run>
 <Run Phase="FactoryReset_AfterImageApply">
   <Path></Path>
   <Param></Param>
   <Duration></Duration>
 </Run>
 <SystemDisk>
   <MinSize></MinSize>
   <DiskpartScriptPath> </DiskpartScriptPath>
   <OSPartition></OSPartition>
   <RestoreFromIndex></RestoreFromIndex>
   <WindowsREPartition></WindowsREPartition>
   <WindowsREPath></WindowsREPath>
   <Compact></Compact>
 </SystemDisk>
</Reset>

Redefinir

O Reset elemento XML pode conter os elementos: <Run> e <SystemDisk>.

Executar

O <Run> elemento XML é usado para adicionar scripts personalizados aos recursos de redefinição de botão de push.

Você pode especificar até quatro Run elementos em um único arquivo de ResetConfig.xml. Cada Run elemento deve conter um valor diferente [ExtPoint] para seu Phase atributo.

A tabela a seguir descreve os elementos válidos que podem ser adicionados ao Run elemento :

Elemento Descrição

Run Phase="[ExtPoint]""

Cada Run elemento define o ponto de extensibilidade a ser usado, o script executado nesse ponto de extensibilidade e a duração estimada do tempo em minutos.

O atributo Phase é necessário. Ele aceita apenas os seguintes valores para [ExtPoint]:

  • BasicReset_BeforeImageApply. Executa o programa especificado no ponto de extensibilidade A.

  • BasicReset_AfterImageApply. Executa o programa especificado no ponto de extensibilidade B

  • FactoryReset_AfterDiskFormat. Executa o programa especificado no ponto de extensibilidade C

  • FactoryReset_AfterImageApply. Executa o programa especificado no ponto de extensibilidade D

Você pode especificar até quatro Run seções em um único arquivo ResetConfig.xml. No entanto, cada Run seção deve conter um valor diferente para o atributo de fase.

Path

Especifica o local do script para uma seção específica Run .

O caminho deve ser o caminho relativo do script da pasta que contém ResetConfig.xml (geralmente este é C:\Recovery\OEM).

Duration

Especifica o tempo estimado, em minutos, que você espera que o script personalizado seja executado. Essa estimativa é usada para exibir informações de progresso na GUI.

A duração deve ser um inteiro e deve estar entre 1 e 5.

Param

Especifica os parâmetros de linha de comando a serem usados ao executar o script personalizado ou o arquivo executável. O valor é tratado como uma cadeia de caracteres e pode conter vários parâmetros.

Param não dá suporte a elementos vazios. Se o script não exigir parâmetros, não inclua esse elemento. Para obter exemplos, consulte Usando ResetConfig.xml mais adiante neste tópico.

SystemDisk

O SystemDisk elemento personaliza a funcionalidade de recuperação bare-metal. Para obter mais informações, consulte Criar mídia para executar Push-Button redefinir recursos.

Você pode especificar uma <SystemDisk> seção. Aqui estão os elementos obrigatórios e opcionais:

Elemento Descrição
MinSize

Obrigatórios. Especifica o tamanho mínimo necessário para o disco rígido primário, em megabytes.

A recuperação bare-metal não continuará se o disco do sistema não atender a esse requisito de tamanho.

DiskpartScriptPath

Obrigatórios. Caminho para o script Diskpart em relação a C:\Recovery\OEM. O script deve assumir que todas as partições existentes foram excluídas e o disco do sistema tem foco em Diskpart.

Por exemplo, se os scripts de recuperação estiverem localizados em C:\Recovery\OEM\Scripts\RecreatePartitions.dps, use o valor \Scripts\RecreatePartitions.dps.

OSPartition

Obrigatórios. A partição para a qual o sistema operacional deve ser restaurado. A partição ativa ou ESP deve estar no mesmo disco que o sistema operacional.

WindowsREPartition

Obrigatórios. Especifica a partição em que a imagem de inicialização Windows RE está instalada.

WindowsREPath

Obrigatórios. Especifica o caminho da pasta em que a imagem de inicialização Winre.wim é copiada e preparada, em relação à raiz da partição especificada no WindowsREPartition elemento .

RestoreFromIndex

Opcional. O índice da imagem em install.wim a ser aplicado durante a recuperação bare-metal. Esse elemento é opcional e só é necessário na mídia de recuperação criada pelo fabricante

Compact

Opcional. Especifica se a imagem de recuperação deve ser aplicada com a compactação por arquivo habilitada. Esse elemento é opcional e só é necessário na mídia de recuperação criada pelo fabricante.

Compact aceita os seguintes valores:

  • True: os arquivos aplicados da imagem são compactados individualmente.
  • False (valor padrão): a compactação não é usada.

RecoveryImagePartition

Essa configuração foi preterida em Windows 10.

RecoveryImagePath

Essa configuração foi preterida em Windows 10.

RecoveryImageIndex

Essa configuração foi preterida em Windows 10.

WIMBoot

Essa configuração foi preterida em Windows 10.

Usando ResetConfig.xml

Se você usar um editor de texto para criar seus arquivos .xml, deverá salvar o documento com uma extensão de nome de arquivo .xml e usar a codificação UTF-8. Não use ANSI ou qualquer outra codificação.

Esses arquivos devem ser colocados na pasta C:\Recovery\OEM para que possam ser detectados automaticamente pelos recursos de redefinição de botão de push.

Exemplo

Este é um exemplo de código para o arquivo ResetConfig.xml.

<?xml version="1.0" encoding="utf-8"?>
<Reset>
 <Run Phase="BasicReset_BeforeImageApply">
   <Path>Fabrikam\CopyFiles.cmd</Path>
   <Duration>2</Duration>
 </Run>
 <Run Phase="BasicReset_AfterImageApply">
   <Path>Fabrikam\InstallDrivers.cmd</Path>
   <Param>/allDrivers</Param>
   <Duration>2</Duration>
 </Run>
 <Run Phase="FactoryReset_AfterDiskFormat">
   <Path>Fabrikam\FixPartitions.exe</Path>
   <Duration>2</Duration>
 </Run>
 <Run Phase="FactoryReset_AfterImageApply">
   <Path>Fabrikam\InstallDrivers.cmd</Path>
   <Param>/allDrivers</Param>
   <Duration>2</Duration>
 </Run>
 <SystemDisk>
   <MinSize>75000</MinSize>
   <DiskpartScriptPath>Fabrikam\CreatePartition.txt </DiskpartScriptPath>
   <OSPartition>4</OSPartition>
   <RestoreFromIndex>2</RestoreFromIndex>
   <WindowsREPartition>1</WindowsREPartition>
   <WindowsREPath>Recovery\WindowsRE</WindowsREPath>
   <Compact>False</Compact>
 </SystemDisk>
</Reset>

Visão geral da restauração por botão de comando

Criar mídia para executar Push-Button redefinir recursos