Compartir a través de

Referencia XML de ResetConfig

  • Artículo

Esta referencia describe todos los elementos XML que se usan para crear el archivo ResetConfig.xml, que se usan para configurar las características de restablecimiento de botón de inserción del entorno de recuperación de Windows.

ResetConfig XML

Este es un ResetConfig.xml vacío que puede usar como punto 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>

Reset

El Reset elemento XML puede contener los elementos : <Run> y <SystemDisk>.

Ejecutar

El <Run> elemento XML se usa para agregar scripts personalizados a las características de restablecimiento de botón de inserción.

Puede especificar hasta cuatro Run elementos en un único archivo ResetConfig.xml. Cada Run elemento debe contener un valor diferente [ExtPoint] para su Phase atributo.

En la tabla siguiente se describen los elementos válidos que se pueden agregar al Run elemento :

Elemento Descripción

Run Phase="[ExtPoint]""

Cada Run elemento define el punto de extensibilidad que se va a usar, el script que se ejecuta en ese punto de extensibilidad y la duración estimada del tiempo en minutos.

El atributo Phase es necesario. Solo acepta los siguientes valores para [ExtPoint]:

  • BasicReset_BeforeImageApply. Ejecuta el programa especificado en el punto de extensibilidad A.

  • BasicReset_AfterImageApply. Ejecuta el programa especificado en el punto de extensibilidad B.

  • FactoryReset_AfterDiskFormat. Ejecuta el programa especificado en el punto de extensibilidad C

  • FactoryReset_AfterImageApply. Ejecuta el programa especificado en el punto de extensibilidad D.

Puede especificar hasta cuatro Run secciones en un solo archivo ResetConfig.xml. Sin embargo, cada Run sección debe contener un valor diferente para el atributo phase.

Path

Especifica la ubicación del script para una sección determinada Run .

La ruta de acceso debe ser la ruta de acceso relativa del script de la carpeta que contiene ResetConfig.xml (normalmente es C:\Recovery\OEM).

Duration

Especifica el tiempo estimado, en minutos, que espera que se ejecute el script personalizado. Esta estimación se usa para mostrar información de progreso en la GUI.

La duración debe ser un entero y debe estar entre 1 y 5.

Param

Especifica los parámetros de la línea de comandos que se van a usar al ejecutar el archivo ejecutable o el script personalizado. El valor se trata como una cadena y puede contener varios parámetros.

Param no admite elementos vacíos. Si el script no requiere parámetros, no incluya este elemento. Para obtener ejemplos, consulte Uso de ResetConfig.xml más adelante en este tema.

SystemDisk

El SystemDisk elemento personaliza la funcionalidad de recuperación sin sistema operativo. Para obtener más información, vea Crear medios para ejecutar Push-Button restablecer características.

Puede especificar una <SystemDisk> sección. Estos son los elementos obligatorios y opcionales:

Elemento Descripción
MinSize

Necesario. Especifica el tamaño mínimo necesario para el disco duro principal, en megabytes.

La recuperación sin sistema operativo no continuará si el disco del sistema no cumple este requisito de tamaño.

DiskpartScriptPath

Necesario. Ruta de acceso al script diskpart relativo a C:\Recovery\OEM. El script debe suponer que se han eliminado todas las particiones existentes y que el disco del sistema se ha centrado en Diskpart.

Por ejemplo, si los scripts de recuperación se encuentran en C:\Recovery\OEM\Scripts\RecreatePartitions.dps, use el valor \Scripts\RecreatePartitions.dps.

OSPartition

Necesario. Partición a la que se debe restaurar el sistema operativo. La partición ESP o activa debe estar en el mismo disco que el sistema operativo.

WindowsREPartition

Necesario. Especifica la partición donde está instalada la imagen de arranque de Windows RE.

WindowsREPath

Necesario. Especifica la ruta de acceso de la carpeta donde se copia y almacena provisionalmente la imagen de arranque winre.wim, en relación con la raíz de la partición especificada en el WindowsREPartition elemento .

RestoreFromIndex

Opcional. Índice de la imagen dentro de install.wim que se va a aplicar durante la recuperación sin sistema operativo. Este elemento es opcional y solo es necesario en medios de recuperación creados por el fabricante.

Compact

Opcional. Especifica si la imagen de recuperación se debe aplicar con la compresión por archivo habilitada. Este elemento es opcional y solo es necesario en medios de recuperación creados por el fabricante.

Compact acepta los siguientes valores:

  • True: los archivos aplicados a partir de la imagen se comprimen individualmente.
  • False (valor predeterminado): no se usa la compresión.

RecoveryImagePartition

Esta configuración está en desuso en Windows 10.

RecoveryImagePath

Esta configuración está en desuso en Windows 10.

RecoveryImageIndex

Esta configuración está en desuso en Windows 10.

WIMBoot

Esta configuración está en desuso en Windows 10.

Uso de ResetConfig.xml

Si usa un editor de texto para crear los archivos de .xml, debe guardar el documento con una extensión de nombre de archivo .xml y usar la codificación UTF-8. No use ANSI ni ninguna otra codificación.

Estos archivos deben colocarse en la carpeta C:\Recovery\OEM para que las características de restablecimiento de botón de inserción puedan detectarlos automáticamente.

Ejemplo

Este es un ejemplo de código para el archivo 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>

Introducción al reseteo con botón

Crear medios para ejecutar características de restablecimiento de Push-Button